Vorbereitende Schritte

Um das Geomap-Widget zu konfigurieren, benötigen Sie Standortinformationen in Ihren Daten. Der Standort kann als geografische Koordinaten oder als unterstützte Standortkennung angegeben werden.

Sie können Standortinformationen mit einer der folgenden Optionen weitergeben:

• Option 1: Aufnahme der Felder für Breiten- und Längengrad in jeden Datensatz

  Sie können die Felder für Breiten- und Längengrad direkt zur Konfiguration des Geomap-Widgets verwenden.

  Die Felder müssen gültige numerische Koordinatenwerte enthalten.

• Option 2: Einfügen eines Feldes, das einen IP-Adresswert enthält, und Verwendung der Geo-Enrichment-Funktion

  Sie müssen die Geo-Anreicherung für das entsprechende IP-Feld konfigurieren. Die Geo-Anreicherung leitet numerische Längen- und Breitengrade aus IP-Adressen ab und bietet eine konsistente Quelle für Standortdaten für Geomap. Weitere Informationen finden Sie unter Konfigurieren von Geo-Enrichments.

Um das Widget zu konfigurieren, müssen die Felder für Breiten- und Längengrad einem der unterstützten Formate entsprechen:

Die Daten, die durch ein Geomap-Widget visualisiert werden, sind nach Längen- und Breitengradkoordinaten in Clustern gruppiert. Stellen Sie sich einen Cluster als einen virtuellen Eimer mit Daten vor, die denselben Breiten- und Längengrad haben.

Die Abfrage, die Sie in einem Geomap-Widget konfigurieren, wertet nur die letzten 2.000 Protokolldatensätze im ausgewählten Zeitbereich aus. Wenn einige dieser Protokolldatensätze keine geografischen Felder enthalten, werden sie von der Karte ausgeschlossen, was zu einer leeren oder nur spärlich gefüllten Ansicht führen kann. Um sicherzustellen, dass die ausgewerteten Datensätze geografische Daten enthalten, müssen Sie im Query Builder des Widgets explizit nach Ortsfeldern filtern, die nicht leer sind.

Sie können zum Beispiel eine Dataprime-Abfrage verwenden, die Protokolldatensätze herausfiltert, die keine geografischen Felder enthalten:

source logs
| filter $d.latitude != null
| filter $d.longitude != null
xxxxx

Beachten Sie die folgenden Informationen, wenn Sie mit der Karte interagieren:

• Durch Vergrößern und Verkleinern lässt sich die geografische Aggregationsebene ändern, so dass Sie von übergeordneten regionalen Mustern zu detaillierteren Standorten wechseln können.
• Wenn Sie den Mauszeiger über Punkte oder Cluster bewegen, wird eine QuickInfo mit kontextbezogenen Informationen auf der Grundlage der aktuellen Konfiguration angezeigt.
• Wenn Sie auf einen Cluster klicken, werden kleinere geografische Gruppierungen angezeigt, was die Untersuchung von Gebieten mit gemischten oder aggregierten Werten erleichtert.

Schritt 1: Name und Beschreibung eingeben

Führen Sie die folgenden Schritte aus:

1. Klicken Sie in einer benutzerdefiniertes Dashboard auf Widget hinzufügen und ziehen Sie das Widget Geomap aus Ihrer Seitenleiste.

2. Ersetzen Sie New Geomap durch den Namen des Widgets.

3. Geben Sie eine Beschreibung ein.

   Klicken Sie auf das Aktionssymbol . Wählen Sie dann Beschreibung hinzufügen.

Schritt 2: Konfigurieren Sie die Abfrage, um den Datensatz zu definieren

Führen Sie die folgenden Schritte aus:

1. Klicken Sie auf das Aktionssymbol . Wählen Sie dann den Bearbeitungsmodus.

2. Für Query 1 führen Sie die folgenden Schritte aus:

   Wählen Sie den Datentyp. Gültige Werte sind: Logs, Metrics, und DataPrime.

   Wählen Sie die Quelle. Gültige Optionen sind: Priority Insights und Analyze and Alert.

   Sie können die Abfrage umbenennen. Wählen Sie das und klicken Sie dann auf Abfrage umbenennen.

