Erfassen Sie eine benutzerdefinierte Metrik für ein benutzerdefiniertes Gerät

Mit benutzerdefinierten Metriken können Sie angeben, welche Metrikdaten das ExtraHop-System aus Ihrem Netzwerk sammelt. Nachdem Sie eine benutzerdefinierte Metrik mit einem Auslöser erstellt haben, weisen Sie den Auslöser Ihren Geräten zu. Dieser Vorgang ist für Geräte, die vom ExtraHop-System erkannt werden, recht einfach, benutzerdefinierte Geräte erfordern jedoch eine zusätzliche Verarbeitung.

1. Loggen Sie sich in das ExtraHop-System ein über https://<extrahop-hostname-or-IP-address>.
2. Klicken Sie auf das Symbol Systemeinstellungen und dann klicken Auslöser.
3. Klicken Sie auf den Namen des Auslöser, der die benutzerdefinierte Metrik erfasst.
4. Klicken Sie auf Herausgeber Registerkarte.
5. Ändern Sie das Trigger-Skript, um die benutzerdefinierte Metrik für benutzerdefinierte Geräte zu erfassen.
   In diesem Beispiel ändern wir den folgenden Triggercode, der eine benutzerdefinierte Metrik für HTTP 404-Fehler auf Webservern erfasst, die vom ExtraHop-System entdeckt wurden:

   if (HTTP.statusCode === 404){    
       Flow.server.device.metricAddDetailCount(
       "404UriAndReferrer",
       "404:" + HTTP.uri + " | REFERRER:" + HTTP.referer,
       1);
   }

   Kopieren
   1. Fügen Sie zunächst eine Anweisung hinzu, die den Flow.server.device Objekt zu einer Variablen:

      let server = Flow.server.device;

      Kopieren
   2. Fügen Sie eine For-Schleife hinzu, die auf jedes benutzerdefinierte Gerät zugreift, das im Fluss als Server fungiert:

      for (i = 0; i < Flow.server.customDevices.length; i++){
      
      }

      Kopieren
   3. Fügen Sie innerhalb der for-Schleife eine if-Anweisung hinzu, die das überprüft hasTrigger Eigenschaft jedes benutzerdefinierten Geräts, um festzustellen, ob der Auslöser auf dem Gerät ausgeführt wird:

      if (Flow.server.customDevices[i]['hasTrigger']){
      
      }

      Kopieren
   4. Fügen Sie innerhalb der if-Anweisung eine Anweisung hinzu, die die Servervariable dem Gerät neu zuweist, und fügen Sie eine weitere Anweisung hinzu, um die for-Schleife zu unterbrechen:

      server = Flow.server.customDevices[i];
      break;

      Kopieren
   5. Fügen Sie abschließend außerhalb der For-Schleife einen Aufruf zum metricAddDetailCount Methode zum Hinzufügen der benutzerdefinierten Metrik zum Gerät:

      server.metricAddDetailCount(
          "404UriAndReferrer",
          "404:" + HTTP.uri + " | REFERRER:" + HTTP.referer,
          1);

      Kopieren
   Da die Servervariable nur dann neu zugewiesen wird, wenn der Auslöser auf einem benutzerdefinierten Gerät ausgeführt wird, funktioniert der Code sowohl für erkannte als auch für benutzerdefinierte Geräte. Der vollständige Code für dieses Beispiel ist unten dargestellt:

   if (HTTP.statusCode === 404){
       let server = Flow.server.device;
       for (i = 0; i < Flow.server.customDevices.length; i++){
           if (Flow.server.customDevices[i]['hasTrigger']){
               server = Flow.server.customDevices[i]; 
               break;
           }
       }
       server.metricAddDetailCount(
           "404UriAndReferrer",
           "404:" + HTTP.uri + " | REFERRER:" + HTTP.referer,
           1);
   }

   Kopieren
6. Weisen Sie den Auslöser dem benutzerdefinierten Gerät zu.