Configuration Log Metricbeat

De EjnTricks
Révision de 20 septembre 2018 à 12:21 par Etienne (discussion | contributions)

(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)

Lors de l'installation de Metricbeat, les fichiers trace ont été configurés pour se trouver dans le répertoire dans le répertoire /var/log/metricbeat. Cet article présente la configuration mise en place.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Study icon.png Etude

Le fichier trace est généré à l'emplacement /var/log/metricbeat/metricbeat.

Cependant, la configuration par défaut inclus une définition autorisant uniquement le propriétaire à lire / écrire le fichier. L'installation étant réalisé sur une machine Ubuntu, il est souhaité d'harmoniser les permissions, à savoir donner un accès total au propriétaire, soit metricbeat et un accès en lecture au groupe adm.


Icon ACL.png Permission

La configuration des permissions s'effectue avec la propriété permissions dans la section logging.files qui prend un masque de permissions identique à l'argument de la commande chmod.

L'objectif est d'avoir les permissions suivantes.

  • Lecture et écriture pour propriétaire;
  • Lecture pour le groupe;
  • Aucune pour les utilisateurs.

La valeur de la propriété est donc O640.

logging.files:
  # Configure the path where the logs are written. The default is the logs directory
  # under the home path (the binary location).
  #path: /var/log/metricbeat

  # The name of the files where the logs are written to.
  #name: metricbeat

  # Configure log file size limit. If limit is reached, log file will be
  # automatically rotated
  #rotateeverybytes: 10485760 # = 10MB

  # Number of rotated log files to keep. Oldest files will be deleted first.
  #keepfiles: 7

  # The permissions mask to apply when rotating log files. The default value is 0600.
  # Must be a valid Unix-style file permissions mask expressed in octal notation.
  permissions: 0640


User-group-icon.png Nom groupe

Le fichier de trace étant créé par le compte de démarrage du service, les permissions sont hérités de celui-ci. Or il n'existe pas d'option pour indiquer le groupe. Donc dans le cadre de cette installation, les permissions sont affectées à metricbeat:metricbeat, or il est souhaité que ce soit metricbeat:adm.

Pour cela, les options de permissions natives à Linux sont utilisées, en fournissant l'argument g+s à la commande chmod sur le répertoire.

#sudo chmod g+s /var/log/metricbeat

Ainsi, les propriétés sont hérités lors de la création d'un nouveau fichier dans le répertoire /var/log/metricbeat.


Vues-icon.png Rotation

Par défaut, la rotation est mise en place à l'aide de la propriété keepfiles. La valeur par défaut de 7, qui correspond aux nombre de rotation dont il y a 8 fichiers, est suffisante et non modifiée.

A noter qu'il est également possible de mettre en place la rotation en fonction de la taille du fichier à l'aide de la propriété rotateeverybytes.


Configuration App Web-Icon.png Log execution

La propriété logging.metrics.enabled, dont la valeur par défaut est true, permet d'activer l'écriture dans le fichier trace pour chaque métrique enregistrée. Cependant, ceci peut être volumineux et n'est pas forcément pertinent. Pour désactiver les enregistrement, il suffit de spécifier la valeur false.

# If enabled, filebeat periodically logs its internal metrics that have changed
# in the last period. For each metric that changed, the delta from the value at
# the beginning of the period is logged. Also, the total values for
# all non-zero internal metrics are logged on shutdown. The default is true.
logging.metrics.enabled: false


Viewer icon.png Voir Aussi

Documentation officielle: https://www.elastic.co/guide/en/beats/metricbeat/current/configuration-logging.html