Nom du rôle

Ce rôle installe les produits Beats sur une machine Ubuntu.

Ce rôle peut installer les produits Beats disponibles sous forme de paquets deb. Cependant, pour configurer les produits Beats (par ex. filebeat.yml, metricbeat.yml), les seuls produits pris en charge jusqu'à présent sont :

• filebeat
• metricbeat

Exigences

Aucune

Variables du rôle

Vous devez spécifier la version des produits Beats que vous souhaitez installer avec la variable beats_version (par défaut : 6.7.2).

beats_version: 6.7.2

Vous devez également spécifier les produits que vous souhaitez installer dans une variable de liste appelée beats_products (par défaut : []) :

beats_products:
  - filebeat
  - metricbeat

Si vous souhaitez bloquer les paquets Beats sur APT afin qu'ils ne soient pas mis à jour (par défaut : vrai), vous pouvez utiliser la variable beats_hold_products :

beats_hold_products: true

Si vous souhaitez également configurer les produits à la volée, vous devrez créer une variable avec le nom du produit suivi de _config: qui doit être un dictionnaire contenant la configuration YAML pour le produit choisi. Par exemple :

filebeat_config:
  filebeat.modules:
    - module: system
      syslog:
        enabled: true
  output.logstash.hosts:
    - logstash.server:5044

metricbeat_config:
  metricbeat.modules:
    - module: system
      metricsets: ["cpu","memory","network"]
      enabled: true
      period: 15s
      processes: ['.*']
  output.logstash.hosts:
    - logstash.server:5044

Les valeurs spécifiques pour la configuration sont bien décrites dans la documentation des Beats.

Dépendances

Il n'y a pas de dépendances.

Exemple de Playbook

Inclure un exemple de la façon d'utiliser votre rôle (par exemple, avec des variables passées en tant que paramètres) est toujours agréable pour les utilisateurs également :

- hosts: servers
  become: true
  roles:
    - role: jobscore.beats
      beats_version: 6.7.2
      beats_products:
        - filebeat
        - metricbeat
      filebeat_config:
        filebeat.modules:
          - module: system
            syslog:
              enabled: true
        output.logstash.hosts:
          - logstash.server:5044
      metricbeat_config:
        metricbeat.modules:
          - module: system
            metricsets: ["cpu","memory","network"]
            enabled: true
            period: 15s
            processes: ['.*']
        output.logstash.hosts:
          - logstash.server:5044

Licence

GPLv3

Informations sur l'auteur

Ce rôle a été créé par Eric Magalhães