diff --git a/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/applications-docker-restapi.md b/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/applications-docker-restapi.md index 95c8d3d80022..30a2b6355aba 100644 --- a/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/applications-docker-restapi.md +++ b/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/applications-docker-restapi.md @@ -36,7 +36,7 @@ Le connecteur apporte les modèles de service suivants | Alias | Modèle de service | Description | Découverte | |:----------------|:------------------------------------------|:-------------------------------------------------------------|:----------:| -| Container-Usage | App-Docker-Container-Usage-Restapi-custom | Contrôle permettant de vérifier l'utilisation des containers | X | +| Container-Usage | App-Docker-Container-Usage-Restapi-custom | Contrôle permettant de vérifier l'utilisation des containers | X | > Les services listés ci-dessus ne sont pas créés automatiquement lorsqu'un modèle d'hôte est appliqué. Pour les utiliser, [créez un service manuellement](/docs/monitoring/basic-objects/services) et appliquez le modèle de service souhaité. @@ -108,7 +108,26 @@ ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock * Enregistrer les modifications * Recharger les services du système : ```systemctl daemon-reload``` * Redémarrer Docker : ```system docker restart``` - + +### Bonne pratique : nommer vos conteneurs + +Par défaut, Docker génère un nom aléatoire à chaque recréation de conteneur. +Or, le connecteur identifie chaque conteneur par son nom pour créer les métriques associées. +Si ce nom change, de nouvelles métriques et un nouveau fichier RRD sont créés dans `/var/lib/centreon/metrics`, +entraînant une prolifération de données obsolètes. + +**Attribuez toujours un nom fixe à chaque conteneur supervisé :** + +```bash +# Ligne de commande +docker run -d --name mon-nginx nginx + +# Docker Compose +services: + web: + image: nginx + container_name: mon-nginx +``` ## Installer le connecteur de supervision diff --git a/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/applications-docker-ssh.md b/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/applications-docker-ssh.md index c909592c46f6..e4be1b2c7f6c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/applications-docker-ssh.md +++ b/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/applications-docker-ssh.md @@ -21,8 +21,8 @@ Le connecteur apporte les modèles de service suivants | Alias | Modèle de service | Description | Découverte | |:-----------------|:---------------------------------------|:-------------------------------------------------------------|:----------:| -| Container-Status | App-Docker-Container-Status-SSH-custom | Contrôle permettant de vérifier le statut des conteneurs | X | -| Container-Usage | App-Docker-Container-Usage-SSH-custom | Contrôle permettant de vérifier l'utilisation des conteneurs | X | +| Container-Status | App-Docker-Container-Status-SSH-custom | Contrôle permettant de vérifier le statut des conteneurs | X | +| Container-Usage | App-Docker-Container-Usage-SSH-custom | Contrôle permettant de vérifier l'utilisation des conteneurs | X | > Les services listés ci-dessus sont créés automatiquement lorsque le modèle d'hôte **App-Docker-SSH-custom** est utilisé. @@ -82,6 +82,31 @@ Deux méthodes de connexion SSH sont possibles : * soit en copiant la clé SSH publique de l'utilisateur `centreon-engine` du collecteur Centreon à la ressource à superviser * soit en définissant votre utilisateur et votre mot de passe directement dans les macros d'hôtes. +## 2. Docker SSH + +**Page cible :** `applications-docker-ssh` + +--- + +### Bonne pratique : nommer vos conteneurs + +Par défaut, Docker génère un nom aléatoire à chaque recréation de conteneur. +Le connecteur utilise ce nom (via l'option `--filter-name`) pour identifier les conteneurs et créer les métriques associées. +Si ce nom change, de nouvelles métriques et un nouveau fichier RRD sont créés dans `/var/lib/centreon/metrics`, entraînant une prolifération de données obsolètes. + +**Attribuez toujours un nom fixe à chaque conteneur supervisé :** + +```bash +# Ligne de commande +docker run -d --name mon-nginx nginx + +# Docker Compose +services: + web: + image: nginx + container_name: mon-nginx +``` + ## Installer le connecteur de supervision ### Pack diff --git a/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/cloud-cadvisor-api.md b/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/cloud-cadvisor-api.md index aacf09938f3e..1cd2009011db 100644 --- a/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/cloud-cadvisor-api.md +++ b/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/cloud-cadvisor-api.md @@ -35,9 +35,9 @@ Le connecteur apporte les modèles de service suivants | Alias | Modèle de service | Description | Découverte | |:------------------|:--------------------------------------------|:-----------------------------------------------------------------------|:----------:| -| Container-Disk-IO | Cloud-cAdvisor-Container-Disk-IO-Api-custom | Contrôle permettant de vérifier les I/O disques des containers. | X | -| Container-Traffic | Cloud-cAdvisor-Container-Traffic-Api-custom | Contrôle permettant de vérifier l'utilisation du réseau des containers | X | -| Container-Usage | Cloud-cAdvisor-Container-Usage-Api-custom | Contrôle permettant de vérifier l'utilisation des containers | X | +| Container-Disk-IO | Cloud-cAdvisor-Container-Disk-IO-Api-custom | Contrôle permettant de vérifier les I/O disques des containers. | X | +| Container-Traffic | Cloud-cAdvisor-Container-Traffic-Api-custom | Contrôle permettant de vérifier l'utilisation du réseau des containers | X | +| Container-Usage | Cloud-cAdvisor-Container-Usage-Api-custom | Contrôle permettant de vérifier l'utilisation des containers | X | > Les services listés ci-dessus ne sont pas créés automatiquement lorsqu'un modèle d'hôte est appliqué. Pour les utiliser, [créez un service manuellement](/docs/monitoring/basic-objects/services) et appliquez le modèle de service souhaité. @@ -50,11 +50,11 @@ Le connecteur apporte les modèles de service suivants #### Découverte de service -| Nom de la règle | Description | -|:-------------------------------------|:--------------------------------------------------------------| -| Cloud-cAdvisor-API-Container-Disk-IO | Discover the disk partitions and monitor space occupation | -| Cloud-cAdvisor-API-Container-Traffic | Discover network interfaces and monitor bandwidth utilization | -| Cloud-cAdvisor-API-Container-Usage | Discover containers and monitor their resource usage | +| Nom de la règle | Description | +|:-------------------------------------|:-------------------------------------------------------------------------------| +| Cloud-cAdvisor-API-Container-Disk-IO | Découvre les partitions disque et supervise l'espace occupé | +| Cloud-cAdvisor-API-Container-Traffic | Découvre les interfaces réseau et supervise l'utilisation de la bande passante | +| Cloud-cAdvisor-API-Container-Usage | Découvre les conteneurs et supervise leur utilisation | Rendez-vous sur la [documentation dédiée](/docs/monitoring/discovery/services-discovery) pour en savoir plus sur la découverte automatique de services et sa [planification](/docs/monitoring/discovery/services-discovery/#règles-de-découverte). @@ -116,7 +116,28 @@ documentation officielle permet de [déployer le nécessaire rapidement](https:/ ### Flux réseaux Le Collecteur doit être en mesure de contacter le serveur hébergeant cAdvisor au travers -du port TCP/8080. Attention, selon la configuration le port peut être différent. +du port TCP/8080. Attention, selon la configuration le port peut être différent. + +### Bonne pratique : nommer vos conteneurs + +cAdvisor identifie chaque conteneur par son nom. +Par défaut, Docker génère un nom aléatoire à chaque recréation de conteneur, ce qui amène Centreon à créer +de nouvelles métriques et un nouveau fichier RRD dans `/var/lib/centreon/metrics` à chaque changement, entraînant une prolifération de données obsolètes. + +**Attribuez toujours un nom fixe à chaque conteneur supervisé :** + +```bash +# Ligne de commande +docker run -d --name mon-nginx nginx + +# Docker Compose +services: + web: + image: nginx + container_name: mon-nginx +``` + +> Si vous utilisez Kubernetes, privilégiez des `StatefulSets` pour garantir des noms de pods stables (`mon-service-0`, `mon-service-1`, etc.), compatibles avec les filtres `--container` et `--pod` du connecteur. ## Installer le connecteur de supervision diff --git a/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/cloud-prometheus-cadvisor-api.md b/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/cloud-prometheus-cadvisor-api.md index bfb00110e439..c8c2b5cead12 100644 --- a/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/cloud-prometheus-cadvisor-api.md +++ b/i18n/fr/docusaurus-plugin-content-docs-pp/current/integrations/plugin-packs/procedures/cloud-prometheus-cadvisor-api.md @@ -106,6 +106,34 @@ Voici le tableau des services pour ce connecteur, détaillant les métriques et Il est essentiel d'avoir Docker, un fichier de configuration Prometheus et des volumes Docker appropriés pour utiliser Prometheus avec cAdvisor. +## 3. cAdvisor API + +**Page cible :** `cloud-cadvisor-api` + +--- + +### Bonne pratique : nommer vos conteneurs + +cAdvisor identifie chaque conteneur par son nom. +Par défaut, Docker génère un nom aléatoire à chaque recréation de conteneur, ce qui amène Centreon +à créer de nouvelles métriques et un nouveau fichier RRD dans `/var/lib/centreon/metrics` à chaque changement, +entraînant une prolifération de données obsolètes. + +**Attribuez toujours un nom fixe à chaque conteneur supervisé :** + +```bash +# Ligne de commande +docker run -d --name mon-nginx nginx + +# Docker Compose +services: + web: + image: nginx + container_name: mon-nginx +``` + +> Si vous utilisez Kubernetes, privilégiez des `StatefulSets` pour garantir des noms de pods stables (`mon-service-0`, `mon-service-1`, etc.), compatibles avec les filtres `--container` et `--pod` du connecteur. + ## Installer le connecteur de supervision ### Pack diff --git a/pp/integrations/plugin-packs/procedures/applications-docker-restapi.md b/pp/integrations/plugin-packs/procedures/applications-docker-restapi.md index 28a7c14a0932..7d51ad56ce07 100644 --- a/pp/integrations/plugin-packs/procedures/applications-docker-restapi.md +++ b/pp/integrations/plugin-packs/procedures/applications-docker-restapi.md @@ -35,7 +35,7 @@ The connector brings the following service templates (sorted by the host templat | Service Alias | Service Template | Service Description | Discovery | |:----------------|:------------------------------------------|:----------------------|:---------:| -| Container-Usage | App-Docker-Container-Usage-Restapi-custom | Check container usage | X | +| Container-Usage | App-Docker-Container-Usage-Restapi-custom | Check container usage | X | > The services listed above are not created automatically when a host template is applied. To use them, [create a service manually](/docs/monitoring/basic-objects/services), then apply the service template you want. @@ -107,8 +107,26 @@ ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock * Save the changes * Apply the changes made at the systemd level : ```systemctl daemon-reload``` -* Restart the Docker engine: ```systemctl restart docker``` - +* Restart the Docker engine: ```systemctl restart docker``` + +### Best practice: naming your containers + +By default, Docker generates a random name each time a container is recreated. T +he connector uses that name to identify each container and create the associated metrics. +If the name changes, new metrics and a new RRD file are created in `/var/lib/centreon/metrics`, leading to a proliferation of stale data. + +**Always assign a fixed name to each monitored container:** + +```bash +# Command line +docker run -d --name my-nginx nginx + +# Docker Compose +services: + web: + image: nginx + container_name: my-nginx +``` ## Installing the monitoring connector diff --git a/pp/integrations/plugin-packs/procedures/applications-docker-ssh.md b/pp/integrations/plugin-packs/procedures/applications-docker-ssh.md index 836049d6371f..2d47051a8434 100644 --- a/pp/integrations/plugin-packs/procedures/applications-docker-ssh.md +++ b/pp/integrations/plugin-packs/procedures/applications-docker-ssh.md @@ -18,10 +18,10 @@ The connector brings the following service templates (sorted by the host templat -| Service Alias | Service Template | Service Description | Discovery | -|:-----------------|:---------------------------------------|:-----------------------|:----------:| -| Container-Status | App-Docker-Container-Status-SSH-custom | Check container status | X | -| Container-Usage | App-Docker-Container-Usage-SSH-custom | Check container usage | X | +| Service Alias | Service Template | Service Description | Discovery | +|:-----------------|:---------------------------------------|:-----------------------|:---------:| +| Container-Status | App-Docker-Container-Status-SSH-custom | Check container status | X | +| Container-Usage | App-Docker-Container-Usage-SSH-custom | Check container usage | X | > The services listed above are created automatically when the **App-Docker-SSH-custom** host template is used. @@ -77,6 +77,25 @@ privileges. There are two possible ways to log in through SSH, either by copying the SSH key of the **centreon-engine** user to the target resource, or by setting your unique user and password directly in the host macros. +### Best practice: naming your containers + +By default, Docker generates a random name each time a container is recreated. +The connector uses that name (via the `--filter-name` option) to identify containers and create the associated metrics. +If the name changes, new metrics and a new RRD file are created in `/var/lib/centreon/metrics`, leading to a proliferation of stale data. + +**Always assign a fixed name to each monitored container:** + +```bash +# Command line +docker run -d --name my-nginx nginx + +# Docker Compose +services: + web: + image: nginx + container_name: my-nginx +``` + ## Installing the monitoring connector ### Pack diff --git a/pp/integrations/plugin-packs/procedures/cloud-cadvisor-api.md b/pp/integrations/plugin-packs/procedures/cloud-cadvisor-api.md index 80a9f6a02855..10c12095393b 100644 --- a/pp/integrations/plugin-packs/procedures/cloud-cadvisor-api.md +++ b/pp/integrations/plugin-packs/procedures/cloud-cadvisor-api.md @@ -32,11 +32,11 @@ The connector brings the following service templates (sorted by the host templat -| Service Alias | Service Template | Service Description | Discovery | -|:------------------|:--------------------------------------------|:------------------------------|:----------:| -| Container-Disk-IO | Cloud-cAdvisor-Container-Disk-IO-Api-custom | Check container disk I/O. | X | -| Container-Traffic | Cloud-cAdvisor-Container-Traffic-Api-custom | Check container network usage | X | -| Container-Usage | Cloud-cAdvisor-Container-Usage-Api-custom | Check container usage | X | +| Service Alias | Service Template | Service Description | Discovery | +|:------------------|:--------------------------------------------|:------------------------------|:---------:| +| Container-Disk-IO | Cloud-cAdvisor-Container-Disk-IO-Api-custom | Check container disk I/O. | X | +| Container-Traffic | Cloud-cAdvisor-Container-Traffic-Api-custom | Check container network usage | X | +| Container-Usage | Cloud-cAdvisor-Container-Usage-Api-custom | Check container usage | X | > The services listed above are not created automatically when a host template is applied. To use them, [create a service manually](/docs/monitoring/basic-objects/services), then apply the service template you want. @@ -112,6 +112,26 @@ Here is the list of services for this connector, detailing all metrics linked to A running cAdvisor container should be available. You can refer to the official [quick start](https://github.com/google/cadvisor#quick-start-running-cadvisor-in-a-docker-container). +### Best practice: naming your containers + +cAdvisor identifies each container by its name. By default, Docker generates a random name each time a container is recreated, +causing Centreon to create new metrics and a new RRD file in `/var/lib/centreon/metrics` on every change, leading to a proliferation of stale data. + +**Always assign a fixed name to each monitored container:** + +```bash +# Command line +docker run -d --name my-nginx nginx + +# Docker Compose +services: + web: + image: nginx + container_name: my-nginx +``` + +> If you are using Kubernetes, prefer `StatefulSets` to ensure stable pod names (`my-service-0`, `my-service-1`, etc.), which are compatible with the `--container` and `--pod` filter options of the connector. + ### Network flow The Poller should be able to reach the cAdvisor Host over the TCP/8080 port. Note that the port diff --git a/pp/integrations/plugin-packs/procedures/cloud-prometheus-cadvisor-api.md b/pp/integrations/plugin-packs/procedures/cloud-prometheus-cadvisor-api.md index 112570c186a9..975d0e52ad53 100644 --- a/pp/integrations/plugin-packs/procedures/cloud-prometheus-cadvisor-api.md +++ b/pp/integrations/plugin-packs/procedures/cloud-prometheus-cadvisor-api.md @@ -24,13 +24,13 @@ The connector brings the following service templates (sorted by the host templat -| Service Alias | Service Template | Service Description | -|:---------------------|:------------------------------------------------|:------------------------------| -| Container-Cpu | Cloud-Prometheus-cAdvisor-Cpu-Api-custom | Check container CPU usage | -| Container-Load | Cloud-Prometheus-cAdvisor-Load-Api-custom | Check container load | -| Container-Memory | Cloud-Prometheus-cAdvisor-Memory-Api-custom | Check container memory usage | -| Container-Storage | Cloud-Prometheus-cAdvisor-Storage-Api-custom | Check container storage usage | -| Container-Task-State | Cloud-Prometheus-cAdvisor-Task-State-Api-custom | Check the state of container tasks | +| Service Alias | Service Template | Service Description | +|:---------------------|:------------------------------------------------|:-----------------------------------| +| Container-Cpu | Cloud-Prometheus-cAdvisor-Cpu-Api-custom | Check container CPU usage | +| Container-Load | Cloud-Prometheus-cAdvisor-Load-Api-custom | Check container load | +| Container-Memory | Cloud-Prometheus-cAdvisor-Memory-Api-custom | Check container memory usage | +| Container-Storage | Cloud-Prometheus-cAdvisor-Storage-Api-custom | Check container storage usage | +| Container-Task-State | Cloud-Prometheus-cAdvisor-Task-State-Api-custom | Check the state of container tasks | > The services listed above are created automatically when the **Cloud-Prometheus-cAdvisor-Api-custom** host template is used. @@ -105,6 +105,26 @@ Here is the list of services for this connector, detailing all metrics and statu It is essential to have Docker, a Prometheus configuration file, and appropriate Docker volumes to use Prometheus with cAdvisor. +### Best practice: naming your containers + +cAdvisor identifies each container by its name. By default, Docker generates a random name each time a container is recreated, +causing Centreon to create new metrics and a new RRD file in `/var/lib/centreon/metrics` on every change, leading to a proliferation of stale data. + +**Always assign a fixed name to each monitored container:** + +```bash +# Command line +docker run -d --name my-nginx nginx + +# Docker Compose +services: + web: + image: nginx + container_name: my-nginx +``` + +> If you are using Kubernetes, prefer `StatefulSets` to ensure stable pod names (`my-service-0`, `my-service-1`, etc.), which are compatible with the `--container` and `--pod` filter options of the connector. + ## Installing the monitoring connector ### Pack