地域別集計と地域マップの有効化

Edge for Private Cloud v4.18.05

地域別集計を使用すると、地域に基づいて API 呼び出しの分析データを収集できる 地域、大陸、国、都市などの属性で識別できます。この分析データから、 API リクエストの場所を示す Edge UI の GeoMap:

地域別集計では、サードパーティのデータベースから地域データを抽出し、 Edge で収集された分析データに関連付けます。地理情報には都市 API プロキシに対するリクエストの国、大陸、タイムゾーン、リージョン。

地域別集計を使用するには、このデータを含む MaxMind GeoIP2 データベースを購入する必要があります 提供しますhttps://www.maxmind.com/en/geoip2-databases をご覧ください。 をご覧ください。

地域別集計の有効化

デフォルトでは、地域別集計は有効になっていません。地域別集計を有効にするには、次の操作を行う必要があります。

  • すべての Qpid サーバーに MaxMind データベースをインストールし、以下を使用するように Qpid サーバーを設定します。 できます。
  • Edge UI で GeoMap の表示を有効にします。

MaxMind をインストールする すべてのエッジ Qpid サーバー上のデータベースに

次の手順で、すべての Edge Qpid サーバーに MaxMind データベースをインストールします。

  1. MaxMind GeoIP2 データベースを取得します。
  2. Qpid サーバーノードに次のフォルダを作成します。 
    /opt/apigee/maxmind
  3. MaxMind GeoIP2 データベースを /opt/apigee/maxmind にダウンロードします。
  4. データベース ファイルの所有権を「apigee」に変更します。user: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. データベースに対する権限を 744 に設定します。 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. /opt/apigee/customer/application/qpid-server.properties に次のトークンを設定します。 このファイルが存在しない場合は作成します。 
    conf_ingestboot-service_vdim.geo.ingest.enabled=true
conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb

    Maxmind GeoIP2 データベースを別の場所に保存している場合は、path プロパティを編集します 必要があります。

    このデータベース ファイルにはバージョン番号が含まれています。後で最新の バージョン番号が異なる場合があります。代わりに、シンボリック リンクを作成し、 データベース ファイルを指定し、qpid-server.properties でシンボリック リンクを使用します。

    たとえば、「GeoIP2-City-current.mmdb」というシンボリック リンクを作成します。を「GeoIP2-City_20160127.mmdb」に変更します。条件 後で別のファイル名の新しいデータベースを受け取った場合、 シンボリック リンクを使用できるようになります。

  7. qpid-server.properties ファイルの所有権を「apigee」に変更します。user: 
    chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
  8. Qpid サーバーを再起動します。 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  9. すべての Qpid ノードでこの手順を繰り返します。
  10. 地域別集計が機能していることを確認するには: <ph type="x-smartling-placeholder">
      </ph>
    1. サンプル API プロキシで複数の API プロキシ呼び出しをトリガーします。
    2. 集計が完了するまで 5 ～ 10 分ほど待ちます。
    3. コンソールを開き、Edge Postgres サーバーに接続します。 
      psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. テーブル analytics.agg_geo で SELECT クエリを実行して、 地域属性: 
      select * from analytics.agg_geo;

      次の列がクエリの結果に表示されます: MaxMind GeoIP2 データベース: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region。

      agg_geo テーブルにデータが入力されていない場合は、次の場所にある Qpid サーバーログを確認してください。 /opt/apigee/var/log/edge-qpid-server/logs/ を使用して、 例外があります。

Edge UI で Geo Maps を有効にする

Edge UI で GeoMap を有効にするには、次の手順を実行します。

  1. /opt/apigee/customer/application/ui.properties で次のトークンを設定します。 Geo マップを有効にしますこのファイルが存在しない場合は作成します。 
    conf_apigee_apigee.feature.disablegeomap=false
  2. ui.properties ファイルの所有権を「apigee」に変更するuser: 
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. Edge UI を再起動します。 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
  4. Edge UI で、[Analytics] >GeoMap: 地域別集計を表示 分析できます

MaxMind GeoIP2 データベースの更新

MaxMind は MaxMind GeoIP2 データベースを定期的に更新しています。最新の 次の手順で Edge にインストールします。

  1. 更新された MaxMind GeoIP2 データベースを取得します。
  2. MaxMind GeoIP2 データベースを /opt/apigee/maxmind にダウンロードします。
  3. データベース ファイルの名前を確認します。ファイルが古いファイル（ /opt/apigee/customer/application/qpid-server.properties の場合は、次のステップに進みます。 ファイル名が異なる場合は、ファイルを編集する必要があります。 qpid-server.properties ファイルに新しいデータベース ファイルの名前を指定し、 前述のように Qpid サーバーを再起動します。

    別の方法として、ファイルへのシンボリック リンクを作成することもできます。たとえば、Kubernetes Engine の 「GeoIP2-City-current.mmdb」を「GeoIP2-City_20160127.mmdb」に変更します。後で新しいデータベースを受け取った場合 シンボリック リンクを更新するだけで済みます。 Qpid サーバーを再構成します。

  4. データベース ファイルの所有権を「apigee」に変更します。user: 
    chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  5. データベースに対する権限を 744 に設定します。 
    chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
  6. Qpid サーバーを再起動します。 
    /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
  7. すべての Qpid ノードでこの手順を繰り返します。