Benutzerdefinierte geografische Details
Instana ordnet die IP-Adressen der Endnutzer geografischen Angaben zu, beispielsweise Städtenamen und Ländernamen. Dazu werden verschiedene HTTP-Header überprüft, um die IP-Adressen der Endbenutzer abzurufen. Diese IP-Adressen werden dann mithilfe der geografischen Datenbanken von Maxmind in geografische Angaben umgewandelt.
Hier erfahren Sie, wie Sie benutzerdefinierte Zuordnungsregeln von IP-Adressbereichen zu geografischen Angaben konfigurieren können. Der Hauptanwendungsfall für diese benutzerdefinierten Zuordnungsregeln sind private Netzwerke. Beispielsweise, wenn Sie über private Netzwerke auf (selbst gehostete) Installationen von Instana zugreifen. In solchen Fällen enthalten öffentliche geografische Datenbanken niemals relevante Informationen, sodass der Übersetzungsprozess entweder keine Ergebnisse liefert oder nur falsche bzw. unbrauchbare Ergebnisse.
Stellen Sie bei selbst gehosteten Installationen von „ Instana “ sicher, dass die Konfigurationen für die Endbenutzerüberwachung abgeschlossen sind.
Datenformat
Regeln für benutzerdefinierte geografische Angaben werden stets als kommagetrennte Werte ( CSV ) angegeben. In diesem Abschnitt werden die technischen Details des Datenformats beschrieben, wie sie sowohl von der Benutzeroberfläche als auch vom „ Web REST API “ gefordert werden.
CSV-Format
- Spaltenbegrenzungszeichen:
, - Anführungszeichen:
" - Satztrennzeichen:
\r\n - Die erste Zeile muss ein Headersatz sein.
- Leere Zeilen sind zulässig
- Bis zu 512 Regeln
Unterstützte Spalten
network( erforderlich ): Entweder eine einzelne IPv4/IPv6 -Adresse oder ein IPv4/IPv6 -Adressbereich, der in CIDR-Notation angegeben wird. Beispiel:84.119.41.64/26latitude: Breitengrad der geografischen Koordinaten in Dezimalgrad. Beispiel:51.5900204longitude: Längengradteil der geografischen Koordinaten in Dezimalgrad. Beispiel:6.1974817accuracy_radius: Eine Schätzung der Genauigkeit der Koordinaten in Kilometern um den Breiten- und Längengrad herum. Beispiel:8city_name: Name der Stadt. Beispiel:Kevelaersubdivision_1_name: Name des am wenigsten spezifischen Teilbereichs. Wird häufig verwendet, um Informationen zu Status auszudrücken. Bei Ländern, die andere Länder umfassen, kann dies auch die Namen der darin enthaltenen Länder beinhalten; so ist beispielsweise England ein Land innerhalb des Vereinigten Königreichs. Beispiel:North Rhine-Westphaliasubdivision_1_iso_code: Codedarstellung des Teilbereichs 1. Beispiel:NWsubdivision_2_name: Eine spezifischere Unterteilung als Unterteilung 1. Beispiel:Kreis Klevesubdivision_2_iso_code: Codedarstellung von Unterbereich 2 Beispiel:KLEcountry_name: Der Name des Landes. Beispiel:Germanycountry_iso_code: Codedarstellung des Landes. BeispielDEcontinent_name: Name des Kontinents. Beispiel:Europecontinent_code: Codedarstellung des Kontinents. Beispiel:EU
Beispiel
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
Konfiguration über die „ Web REST API “
Konfiguration abrufen
curl -H "Authorization: apiToken $API_TOKEN" \
-H "Accept: text/csv" \
"https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/geo-mapping-rules"
Konfiguration festlegen.
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'
Konfiguration über die Benutzeroberfläche
Die Benutzeroberfläche von „ Instana “ ermöglicht die Interaktion mit dem „ Web REST API “. Für Ihren Komfort unterstützt es das Herunterladen und Hochladen der oben genannten „ CSV “-Dateien. Die jeweilige Sicht befindet sich auf der Konfigurationsregisterkarte einer Website unter Benutzerdefinierte geografische Details.
