Elasticsearch:Configurer un bot DingTalk pour les alertes X-Pack Watcher

Étape 1 : Créer et configurer un bot DingTalk

1. Créez un groupe DingTalk pour recevoir les alertes.

2. Dans le coin supérieur droit du groupe, cliquez sur l'icône . Dans le panneau Group Settings, cliquez sur Bot.

3. Dans la boîte de dialogue Robot Management , cliquez sur Add Robot, sélectionnez Custom, puis cliquez sur Add.

4. Saisissez un Robot Name, sélectionnez Custom Keywords, puis saisissez vos mots-clés.

   Important

   Les mots-clés doivent être inclus dans le message d'alerte que vous configurez.

5. Cochez la case I have read and agree to the "Custom Robot Service and Disclaimer Terms", puis cliquez sur Complete.

6. À côté de Webhook, cliquez sur Copy pour copier l'URL webhook du bot.

   Conservez l'URL webhook en toute sécurité. La partager sur des sites web externes crée un risque de sécurité.

Étape 2 : Configurer le proxy NGINX et le groupe de sécurité ECS

1. Configurez le proxy NGINX sur votre instance ECS.

   X-Pack Watcher envoie les alertes à un proxy NGINX sur votre instance ECS, qui les transfère ensuite vers DingTalk ou WeCom.

   1. Installez NGINX sur l'instance ECS.

   2. Configurez le fichier nginx.conf.

      Remplacez la section server du fichier nginx.conf par la configuration suivante.

      server
        {
          listen 8080;# Listener port
          server_name localhost;# Domain name
          index index.html index.htm index.php;
          root /usr/local/webserver/nginx/html;# Site directory
            location ~ .*\.(php|php5)?$
          {
            #fastcgi_pass unix:/tmp/php-cgi.sock;
            fastcgi_pass 127.0.0.1:9000;
            fastcgi_index index.php;
            include fastcgi.conf;
          }
          location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|ico)$
          {
            expires 30d;
            # access_log off;
          }
          location / {
            proxy_pass <Webhook URL>;
          }
          location ~ .*\.(js|css)?$
          {
            expires 15d;
            # access_log off;
          }
          access_log off;
        }

      Remplacez <Webhook URL> par l'URL webhook du bot DingTalk que vous avez copiée à l'étape 1.

   3. Rechargez le fichier de configuration et redémarrez NGINX.

      /usr/local/webserver/nginx/sbin/nginx -s reload            # Reload the configuration file
      /usr/local/webserver/nginx/sbin/nginx -s reopen            # Restart NGINX

2. Configurez le groupe de sécurité ECS.

   Autorisez le trafic entrant depuis votre instance Alibaba Cloud Elasticsearch vers le proxy NGINX sur l'instance ECS.

   1. Connectez-vous à la console Alibaba Cloud ECS.

   2. Dans le volet de navigation de gauche, choisissez Instances & Images > Cluster.

   3. Sur la page Cluster, cliquez sur le nom de l'instance cible.

   4. Cliquez sur l'onglet Security Group.

   5. Sur l'onglet Security Groups, cliquez sur le nom du groupe de sécurité cible.

   6. Sur l'onglet Inbound, cliquez sur Add Rule.

   7. Configurez les paramètres.

      Paramètre	Description
      Action	Sélectionnez Permitted.
      Priority	Conservez la valeur par défaut.
      Protocol	Sélectionnez Custom TCP.
      Access Source	Saisissez les adresses IP de tous les nœuds de votre instance Alibaba Cloud Elasticsearch. Remarque Pour obtenir les adresses IP des nœuds, consultez la rubrique Afficher les informations de base des nœuds.
      Destination	Saisissez le port sur lequel NGINX est configuré pour écouter. Cette rubrique utilise le port 8080 à titre d'exemple.
      Description	Saisissez une description pour la règle.

   8. Cliquez sur OK.

Étape 3 : Configurer une alerte Watcher

1. Connectez-vous à la console Kibana de votre cluster Elasticsearch.

   Pour obtenir des instructions, consultez la rubrique Se connecter à la console Kibana.

   Remarque

   Les exemples présentés ici utilisent Elasticsearch V6.7.0. Les opérations peuvent varier légèrement selon les versions.

2. Dans le menu de navigation de gauche, choisissez Management > Dev Tools.

3. Dans la Console, exécutez la commande suivante pour créer une règle de surveillance.

   L'exemple suivant crée une règle de surveillance nommée log_error_watch. Elle interroge l'index logs toutes les 10 secondes pour rechercher les journaux contenant error. Si plus de 0 journaux correspondants sont trouvés, une alerte est déclenchée.

   PUT _xpack/watcher/watch/log_error_watch
   {
     "trigger": {
       "schedule": {
         "interval": "10s"
       }
     },
     "input": {
       "search": {
         "request": {
           "indices": ["logs"],
           "body": {
             "query": {
               "match": {
                 "message": "error"
               }
             }
           }
         }
       }
     },
     "condition": {
       "compare": {
         "ctx.payload.hits.total": {
           "gt": 0
         }
       }
     },
     "actions" : {
     "test_issue" : {
       "webhook" : {
         "method" : "POST",
         "url" : "http://<yourAddress>:8080",
         "body" : "{\"msgtype\": \"text\", \"text\": { \"content\": \"An error log has appeared. Please handle it as soon as possible.\"}}"
       }
     }
   }
   }

   Tableau 1. Paramètres clés

   Paramètre	Type de réseau	Configuration
   url	Nouvelle architecture réseau	Définissez ce paramètre sur le nom de domaine du point de terminaison. Pour obtenir le nom de domaine du point de terminaison, consultez la rubrique Configurer une connexion PrivateLink pour une instance Alibaba Cloud Elasticsearch.
   	Ancienne architecture réseau	Définissez ce paramètre sur l'une des adresses suivantes : L'adresse IP du proxy NGINX : les requêtes sont transférées par le proxy NGINX dans le même VPC via Internet public. L'URL webhook du bot DingTalk.
   body	Nouvelle architecture réseau Ancienne architecture réseau	Configurez ce paramètre en fonction des paramètres de sécurité du bot DingTalk. Par exemple, à l'étape 1 : Créer et configurer un bot DingTalk, si vous définissez les Security Settings sur Custom Keywords et ajoutez le mot-clé personnalisé error, le bot DingTalk pousse les messages d'alerte uniquement si le champ content dans le body contient error.

   Remarque

   Si vous voyez l'erreur No handler found for uri [/_xpack/watcher/watch/log_error_watch_2] and method [PUT] lors de l'exécution de la commande, cela signifie que X-Pack Watcher n'est pas activé pour votre instance Alibaba Cloud Elasticsearch. Vous devez l'activer, puis exécuter à nouveau la commande. Pour plus d'informations, consultez la rubrique Configurer les paramètres YML.

Étape 4 : Vérifier l'alerte

Une fois la configuration terminée, votre groupe DingTalk reçoit un message tel que An error log has appeared. Please handle it as soon as possible. chaque fois que la condition d'alerte de l'étape 3 est remplie.

DELETE _xpack/watcher/watch/log_error_watch