Edge for Private Cloud 4.18.05 sürümü
Tüm Edge for Private Cloud müşterilerinin, API ile ilgili Apigee istatistiklerini göndermeleri gerekir proxy trafiğinden farklıdır. Apigee, müşterilerin bu bilgileri günde bir kez, bazen cron işi oluşturmayı öğrendiniz.
Geliştirme aşamasındaki API'ler için değil, üretim API'si dağıtımlarınız için veri göndermeniz gerekir test etmek anlamına gelir. Çoğu Edge yüklemesinde belirli kuruluşları veya ortamları için ideal. Gönderdiğiniz veriler yalnızca bu üretim için geçerlidir kurumlar ve ortamlarla ilişkilidir.
Apigee, bu verilerin yüklenmesine yardımcı olmak için apigee-analytics-collector komut satırının Beta sürümünü sunar yardımcı olur. Bu yardımcı program, API çağrı hacmi raporunu Apigee'ye geri gönderir. Her Uç Private Cloud yüklemesi, trafik verilerini almak ve raporlamak için bu yardımcı programı kullanabilir Apigee.
Gerekli: Veri yüklemeden önce Apigee Destek Ekibi ile iletişime geçin
Apigee'ye veri yüklemeden önce ilk katılım işlemini tamamlamak için Apigee Edge Destek Ekibi ile iletişime geçmeniz gerekir.
Apigee-analytics-collector uygulamasını yükleme
apigee-analytics-collector yardımcı program, apigee-service yardımcı programını kullanarak yüklediğiniz bir BGBG'dir.
Nereye yüklenir?
apigee-analytics-collector yardımcı programını yüklediğiniz düğüm düğümünün bir bölümüdür. Yükleyebilirsiniz doğrudan Yönetim Sunucusu'nda, Edge kurulumunun başka bir düğümünde veya yalnızca söz konusu düğümün Yönetim Sunucusu'na API istekleri gönderebilmesi gerekir.
İnternet erişimi koşullar
apigee-analytics-collector yardımcı programını Harici internet erişimi olan bir makinede. Daha sonra apigee-analytics-collector yardımcı programı doğrudan Apigee'ye aktarır.
Uç Yönetim Sunucusu'nda Edge Management API'ye her iki erişimi olan düğüm yoksa Ayrıca, harici internet erişimiyle de trafikten tasarruf etmek için Edge management API'yi kullanabilirsiniz verileri yerel olarak toplar. Ardından, verileri yüklemek için internet erişimi olan bir makineye aktarmanız gerekir. Apigee. Bu senaryoda, apigee-analytics-collector yardımcı programını kullanmanız gerekmez. Görüntüleyin Verileri Apigee hakkında daha fazla bilgi edinin.
Kurulum
apigee-analytics-collector yardımcı programını yüklemek için aşağıdaki komutu kullanın. Çünkü bir BGBG dosyası yüklüyorsanız, bu komut kök kullanıcı veya tam sudo erişimi. Tam sudo erişimi için, kullanıcının aynı işlemi gerçekleştirmek üzere sudo erişimine sahip olması işlemleri kök olarak gerçekleştirmesini sağlar.
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector install
Apigee-analytics-collector öğesini çalıştırma
Bu bölümde, apigee-analytics-collector yardımcı programının nasıl çalıştırılacağı açıklanmaktadır.
Bir kullanıcıyı Apigee-analytics-collector komutunu çalıştıracak şekilde yapılandırma
apigee-analytics-collector kodunu kök olmayan bir belirtir. Bu kullanıcı "Apigee" için tam sudo erişimine sahip olmalıdır belirtir.
Bir kullanıcıyı "Apigee"ye tam sudo erişimine sahip olacak şekilde yapılandırmak için kullanıcı için "visudo" komutuna şunu eklemek için sudoers dosyasını düzenleyin:
analyticsUser ALL=(apigee) NOPASSWD: ALL
Burada analyticsUser, apigee-analytics-collector yardımcı programını uygular.
apigee-analytics-collector yardımcı programını yükledikten sonra yapılandırdıktan sonra, doğrulama işlemini gerçekleştirmek için "help" komutunu çalıştırarak apigee-analytics-collector yardımcı programını oluşturun:
> /opt/apigee/apigee-service/bin/ apigee-service apigee-analytics-collector export traffic --help
Apigee-analytics-collector komutunu çalıştırmak için gerekli bilgiler
apigee-analytics-collector komutunu çalıştırmak ve Apigee'ye iletmeniz gerekir:
- apigee_mgmt_api_uri: Yönetiminizdeki Edge API'nin temel URL'si
Sunucu. Bu URL genellikle şu biçimdedir:
http://ms_IP:8080/v1
. Burada ms_IP IP adresiniz veya Yönetim Sunucunuz ve 8080'dir. Edge API tarafından kullanılan bağlantı noktası. Edge API için bir DNS girişi oluşturduysanız URL şuradadır: şu formu kullanın:
http://ms_DNS/v1
. TLS'yi Edge management API'de etkinleştirirseniz şu biçimde olur:
https://ms_IP:8080/v1
https://ms_DNS/v1 - apigee_mgmt_api_email: Edge /stats API'leri. Genellikle bu Edge sistem yöneticisinin e-posta adresi veya kuruluş yöneticisinin e-posta adresi olacaktır üretim kuruluşları için.
- apigee_mgmt_api_password: apigee_mgmt_api_email.
- apigee_analytics_client_id ve apigee_analytics_client_id: Apigee'ye veri yüklemek için sahip olduğunuz kimlik bilgileri. Destek almak için lütfen Apigee Destek Ekibi'ne bir kayıt oluşturun apigee_analytics_client_id ve apigee_analytics_client_id.
Örnek komutlar
Aşağıda, tüm kuruluşlar ve kuruluşlar için trafik verilerini almaya yönelik bir örnek komut gösterilmektedir: ortamlarında yükleme yapabilir ve bu verileri Apigee'ye yükleyebilirsiniz. Web sitenizde apigee-service etiketini kullanarak apigee-analytics-collector komutunu çalıştırın:
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
Komutun, apigee_analytics_client_id ve apigee_analytics_secret değerine ayarlayın.
Sonuçları şu formda göreceksiniz:
[
{
"org": "myOrg",
"env": "prod",
"time_range_start": "08/27/2016 00:00",
"time_range_end": "08/30/2016 00:00",
"response": [
{
"store_org_env_metrics_hourly_v4": 1
}
]
},
{
"org": "VALIDATE",
"env": "test",
"time_range_start": "08/27/2016 00:00",
"time_range_end": "08/30/2016 00:00",
"response": [
{
"store_org_env_metrics_hourly_v4": 1
}
]
}
]
Komutun işlemlerini kontrol etmek için komut satırı seçeneklerini kullanın. Aşağıdaki seçenekleri kullanarak oluşturulan verilere dahil edilecek kuruluşları ve ortamları belirtin:
- -i, --include_orgs <virgülle ayrılmış öğe listesi>
- -x, --excluded_orgs <virgülle ayrılmış öğe listesi>
- -n, --include_envs <virgülle ayrılmış öğe listesi>
- -e, --excluded_envs <virgülle ayrılmış öğe listesi>
Örneğin, yalnızca üretim kuruluşlarını ve ortamlarını belirtmek için -i (veya --include_orgs) ve -n (veya --include_envs) seçenekleri:
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
Bu örnekte, yalnızca şunun üretim ortamından veri topluyorsunuz: myOrg.
Verileri Apigee'ye göndermeden önce incelemek üzere bir ekrana aktarmak için -S seçeneğini kullanın:
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
-S seçeneği verileri atlar Apigee'ye yükleyebilirsiniz. Ardından, verileri Apigee'ye göndermek için -S seçeneği olmadan komutu yeniden çalıştırabilirsiniz.
-S seçeneğidir. Apigee için yalnızca API trafik verilerini yükleyebilirsiniz, ancak -D seçeneği API hakkında veriler görüntüleyebilmenizi sağlar ürünler, geliştiriciler, uygulamalar veya API proxy'leri. Aşağıdaki örnekte, geliştirici verilerini görüntülemek için -D ve -S seçenekleri kullanılmaktadır yerel olarak:
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S -D devs \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
Aşağıdakileri almak için -v seçeneğini ekleyin: ayrıntılı çıkış ve -R seçeneği apigee-analytics-collector tarafından oluşturulan curl komutlarını görebilirsiniz:
> /opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic -i myOrg -n prod -S -R -v \ --apigee_mgmt_api_uri http://192.168.56.103:8080/v1 \ --apigee_mgmt_api_email $ae_username \ --apigee_mgmt_api_password $ae_password \ --apigee_analytics_client_id $apigee_analytics_client_id \ --apigee_analytics_secret $apigee_analytics_secret
Bir sonraki bölümde, komut satırı seçeneklerinin tam listesi yer alır.
Komut parametreleri
Aşağıdaki tabloda, apigee-analytics-collector yardımcı programına yönelik tüm seçenekler listelenmiştir:
|
Komut |
Kullanım |
|---|---|
|
-h, --yardım |
Çıkış kullanım bilgileri |
|
-D, --boyut <dimension> |
Toplanacak trafik boyutu. Geçerli boyutlar: apiproducts, devs, apps, apiproxy (varsayılan) |
|
-d, --gün <days> |
Geçerli tarihten itibaren toplanacak verilerin son gün sayısı. İlgili içeriği oluşturmak için kullanılan varsayılan değer 3'tür. -d değerini belirtirseniz -s ve Saat ayarlamak için -z aralığı. |
|
-m, --Apigee_mgmt_api_uri <apigee_mgmt_api_uri> |
Edge management API'nin URL'si. |
|
-u, --Apigee_mgmt_api_email <apigee_mgmt_api_email> |
Edge /stats API'lerine erişimi olan bir hesabın e-posta adresi. Bu çoğu zaman Edge sistem yöneticisinin e-posta adresi veya kuruluş yöneticisinin e-posta adresi üretim kurumlarınız. |
|
-p, --Apigee_mgmt_api_password <apigee_mgmt_api_password> |
-u ile belirtilen Edge management API e-posta hesabıyla ilişkilendirilmiş şifre. |
|
-i, --include_orgs <items> |
Çıkışa dahil edilecek kuruluşların virgülle ayrılmış listesi. |
|
-x, --excluded_orgs <items> |
Çıkıştan hariç tutulacak kuruluşların virgülle ayrılmış listesi. |
|
-n, --include_envs <items> |
Çıkışa dahil edilecek ortamların virgülle ayrılmış listesi. |
|
-e, --excluded_envs <items> |
Çıkıştan eklenecek ortamların virgülle ayrılmış listesi. |
|
-o, --çıkış <path> |
Çıkışın kaydedileceği yol ve dosya adı. |
|
-s, --time_range_start <time_range_start> |
Trafik istatistiklerinin sorgulanması için başlayacak zaman aralığı: "03/01/2016 00:00". -d belirtirseniz bir zaman aralığı ayarlamak için -s ve -z değerlerini de belirtmeyin. |
|
-z, --zaman_aralığı_bitiş <time_range_end> |
Trafik istatistiklerini sorgulamak için zaman aralığı bitişi: "04/01/2016 24:00". -d belirtirseniz bir zaman aralığı ayarlamak için -s ve -z değerlerini de belirtmeyin. |
|
-t, --time_unit <time_unit> |
Trafik verileri için zaman birimi. Varsayılan birimler saattir. Geçerli zaman birimleri: saniye, dakika, saat, gün, hafta. |
|
-S, --standart_çıkış |
Çıkışı Apigee'ye yüklemek yerine terminale (stdout) yazın. |
|
-c, --Apigee_analytics_client_id <apigee_analytics_client_id> |
Apigee'ye veri yüklemek için kullanılan kimliğiniz. Lütfen Apigee Destek Ekibi'ne bir kayıt oluşturarak şu işlemi yapın: ele alacağız. |
|
-r, --Apigee_analytics_secret <apigee_analytics_secret> |
Apigee'ye veri yükleme sırrınız. Lütfen Apigee Destek Ekibi'ne bir kayıt oluşturarak şu işlemi yapın: ele alacağız. |
|
-R, --include_curl_komutları |
Oluşturulan cURL komutlarını, hata ayıklama için çıkışa ekleyin. |
|
-v, --ayrıntılı |
Ayrıntılı çıkışı görüntüleyin. |
Apigee'ye manuel olarak veri yükleme
Apigee, apigee-analytics-collector yardımcı programını Harici internet erişimi olan bir makinede. Daha sonra apigee-analytics-collector yardımcı programı doğrudan Apigee'ye aktarır.
Ancak makinenin harici internet erişimi yoksa Edge management API'yi kullanarak şu işlemleri yapabilirsiniz: trafik verilerini toplayabilir ve cURL komutlarını kullanarak bu verileri bir makineden Apigee'ye yükleyebilir. internet erişimi. Bu işlemi her üretim kuruluşu için tekrarlamanız ve ortamını kullandığınızdan emin olun.
Belirli bir kuruluş için trafik verilerini toplamak üzere aşağıdaki cURL komutunu kullanın ve belirli bir zaman aralığı için uygun bir ortam sağlar:
curl -X GET -u apigee_mgmt_api_email:apigee_mgmt_api_password \
"http://<ms_IP>:8080/v1/organizations/{org_name}/environments/{env_name}/stats/apiproxy?select=sum(message_count)&timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour"
Bu komut, Edge Get API mesaj sayısı API'sini kullanır. Bu komutta:
- apigee_mgmt_api_email:apigee_mgmt_api_password Edge /stats API'lerine erişimi olan bir hesabın e-posta adresi.
- <ms_IP>, Edge'in IP adresi veya DNS adıdır Yönetim Sunucusu.
- {org_name} ve {org_name}, kuruluş ve ortam.
- apiproxy, metrikleri API proxy'lerine göre gruplandıran boyuttur.
- MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour
toplanacak metriklerin zaman birimlerine bölünmesi. cURL komutunun
zaman aralığındaki boşluklar için
%20onaltılık kodunu kullanır.
Örneğin, 24 saatlik bir süre içinde saat bazında API proxy mesajı sayılarını toplamak için kişi takip ediliyor management API çağrısı ile ilgili daha fazla bilgi edinin. timeRange, URL kodlamalı karakterler içerir.
curl -X GET -u apigee_mgmt_api_email:apigee_mgmt_api_password \ "http://192.168.56.103:8080/v1/organizations/myOrg/environments/prod/stats/apiproxy?select=sum(message_count)&timeRange=01%2F01%2F2018%2000%3A00~01%2F02%2F2018%2000%3A00&timeUnit=hour"
Şu biçimde bir yanıt görmeniz gerekir:
{
"environments" : [ {
"dimensions" : [ {
"metrics" : [ {
"name" : "sum(message_count)",
"values": [
{
"timestamp": 1514847600000,
"value": "35.0"
},
{
"timestamp": 1514844000000,
"value": "19.0"
},
{
"timestamp": 1514840400000,
"value": "58.0"
},
{
"timestamp": 1514836800000,
"value": "28.0"
},
{
"timestamp": 1514833200000,
"value": "29.0"
},
{
"timestamp": 1514829600000,
"value": "33.0"
},
{
"timestamp": 1514826000000,
"value": "26.0"
},
{
"timestamp": 1514822400000,
"value": "57.0"
},
{
"timestamp": 1514818800000,
"value": "41.0"
},
{
"timestamp": 1514815200000,
"value": "27.0"
},
{
"timestamp": 1514811600000,
"value": "47.0"
},
{
"timestamp": 1514808000000,
"value": "66.0"
},
{
"timestamp": 1514804400000,
"value": "50.0"
},
{
"timestamp": 1514800800000,
"value": "41.0"
},
{
"timestamp": 1514797200000,
"value": "49.0"
},
{
"timestamp": 1514793600000,
"value": "35.0"
},
{
"timestamp": 1514790000000,
"value": "89.0"
},
{
"timestamp": 1514786400000,
"value": "42.0"
},
{
"timestamp": 1514782800000,
"value": "47.0"
},
{
"timestamp": 1514779200000,
"value": "21.0"
},
{
"timestamp": 1514775600000,
"value": "27.0"
},
{
"timestamp": 1514772000000,
"value": "20.0"
},
{
"timestamp": 1514768400000,
"value": "12.0"
},
{
"timestamp": 1514764800000,
"value": "7.0"
}
]
}
],
"name" : "proxy1"
} ],
"name" : "prod"
} ],
"metaData" : {
"errors" : [ ],
"notices" : [ "query served by:53dab80c-e811-4ba6-a3e7-b96f53433baa", "source pg:6b7bab33-e732-405c-a5dd-4782647ce096", "Table used: myorg.prod.agg_api" ]
}
}
Daha sonra bu verileri internet erişimi olan bir makineden Apigee'ye yüklemek için aşağıdaki cURL'yi kullanın komut:
curl -X POST -H 'Content-Type:application/json' \
-u apigee_analytics_client_id:apigee_analytics_secret \
https://nucleus-api-prod.apigee.com/v1/apigee-analytics-cli-api/traffic/orgs/{org_name}/apis -d '{"environments"...}'
Bu örnekte:
- Apigee_analytics_client_id:fu_analytics_secret Apigee Desteği'nden aldığınız verileri Apigee'ye yüklemek için gereken kimlik bilgileridir.
- {org_name}, kuruluşu belirtir.
- {"environments"...}, oluşturulan cURL komutunun sonuçlarını içerir. bir şablondur.