Détails géographiques personnalisés

Modifier en ligne

Instana associe les adresses IP des utilisateurs finaux à des informations géographiques, par exemple les noms de villes et de pays. A cet effet, différents en-têtes HTTP sont examinés afin d'extraire les adresses IP des utilisateurs finaux. Ces adresses IP sont ensuite converties en coordonnées géographiques à l'aide des bases de données géographiques d' Maxmind.

Vous pouvez découvrir comment configurer des règles de mappage personnalisées entre des plages d'adresses IP et des coordonnées géographiques. Ces règles de mappage personnalisées sont principalement utilisées dans le cadre de réseaux privés. Par exemple, lorsque vous accédez à des installations (auto-hébergées) d' Instana via des réseaux privés. Dans ce genre de cas, les bases de données géographiques publiques ne contiennent jamais d'informations pertinentes; par conséquent, le processus de traduction ne donne aucun résultat, ou bien des résultats erronés ou inutiles.

Pour les installations auto-hébergées d' Instana, assurez-vous que les configurations relatives à la surveillance des utilisateurs finaux sont bien effectuées.

Format des données

Modifier en ligne

Les règles relatives aux détails géographiques personnalisés sont toujours exprimées sous forme de valeurs séparées par des virgules ( CSV ). Cette section décrit les détails techniques du format de données requis à la fois par l'interface utilisateur et par l' Web REST API.

format CSV

Modifier en ligne
  • Délimiteur de colonne: ,
  • Guillemet: "
  • Séparateur d'enregistrement: \r\n
  • La première ligne doit être un enregistrement d'en-tête
  • Les lignes vides sont autorisées
  • Jusqu'à 512 règles

Colonnes prises en charge

Modifier en ligne
  • network ( obligatoire ) : soit une adresse IPv4/IPv6 unique, soit une plage d'adresses IPv4/IPv6 exprimée en notation CIDR. Exemple : 84.119.41.64/26
  • latitude: partie latitude des coordonnées géographiques en degrés décimaux. Exemple : 51.5900204
  • longitude: partie de longitude des coordonnées géographiques en degrés décimaux. Exemple : 6.1974817
  • accuracy_radius: Une estimation de la précision des coordonnées, exprimée en kilomètres autour de la latitude et de la longitude. Exemple : 8
  • city_name: nom de la ville. Exemple : Kevelaer
  • subdivision_1_name: nom de la subdivision la moins spécifique. Commun couramment utilisé pour exprimer des informations sur les états. Dans le cas de pays qui en comprennent d'autres, cela peut également inclure le nom des pays concernés; par exemple, l'Angleterre est un pays faisant partie du Royaume-Uni. Exemple : North Rhine-Westphalia
  • subdivision_1_iso_code: représentation du code de la subdivision 1. Exemple : NW
  • subdivision_2_name: subdivision plus spécifique que la subdivision 1. Exemple : Kreis Kleve
  • subdivision_2_iso_code: représentation du code de la subdivision 2. Exemple : KLE
  • country_name: nom du pays. Exemple : Germany
  • country_iso_code: représentation du code du pays. Exemple DE
  • continent_name: nom du continent. Exemple : Europe
  • continent_code: représentation du code du continent. Exemple : EU

Exemple

Modifier en ligne
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

Configuration via l' Web REST API

Modifier en ligne

Obtenir la configuration

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

Définir la configuration

Modifier en ligne
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'

Configuration via l'interface utilisateur

Modifier en ligne

L'interface utilisateur d' Instana permet d'interagir avec l' Web REST API. Pour vous faciliter la tâche, il prend en charge le téléchargement et le chargement des fichiers « CSV » mentionnés ci-dessus. La vue spécifique se trouve dans l'onglet de configuration d'un site Web sous Détails géographiques personnalisés.

Figure 1. Détails géographiques personnalisés
Capture d'écran montrant la vue des détails géographiques personnalisés