Tous les produits
Search
Centre de documentation

Elasticsearch:Dépannage des échecs d'installation de Beats

Dernière mise à jour :Aug 22, 2026

Si un expéditeur (Beats) ne parvient pas à s'installer ou si son signal de présence est anormal, utilisez cette rubrique pour diagnostiquer et résoudre ces problèmes.

Procédure

  1. Vérifiez que l'instance ECS destinée au service Beats exécute Alibaba Cloud Linux (Alinux), Red Hat Enterprise Linux (RHEL) ou CentOS.

  2. Assurez-vous que l'instance ECS du service Beats se trouve dans le même VPC que votre instance Elasticsearch ou Logstash.

  3. Confirmez que Cloud Assistant et Docker sont installés sur l'instance ECS.

    Connectez-vous à l'instance ECS et exécutez les commandes suivantes pour vérifier les installations.

    • Vérifiez l'état du service Cloud Assistant

      systemctl status aliyun.service

      Si le service fonctionne correctement, un résultat similaire à celui ci-dessous s'affiche.

      [root@VM01 ~]# systemctl status aliyun.service
      ● aliyun.service - aliyun-assist
         Loaded: loaded (/etc/systemd/system/aliyun.service; enabled; vendor preset: disabled)
         Active: active (running) since Sat 2020-08-15 15:38:25 CST; 4 days ago
       Main PID: 20311 (aliyun-service)
         CGroup: /system.slice/aliyun.service
                 └─20311 /usr/sbin/aliyun-service
      
      Aug 15 15:38:25 VM01 systemd[1]: Stopped aliyun-assist.
      Aug 15 15:38:25 VM01 systemd[1]: Started aliyun-assist.

      Si Cloud Assistant n'est pas installé, consultez la page Installation du client Cloud Assistant.

    • Vérifiez l'état de Docker

      systemctl status docker

      Si Docker fonctionne normalement, un résultat similaire à celui ci-dessous s'affiche.

      [root@VM01 ~]# systemctl status docker
      ● docker.service - Docker Application Container Engine
         Loaded: loaded (/usr/lib/systemd/system/docker.service; disabled; vendor preset: disabled)
         Active: active (running) since Wed 2020-08-19 16:45:21 CST; 1min 39s ago
           Docs: http://docs.docker.com
       Main PID: 14625 (dockerd-current)
         CGroup: /system.slice/docker.service
                 ├─14625 /usr/bin/dockerd-current --add-runtime docker-runc=/usr/libexec/docker/docker-runc-current --default-runti...
                 └─14632 /usr/bin/docker-containerd-current -l unix:///var/run/docker/libcontainerd/docker-containerd.sock --metric...
      
      Aug 19 16:45:20 VM01 dockerd-current[14625]: time="2020-08-19T16:45:20.973350772+08:00" level=warning msg="Docker could...yste...
      Aug 19 16:45:21 VM01 dockerd-current[14625]: time="2020-08-19T16:45:21.005411644+08:00" level=info msg="Graph migration...cond...
      Aug 19 16:45:21 VM01 dockerd-current[14625]: time="2020-08-19T16:45:21.006055965+08:00" level=info msg="Loading contain...tar...
      Aug 19 16:45:21 VM01 dockerd-current[14625]: time="2020-08-19T16:45:21.136526271+08:00" level=info msg="Firewalld runni...fals...
      Aug 19 16:45:21 VM01 dockerd-current[14625]: time="2020-08-19T16:45:21.239151591+08:00" level=info msg="Default bridge ...dres...
      Aug 19 16:45:21 VM01 dockerd-current[14625]: time="2020-08-19T16:45:21.280253025+08:00" level=info msg="Loading contain...done...
      Aug 19 16:45:21 VM01 dockerd-current[14625]: time="2020-08-19T16:45:21.442183479+08:00" level=info msg="Daemon has comp...atio...
      Aug 19 16:45:21 VM01 dockerd-current[14625]: time="2020-08-19T16:45:21.442217221+08:00" level=info msg="Docker daemon" ...1.13...
      Aug 19 16:45:21 VM01 systemd[1]: Started Docker Application Container Engine.
      Aug 19 16:45:21 VM01 dockerd-current[14625]: time="2020-08-19T16:45:21.450179119+08:00" level=info msg="API listen on /...soc...
      Hint: Some lines were ellipsized, use -l to show in full.

      Si Docker n'est pas installé, reportez-vous à la section Déploiement et utilisation de Docker (Alibaba Cloud Linux 2).

  4. Examinez la configuration YML de l'expéditeur afin de vous assurer que les paramètres suivants sont définis.

    - type: log
      # Change to true to enable this input configuration.
      enabled: true              
      # Paths that should be crawled and fetched. Glob based paths.
      paths:
        - /var/log/*.log

    Paramètre

    Description

    enabled

    La valeur par défaut est false. Définissez ce paramètre sur true.

    paths

    Chemin d'accès au fichier journal. Vous pouvez utiliser des caractères génériques, tels que *.log.

    Important
    • Le paramètre paths diffère du répertoire de fichiers Filebeat spécifié sur la page de configuration. Le répertoire de fichiers Filebeat correspond à un répertoire mappé par Docker. Les fichiers indiqués dans paths ne peuvent être collectés que si ce répertoire est mappé au répertoire de collecte. Il est recommandé de maintenir la cohérence entre les deux.

    • Si vous avez spécifié une option Output sur la page de configuration, ne la renseignez pas à nouveau dans la configuration YML. Dans le cas contraire, une erreur d'installation surviendra.

    • Soyez prudent lorsque vous modifiez les paramètres commentés par défaut (#) dans la configuration YML de l'expéditeur, notamment ceux liés à X-Pack. Des modifications incorrectes peuvent entraîner l'échec de l'installation.

  5. Connectez-vous à l'instance ECS et vérifiez le répertoire /opt/aliyunbeats/. Assurez-vous qu'un répertoire correspondant à l'instance Beats existe et contient les sous-répertoires conf, data et logs.

    [root@PVM1 ~]# cd /opt/aliyumbeats
    [root@PVM1 aliyumbeats]# ls
    ct-cn-77uqof2s7rgxxx
    [root@PVM1 aliyumbeats]# cd ct-cn-77uqof2s7rgxxx
    [root@PVM1 ct-cn-77uqof2s7rgxxx]# ls
    filebeat
    [root@PVM1 ct-cn-77uqof2s7rgxxx]# cd filebeat
    [root@PVM1 filebeat]# ls
    conf  data  logs

    Consultez également les journaux Beats situés dans le répertoire logs pour identifier le problème.

    [root@VM01 logs]# tail -n 2 filebeat
    2020-08-19T09:25:52.871Z	INFO	[monitoring]	log/log.go:144	Non-zero metrics in the last 30s	{"monitoring":
    "metrics": {"beat":{"cpu":{"system":{"ticks":130,"time":{"ms":1}},"total":{"ticks":390,"time":{"ms":5},"value":390},"user":{"ti
    cks":260,"time":{"ms":4}}},"handles":{"limit":{"hard":1048576,"soft":1048576},"open":6},"info":{"ephemeral_id":"f960431f-2849-
    e-9dc9-f17xxx","uptime":{"ms":15900027}},"memstats":{"gc_next":4285312,"memory_alloc":2157688,"memory_total":367547441},
    libbeat":{"harvester":{"open_files":0,"running":0}},"libbeat":{"config":{"module":{"running":0}},"pipeline":{"clients":1,"even
    t":{"active":0}}},"registrar":{"states":{"current":1}},"system":{"load":{"1":0.17,"15":0.11,"5":0.09,"norm":{"1":0.17,"15":0.11
    ":0.09}}}}}}
    2020-08-19T09:26:22.872Z	INFO	[monitoring]	log/log.go:144	Non-zero metrics in the last 30s	{"monitoring":
    "metrics": {"beat":{"cpu":{"system":{"ticks":130,"time":{"ms":3}},"total":{"ticks":390,"time":{"ms":4},"value":390},"user":{"ti
    cks":260,"time":{"ms":1}}},"handles":{"limit":{"hard":1048576,"soft":1048576},"open":6},"info":{"ephemeral_id":"f960431f-2849-
    e-9dc9-f17xxx","uptime":{"ms":16200027}},"memstats":{"gc_next":4285312,"memory_alloc":2449992,"memory_total":370470483},
    libbeat":{"harvester":{"open_files":0,"running":0}},"libbeat":{"config":{"module":{"running":0}},"pipeline":{"clients":1,"even
    t":{"active":0}}},"registrar":{"states":{"current":1}},"system":{"load":{"1":0.11,"15":0.11,"5":0.08,"norm":{"1":0.11,"15":0.11
    ":0.08}}}}}}
  6. Vérifiez l'état du conteneur Beats et analysez ses journaux pour identifier le problème.

    1. Contrôlez l'état du conteneur Docker.

      docker ps -a | grep filebeat
      [root@VM01 logs]# docker ps -a | grep filebeat
      922d7f8xxx   registry-vpc.cn-hangzhou.aliyuncs.com/elasticsearch/aliyun-elasticsearch-beats:filebeat-6.8.5   "/usr/local/bin/do..."   33 minutes ago   Up 33 minutes   ct-cn-77uqof2s7rg   ___FILEBEAT
    2. Si l'état du conteneur est exited, examinez les journaux de sortie du conteneur.

      docker logs -f <container_id>