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 Google Cloud Platform'un Beta sürümünü sunar.
apigee-analytics-collector komut satırı
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 bahsedeceğim.
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 veri yükleyebiliyor.
Uç Yönetim Sunucusu'nda Edge Management API'ye her iki erişimi olan düğüm yoksa
harici internete erişimi varsa, 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 kullanmanız gerekmez.
yardımcı olur. Görüntüleyin
Verileri
Apigee'den daha fazla bilgi edinebilirsiniz.
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 öğesini kök olmayan bir hesap olarak çalıştırmalısınız
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, koşu yapan kişinin kullanıcı adıdır.
apigee-analytics-collector yardımcı programı.
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ı:
/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 için aşağıdaki bilgilere ihtiyacınız var
ve verileri Apigee'ye iletmek için:
apigee_mgmt_api_uri: Yönetiminizdeki Edge API'nin temel URL'si Sunucu. Bu URL genellikle aşağıdaki 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
Edge Management API'de TLS'yi etkinleştirirseniz şu şekilde olur:
https://ms_IP:8080/v1 https://ms_DNS/v1
apigee_mgmt_api_email: Şuna erişimi olan bir hesabın e-posta adresi: Uç/statsAPI'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_idve apigee_analytics_secret: Apigee'ye veri yüklemek için sahip olduğunuz kimlik bilgileri. Almak için lütfen Apigee Edge Destek Ekibi'ne kayıt gönderinapigee_analytics_client_idveapigee_analytics_secret.
Ö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 ile şu işlemleri yapın:
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_client_id.
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 comma-separated list of items-x, --exclude_orgs comma-separated list of items-n, --include_envs comma-separated list of items-e, --exclude_envs comma-separated list of items
Ö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 kullanın.
seçenek:
/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. Daha sonra, şunu göndermek için -S seçeneği olmadan komutu yeniden çalıştırabilirsiniz:
verileri Apigee'ye aktarır.
-S kullanmak için bir neden
seçeneğidir. Apigee için yalnızca
API trafik verilerini yükleyebilirsiniz. Ancak -D seçeneği, API ile ilgili verileri görüntülemenize olanak tanır.
ürünler, geliştiriciler, uygulamalar veya API proxy'leri. Aşağıdaki örnekte -D ve
Geliştirici verilerini görüntülemek için -S seçenek
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
Şunları 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örmek için:
/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ı:
| Komut | Açıklama |
|---|---|
-h, --help |
Çıkış kullanım bilgileri |
-D, --dimension dimension |
Toplanacak trafik boyutu. Geçerli değerler şunlardır:
|
-d, --days days
|
Geçerli tarihten itibaren geçmişteki günlerin toplanacak verilerin sayısı. İlgili içeriği oluşturmak için kullanılan varsayılan değer 3'tür.
|
-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 |
-p, --apigee_mgmt_api_password apigee_mgmt_api_password |
Edge Management API e-posta hesabıyla ilişkili şifre:
|
-i, --include_orgs items
|
Çıkışa dahil edilecek kuruluşların virgülle ayrılmış listesi. |
-x, --exclude_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, --exclude_envs items
|
Çıkıştan eklenecek ortamların virgülle ayrılmış listesi. |
-o, --output path
|
Çıkışın kaydedileceği yol ve dosya adı. |
-s, --time_range_start time_range_start
|
Trafik istatistiklerinin sorgulanması için başlangıç zamanı: "MM/DD/YYYY HH:MM".
|
-z, --time_range_end time_range_end
|
Trafik istatistiklerini sorgulamak için zaman aralığı bitişi: "04/01/2016 24:00".
|
-t, --time_unit time_unit
|
Trafik verileri için zaman birimi. Varsayılan değer:
|
-S, --standard_output
|
Çı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 Edge Destek Ekibi'ne başvurarak ele alacağız. |
-r, --apigee_analytics_secret apigee_analytics_secret
|
Apigee'ye veri yükleme sırrınız. Lütfen Apigee Edge Destek Ekibi'ne başvurarak ele alacağız. |
-R, --include_curl_commands
|
Oluşturulan |
-v, --verbose
|
Ayrıntılı çıkışı görüntüleyin. |
Apigee'ye manuel olarak veri yükleme
Apigee, apigee-analytics-collector yardımcı programını bir cihaza yüklemenizi öneriyor.
Harici internet erişimi olan bir makinede. Daha sonra, apigee-analytics-collector yardımcı programı
doğrudan Apigee'ye veri yükleyebiliyor.
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
makine
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 env_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. belirtir toplanacak metriklerin zaman birimlerine bölünmesi. Not:curlkomutu, zamandaki boşluklar için%20onaltılık kodunu kullanır aralığı.
Ö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 API çağrısı.
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"
(timeRange öğesinin URL olarak kodlanmış karakterler içerdiğini unutmayın.)
Ş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 şunu kullanın:
curl komutu:
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"...'
Burada:
- apigee_analytics_client_id:apigee_analytics_secret Apigee'ye veri yüklemek için kullanabileceğiniz kimlik bilgileridir.
- org_name, kuruluş adını belirtir.
- "environments"..., şu
curlkomutunun sonuçlarını içerir: bir şablondur.