Apigee への API トラフィック データのアップロード - ベータ版リリース

Edge for Private Cloud をご利用のお客様は、API プロキシのトラフィックに関する統計情報を Apigee に送信していただく必要があります。cron ジョブを作成することによって、1 日 1 回情報をアップロードすることをおすすめします。

本番環境にデプロイされた API のデータを送信する必要がありますが、開発環境やテスト環境にデプロイされた API のデータは送信しないでください。ほとんどの Edge インストールでは、本番環境の API に特定の組織または環境を定義します。送信するデータは、本番環境用の組織と環境にのみ使用されます。

このデータのアップロードを支援するために、Apigee は apigee-analytics-collector コマンドライン ユーティリティのベータ版をリリースしています。このユーティリティは、API 呼び出し量レポートを Apigee に返します。すべての Edge for Private Cloud インストール環境で、このユーティリティを使用してトラフィック データを取得し、Apigee に報告できます。

必須: データをアップロードする前に Apigee サポートに問い合わせる

データを Apigee にアップロードする前に、Apigee Edge サポートに連絡してオンボーディング プロセスを完了してください。

apigee-analytics-collector をインストールする

apigee-analytics-collector ユーティリティは、apigee-service ユーティリティを使用してインストールする RPM です。

インストールする場所

apigee-analytics-collector ユーティリティをインストールするノードは、Edge Management Server 上の Edge Management API にアクセスできる任意のノードにできます。このノードが Management Server に API リクエストを送信できる場合は、Management Server 、Edge インストールの別のノード、または別のノードに直接インストールできます。

インターネット アクセスの要件

外部インターネットにアクセスできるマシンに apigee-analytics-collector ユーティリティをインストールします。これにより、apigee-analytics-collector ユーティリティがデータを Apigee に直接アップロードできます。

Edge Management Server 上の Edge Management API へのアクセスが可能なノードと、外部インターネット アクセスが可能なノードの両方が存在しない場合は、Edge Management API を使用してトラフィック データをローカルに保存できます。その後、インターネットにアクセスできるマシンにデータを転送し、Apigee にアップロードする必要があります。このシナリオでは apigee-analytics-collector ユーティリティを使用する必要はありません。詳細については、Apigee へのデータの手動アップロードをご覧ください。

インストール

次のコマンドを使用して、apigee-analytics-collector ユーティリティをインストールします。RPM ファイルをインストールするため、このコマンドは root ユーザーまたは sudo フルアクセス権を持つユーザーが実行する必要があります。sudo フルアクセスとは、ユーザーが root と同じ操作を行うための sudo アクセス権を持っていることを意味します。

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector install

apigee-analytics-collector の実行

このセクションでは、apigee-analytics-collector ユーティリティの実行方法について説明します。

apigee-analytics-collector を実行するようにユーザーを構成する

root 以外のユーザーとして apigee-analytics-collector を実行する必要があります。このユーザーには、「apigee」ユーザーに対する sudo フルアクセス権限が必要です。

あるユーザーに「apigee」ユーザーに対する sudo フルアクセス権限を与えるには、visudo コマンドを使用して sudoers ファイルに次の行を追加します。

analyticsUser        ALL=(apigee)      NOPASSWD: ALL

ここで、analyticsUserapigee-analytics-collector ユーティリティを実行しているユーザーのユーザー名です。

apigee-analytics-collector ユーティリティをインストールしてユーザーを構成した後、apigee-analytics-collector ユーティリティの help コマンドを実行してユーティリティをテストできます。

/opt/apigee/apigee-service/bin/apigee-service apigee-analytics-collector export traffic --help

apigee-analytics-collector を実行するために必要な情報

apigee-analytics-collector コマンドを実行してデータを Apigee に転送するには、次の情報が必要です。

  • apigee_mgmt_api_uri: Management Server 上の Edge API のベース URL。この URL の形式は通常、次のとおりです。

    http://ms_IP:8080/v1

    ここで、ms_IP は Management Server の IP アドレスで、8080 は Edge API で使用されるポートです。Edge API の DNS エントリを作成した場合、URL の形式は次のとおりです。

    http://ms_DNS/v1

    Edge Management API で TLS を有効にする場合、その形式は次のとおりです。

    https://ms_IP:8080/v1
    https://ms_DNS/v1
  • apigee_mgmt_api_email: Edge /stats API へのアクセス権を持つアカウントのメールアドレス。多くの場合、これは Edge システム管理者のメールアドレス、または本番環境組織の組織管理者のメールアドレスになります。
  • apigee_mgmt_api_password: apigee_mgmt_api_email で指定されたアカウントの Edge パスワード。
  • apigee_analytics_client_idapigee_analytics_secret: Apigee にデータをアップロードするための認証情報。apigee_analytics_client_idapigee_analytics_secret を取得するには、Apigee Edge サポートにチケットを送信してください。

コマンドの例

次の例は、Edge のインストール環境内のすべての組織と環境のトラフィック データを取得し、そのデータを Apigee にアップロードするコマンドの例です。apigee-service を使用して apigee-analytics-collector コマンドを実行している点に注目してください。

/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

このコマンドには、apigee_analytics_client_idapigee_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 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

