Agent IoT

Présentation

L’Agent IoT Datadog est une version de l’Agent optimisée pour surveiller les périphériques IoT et les applications intégrées. Les clients se servent de l’Agent IoT pour surveiller un grand nombre de périphériques, tels que des écrans numériques ou des appareils de sécurité exécutant des algorithmes de détection d’images.

Fonctionnalités

L’Agent IoT comprend les checks système suivants. La configuration pour les périphériques IoT est identique à celle pour les autres types de hosts.

Système (comprend le processeur, les E/S, la charge, la mémoire, le swap et l’uptime)
Disque
Réseau
Systemd
NTP

L’Agent IoT prend également en charge les fonctionnalités suivantes :

La collecte de métriques custom via un serveur DogStatsD intégré
La collecte de logs via le suivi de fichiers, TCP/UDP et journald

L’Agent IoT n’inclut pas l’interpréteur Python ni d’autres intégrations packagées avec la version standard de l’Agent. Il ne prend pas non plus en charge le tracing d’APM, la surveillance des live processes ou la surveillance des performances réseau.

Configuration

Prérequis

L’Agent IoT est disponible sous la forme de packages DEB et RPM pour les périphériques Linux basés sur une architecture x64, arm64 (ARMv8) ou ARMv7.

Ressources

Les ressources des périphériques IoT sont généralement plus limitées que celles des hosts appartenant à une infrastructure cloud. L’Agent IoT a été pensé pour ne pas être gourmand en ressources et en bande passante réseau.

Les besoins exacts en ressources dépendent de l’utilisation faite de l’Agent IoT. Datadog l’a testé en interne (v7.20) et a obtenu les résultats suivants :

CPU : 0,5 % (sur une machine virtuelle avec deux VCPU Intel Xeon)
Mémoire : 36 Mo
Bande passante réseau : 237 bps (montant)/79 bps (descendant)
Disque : 63 Mo

Installation

Configuration automatique

Pour télécharger et installer automatiquement l’Agent IoT adapté à votre système d’exploitation et à l’architecture de votre chipset, utilisez la commande suivante :

DD_API_KEY=<VOTRE_CLÉ_API_DATADOG> DD_SITE="" DD_AGENT_FLAVOR=datadog-iot-agent bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

Méthode manuelle

Pour installer manuellement l’Agent IoT sur les systèmes d’exploitation basés sur Debian, exécutez les commandes suivantes :

Modifiez apt, installez apt-transport-https pour les téléchargements via HTTPS et installez curl et gnupg pour obtenir les clés de signature :
```
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
```

Configurez le référentiel Debian de Datadog sur votre système et importez la clé apt de Datadog :

sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable 7' > /etc/apt/sources.list.d/datadog.list"
sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg

curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_06462314.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_C0962C7D.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
curl https://keys.datadoghq.com/DATADOG_APT_KEY_382E94DE.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch

Si vous utilisez Ubuntu 14 ou une version antérieure, ou Debian 8 ou une version antérieure, copiez le keyring vers /etc/apt/trusted.gpg.d :
```
sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
```

Mettez à jour apt et installez l’Agent IoT :

sudo apt-get update
sudo apt-get install datadog-iot-agent datadog-signing-keys

Copiez l’exemple de configuration et spécifiez votre clé d’API :

DD_API_KEY=<YOUR_DD_API_KEY> ; sudo sh -c "sed 's/api_key:.*/api_key:$DD_API_KEY/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"

Définissez votre site Datadog sur . Valeur par défaut : datadoghq.com.

sudo sh -c "sed 's/# site:.*/site: <YOUR_DD_SITE>/' /etc/datadog-agent/datadog.yaml > /etc/datadog-agent/datadog.yaml.new && mv /etc/datadog-agent/datadog.yaml.new /etc/datadog-agent/datadog.yaml

Démarrez l’Agent IoT :

sudo systemctl restart datadog-agent.service

Pour installer manuellement l’Agent IoT sur les systèmes d’exploitation basés sur RPM, exécutez les commandes suivantes :

Configurez le référentiel Yum de Datadog sur votre système en créant un fichier /etc/yum.repos.d/datadog.repo avec le contenu suivant :

[datadog]
name = Datadog, Inc.
baseurl = https://yum.datadoghq.com/stable/7/<HOST_ARCHITECTURE>
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_4F09D16B.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_FD4BF915.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_E09422B3.public

Remarque : en raison d’un bug dans dnf, utilisez repo_gpgcheck=0 au lieu de repo_gpgcheck=1 pour RHEL/CentOS 8.1.

baseurl dépend du système d’exploitation de votre host :

x86_64 : https://yum.datadoghq.com/stable/7/x86_64/
arm64 : https://yum.datadoghq.com/stable/7/aarch64/
ARMv7 : https://yum.datadoghq.com/stable/7/armv7hl/

Mettez à jour votre référentiel yum local et installez l’Agent :
```
sudo yum makecache
sudo yum install datadog-iot-agent
```

Copiez l’exemple de configuration et spécifiez votre clé d’API :

DD_API_KEY=<YOUR_DD_API_KEY> ; sudo sh -c "sed 's/api_key:.*/api_key:$DD_API_KEY/' /etc/datadog-agent/datadog.yaml.example > /etc/datadog-agent/datadog.yaml"

Définissez votre site Datadog sur . Valeur par défaut : datadoghq.com.

sudo sh -c "sed 's/# site:.*/site: <YOUR_DD_SITE>/' /etc/datadog-agent/datadog.yaml > /etc/datadog-agent/datadog.yaml.new && mv /etc/datadog-agent/datadog.yaml.new /etc/datadog-agent/datadog.yaml

Démarrez l’Agent IoT :

sudo systemctl restart datadog-agent.service

Interface de ligne de commande

L’Agent IoT prend en charge les mêmes commandes CLI que l’Agent standard.

Désinstaller

sudo apt-get remove datadog-iot-agent -y

Cette commande supprime l’Agent, mais pas :

Le fichier de configuration datadog.yaml
Les fichiers créés par l’utilisateur dans le dossier de configuration /etc/datadog-agent
Les fichiers créés par l’utilisateur dans le dossier /opt/datadog-agent
L’utilisateur dd-agent

Si vous souhaitez également supprimer ces éléments, utilisez plutôt la commande suivante :

sudo apt-get remove --purge datadog-iot-agent -y

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Débuter avec l'AgentDOCUMENTATION