自訂地理詳細資料

Instana 將一般使用者 IP 位址對映至地理詳細資料，例如城市和國家/地區名稱。 這可以透過檢查各種 HTTP 標頭以擷取一般使用者 IP 位址來達成。 然後，在Max心態的 地理資料庫的協助下，這些 IP 位址會轉換為地理詳細資料。

此頁面說明如何配置從 IP 位址範圍到地理詳細資料的自訂對映規則。 這些自訂對映規則的主要使用案例是私密網路。 例如，透過私密網路存取（自行管理的）Instana 安裝時。 在這類情況下，公用地理資料庫將永遠不會包含相關資訊，因此轉換程序將不會提供任何結果或僅提供錯誤/無助益的結果。

若為自行管理的 Instana 安裝，請確定 一般使用者監視的配置 已完成。

資料格式

自訂地理詳細資料的規則一律透過 以逗點區隔的值 (CSV) 表示。 本節說明使用者介面及 Web REST API 所需的資料格式技術詳細資料。

CSV 格式

  • 直欄定界字元： ,
  • 引號字元: "
  • 記錄分隔字元: \r\n
  • 第一行必須是標頭記錄
  • 容許空行
  • 最多 512 個規則

支援的直欄

  • network (必要): 單一 IPv4/IPv6 位址或透過 CIDR 表示法表示的 IPv4/IPv6 位址範圍。 範例： 84.119.41.64/26
  • latitude: 地理座標的緯度部分，以 十進位度數表示。 範例： 51.5900204
  • longitude: 地理座標的經度部分，以 十進位度數表示。 範例： 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 檔案。 您可以在網站配置標籤的 自訂地理詳細資料下找到特定視圖。

顯示自訂地理詳細資料視圖的擷取畫面