Erstellen Sie einen Auslöser, um benutzerdefinierte Metriken für HTTP 404-Fehler zu sammeln

In den folgenden Schritten benennen und beschreiben Sie den Auslöser, aktivieren das Debugging und konfigurieren den Auslöser für die Ausführung auf HTTP Reaktionsereignisse.

1. Klicken Sie auf das Symbol Systemeinstellungen , und klicken Sie dann auf Auslöser.
2. klicken Erstellen.
3. Geben Sie einen Namen für den Auslöser ein. Geben Sie für diese exemplarische Vorgehensweise ein HTTP 404-Fehler.
4. Geben Sie eine Beschreibung des Auslöser ein. Geben Sie für diese exemplarische Vorgehensweise ein 404-Fehler bis zur Quelle zurückverfolgen.
5. klicken Debug-Log aktivieren.
6. Klicken Sie in den Ereignisse Feld und Auswahl HTTP_RESPONSE aus der Liste.

Die folgende Abbildung zeigt die Trigger-Konfigurationsattribute, die Sie oben konfiguriert haben:

Fügen Sie als Nächstes eine einfache Debug-Anweisung hinzu, um sich mit dem Layout und den Funktionen des Trigger-Editors vertraut zu machen.

1. Klicken Sie auf Herausgeber Tabulatur.
2. Fügen Sie dem Editor den folgenden Code hinzu:

   if (HTTP.statusCode === 404) {
       debug (HTTP.uri);
   }

   Kopieren

   Hinweis:

   Der Editor bietet einige Funktionen zur automatischen Vervollständigung bei der Codeeingabe. Wenn Sie beispielsweise nach der Auswahl eines Klassenobjekts einen Punkt (.) eingeben, erhalten Sie eine Liste von Methoden und Eigenschaften, die für das HTTP-Objekt gelten. Sie können das gewünschte Element aus der Liste auswählen, wie in der folgenden Abbildung gezeigt: Klicken Sie auf den ich Das Symbol zeigt eine Beschreibung des aktuellen Elements an, wie in der folgenden Abbildung dargestellt:

3. klicken Speichern und schließen.

Bevor der Auslöser die Ausgabe der Debug-Anweisung protokollieren kann, müssen Sie den Auslöser mindestens einem Gerät zuweisen. Für diese exemplarische Vorgehensweise weisen Sie den Auslöser dem zu HTTP Server Gerätegruppe.

1. klicken Vermögenswerte aus dem oberen Menü.
2. klicken Gerätegruppen, und wählen Sie dann HTTP-Server Checkbox.
3. klicken Trigger zuweisen vom Seitenanfang aus, um eine Liste der Auslöser zu öffnen, die für eine Zuweisung in Frage kommen.
4. Wählen Sie den HTTP 404-Fehler Auslöser und dann klicken Trigger zuweisen.
5. Klicken Sie auf Systemeinstellungen Symbol, zurück zum Auslöser Seite, und wählen Sie die HTTP 404-Fehler Auslöser.
6. In der Zuweisungen Feld, stellen Sie sicher, dass die ausgewählten HTTP-Server hinzugefügt wurden.

Das Feld sollte der folgenden Abbildung ähneln:

Die Ergebnisse der Debug-Anweisung haben bestätigt, dass es URIs gibt, die zu 404-Statuscodes führen. In diesem Abschnitt erstellen Sie eine benutzerdefinierte Metrik mit dem Namen „404UriandReferrer", um die ungültigen URIs und die entsprechenden Referrer zu extrahieren.

1. Fügen Sie im rechten Bereich den folgenden, grün hervorgehobenen Triggercode zum vorhandenen Skript hinzu:

   if (HTTP.statusCode === 404){
       debug (HTTP.uri);
       var app = Application("File Not Found");
   }

   Kopieren
   Dieser Code deklariert die Anwendung als Variable und gibt den Namen der Anwendung an. Es wird empfohlen, eine Variable für Methoden zu deklarieren, die Sie mehrmals aufrufen möchten, um den Ressourcenverbrauch durch den Auslöser zu reduzieren. In dieser exemplarischen Vorgehensweise ruft der Code die Anwendung zweimal auf.
