Suivez les erreurs du serveur à l'aide de métriques et d'alertes personnalisées

Créons d'abord un déclencheur qui surveille certains URI pour détecter les erreurs de serveur de niveau 500. Lorsque des erreurs se produisent, le déclencheur collecte des données telles que les codes d'erreur et les adresses IP du serveur et du client et les transmet sous forme de mesures personnalisées à une application.

1. Connectez-vous au système ExtraHop via https://<extrahop-hostname-or-IP-address>.
2. Cliquez sur les paramètres système icône, puis cliquez sur DÉCLENCHEURS.
3. Cliquez Créez.
4. Dans le Nom champ, saisissez le nom du déclencheur. Pour cette procédure pas à pas, tapez Erreurs de serveur de niveau 500.
5. Dans le Description champ, saisissez les informations relatives au déclencheur. Pour cette procédure pas à pas, tapez Surveillez les URI spécifiées pour détecter les erreurs de serveur de niveau 500 ; l'application collecte des métriques personnalisées en cas d'erreur .
6. Cliquez Activer le journal de débogage.
7. Cliquez dans le Évènements champ et sélectionnez HTTP_RESPONSE depuis la liste.
   La figure suivante montre les paramètres du déclencheur que nous avons configurés ci-dessus :
   
   
8. Cliquez sur le Rédacteur onglet.
9. Dans l'éditeur Trigger Script, copiez et collez le code suivant :

   // VARIABLES TO EDIT //
   
   // Edit this array with hosts and URIs to monitor
   var CHECK_URI_LIST = [
   'www.example.com',
   'example.com/about/main_page',
   'http://www.example.com/about/main_page',
   ];
   
   // Edit this array with client IP addresses to ignore
   var IGNORE_CLIENT_IP = [
   '180.57.175.147',
   '172.16.156.130'
   ];
   
   // END VARIABLES TO EDIT //
   
   // DO NOT EDIT REMAINDER OF SCRIPT //
   
   // If client IP is in array above, end process
   if (IGNORE_CLIENT_IP.indexOf(Flow.client.ipaddr.toString()) > -1){
   //debug ('Ignoring client IP: ' + Flow.client.ipaddr);
   return}
   
   // If URI is empty, end process
   var uri = HTTP.uri || HTTP.host;
   if (uri === null){//debug ('No URI Found, ending');
   return}
   
   // If URI/hostname does not match array above, end process
   var matches = CHECK_URI_LIST.filter(condition => uri.indexOf(condition) > -1);
   if (matches.length === 0) {
   //debug ('URI or host did not match: ' + uri);
   return}
   
   var app = "HTTP Server Errors",
   code = HTTP.statusCode,
   client = Flow.client.ipaddr.toString(),
   server = Flow.server.ipaddr.toString(),
   detail = 'Code: ' + code + ' || Server: ' + server + ' || Client: ' + client + ' || URI: '
             + uri;
   
   if (code < 500 || code > 600) {return}
   
   var code = HTTP.statusCode.toString();
   
   // If URI matches and is a 5xx error, commit custom metrics
   // to the application, which is created upon the initial event
   Application(app).metricAddCount('HTTP_error', 1);
   Application(app).metricAddDetailCount('HTTP_error_uri', uri, 1);
   Application(app).metricAddDetailCount('HTTP_error_serverIP', server, 1);
   Application(app).metricAddDetailCount('HTTP_error_clientIP', client, 1);
   Application(app).metricAddDetailCount('HTTP_error_allDetail', detail, 1);
   debug ('Detail: ' + detail);

   Copier
10. Dans le CHECK_URI_LIST tableau de variables, remplacez example.com par les hôtes, les URI et les combinaisons hôte-URI que vous souhaitez que le déclencheur surveille.
11. Dans le IGNORE_CLIENT_IP tableau variable, remplacez les adresses IP d'exemple (180.57.175.147 et 172.16.156.130) par les adresses IP que vous souhaitez que le déclencheur ignore.
    Supprimez ou commentez ce tableau s'il n'y a aucune adresse IP à ignorer.
