Travailler avec l'agent d' Docker

Après avoir mis à disposition une instance du service IBM Cloud Monitoring dans le IBM Cloud, vous pouvez déployer l'agent Monitoring en tant que deux conteneurs Docker dans des hôtes pris en charge pour collecter automatiquement des données et des métriques. Vous pouvez configurer quelles métriques surveiller dans chaque environnement.

Vous pouvez associer une ou plusieurs étiquettes à chaque agent de surveillance. Les étiquettes sont des valeurs séparées par une virgule qui se présentent sous la forme TAG_NAME:TAG_VALUE. Lorsque vous surveillez votre environnement, vous pouvez les utiliser pour identifier les métriques mises à disposition par un agent. Par exemple, vous pouvez inclure des informations sur le nom du service et l'emplacement dans toutes les métriques qui sont collectées par cet agent.

Déploiement d'un agent de surveillance sous la forme de deux conteneurs d' Docker

Lorsque vous configurez un agent de surveillance directement sur un hôte Linux en tant que conteneurs d' Docker s standard, vous devrez peut-être installer des en-têtes Linux externes pour lancer correctement l'agent de surveillance.

Par exemple, vous devrez peut-être exécuter la commande suivante pour installer les en-têtes linux externes :

apt-get -y install linux-headers-$(uname -r)

Remarquez que lorsque vous utilisez un MacOS avec un conteneur qui renvoie ...-linuxkit avec la commande uname -r, il est fort probable qu'elle ne soit pas compatible.

Effectuez les étapes suivantes pour configurer un agent de surveillance sur deux conteneurs d' Docker, afin de collecter et de transmettre des métriques à une instance du service d' IBM Cloud Monitoring

  1. Obtenez la clé d'accès. Pour plus d'informations, voir Obtention de la clé d'accès via l'interface utilisateur IBM Cloud.

  2. Obtenez l'URL d'ingestion publique ou privée. Pour plus d'informations, voir Noeuds finaux du collecteur.

  3. Déployez l'agent de surveillance. Exécutez la commande suivante :

    docker run -it --privileged --rm --name sysdig-agent-kmodule \
-v /usr:/host/usr:ro \
-v /boot:/host/boot:ro \
-v /lib/modules:/host/lib/modules \
quay.io/sysdig/agent-kmodule

  4. Exécutez l'agent de surveillance:

    docker run -d --name sysdig-agent \
--restart always \
--privileged \
--net host \
--pid host \
-e ACCESS_KEY=[MONITORING_ACCESS_KEY] \
-e COLLECTOR=[COLLECTOR_ENDPOINT] \
[-e TAGS=[TAG_DATA]]
-v /var/run/docker.sock:/host/var/run/docker.sock \
-v /dev:/host/dev \
-v /proc:/host/proc:ro \
-v /boot:/host/boot:ro \
--shm-size=512m \
quay.io/sysdig/agent-slim

    Où

    • MONITORING_ACCESS_KEY est la clé d'ingestion de l'instance.

    • COLLECTOR_ENDPOINT est l'URL d'ingestion publique ou privée de la région où l'instance de surveillance est disponible. Pour obtenir un noeud final, voir Noeuds finaux de collecteur.

    • TAG_DATA sont des étiquettes séparées par une virgule qui se présentent sous la forme TAG_NAME:TAG_VALUE. Vous pouvez associer une ou plusieurs étiquettes à votre agent de surveillance. Par exemple, role:serviceX,location:us-south.

Le conteneur s'exécute en mode déconnecté. Pour afficher la sortie du conteneur, supprimez -d.

Vérification de la version d'un agent à l'aide de l'interface de ligne de commande

Pour vérifier la version d'un agent, exécutez la commande suivante :

docker exec sysdig-agent /opt/draios/bin/dragent --version

Vérification du statut d'un agent à l'aide de l'interface de ligne de commande

Pour vérifier le statut d'un agent, exécutez la commande suivante :

docker ps | grep sysdig-agent

Vous pouvez exécuter docker ps -a pour afficher tous les conteneurs qui sont en cours d'exécution.

La liste des conteneurs en cours d'exécution s'affiche. Vérifiez que le conteneur sysdig-agent y figure bien.

Recherche des journaux d'agent

Pour voir les journaux des agents, vous pouvez exécuter la commande suivante :

docker logs sysdig-agent

Affichage des journaux d'un agent

Pour rechercher des erreurs, vous pouvez exécuter la commande suivante pour afficher les journaux:

docker logs sysdig-agent 2>&1 | grep "error"

Mise à jour d'un agent d' Docker

Effectuez les étapes suivantes pour supprimer l'agent de surveillance déployé en tant que conteneur dans un système d' Linux s :

  1. Arrêtez le conteneur de l'agent de surveillance. Exécutez la commande suivante :

    docker stop sysdig-agent

  2. Retirez le conteneur de l'agent de surveillance. Exécutez la commande suivante :

    docker rm sysdig-agent

  3. Obtenez la version la plus récente de l'agent de surveillance. Exécutez la commande suivante :

    docker pull sysdig/agent

  4. Installez l'agent. En savoir plus.

Suppression des conteneurs d'agent de surveillance

Pour supprimer un agent de surveillance déployé, procédez comme suit:

  1. Arrêtez le conteneur de l'agent de surveillance.

    Exécutez la commande suivante :

    docker stop sysdig-agent

  2. Supprimez les références au conteneur de l'agent de surveillance.

    docker rm sysdig-agent