Personnalisation des agents de surveillance Linux

Par défaut, l'agent de surveillance collecte des données provenant d'une large gamme de plateformes et d'applications. Vous pouvez éditer le fichier de configuration de l'agent pour modifier son comportement par défaut et inclure ou exclure des données. Vous pouvez personnaliser le fichier de configuration de l'agent de surveillance pour inclure des métriques personnalisées telles que JMX, StatsD et Prometheus. Vous pouvez également filtrer les métriques et les conteneurs.

L'agent de surveillance utilise deux fichiers de configuration qui indiquent les données à collecter automatiquement :

fichiers de configuration de l'agent de surveillance
Fichier	Description	Emplacement
`dragent.default.yaml`	Fichier de configuration principal IMPORTANT : Ne pas modifier ce fichier.	`/opt/draios/etc/dragent.default.yaml`
`dragent.yaml`	Fichier de configuration que vous modifiez pour personnaliser l'agent de surveillance.	`/opt/draios/etc/dragent.yaml`

Vous pouvez éditer le fichier dragent.yaml pour personnaliser les données collectées. Les modifications sont immédiatement prises en compte après la sauvegarde du fichier. L'agent détecte la modification et redémarre automatiquement. Le fichier dragent.default.yaml indique la fréquence à laquelle un agent de surveillance vérifie les fichiers, ainsi que le nom de ces derniers.

Par exemple, dragent.default.yaml inclut les informations suivantes :

check_frequency_s: 5
files:
- /opt/draios/etc/dragent.yaml
- /opt/draios/etc/kubernetes/config/dragent.yaml
- /opt/draios/etc/kubernetes/secrets/access-key

Edition du fichier yaml dragent

Le fichier yaml se trouve dans /opt/draios/etc/.

Pour éditer le fichier et appliquer les modifications, procédez comme suit :

Accédez au fichier dragent.yaml directement. Il se trouve dans /opt/draios/etc/dragent.yaml.
Éditez le fichier. Utilisez une syntaxe YAML valide.
Redémarrez l'agent. Exécutez la commande suivante :
```
service dragent restart
```

Blocage de ports

Pour bloquer le trafic réseau et les métriques provenant de ports réseau, vous devez personnaliser la section blacklisted_ports dans le fichier dragent.yaml. Vous devez répertorier les ports à partir desquels vous voulez filtrer les données.

Remarque : Le port 53 (DNS) se trouve toujours sur liste noire.

L'exemple suivant montre comment définir la section blacklisted_ports d'un agent de surveillance pour exclure les données provenant des ports 6666 et 6379 :

blacklisted_ports:
    - 6666
    - 6379

Inclusion et exclusion de métriques

Pour filtrer des métriques personnalisées, vous devez personnaliser la section metrics_filter dans le fichier dragent.yaml. Vous pouvez indiquer les métriques à inclure et celles à filtrer en configurant les paramètres de filtrage include et exclude.

Remarque : L'ordre des règles de filtrage est défini comme suit : la première règle correspondant à une métrique est appliquée.

Par exemple, si la section metrics_filter d'un agent de surveillance se présente comme suit :

metrics_filter:
  - include: metricA.*
  - exclude: metricA.*
  - include: metricB.*
  - include: haproxy.backend.*
  - exclude: haproxy.*
  - exclude: metricC.*

Vous configurez l'agent de surveillance pour qu'il collecte toutes les données des métriques commençant par metricA, metricB et haproxy.backend.
Vous filtrez les métriques commençant par metricC et d'autres métriques commençant par haproxy.
L'entrée exclude: metricA.* est ignorée.

Modification du niveau de journalisation

Pour configurer le niveau de journalisation, vous devez personnaliser la section log dans le fichier dragent.yaml.

L'agent de surveillance génère des entrées de journal dans /opt/draios/logs/draios.log.

Le fichier journal pivote lorsque sa taille atteint 10 Mo.
Les 10 derniers fichiers journaux sont conservés. L'horodatage qui est ajouté au nom de fichier permet de déterminer les fichiers à conserver.
Les niveaux de journalisation valides sont les suivants : none, error, warning, info, debug, trace.
Le niveau de journalisation par défaut est info, où une entrée est créée pour chaque transmission de métriques agrégées aux serveurs de back end, sur la base d'une par seconde, outre les entrées pour les avertissements et les erreurs.
Vous pouvez personnaliser le type de journal et les entrées collectées en configurant le fichier de configuration /opt/draios/etc/dragent.yaml de l'agent de surveillance. Une fois le fichier modifié, vous devez redémarrer l'agent sur le shell avec service dragent restart pour activer les modifications.

Entrées dans la section du journal
Cas d'utilisation	Entrée de section de journal
Traitement des incidents liés au comportement de l'agent	`file_priority: debug`
Réduction de la sortie de la console de conteneur	`console_priority: warning`
Filtrage des événements par gravité	`event_priority: warning`
Vérification de l'inclusion ou de l'exclusion de métriques	`metrics_excess_log: true`