ISPデータの監視設定（リアルユーザー監視）

デフォルトでは、リアルユーザー監視/モバイルアプリ監視では、エンドユーザーのISPおよび地域データは表示されません。ISPデータを取得するには、サードパーティ製のジオロケーションAPIをご利用いただけます。現在、DEM Collectorでは、JSON形式でレスポンスを返すAPIのみをサポートしています。

ジオロケーションAPIとは

IPジオロケーションAPIとは、IPアドレスに基づいて地理情報を提供するために構築されたオンラインサービスです。その目的は、IPアドレスに関連付けられたおおよその物理的な位置を特定することを支援することであり、幅広いアプリケーションやサービスにおいて役立ちます。
通常、IPジオロケーションAPIはIPアドレスを入力として受け取り、それに関連する地理的位置に関する情報を返します。この情報には、提供されたIPアドレスに関連付けられた国、地域、都市、およびインターネットサービスプロバイダー（ISP）などの詳細が含まれます。

注：市場には多くのIPジオロケーションAPIが存在し、その中には一定の制限付きで無料利用枠を提供しているものもあります。
具体的な用途やユーザー数に応じて、提供されている無料プランがニーズを満たしているか、あるいはより上位の有料プランを選択する必要があるかを判断することが重要です。

ジオロケーションAPIをご購入後は、以下の例に示されている詳細情報を確認してください。
その後、これらの詳細情報をDEM Collectorの設定に組み込んでください。

属性 説明
位置情報API https://me-apm-ip.com/json
IPアドレス

API によっては、IPアドレスがURIまたはクエリパラメータのいずれかで渡されることを想定している場合があります。

  • URI：https://me-apm-ip.com/121.0.0.1/json
  • クエリパラメータ：https://me-apm-ip.com/json?ip=121.0.0.1
APIのレスポンス {
"query": "121.0.0.1",
"status": "success",
"country": "India",
"countryCode": "IN",
"region": "タミル・ナードゥ州",
"regionCode": "TN",
"timezone": "Asia/Kolkata",
"isp": "VSNL"
}
APIレスポンスの内訳 'country'：そのIPアドレスに関連付けられている国です。
'countryCode'：その国の2文字の国コードです。
'region'：そのIPアドレスに関連付けられている州/地域です。
'regionCode'：IPアドレスに関連付けられた州の地域コードです。
'isp'：そのIPアドレスに関連付けられているインターネットサービスプロバイダーです。

DEM CollectorでGeological APIの詳細を設定するには、以下の手順に従ってください。

  1. <DEMCollector_Home>/conf/ディレクトリにあるGeolocationAPIResources.xmlファイルを、任意のテキストエディタで開いてください。

  2. 以下のサンプルAPI設定を参考に、GeolocationAPIResources.xmlファイルにサードパーティAPIの詳細を追加してください。

    クエリパラメータ内のIP：

    <GEO-API-DETAILS resource="1" method="queryparam" url="https://me-apm-ip.com/json" ipKey="ip" responseType="JSON" countryKey="country" countryCodeKey="countryCode" regionKey="regionName" regionCodeKey="regionCode" ispKey="org"/>

    URI内のIP:

    <GEO-API-DETAILS resource="2" method="uri" url="http://ip-g3-location.com/{query}/json" ipKey="ip" responseType="JSON" countryKey="location" countryCodeKey="regionCode" regionKey="regionName" regionCodeKey="regionCode" ispKey="isp"/>
    注：
    • URIでのIPアドレスの指定機能は、DEM Collectorバージョン3.7以降でのみご利用いただけます。
    • 地域/州データの取得機能は、DEM Collectorバージョン3.12およびAppManagerバージョン172600以降でのみご利用いただけます。
    属性 説明
    resource 一意のリソース識別子を指定します。
    method IPアドレスをエンドポイントにどのように渡すかを指定します。
    • 'queryparam'- IPアドレスはクエリ文字列として渡されます。例：https://me-apm-ip.com/json?ip=121.0.0.1
    • 'uri'- IP アドレスは URI として渡されます。例：https://me-apm-ip.com/121.0.0.1/json
    url Geolocation APIを指定します。
    • メソッドが「queryparam」の場合は、APIのみを指定してください。例：https://me-apm-ip.com/json。
    • メソッドがuriの場合、IPアドレスを渡す必要がある Geolocation APIに {query} タグを追加してください。例：
      • https://me-apm-ip.com/{query}/json
      • https://test-apm-ip.com/json/{query}
    ipKey IPアドレスを渡す必要があるクエリパラメータ名を指定してください。（queryparam メソッドの場合）。
    countryKey APIのレスポンスに、IPアドレスに関連付けられた国が格納されるキーを指定します。
    countryCodeKey APIのレスポンスに、その国の2文字の国コードが含まれるキーを指定します。
    regionKey APIの応答において、IPアドレスに関連付けられた地域名/州名が格納されるキーを指定してください。
    regionCodeKey APIレスポンスに、その地域の地域コードが含まれるキーを指定します。
    ispKey APIレスポンス内で、IPアドレスに関連付けられたインターネットサービスプロバイダが格納されるキーを指定します。
  3. 次に、<DEMCollector_Home>/conf/ディレクトリにあるAppServer.propertiesファイルを任意のテキストエディタで開き、キーgeo.api.typeの値を、GeolocationAPIResources.xmlファイルに記載されているリソース値に変更してください。
  4. ファイルを保存し、エージェントを再起動してください。

サンプル

GeolocationAPIResources.xmlファイル

<?xml version="1.0" encoding="UTF-8"?>
<GEO-RESOURCES>
<GEO-API-DETAILS resource="1" method="queryparam" url="http://me-apm-ip.com/json" ipKey="ip" responseType="JSON" countryKey="country" countryCodeKey="countryCode" regionKey="regionName" regionCodeKey="regionCode" ispKey="org"/> 
<GEO-API-DETAILS resource="2" method="uri" url="http://ip-g3-location.com/{query}/json" ipKey="ip" responseType="JSON" countryKey="location" countryCodeKey="regionCode" ispKey="isp"/> 

</GEO-RESOURCES\>

AppServer.propertiesファイル

#$Id$
geo.api.type=2
apm.host=localhost
apm.https.port=8441
apm.apikey=RUM4tFgjBtlKMnuWYBpQH6MC6lkoFCZKKW7