カスタム地理の詳細

Instana エンドユーザーのIPアドレスを、都市名や国名などの地理的情報に紐付けます。 これは、さまざまな HTTP ヘッダーを検査してエンド・ユーザー IP アドレスを取得することによって行われます。 これらの IP アドレスは、Maxmind の 地理的データベースを使用して地理的詳細に変換されます。

IPアドレス範囲から地理的な詳細情報へのカスタムマッピングルールを設定する方法については、こちらをご覧ください。 これらのカスタムマッピングルールの主な用途は、プライベートネットワークです。 たとえば、プライベートネットワーク経由で(セルフホスト型の) Instana 環境にアクセスする場合などです。 このような場合、公開されている地理データベースには関連情報が一切含まれていないため、翻訳プロセスでは結果が得られないか、あるいは誤った結果や役に立たない結果しか得られないことになる。

Instana を自社でホストして運用している場合は、 エンドユーザー監視の設定が完了していることを確認してください。

データ形式

カスタム地理的詳細のルールは、常に以下のように表現されます。コンマ区切り値 (CSV)。 このセクションでは、ユーザーインターフェースおよび Web REST API の両方で必要とされるデータ形式の技術的な詳細について説明します。

CSV形式

  • カラム区切り文字:,
  • 引用文字: "
  • レコード分離文字: \r\n
  • 最初の行はヘッダー・レコードでなければなりません。
  • 空の行は許可されます
  • 最大 512 個のルール

サポートされる列

  • network ( 必須 ):単一の IPv4/IPv6 アドレス、または CIDR 表記で記述された IPv4/IPv6 アドレスの範囲のいずれか。 例:84.119.41.64/26
  • latitude: 10 進度の地理的座標の緯度部分。 例:51.5900204
  • longitude: 10 進度内の地理座標の経度部分。 例:6.1974817
  • accuracy_radius: 緯度・経度の周囲数キロメートルにおける座標の精度の推定値。 例:8
  • city_name: 市区町村の名前。 例:Kevelaer
  • subdivision_1_name: 最も具体性の低いサブディビジョンの名前。 一般的に、状態に関する情報を表すために使用されます。 国の中に国が含まれる場合、その名称には含まれる国の名前も含まれることがあります。例えば、イングランドはイギリスという国の中に位置する国です。 例:North Rhine-Westphalia
  • subdivision_1_iso_code: サブディビジョン 1 のコード表現。 例:NW
  • subdivision_2_name: サブディビジョン 1 よりも具体的なサブディビジョン。 例:Kreis Kleve
  • subdivision_2_iso_code: サブディビジョン 2 のコード表現。 例:KLE
  • country_name: 国の名前。 例:Germany
  • country_iso_code: 国のコード表現。 例DE
  • continent_name: 大陸の名前。 例:Europe
  • continent_code: 大陸のコード表現。 例:EU

network,latitude,longitude,accuracy_radius,city_name,subdivision_1_name,subdivision_1_iso_code,subdivision_2_name,subdivision_2_iso_code,country_name,country_iso_code,continent_name,continent_code
84.119.41.64/26,51.5900204,6.1974817,8,Kevelaer,North Rhine-Westphalia,NW,Kreis Kleve,KLE,Germany,DE,Europe,EU

Web REST API による設定

構成の取得

curl -H "Authorization: apiToken $API_TOKEN" \
  -H "Accept: text/csv" \
  "https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/geo-mapping-rules"

構成を設定します

curl -X PUT \
  -H "Authorization: apiToken $API_TOKEN" \
  -H "Accept: text/csv, application/json" \
  -H "Content-Type: text/csv" \
  "https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/geo-mapping-rules" \
  -d 'network,latitude,longitude,accuracy_radius,city_name,subdivision_1_name,subdivision_1_iso_code,subdivision_2_name,subdivision_2_iso_code,country_name,country_iso_code,continent_name,continent_code
84.119.41.64/26,51.5900204,6.1974817,8,Kevelaer,North Rhine-Westphalia,NW,Kreis Kleve,KLE,Germany,DE,Europe,EU'

ユーザーインターフェースによる設定

Instana のユーザーインターフェースは、 Web REST API とやり取りするための手段を提供します。 お客様の利便性のために、上記の CSV ファイルのダウンロードとアップロードをサポートしています。 特定のビューは、 カスタム地理的詳細の下の Web サイトの構成タブ内にあります。

図 1. カスタム地理の詳細
カスタム地理的詳細ビューを示すスクリーン・ショット