Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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é.

Expand Down Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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é.

Expand Down Expand Up @@ -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`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

?


---
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
---


### 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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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é.

Expand All @@ -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).
Expand Down Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

?


---

### 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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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

Expand Down
27 changes: 23 additions & 4 deletions pp/integrations/plugin-packs/procedures/applications-docker-ssh.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,10 +18,10 @@ The connector brings the following service templates (sorted by the host templat
<Tabs groupId="sync">
<TabItem value="App-Docker-SSH-custom" label="App-Docker-SSH-custom">

| 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.

Expand Down Expand Up @@ -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
Expand Down
30 changes: 25 additions & 5 deletions pp/integrations/plugin-packs/procedures/cloud-cadvisor-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,11 +32,11 @@ The connector brings the following service templates (sorted by the host templat
</TabItem>
<TabItem value="Not attached to a host template" label="Not attached to a host template">

| 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.

Expand Down Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,13 @@ The connector brings the following service templates (sorted by the host templat
<Tabs groupId="sync">
<TabItem value="Cloud-Prometheus-cAdvisor-Api-custom" label="Cloud-Prometheus-cAdvisor-Api-custom">

| 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.

Expand Down Expand Up @@ -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
Expand Down
Loading