3. Geben Sie die Abfrage ein.

   Wenn der Datentyp DataPrime ist, geben Sie eine Dataprime-Abfrage in das Feld Abfrage ein.

   Wenn der Datentyp Logs ist, geben Sie eine Lucene-Abfrage in das Feld Abfrage ein. Sie können Filter und Aggregationen anwenden.

   Wenn der Datentyp Metrics ist, geben Sie im Feld Abfrage die Metrik oder die gewünschte PromQL an. Sie können Filter und Aggregationen anwenden.

4. [Optional] Fügen Sie einen oder mehrere für das Widget spezifische Filter hinzu, um die Daten einzugrenzen, die in Ihrem Messgerät angezeigt werden.

   Wählen Sie ein Etikett und den entsprechenden Wert aus.

   Filter werden auf der Ebene des Widgets angewendet und funktionieren parallel zu den Dashboard-Filtern. Wenn es einen Konflikt gibt, haben die Dashboard-Filter Vorrang vor den Widget-Filtern.

5. Fügen Sie eine Funktion zum Gruppieren und Aggregieren Ihrer Daten für die Geomap hinzu.

Schritt 3: Konfigurieren Sie das Widget

Führen Sie die folgenden Schritte aus:

1. Klicken Sie auf das Aktionssymbol . Wählen Sie dann den Bearbeitungsmodus.

2. Wählen Sie im Abschnitt Standortverwaltung > Koordinaten die zu verwendenden Felder aus, die die Längen- und Breitengradinformationen enthalten.

   Felder, die Werte für Breiten- und Längengrad enthalten , können nicht vom Typ String sein.

   Sie können pro Widget nur 1 Feld für die Angabe des Breitengrads und 1 Feld für die Angabe des Längengrads konfigurieren.

   Wenn Ihre geografischen Daten über verschiedene Felder in verschiedenen Datensätzen verfügbar sind, verwenden Sie Parsing-Regeln, um die Daten in einem einzigen Datensatz zu konsolidieren.

   Das Geomap-Widget erkennt oder leitet Standortfelder nicht automatisch ab. Sie müssen die für die Ortsauflösung verwendeten Felder explizit auswählen.

3. Wählen Sie unter Standortverwaltung > Berechnung der Clusterwerte aus, wie die Werte für die einzelnen geografischen Cluster berechnet werden sollen. Wenn Sie eine numerische Berechnung auswählen, Sum, Average, Minimum oder Maximum, müssen Sie ein numerisches Feld im Feld Nach auswählen, das zur Berechnung der Daten verwendet wird, die in eine Clustergruppe eingehen.

   Gültige Werte sind: Count, Sum, Average, Minimum oder Maximum.

   Die Werte werden für einen Cluster dynamisch neu berechnet, wenn Sie die Karte vergrößern oder verkleinern.

   Durch das Heranzoomen wird die Granularität erhöht, sodass kleinere Cluster oder einzelne Punkte sichtbar werden.

   Beim Herauszoomen werden nahe gelegene Cluster zu übergeordneten Gruppierungen zusammengefasst.

   Volumenbasierte Berechnungen mit Count oder Sum akkumulieren die Werte, wenn die Cluster verschmelzen.

   Wertbasierte Berechnungen, die Average, Minimum oder Maximum verwenden, werden aus den zugrunde liegenden Daten neu berechnet.

   Für numerische Aggregationsberechnungen unter Verwendung von Sum, Average, Minimum oder Maximum muss ein numerisches Feld in den Abfrageergebnissen vorhanden sein.

   Ergebnisse ohne einen gültigen numerischen Wert werden von der Aggregation ausgeschlossen.

   Wenn ein numerischer Wert als Zeichenkette in Ihren Daten gespeichert ist, müssen Sie ihn möglicherweise in der Abfrage in einen numerischen Typ umwandeln oder ihn bei der Aufnahme parsen, bevor Sie ihn mit numerischen Aggregationen verwenden. Dadurch wird sichergestellt, dass der Wert in die Berechnungen Sum, Average, Minimum oder Maximum einbezogen werden kann.

   Abfrageergebnisse, die nicht auf einen geografischen Ort aufgelöst werden können, werden ausgeschlossen.

   Count zählt die Anzahl der Ereignisse innerhalb jedes geografischen Clusters. Sie können count verwenden, um Hotspots, Verkehrskonzentrationen oder Regionen mit erhöhtem Fehleraufkommen zu identifizieren. Beim Herauszoomen werden die Zählungen aus kleineren Clustern addiert.

   Sum addiert die Werte eines numerischen Feldes für alle Ereignisse in den einzelnen Clustern. Sie können sie für kumulative Metriken wie Gesamtbytes, Gesamtanforderungen oder Gesamtkosten verwenden. Beim Verkleinern werden die Summen in den Clustern addiert.

   Average berechnet den Durchschnittswert eines numerischen Feldes pro Cluster. Sie können sie für Leistungskennzahlen wie Latenz oder Dauer verwenden. Beim Herauszoomen werden die Durchschnittswerte aus den zugrunde liegenden Clustern neu berechnet und nicht summiert.

   Minimum oder Maximum zeigt den niedrigsten bzw. höchsten Wert an, der in den einzelnen Clustern beobachtet wurde. Sie können diese Optionen verwenden, um die besten und schlechtesten Werte, Ausreißer oder Spitzen zu ermitteln. Beim Verkleinern wird das Minimum oder Maximum für alle zusammengeführten Cluster neu berechnet.

