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

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

地理的集計は、サードパーティのデータベースから地理データを抽出し、Edge で収集された分析データに追加することで機能します。地理情報には、API プロキシに対するリクエストの市区町村、国、大陸、タイムゾーン、地域が含まれます。

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

地域別集計の有効化

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

• すべての Qpid サーバーに MaxMind データベースをインストールし、それを使用するように Qpid サーバーを構成します。
• 新しい Edge UI で地域マップの表示を有効にします。

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

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

1. Maxmind GeoIp2 データベースを取得します。
   
2. Qpid サーバーノードに次のフォルダを作成します。

   /opt/apigee/maxmind

3. Maxmind GeoIp2 データベースを /opt/apigee/maxmind にダウンロードします。
4. データベース ファイルの所有権を「apigee」ユーザーに変更します。

   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」へのシンボリック リンクを作成します。後で別のファイル名を持つ新しいデータベースを受け取った場合、Qpid サーバーを再構成して再起動するのではなく、シンボリック リンクを更新するだけで済みます。

7. qpid-server.properties ファイルの所有権を「apigee」ユーザーに変更します。

   chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties

8. Qpid サーバーを再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

9. このプロセスをすべての Qpid ノードで繰り返します。
10. 地理情報集計が機能していることを検証するには:
    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 テーブルが入力されない場合は、/opt/apigee/var/log/edge-qpid-server/logs/ の Qpid サーバーログを調べて、潜在的な例外を検出します。

新しい Edge UI で地域マップを有効にする

新しい Edge UI で地域マップを有効にする手順は次のとおりです。

1. 地域マップを有効にするには、/opt/apigee/customer/application/management-ui.properties に次のトークンを設定します。ファイルが存在しない場合は作成します。

   conf_uebe_disableGeoMap=false

2. management-ui.properties ファイルの所有権を apigee ユーザーに変更します。

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties

3. 新しい Edge UI を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

4. 新しい Edge UI で、[Analyze] > [End Users] > [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 サーバーを再起動する必要があります。

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

4. データベース ファイルの所有権を「apigee」ユーザーに変更します。

   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/apigee-service/bin/apigee-service edge-qpid-server restart

7. このプロセスをすべての Qpid ノードで繰り返します。