12. Cliquez Enregistrer et fermer.
    L'éditeur de déclencheurs valide la syntaxe de votre script. Les actions non valides, les erreurs de syntaxe ou les éléments obsolètes vous empêcheront d'enregistrer le déclencheur tant que vous n'avez pas corrigé le code ou désactivé la validation de la syntaxe.

Avant que le déclencheur puisse s'exécuter, il doit être attribué à au moins un équipement. Au cours de cette étape, nous allons attribuer le déclencheur à un ou plusieurs serveurs HTTP qui prennent en charge le trafic via les URI que vous avez spécifiés dans le déclencheur.

1. Cliquez Actifsdepuis le menu supérieur.
2. Dans Appareils par activité de protocole, cliquez sur Serveurs HTTP, puis cliquez sur Appareils depuis le volet de gauche.
3. Dans la liste des équipements, cochez la case à côté d'un ou de plusieurs appareils prenant en charge le trafic via les URI.
4. En haut de la page, cliquez sur Assigner un déclencheur pour ouvrir une liste de déclencheurs.
5. Sélectionnez le déclencheur nommé Erreurs de serveur de niveau 500 que nous avons créé dans la section précédente, puis cliquez sur Assigner des déclencheurs.

Configurons ensuite les paramètres d'alerte qui émettront une alerte et enverront une notification par e-mail chaque fois qu'une erreur de niveau 500 se produit sur les URI surveillés par le déclencheur .

1. Cliquez sur les paramètres système icône, puis cliquez sur Alertes.
2. Cliquez Créez puis tapez le nom de l'alerte dans le Nom champ. Pour cette procédure pas à pas, tapez Erreurs de serveur de niveau 500.
3. Entrez une description de l'alerte dans le Descriptif champ. Pour cette procédure pas à pas, tapez Alerte émise lorsqu'une erreur de serveur de niveau 500 se produit sur les URI surveillés.
4. Dans le Type d'alerte section, sélectionnez Alerte de seuil pour émettre une alerte lorsque l'événement métrique suivi se produit.
5. Dans le Métrique surveillée champ, type Erreur_HTTP puis sélectionnez Personnalisé - HTTP_Error à partir des résultats de recherche.
6. Dans le Comportement des alertes section, sélectionnez Alerte une fois lorsque la condition d'alerte est remplie pour générer une alerte pour chaque occurrence de la métrique suivie.
7. Dans le État d'alerte section, spécifiez la condition suivante pour générer une alerte si l'événement métrique suivi se produit plusieurs fois par période de 30 secondes : Alert when value > 1 during a 30s rollup
8. Dans le Notifications section, saisissez une adresse e-mail qui doit recevoir des notifications d'alerte.

   Conseil :

   La liste déroulante des groupes de notifications par e-mail affiche tous groupes de messagerie configurés dans les paramètres d'administration. Vous pouvez sélectionner un ou plusieurs groupes devant recevoir des notifications d'alerte.

9. Cliquez Afficher les options avancées puis cliquez sur Ajouter une métrique.
10. Dans le champ de recherche, tapez HTTP_Error_AllDetail, puis sélectionnez Personnalisé - Http_Error_AllDetail à partir des résultats de recherche.
11. Cliquez Enregistrer.

Comme pour les déclencheurs, le système ne génère pas d'alertes tant que la configuration des alertes n'est pas affectée à au moins une métrique source. Au cours de cette étape, nous allons attribuer la configuration d'alerte à l'application nommée HTTP Server Errors que nous avons créée avec le script déclencheur. Les métriques personnalisées que nous voulons suivre par l'alerte sont enregistrées dans cette application.

1. Cliquez Actifs depuis le menu supérieur.
2. Cliquez Demandes, puis sélectionnez Erreurs du serveur HTTP case à cocher.
3. Cliquez Attribuer une alerte en haut de la page pour ouvrir une liste des configurations d'alerte éligibles à l'attribution.
4. Sélectionnez le Erreurs de serveur de niveau 500 alerte, puis cliquez sur Attribuer des alertes.