本番環境の組織と環境のみを指定するには、-i(または --include_orgs)と -n(または --include_envs) オプション)を使用します。

/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

この例では、myOrg の本番環境からのみデータを収集します。

データを画面にダンプして調査する前に、Apigee に送信する前に -S オプションを使用します。

/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 オプションを使用すると、Apigee へのデータのアップロードを省略できます。その後、-S オプションを指定せずにコマンドを再実行し、データを Apigee に送信することができます。

-S オプションを使用する理由の 1 つは、さまざまな種類のデータをローカルで表示できることです。Apigee では、API トラフィック データのアップロードのみが必要ですが、-D オプションを使用すると、API プロダクト、デベロッパー、アプリ、API プロキシに関するデータを表示できます。以下の例では、-D オプションと -S オプションを使用して、デベロッパー データをローカルに表示します。

/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

詳細出力を取得するには -v オプションを指定し、apigee-analytics-collector によって生成された curl コマンドを表示するには -R オプションを指定します。

/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

次のセクションに、コマンドライン オプションの一覧を示します。

コマンド パラメータ

次の表に、apigee-analytics-collector ユーティリティのオプションの一覧を示します。

コマンド 説明
-h, --help

使用情報の出力

-D, --dimension dimension

収集するトラフィック ディメンション。指定できる値は次のとおりです。

  • apiproducts
  • apiproxy(デフォルト)
  • apps
  • devs
-d, --days days

現在の日付から始まる、収集する過去の日数。デフォルトは 3 です。

-d を指定する場合、期間を設定する -s-z を指定しないでください。

-m, --apigee_mgmt_api_uri apigee_mgmt_api_uri

Edge Management API への URL です。

-u, --apigee_mgmt_api_email apigee_mgmt_api_email

Edge /stats API へのアクセス権を持つアカウントのメールアドレス。これは通常、Edge システム管理者のメールアドレス、または本番環境組織の組織管理者のメールアドレスです。

-p, --apigee_mgmt_api_password apigee_mgmt_api_password

-u で指定された Edge Management API メール アカウントに関連付けられているパスワード。

-i, --include_orgs items

出力に含める組織のカンマ区切りのリスト。

-x, --exclude_orgs items

出力から除外する組織のカンマ区切りのリスト。

-n, --include_envs items

出力に含める環境のカンマ区切りリスト。

-e, --exclude_envs items

出力に含める環境のカンマ区切りリスト。

-o, --output path

出力を保存するパスとファイル名

-s, --time_range_start time_range_start

トラフィック統計情報のクエリを開始する期間。形式: MM/DD/YYYY HH:MM

-d を指定する場合、期間を設定する -s-z を指定しないでください。

-z, --time_range_end time_range_end

トラフィック統計情報のクエリを終了する期間は、「04/01/2016 24:00」の形式です。

-d を指定する場合、期間を設定する -s-z を指定しないでください。

-t, --time_unit time_unit

トラフィック データの時間単位。デフォルト値は hour です。有効な時間単位は次のとおりです。

  • second
  • minute
  • hour(デフォルト)
  • day
  • week

-tweek に、-d365 に設定すると、Apigee は大量のデータを 52 個の個別のエントリにグループ化して返します(週に 1 つずつ)。

-S, --standard_output

出力を Apigee にアップロードするのではなく、ターミナル(stdout)に書き込みます。

-c, --apigee_analytics_client_id apigee_analytics_client_id

Apigee にデータをアップロードするための ID。Apigee Edge サポートにチケットを送信して取得してください。

-r, --apigee_analytics_secret apigee_analytics_secret

Apigee にデータをアップロードするためのシークレット情報。Apigee Edge サポートにチケットを送信して取得してください。

-R, --include_curl_commands

デバッグ用に、生成された curl コマンドを出力に含めます。

-v, --verbose

詳細出力を表示します。

Apigee へのデータの手動アップロード

外部インターネットにアクセスできるマシンに apigee-analytics-collector ユーティリティをインストールすることをおすすめします。これにより、apigee-analytics-collector ユーティリティがデータを Apigee に直接アップロードできます。

マシンに外部インターネット アクセスがない場合は、Edge Management API を使用してトラフィック データを収集し、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/apiproxy?select=sum(message_count)&timeRange=MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour"

このコマンドは、Edge Get API のメッセージ カウント API を使用します。コマンドの内容:

  • apigee_mgmt_api_email:apigee_mgmt_api_password には、Edge /stats API へのアクセス権を持つアカウントのメールアドレスを指定します。
  • ms_IP は、Edge Management Server の IP アドレスまたは DNS 名です。
  • org_nameenv_name には、組織と環境を指定します。
  • apiproxy は、API プロキシごとに指標をグループ化するディメンションです。
  • MM/DD/YYYY%20HH:MM~MM/DD/YYYY%20HH:MM&timeUnit=hour では、収集する指標の時間単位に分割された期間を指定します。curl コマンドは、期間のスペースに 16 進数コード %20 を使用します。

たとえば、24 時間にわたって 1 時間ごとの API プロキシ メッセージの数を収集するには、次の API 呼び出しを使用します。

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 には URL エンコードされた文字が含まれます)。

レスポンスは次の形式で表示されます。

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

インターネットにアクセスできるマシンから 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 コマンドの結果が含まれます。