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

Edge for Private Cloud s. 4.17.05

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.

Şu kullanıcı tarafından yüklenen verilere erişme: apigee-analytics-collector

apigee-analytics-collector yardımcı programıyla veri yükledikten sonra, bunu Apigee 360'ta görüntüleyebilirsiniz.

Verileri görüntülemek için Apigee 360'a giriş yapın ve ardından Kullanım seçeneğini belirleyin. İlgili içeriği oluşturmak için kullanılan Kullanım sayfasında, her bir ürününüze ilişkin kullanım grafiği ve Uç kuruluşlar.

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

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.