Erstellen Sie eine benutzerdefinierte Metrik

Zusätzlich zur Analyse der integrierten Protokollmetriken im ExtraHop-System können Sie Ihre eigenen benutzerdefinierten Metriken erstellen, um spezifische Informationen über Ihre Umgebung zu sammeln. Das Erstellen einer benutzerdefinierten Metrik erfordert zwei Teile: die Angabe von Metrikparametern im Metrikkatalog und die Erstellung eines Auslöser zum Erkennen, Sammeln und Speichern benutzerdefinierter Metrikdaten. In diesem Thema erfahren Sie, wie Sie eine benutzerdefinierte Metrik aus dem Metrikkatalog erstellen.

1. Loggen Sie sich in das ExtraHop-System ein über https://<extrahop-hostname-or-IP-address>.
2. Klicken Sie auf das Symbol Systemeinstellungen und klicken Sie dann Metrischer Katalog.
3. Klicken Sie auf das Befehlsmenü und wähle Metrik manuell erstellen.
4. In der Parameter Führen Sie im Abschnitt die folgenden Schritte aus, um den Code zu erstellen, auf den ein Auslöser verweist:
   1. Geben Sie im Feld Metrik einen eindeutigen Namen für Ihre Metrik ein. Die Triggermethode, die Daten für Ihre benutzerdefinierte Metrik sammelt, muss auf den exakten Metriknamen verweisen, den Sie im Feld Metrik angeben. Vermeiden Sie Leerzeichen zwischen Wörtern, indem Sie Unterstriche eingeben. Wenn Sie einen Namen für eine Detail-Metrik definieren, geben Sie den Detailschlüssel im Namen an, indem Sie den Metriknamen mit anhängen .by_<key_name_without_spaces>, wo <key_name_without_spaces> ist der Name der wichtigsten Metrik.
      Beispielsweise könnte eine benutzerdefinierte Metrik, die die maximale Anzahl von HTTP-Antworten pro Client erfasst, als angegeben werden max_http_responses.by_client.
   2. Wählen Sie im Feld Quelltyp eine Quelle oder Klasse aus dem Dropdownmenü aus, aus der Sie Daten abrufen möchten. Weitere Informationen zu diesen Klassen finden Sie unter Klassen für allgemeine Zwecke in der Trigger-API-Referenz.
   3. Wählen Sie im Feld Metriktyp eine Option aus dem Drop-down-Menü aus, die festlegt, wie Daten im ExtraHop-System gespeichert und angezeigt werden. Die Auswahl des Metriktyps wird in Triggern als Teil des Methodennamens angezeigt, z. B. metricAddCount oder metricAddDataset. Weitere Informationen finden Sie unter ExtraHop-Datentypen in der Trigger-API-Referenz.
   4. Wählen Sie im Feld Typ eine der folgenden Optionen aus:
   • Wählen Basismetrik. Eine Basismetrik oder Top-Level-Metrik umfasst die Metriktypen „Anzahl" und „Datensatz". Die Typauswahl erscheint in Triggern als Teil des Methodennamens, z. B. metricAddDataset.
   • Wählen Detailmetrik. Eine Detail-Metrik besteht aus Schlüssel-Wert-Paaren, wobei der Schlüssel eine Zeichenfolge oder IP-Adresse ist und der Wert ein Metriktyp der obersten Ebene ist, z. B. eine Zähl- oder Datensatzmetrik. Die Typauswahl erscheint in Triggern als Teil des Methodennamens, z. B. metricAddDetailDataset.

   Wichtig:

   Die im Abschnitt Parameter getroffenen Auswahlen können nicht mehr geändert werden, nachdem Sie die benutzerdefinierte Metrik erstellt haben.

5. Gehen Sie im Abschnitt Anzeige wie folgt vor, um Metrikinformationen anzugeben, die von Benutzern im ExtraHop-System durchsucht werden können:
   1. Geben Sie im Feld Name einen benutzerfreundlichen Anzeigenamen für Ihre Metrik ein , der in den Suchergebnissen und Diagrammen im ExtraHop-System angezeigt wird. Sie können Leerzeichen in den Anzeigenamen aufnehmen.
   2. Optional: Wählen Sie im Feld Einheiten eine Option aus dem Dropdownmenü aus, wenn Sie die Maßeinheit kennen, die in einem Diagramm für Ihre Metrik Daten angezeigt werden soll.
   3. Optional: Geben Sie im Feld Beschreibung Informationen ein, die zusammen mit den Suchergebnissen für Ihre Metrik im ExtraHop-System angezeigt werden. Die Beschreibung der benutzerdefinierten Basismetrik wird automatisch für die Detail-Metrik in den Suchergebnissen angezeigt.
   4. Optional: (Nur für Detailmetriken) Geben Sie im Feld Schlüsselbezeichnung einen Anzeigenamen für die Schlüsselgruppe in Ihrer Metrik ein. Sie können zum Beispiel das Schlüssellabel erstellen, Benutzeragent, für eine benutzerdefinierte Metrik, die Anfragen pro HTTP-Benutzeragent sammelt. Schlüsselbezeichnungen müssen nicht eindeutig sein.
6. Optional: Führen Sie im Abschnitt Detailbeziehungen einen der folgenden Schritte aus, wenn Sie eine benutzerdefinierte Basismetrik einer benutzerdefinierten Detail-Metrik zuordnen möchten:
   • (Für Basismetriken) Klicken Sie im Feld „Detail-Metriken" auf das Feld und suchen Sie nach einer benutzerdefinierten Metrik, die Benutzer anzeigen sollen, indem Sie von der benutzerdefinierten Metrik aus einen Drilldown durchführen. Sie können dieses Feld leer lassen, wenn Sie keine Drilldown-Daten für Ihre benutzerdefinierte Metrik bereitstellen möchten.
   • (Für Detailmetriken) Wählen Sie im Feld Basismetrik eine Top-Level-Metrik aus dem Dropdownmenü aus, die Sie Ihrer benutzerdefinierten Detailmetrik zuordnen möchten. Sie können dieses Feld leer lassen, wenn Sie Ihrer benutzerdefinierten Metrik keine zusätzlichen Metriken zuordnen möchten.
7. Optional: Klicken Sie im Abschnitt Datensatzbeziehungen auf das Dropdownmenü DATENSATZTYP, klicken Sie auf einen oder mehrere Datensatztypen, und klicken Sie dann auf eine Stelle außerhalb der Liste. Optional können Sie die Abfrageergebnisse filtern, wenn Sie die Datensätze für die benutzerdefinierte Metrik mit den folgenden Feldern aufschlüsseln.
   1. Optional: Wählen Sie im Abschnitt QUELLFILTER das Kontrollkästchen neben der Quelle für diese benutzerdefinierte Metrik aus. Dieser Filter fragt automatisch nach der Quelle ab, von der aus Sie einen Drilldown durchführen. Wenn Sie beispielsweise ein Kontrollkästchen neben Server auswählen, wenn Sie Datensätze für dieses benutzerdefinierte Metrik von einem Webserver mit dem Namen abfragen example-web-sea, Ihrer Abfrage wird automatisch ein Filter hinzugefügt, der nur Ergebnisse für Transaktionen zurückgibt, bei denen example-web-sea fungiert als Server.
   2. Optional: Im Abschnitt ZUSÄTZLICHE FILTER können Sie erweiterte Filter erstellen die anhand der angegebenen Kriterien nach Datensätzen abfragen, oder geben Sie eine regulärer Ausdruck (Regex) um Datensätze nach benutzerdefinierten Detailmetriken zu filtern.

   Hinweis:

   Weitere Informationen finden Sie unter Datensatzabfragen für benutzerdefinierte Metriken aktivieren.

8. Wenn Sie mit den Parametern zufrieden sind, klicken Sie auf Erstellen. Ihre benutzerdefinierten Metrikparameter werden dem ExtraHop-System hinzugefügt. REST-API-Parameter für Ihre Metrik werden im Metrikkatalog angezeigt. Sie können jetzt nach Ihrer Metrik suchen und Ihre Metrik zu Diagrammen hinzufügen.

   Wichtig:

   Sie müssen einen Auslöser erstellen, um benutzerdefinierte Metrikdaten zu erkennen, zu sammeln und zu speichern.