El Datadog IoT Agent es una versión del Agent optimizada para monitorizar los dispositivos IoT y las aplicaciones integradas. Los clientes lo usan para monitorizar una amplia gama de dispositivos, desde pantallas digitales a equipos de seguridad que ejecutan algoritmos de detección de imágenes.
Funcionalidades
El IoT Agent incluye los siguientes checks de sistema. La configuración de los dispositivos IoT es idéntica a la de otros tipos de hosts.
El IoT Agent también es compatible con:
El IoT Agent no incluye el intérprete de Python ni otras integraciones que suelen venir en el paquete del Agent estándar. Tampoco admite el rastreo de APM, la monitorización de procesos en tiempo real ni la monitorización del rendimiento de la red.
Configuración
Requisitos
El IoT Agent está disponible en forma de paquetes DEB y RPM para dispositivos Linux que se ejecutan en arquitecturas x64, arm64 (ARMv8) y ARMv7.
Recursos
Los dispositivos IoT, normalmente, están más limitados en cuanto a recursos que los hosts de infraestructuras en la nube. El IoT Agent está pensado para ocupar la mínima superficie posible y consumir un ancho de banda mínimo.
Los requisitos exactos de un recurso varían en función del uso que hace de ellos el IoT Agent. En pruebas internas del IoT Agent (v7.20), Datadog descubrió lo siguiente:
- CPU: 0,5 % (en una máquina virtual con dos VCPU Intel Xeon)
- Memoria: 36 MB
- Ancho de banda de red: 237 bp/s (subida) / 79 bp/s (bajada)
- Disco: 63 MB
Instalación
Automática
Para descargar e instalar automáticamente el IoT Agent correcto para tu sistema operativo y la arquitectura de tu conjunto de chips, usa el siguiente comando:
DD_API_KEY=<YOUR_DD_API_KEY> DD_SITE="" DD_AGENT_FLAVOR=datadog-iot-agent bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"
Manual
Para instalar el IoT Agent en sistemas operativos basados en Debian, ejecuta los siguientes comandos:
Actualiza apt
e instala apt-transport-https
para que se descargue a través de HTTPS, y curl
y gnupg
para obtener las siguientes claves de firma:
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg
Configura el repositorio Debian de Datadog en tu sistema e importa las claves 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 ejecutas Ubuntu 14 o una versión anterior, o Debian 8 o una versión anterior, copia el conjunto de claves en /etc/apt/trusted.gpg.d
:
sudo cp /usr/share/keyrings/datadog-archive-keyring.gpg /etc/apt/trusted.gpg.d
Actualiza apt
e instala el IoT Agent:
sudo apt-get update
sudo apt-get install datadog-iot-agent datadog-signing-keys
Copia la configuración de ejemplo y especifica tu clave de 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"
Define tu sitio Datadog como
. El valor predeterminado es 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
Inicia el IoT Agent:
sudo systemctl restart datadog-agent.service
Para instalar de forma manual el IoT Agent en sistemas operativos basados en RPM, ejecuta los siguientes comandos:
Configura el repositorio Yum de Datadog en tu sistema creando /etc/yum.repos.d/datadog.repo
con estos contenidos:
[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
Nota: Debido a un error en dnf, utiliza repo_gpgcheck=0
en lugar de repo_gpgcheck=1
con RHEL/CentOS 8.1.
El parámetro baseurl
depende del sistema operativo de tu 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/
Actualiza el repositorio Yum local e instala el Agent:
sudo yum makecache
sudo yum install datadog-iot-agent
Copia la configuración de ejemplo y especifica tu clave de 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"
Define tu sitio Datadog como
. El valor predeterminado es 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
Inicia el IoT Agent:
sudo systemctl restart datadog-agent.service
Interfaz de línea de comandos (CLI)
El IoT Agent es compatible con los mismos comandos de CLI que el Agent estándar.
Desinstalar
sudo apt-get remove datadog-iot-agent -y
Este comando borra el Agent, pero no elimina:
- el archivo de configuración
datadog.yaml
; - los archivos que ha creado el usuario en la carpeta de configuración
/etc/datadog-agent
; - los archivos que ha creado el usuario en la carpeta
/opt/datadog-agent
; - el usuario
dd-agent
.
Si también quieres eliminar esos elementos, usa este comando:
sudo apt-get remove --purge datadog-iot-agent -y
Leer más
Additional helpful documentation, links, and articles: