Utilisation de base de l'Agent

Les Agents v6 et v7 sont composés d’un processus principal responsable de la collecte des logs et des métriques d’infrastructure, ainsi que de la réception des métriques DogStatsD. Les composants principaux de ce processus sont les suivants :

• Le Collector s’occupe d’exécuter les checks et de recueillir les métriques.
• Le Forwarder envoie des charges utiles à Datadog.

Deux processus facultatifs sont générés par l’Agent s’ils sont activés dans le fichier de configuration datadog.yaml :

• L’Agent APM est un processus qui permet de recueillir des traces (activé par défaut).
• L’Agent de processus permet de recueillir les informations de live processes. Par défaut, il recueille uniquement les conteneurs disponibles. Si ce n’est pas le cas, il est désactivé.

Sur Windows, les services sont énumérés comme suit :

Par défaut, l’Agent ouvre 3 ports sur Linux et 4 sur Windows et OSX :

Pour en savoir plus sur la configuration des ports, consultez la section Trafic réseau.

Collector

Le Collector récupère toutes les métriques standard toutes les 15 secondes. L’Agent v6 intègre un interpréteur Python 2.7 pour exécuter les intégrations et les checks custom.

Forwarder

Le Forwarder de l’Agent envoie les métriques à Datadog via HTTPS. Une mise en mémoire tampon est effectuée afin d’assurer la bonne transmission des métriques en cas de problème de communication. Les métriques sont mises en mémoire tampon jusqu’à ce que la taille du tampon ou le nombre de requêtes en attente d’envoi atteigne un certain seuil. Les métriques les plus anciennes sont alors supprimées de façon à limiter l’empreinte mémoire du Forwarder. Les logs sont envoyés à Datadog via TCP avec chiffrement SSL.

DogStatsD

Dans la version 6, DogStatsD est une implémentation Golang du daemon d’agrégation des métriques StatsD d’Etsy. Il est utilisé pour recueillir et rassembler des métriques arbitraires via le protocole UDP ou un socket Unix, ce qui permet d’instrumenter du code personnalisé sans augmenter la latence de votre application. En savoir plus sur DogStatsD.

L’Agent v5 est composé de quatre éléments majeurs, chacun écrit en Python et exécuté en tant que processus distinct :

• Collector (agent.py) : le Collector exécute les checks sur la machine actuelle pour les intégrations configurées. Il enregistre également des métriques système, portant par exemple sur la mémoire et le processeur.
• DogStatsD (dogstatsd.py) : il s’agit d’un serveur backend compatible avec StatsD auquel vous pouvez envoyer des métriques custom à partir de vos applications.
• Forwarder (ddagent.py) : le Forwarder récupère les données de DogStatsD et du Collector, les met en attente et les envoie à Datadog.
• SupervisorD : toute la solution est contrôlée par un unique processus de supervision. Celui-ci est séparé afin de limiter la charge système de chaque application si vous n’exécutez pas tous les éléments (peu conseillé).

Remarque : pour les utilisateurs de Windows, les quatre processus de l’Agent apparaissent sous forme d’instances de ddagent.exe, avec la description DevOps' best friend.

Supervision, privilèges et ports réseau

Un processus principal SupervisorD s’exécute en tant qu’utilisateur dd-agent, tout comme l’ensemble des sous-processus dupliqués. Cela s’applique également à n’importe quel appel de système (iostat/netstat) initié par l’Agent Datadog. La configuration de l’Agent est définie dans /etc/dd-agent/datadog.conf et /etc/dd-agent/conf.d. Toutes les configurations doivent être lisibles par dd-agent. Les autorisations recommandées sont 0600, car les fichiers de configuration contiennent votre clé d’API et d’autres identifiants nécessaires pour accéder aux métriques.

Les ports3 suivants acceptent les opérations :

Par défaut, tous les processus d’écoute sont liés à 127.0.0.1 et/ou ::1 pour les versions 3.4.1+ de l’Agent. Dans les versions antérieures, ils étaient liés à 0.0.0.0 (toutes les interfaces). Pour en savoir plus sur l’exécution de l’Agent via un proxy, consultez la section Configuration de l’Agent pour un proxy. Pour en savoir plus sur les plages d’IP à autoriser, consultez la section Trafic réseau.

Nous vous conseillons de prévoir 1024 descripteurs de fichiers ouverts. Vous pouvez consulter cette valeur avec la commande ulimit -a. Si vous êtes contraint d’utiliser une valeur plus faible en raison d’une limite stricte (par exemple si l’option Shell Fork Bomb Protection est activée), vous pouvez ajouter la ligne suivante dans supervisord.conf :

[supervisord]
minfds = 100  # Votre limite stricte

Remarques :

• L’installation depuis les sources peut fonctionner sur des systèmes d’exploitation non mentionnés et est prise en charge dans la mesure du possible.
• Les versions de l’Agent Datadog antérieures à 6.46.0 et 7.46.0 prennent en charge Windows Server 2008 R2, avec les dernières mises à jour Windows installées. Toutefois, Windows Server 2008 R2 fait état d’un problème connu relatif à la dérive de l’horloge et à Go.

Remarques :

• L’installation depuis les sources peut fonctionner sur des systèmes d’exploitation non mentionnés et est prise en charge dans la mesure du possible.

• Version de l’Agent testé : 6.15.0
• Processeur : ~ 1,5 % du processeur utilisé en moyenne
• Mémoire : ~ 95 Mo de RAM utilisés
• Bande passante réseau : ~ 14 KB/s ▲

• Version de l’Agent testé : 6.15.0
• Processeur : ~ 1 % du processeur utilisé en moyenne
• Mémoire : ~ 95 Mo de RAM utilisés
• Bande passante réseau : ~ 20 KB/s ▲

• Version de l’Agent testé : 6.15.0
• Processeur : ~ 0,7 % du processeur utilisé en moyenne
• Mémoire : ~ 90 Mo de RAM utilisés (mémoire RSS)
• Bande passante réseau : ~ 200 KB/s ▲