Загрузка данных трафика API в Apigee — бета-версия

Edge для частного облака v. 4.16.09

Все клиенты Edge for Private Cloud обязаны отправлять в Apigee статистику о трафике прокси-сервера API. Apigee рекомендует клиентам загружать эту информацию один раз в день, возможно, создав задание cron.

Вы должны предоставить данные для своих производственных развертываний API, но не для API, находящихся в стадии разработки или тестирования. В большинстве установок Edge вы определяете конкретные организации или среды для своих рабочих API. Данные, которые вы отправляете, предназначены только для этих производственных организаций и сред.

Чтобы помочь в загрузке этих данных, Apigee предоставляет бета-версию утилиты командной строки apigee-analytics-collector . Эта утилита отправляет отчет об объеме вызовов API обратно в Apigee. Каждая установка Edge для частного облака может использовать эту утилиту для получения и передачи данных о трафике в Apigee.

Дополнительную информацию о процессе загрузки данных о трафике в Apigee можно найти в FAQ .

Установка apigee-analytics-collector

Утилита apigee-analytics-collector — это модуль Node.js, который вы устанавливаете с помощью npm .

Требования к установке

Утилита apigee-analytics-collector требует:

• npm 2.x или новее
• Node.js 4.x.

Где установить

Узел, на котором вы устанавливаете утилиту apigee-analytics-collector, может быть любым узлом, который имеет доступ к API управления Edge на Edge Management Server. Вы можете установить его непосредственно на Сервере управления, на другом узле установки Edge или на отдельном узле, если этот узел может отправлять запросы API к Серверу управления.

Требования к доступу в Интернет

Установите утилиту apigee-analytics-collector на машину с внешним доступом в Интернет. Затем утилита apigee-analytics-collector сможет загрузить данные непосредственно в Apigee.

Если нет узла с доступом к API управления Edge на сервере Edge Management Server и внешним доступом к Интернету, вы можете использовать API управления Edge для локального сохранения данных трафика. Затем вам необходимо перенести данные на компьютер с доступом в Интернет для загрузки в Apigee. В этом сценарии вам не нужно использовать утилиту apigee-analytics-collector . Дополнительную информацию см. в разделе «Загрузка данных в Apigee вручную» ниже.

Установка

Используйте следующую команду для установки утилиты apigee-analytics-collector :

> npm install apigee-analytics-collector -g

Запуск сборщика apigee-analytics-collector

В этом разделе описывается, как запустить утилиту apigee-analytics-collector .

Информация, необходимая для запуска apigee-analytics-collector

Для запуска команды apigee-analytics-collector и пересылки данных в Apigee вам потребуется следующая информация:

• apigee_mgmt_api_uri : базовый URL-адрес Edge API на вашем сервере управления. Этот URL-адрес обычно имеет форму:
  http:// ms_IP :8080/v1
  
  Где ms_IP — это IP-адрес вашего сервера управления, а 8080 — это порт, используемый Edge API. Если вы создали запись DNS для Edge API, URL-адрес будет иметь вид:
  http:// мс_DNS /v1
  
  Если вы включите TLS в API управления Edge, то он будет иметь вид:
  https ://ms_IP:8080/v1
  https ://ms_DNS/v1
• apigee_mgmt_api_email : адрес электронной почты учетной записи с доступом к API Edge /stats . Часто это адрес электронной почты системного администратора Edge или адрес электронной почты администратора вашей производственной организации.
• apigee_mgmt_api_password : пароль Edge для учетной записи, указанной в apigee_mgmt_api_email .
• apigee_analytics_client_id и apigee_analytics_secret : ваши учетные данные для загрузки данных в Apigee. Отправьте заявку в службу поддержки Apigee , чтобы получить apigee_analytics_client_id и apigee_analytics_secret .

Примеры команд

Ниже показан пример команды для получения данных о трафике для всех организаций и сред в установке Edge и загрузки этих данных в Apigee:

> 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

Обратите внимание, что команда содержит всю необходимую информацию, такую ​​как ваш apigee_analytics_client_id и apigee_analytics_secret .

Вы должны увидеть результаты в виде:

[
  {
    "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
      }
    ]
  }
]

Используйте параметры командной строки для команды, чтобы управлять ее действиями. Используйте следующие параметры, чтобы указать организации и среды, которые необходимо включить в сгенерированные данные:

• -i, --include_orgs <список элементов, разделенных запятыми>
• -x, --exclude_orgs <список элементов, разделенных запятыми>
• -n, --include_envs <список элементов, разделенных запятыми>
• -e, --exclude_envs <список элементов, разделенных запятыми>

Например, чтобы указать только производственные организации и среды, используйте параметры -i (или -include_orgs ) и -n (или --include_envs ):

> 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

В этом примере вы собираете данные только из рабочей среды myOrg .

Чтобы выгрузить данные на экран и просмотреть их перед отправкой в ​​Apigee, используйте опцию -S :

> 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 исключает загрузку данных в Apigee. Затем вы можете повторно запустить команду без опции -S , чтобы отправить данные в Apigee.

Одна из причин использования опции -S заключается в том, что вы можете локально отображать различные типы данных. Apigee требует только загрузки данных о трафике API, но опция -D позволяет отображать данные о продуктах API, разработчиках, приложениях или прокси-серверах API. В приведенном ниже примере используются параметры -D и -S для локального отображения данных разработчика:

> 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 

Включите параметр -v , чтобы получить подробный вывод, и параметр -R , чтобы просмотреть команды curl, сгенерированные apigee-analytics-collector :

 > 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 

Следующий раздел содержит полный список параметров командной строки.

Параметры команды

В следующей таблице приведен полный набор параметров утилиты apigee-analytics-collector:

Ручная загрузка данных в Apigee

Apigee рекомендует установить утилиту apigee-analytics-collector на компьютер с внешним доступом в Интернет. Затем утилита apigee-analytics-collector сможет загрузить данные непосредственно в Apigee.

Однако, если у компьютера нет внешнего доступа к Интернету, используйте API управления Edge для сбора данных о трафике, а затем используйте команды cURL для загрузки их в Apigee с компьютера с доступом в Интернет. Вам придется повторить этот процесс для каждой производственной организации и среды в вашей установке Edge.

Используйте следующую команду cURL для сбора данных о трафике для конкретной организации и среды за указанный интервал времени:

curl -X GET -u apigee_mgmt_api_email:apigee_mgmt_api_password \
"http://<ms_IP>:8080/v1/organizations/{org_name}/environments/{env_name}/stats/?select=sum(message_count)&timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM"

Эта команда использует API подсчета сообщений Edge Get API. В этой команде:

• apigee_mgmt_api_email:apigee_mgmt_api_password указывает адрес электронной почты учетной записи с доступом к API Edge/stats.
• <ms_IP> — это IP-адрес или DNS-имя пограничного сервера управления.
• {org_name} и {env_name} определяют организацию и среду.
• ММ/ДД/ГГГГ%20ЧЧ:ММ~ММ/ДД/ГГГГ%20ЧЧ:ММ указывает временной диапазон сбора статистики. Обратите внимание, что команда cURL использует шестнадцатеричный код %20 для пробелов в диапазоне времени.

Например, чтобы собрать статистику за 24 часа, используйте следующую команду:

curl -X GET -u apigee_mgmt_api_email:apigee_mgmt_api_password \
"http://192.168.56.103:8080/v1/organizations/myOrg/environments/prod/stats/?select=sum(message_count)&timeRange=08/29/2016%2000:00~08/30/2016%2000:00"

Вы должны увидеть ответ в виде:

{
  "environments" : [ {
    "metrics" : [ {
      "name" : "sum(message_count)",
      "values" : [ "42.0" ]
    } ],
    "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" ]
  }
}

Чтобы затем загрузить эти данные в Apigee с компьютера с доступом в Интернет, используйте следующую команду cURL:

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"...}'

где:

• apigee_analytics_client_id:apigee_analytics_secret укажите ваши учетные данные для загрузки данных в Apigee, которые вы получили от службы поддержки Apigee.
• {org_name} указывает организацию.
• {"environments"...} содержит результаты команды cURL, которую вы использовали для сбора статистики выше.