4. Im Abschnitt Tooltip-Verwaltung können Sie festlegen, welche Informationen angezeigt werden, wenn Sie den Mauszeiger über einen Punkt oder ein Cluster auf der Karte bewegen. Fügen Sie die Nachricht hinzu und wählen Sie aus, welche Beschriftungen oder Attribute in die QuickInfo aufgenommen werden sollen.

   Fügen Sie die Meldung oder den Wert hinzu, der angezeigt wird, wenn Sie den Mauszeiger über einen Punkt oder Cluster bewegen. Sie können auf dynamische Felder, wie z. B. den aggregierten Wert, mit der Syntax {{ }} verweisen.

   Wenn ein referenziertes Feld zu mehreren unterschiedlichen Werten innerhalb eines Clusters führt, zeigt die QuickInfo eine allgemeine Beschriftung wie "mehrfach" anstelle eines spezifischen Wertes an. Dies deutet darauf hin, dass der Cluster gemischte Werte enthält, und regt dazu an, weitere Details zu ermitteln.

   Wählen Sie aus, welche Bezeichnungen oder Attribute in die QuickInfo aufgenommen werden sollen, z. B. Dienst, Anwendung oder Land.

5. Im Abschnitt Visuelle Verwaltung legen Sie fest, wie die Werte auf der Karte dargestellt werden.

   Gültige Optionen sind Size und Color range.

   Wählen Sie Größe für volumenbasierte Analysen, bei denen Volumen und Konzentration die primären Signale sind.

   Wählen Sie den Farbbereich für eine leistungsorientierte Analyse. Sie können eine Farbpalette auswählen und steuern, wie Werte den Farben zugeordnet werden. Sie können Schwellenwerte definieren, um zu steuern, wie Clusterwerte in Farben übersetzt werden. Die Schwellenwerte werden anhand der ausgewählten Clusterwertberechnung bewertet und dynamisch aktualisiert, wenn sich die Clusterwerte ändern.

Schritt 4: Speichern Sie das Widget

Führen Sie die folgenden Schritte aus:

1. [Optional] Legen Sie die Dashboard-Zeit des Widgets fest, wenn Sie einen anderen Zeitbereich als den im Dashboard ausgewählten verwenden möchten.

2. Klicken Sie auf Speichern, um Ihr Widget zu speichern.

3. [Optional] Fügen Sie eine benutzerdefinierte Aktion hinzu. Weitere Informationen finden Sie unter Verwendung von Aktionen zur Integration mit Diensten von Drittanbietern.

Aktionen auf einer Karte

Verwenden Sie Schnellaktionen, um Daten direkt auf der Karte zu untersuchen.

Wenn Sie einen Punkt oder Cluster auswählen, bietet ein Kontextmenü die folgenden Aktionen:

• Open Explore: Öffnet die Protokolle in der Erkundungsansicht, vorgefiltert anhand des ausgewählten Standorts und Clusterkontexts.

• Filter in: Fügt der Dashboard-Abfrage den ausgewählten Standort und Wertekontext hinzu.

• Filter out: Schließt den ausgewählten Standort und Wertekontext von der Dashboard-Abfrage aus.

• Copy name: Kopiert die Ortsbezeichnung oder das Schlüssel-Wert-Paar, das mit dem ausgewählten Punkt oder Cluster verbunden ist.