API Trafik Verilerini Apigee'ye Yükleme - Beta Sürümü

Edge for Private Cloud s. 4.17.01

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.

Trafik verilerini Apigee'ye yükleme işlemi hakkında daha fazla bilgi için SSS.

Apigee-analytics-collector uygulamasını yükleme

apigee-analytics-collector yardımcı programı, npm kullanarak yüklediğiniz bir Node.js modülüdür.

Kurulum koşullar

apigee-analytics-collector yardımcı program şunları gerektirir:

• npm 2.x veya sonrası
• Node.js 4.x.

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 Daha fazlası için aşağıda Apigee'ye manuel olarak veri yükleme bölümüne bakın.

Kurulum

apigee-analytics-collector yardımcı programını yüklemek için aşağıdaki komutu kullanın:

> npm install apigee-analytics-collector -g

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.

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 adresi 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ına yüklemeli ve bu verileri Apigee'ye yüklemelidir:

> 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:

> 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:

> 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:

> 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:

 > 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 grubuna yönelik tüm seçenekler listelenmiştir yardımcı program:

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.
• &lt;ms_IP&gt;, 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&amp;timeUnit=hour toplanacak metriklerin zaman birimlerine bölünmesi. cURL komutunun zaman aralığındaki boşluklar için %20 onaltı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"

Şu biçimde bir yanıt görmeniz gerekir:

{
  "environments" : [ {
    "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"
  } ],
  "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.