Créez un déclencheur pour collecter des métriques personnalisées pour les erreurs HTTP 404

Dans les étapes suivantes, vous allez nommer et décrire le déclencheur, activer le débogage et configurer le déclencheur pour qu'il s'exécute sur HTTP événements de réponse.

1. Cliquez sur l'icône des paramètres système , puis cliquez sur DÉCLENCHEURS.
2. Cliquez Créez.
3. Entrez le nom du déclencheur. Pour cette procédure pas à pas, tapez Erreurs HTTP 404.
4. Entrez une description du déclencheur. Pour cette procédure pas à pas, tapez Suivez les erreurs 404 jusqu'à la source.
5. Cliquez Activer le journal de débogage.
6. Cliquez dans le Évènements champ et sélectionnez HTTP_RESPONSE depuis la liste.

La figure suivante montre les attributs de configuration du déclencheur que vous avez configurés ci-dessus :

Ajoutez ensuite une simple instruction de débogage pour vous familiariser avec la disposition et les fonctionnalités de l'éditeur de déclencheurs.

1. Cliquez sur Rédacteur onglet.
2. Ajoutez le code suivant dans l'éditeur :

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

   Copier

   Conseil :

   L'éditeur fournit certaines fonctionnalités de saisie semi-automatique lors de la saisie de code. Par exemple, si vous tapez un point (.) après avoir sélectionné un objet de classe, vous obtenez une liste de méthodes et de propriétés applicables à l'objet HTTP. Vous pouvez sélectionner l'élément souhaité dans la liste, comme illustré dans la figure suivante : En cliquant sur le je L'icône affiche une description de l' élément actuel, comme illustré dans la figure suivante :

3. Cliquez Enregistrer et fermer.

Avant que le déclencheur puisse enregistrer le résultat de l'instruction de débogage, vous devez attribuer le déclencheur à au moins un équipement. Pour cette procédure pas à pas, vous allez attribuer le déclencheur au HTTP serveur groupe d'équipements.

1. Cliquez Actifs depuis le menu supérieur.
2. Cliquez Groupes d'appareils, puis sélectionnez Serveurs HTTP case à cocher.
3. Cliquez Assigner un déclencheur en haut de la page pour ouvrir une liste des déclencheurs éligibles à l'attribution.
4. Sélectionnez le Erreurs HTTP 404 déclencheur, puis cliquez sur Assigner des déclencheurs.
5. Cliquez sur le Réglages du système icône, retournez à la DÉCLENCHEURS , puis sélectionnez le Erreurs HTTP 404 déclencheur.
6. Dans le Missions champ, vérifiez que les serveurs HTTP sélectionnés sont ajoutés.

Le champ doit ressembler à la figure suivante :

Les résultats de l'instruction de débogage ont confirmé la présence d'URI générant 404 codes d'état . Dans cette section, vous allez créer une métrique personnalisée nommée « 404URIAndReferrer » pour extraire les URI non valides et les référents correspondants.

1. Dans le volet droit, ajoutez le code déclencheur suivant, surligné en vert, au script existant :

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

   Copier
   Ce code déclare l'application en tant que variable et spécifie le nom de l'application. Nous vous recommandons de déclarer une variable pour les méthodes que vous avez l'intention d' appeler plusieurs fois afin de réduire la consommation de ressources par le déclencheur. Dans cette procédure pas à pas, le code appellera l'application deux fois.
2. Ajoutez le code déclencheur suivant, surligné en vert, au script existant :

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

   Copier
   Le metricAddDetailCount méthode spécifie le nom de la métrique et les données de propriété de l'événement renvoyées par la métrique. La méthode spécifie également le format des données extraites sous la forme 404 : <uri>| RÉFÉRENT : <uri> lorsqu'il est affiché dans un graphique. Voir le Demande section du Référence de l'API ExtraHop Trigger pour plus d'informations sur les méthodes métriques personnalisées.
3. Cliquez Enregistrer.

Pour afficher votre métrique personnalisée, vous devez l'ajouter à un widget graphique sur un tableau de bord. Dans le graphique, la métrique personnalisée indiquera quels URI ne sont pas valides et le référent de chaque lien non valide.

1. Sur le Tableau de bord page, cliquez sur le menu de commandes dans le coin supérieur droit, puis sélectionnez Créer un graphique.
2. Cliquez sur le widget graphique vide dans votre tableau de bord nouvellement créé pour lancer explorateur de métriques.
3. Cliquez Ajouter une source.
4. Tapez et sélectionnez Fichier introuvable, qui est l'application créée par le déclencheur.
5. Dans le Métriques champ, type 404 puis sélectionnez 404 Uri et référent, qui est la métrique personnalisée créée par le déclencheur.

   Remarque :

   Le système ExtraHop convertit le nom métrique personnalisé que vous avez spécifié dans le code en un nom d'affichage convivial. Dans cette procédure pas à pas, « 404 Uri et référent » est converti en « 404 URI et référent ». Vous pouvez modifier le nom d'affichage convivial dans le Catalogue métrique. Voir le Catalogue métrique section du Guide de l'utilisateur du système ExtraHop pour plus d' informations.

6. Sélectionnez le Bar type de graphique depuis le bas de l' explorateur métrique.
7. Dans le coin inférieur droit, cliquez sur Ajouter au tableau de bord et sélectionnez Créer un tableau de bord.
8. Tapez le nom de votre tableau de bord dans le Titre champ. Pour cette procédure pas à pas, tapez Erreurs HTTP 404.
9. Cliquez Créez.

Au cours des étapes précédentes, vous avez ajouté du code au script pour créer une application en tant que source de votre nouvelle métrique personnalisée. Dans cette section, vous allez ajouter du code qui permet à l'application de collecter des données intégrées HTTP des métriques, mais pas des métriques personnalisées, pour fournir une vue personnalisée de votre trafic Web chaque fois qu'un code dstatus 404 apparaît sur les appareils spécifiés.

1. Dans le Configuration du déclencheur fenêtre, cliquez sur Rédacteur onglet.
2. Ajoutez le code déclencheur suivant, surligné en vert, au script existant :

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

   Copier
3. Cliquez Enregistrer et fermer.

La nouvelle application « File Not Found » est créée lors de la première exécution du déclencheur et les conditions spécifiées par le script de déclenchement sont remplies. Après avoir validé l'application, plusieurs minutes peuvent s'écouler avant que le déclencheur ne s'exécute et que les données ne soient disponibles dans l'application.

1. Cliquez Actifs depuis le menu supérieur.
2. Dans le volet de gauche, cliquez sur Demandes, puis sélectionnez le Fichier introuvable application.
3. Dans le volet de gauche, cliquez sur HTTP pour afficher les métriques HTTP intégrées collectées dans l'application.

La page Web doit ressembler à la figure suivante :