Collectez une métrique personnalisée pour un équipement personnalisé

Les métriques personnalisées vous permettent de spécifier les données métriques que le système ExtraHop collecte sur votre réseau. Après avoir créé une métrique personnalisée avec un déclencheur, vous attribuez le déclencheur à vos appareils. Ce processus est assez simple pour les appareils découverts par le système ExtraHop, mais les appareils personnalisés nécessitent un traitement supplémentaire.

1. Connectez-vous au système ExtraHop via https://<extrahop-hostname-or-IP-address>.
2. Cliquez sur l'icône des paramètres système puis cliquez sur DÉCLENCHEURS.
3. Cliquez sur le nom du déclencheur qui collecte la métrique personnalisée.
4. Cliquez sur Rédacteur onglet.
5. Modifiez le script du déclencheur pour collecter la métrique personnalisée pour les appareils personnalisés.
   Dans cet exemple, nous allons modifier le code déclencheur suivant, qui collecte une métrique personnalisée pour les erreurs HTTP 404 découvertes par le système ExtraHop sur les serveurs Web :

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

   Copier
   1. Tout d'abord, ajoutez une instruction qui attribue Flow.server.device objet vers une variable :

      let server = Flow.server.device;

      Copier
   2. Ajoutez une boucle for qui accède à chaque équipement personnalisé agissant en tant que serveur dans le flux :

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

      Copier
   3. À l'intérieur de la boucle for, ajoutez une instruction if qui vérifie hasTrigger propriété de chaque équipement personnalisé pour déterminer si le déclencheur est en cours d'exécution sur l'équipement :

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

      Copier
   4. Dans l'instruction if, ajoutez une instruction qui réaffecte la variable du serveur à l'équipement, puis ajoutez une autre instruction pour interrompre la boucle for :

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

      Copier
   5. Enfin, en dehors de la boucle for, ajoutez un appel au metricAddDetailCount méthode pour ajouter la métrique personnalisée à l'équipement :

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

      Copier
   Comme la variable de serveur n'est réaffectée que si le déclencheur est exécuté sur un équipement personnalisé, le code fonctionne à la fois pour les appareils découverts et personnalisés. Le code complet de cet exemple est illustré ci-dessous :

   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);
   }

   Copier
6. Assignez le déclencheur à l'équipement personnalisé.