2. Fügen Sie dem vorhandenen Skript den folgenden grün hervorgehobenen Triggercode hinzu:

   if (HTTP.statusCode === 404){
       debug (HTTP.uri);
       var app = Application("File Not Found");
       app.metricAddDetailCount(
           "404UriAndReferrer",
           "404:" + HTTP.uri + " | REFERRER:" + HTTP.referer,
           1);
   } 

   Kopieren
   Die metricAddDetailCount Methode gibt den Metriknamen und die von der Metrik zurückgegebenen Ereigniseigenschaftsdaten an. Die Methode spezifiziert auch das Format der extrahierten Daten als 404: <uri>| REFERRER: <uri> wenn es in einem Diagramm angezeigt wird. Sehen Sie die Bewerbung Abschnitt der ExtraHop Trigger API-Referenz für weitere Informationen über benutzerdefinierte Metrik Methoden.
3. klicken Speichern.

Um Ihre benutzerdefinierte Metrik anzuzeigen, müssen Sie sie einem Diagramm-Widget auf einem hinzufügen Dashboard. In der Tabelle zeigt die benutzerdefinierte Metrik, welche URIs ungültig sind und welchen Referrer die einzelnen ungültigen Links haben.

1. Auf dem Armaturenbrett Seite, klicken Sie auf das Befehlsmenü in der oberen rechten Ecke und wählen Sie Diagramm erstellen.
2. Klicken Sie in Ihrem neu erstellten Dashboard auf das leere Diagramm-Widget, um das zu starten Metric Explorer.
3. klicken Quelle hinzufügen.
4. Geben Sie ein und wählen Sie Datei wurde nicht gefunden, das ist die Anwendung, die durch den Auslöser erstellt wurde.
5. In der Metriken Feld, Typ 404 und wählen Sie dann 404 Uri und Referrer, das ist die benutzerdefinierte Metrik, die durch den Auslöser erstellt wurde.

   Hinweis:

   Das ExtraHop-System konvertiert den Namen der benutzerdefinierten Metrik, den Sie im Code angegeben haben, in einen benutzerfreundlichen Anzeigenamen. In dieser exemplarischen Vorgehensweise wird „404UriandReferrer" in „404 Uri And Referrer" umgewandelt. Sie können den Anzeigenamen für die Anzeige in der Metrischer Katalog. Sehen Sie die Metrischer Katalog Abschnitt der ExtraHop System-Benutzerhandbuch für weitere Informationen.

6. Wählen Sie den Bar Diagrammtyp am unteren Rand des Metric Explorers.
7. Klicken Sie in der unteren rechten Ecke Zum Dashboard hinzufügen und wähle Dashboard erstellen.
8. Geben Sie einen Namen für Ihr Dashboard in der Titel Feld. Geben Sie für diese exemplarische Vorgehensweise ein HTTP 404-Fehler.
9. klicken Erstellen.

In den vorherigen Schritten haben Sie dem Skript Code hinzugefügt, um eine Anwendung als Quelle Ihrer neuen benutzerdefinierten Metrik. In diesem Abschnitt fügen Sie Code hinzu, der es der Anwendung ermöglicht, integrierte Daten zu sammeln HTTP Metriken, aber keine benutzerdefinierten Metriken, um jedes Mal, wenn ein 404-Statuscode auf den angegebenen Geräten auftritt, einen maßgeschneiderten Überblick über Ihren Web-Traffic zu erhalten.

1. In der Trigger konfigurieren Fenster, klicken Sie auf Herausgeber Tabulatur.
2. Fügen Sie dem vorhandenen Skript den folgenden grün hervorgehobenen Triggercode hinzu:

   if (HTTP.statusCode === 404){
       debug (HTTP.uri);
       var app = Application("File Not Found");
       app.metricAddDetailCount(
           "404UriAndReferrer",
           "404:" + HTTP.uri + " | REFERRER:" + HTTP.referer,
           1);
       app.commit();
   }

   Kopieren
3. klicken Speichern und schließen.

Die neue Anwendung „Datei nicht gefunden" wird erstellt, wenn der Auslöser zum ersten Mal ausgeführt wird und die vom Triggerskript angegebenen Bedingungen erfüllt sind. Nachdem Sie die Anwendung festgeschrieben haben, kann es mehrere Minuten dauern, bis der Auslöser ausgeführt wird und Daten in der Anwendung verfügbar sind.

1. klicken Vermögenswerte aus dem oberen Menü.
2. Klicken Sie im linken Bereich auf Anwendungen, und wählen Sie dann den Datei wurde nicht gefunden Anwendung.
3. Klicken Sie im linken Bereich auf HTTP um die in der Anwendung gesammelten integrierten HTTP-Metriken anzuzeigen.

Die Webseite sollte der folgenden Abbildung ähneln: