From 2579a21aed9fdcf885818aff5c7d4dc279e3c226 Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 11:54:51 +0200 Subject: [PATCH 1/9] Change OTEL log level from the UI --- .../version-25.10/cma/cma-troubleshooting.md | 21 +++++++------------ 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/versioned_docs/version-25.10/cma/cma-troubleshooting.md b/versioned_docs/version-25.10/cma/cma-troubleshooting.md index 0807dc82571d..3b708ff2b864 100644 --- a/versioned_docs/version-25.10/cma/cma-troubleshooting.md +++ b/versioned_docs/version-25.10/cma/cma-troubleshooting.md @@ -157,6 +157,8 @@ The value **true** must be returned. ## Poller checks +You need to run these checks on every poller that receives data from CMA agents. + ### Check that the server is listening and that packets are arriving @@ -198,19 +200,12 @@ tcpdump -i any port 4317 This command must return results, showing that packets are exchanged between agent and poller. -### Enable the OpenTelemetry logs - -1. Edit the monitoring engine's configuration file: +### Change the OpenTelemetry log level - ```bash - /etc/centreon-engine/centengine.cfg - ``` +By default, the log level is **Error**. -2. Add the following line: - - ```bash - log_level_otl=trace - ``` +1. Go to **Configuration > Pollers > Engine Configuration**, then select the poller you want. +2. In the **Log options** tab, in the **Debug Configuration** section, select the log level you want for OpenTelemetry logs. The different log levels are: trace, debug, info, warning, error, critical, disabled. @@ -232,8 +227,8 @@ Check in the **Monitoring > Resource status** page that all resources are up to ## Location of poller and agent logs -* Poller logs: `/var/log/centreon-engine/centengine.log` +* You can find the engine logs for each poller here: `/var/log/centreon-engine/centengine.log`. -* Agent logs: +* On each host monitored by CMA, the agent's logs can be found here: * Linux: by default, `/var/log/centreon-monitoring-agent/centagent.log` (this log location can be configured in **/etc/centreon-monitoring-agent/centagent.json**) * Windows: the location is the one you specified when installing the agent (by default, in the Windows Event Viewer). From f497b50411fa0c6fb4691793b78f94335e4d976b Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 11:59:48 +0200 Subject: [PATCH 2/9] Update cma-troubleshooting.md --- versioned_docs/version-25.10/cma/cma-troubleshooting.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/versioned_docs/version-25.10/cma/cma-troubleshooting.md b/versioned_docs/version-25.10/cma/cma-troubleshooting.md index 3b708ff2b864..5d2d27e75a42 100644 --- a/versioned_docs/version-25.10/cma/cma-troubleshooting.md +++ b/versioned_docs/version-25.10/cma/cma-troubleshooting.md @@ -202,7 +202,7 @@ This command must return results, showing that packets are exchanged between age ### Change the OpenTelemetry log level -By default, the log level is **Error**. +By default, the log level is **Error**. You may want to change this for debugging purposes. 1. Go to **Configuration > Pollers > Engine Configuration**, then select the poller you want. 2. In the **Log options** tab, in the **Debug Configuration** section, select the log level you want for OpenTelemetry logs. @@ -211,6 +211,8 @@ By default, the log level is **Error**. 3. Restart the monitoring engine. +> Remember to lower the log level once you've finished debugging, to avoid cluttering the poller with unnecessary logs. + ### Check that the engine log file does not contain any errors Execute the following command: From a3d5dbff0031ac0a40d40903d0184c5b1e4e755b Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 13:28:40 +0200 Subject: [PATCH 3/9] Update cma-troubleshooting.md --- .../version-26.10/cma/cma-troubleshooting.md | 23 ++++++++----------- 1 file changed, 10 insertions(+), 13 deletions(-) diff --git a/versioned_docs/version-26.10/cma/cma-troubleshooting.md b/versioned_docs/version-26.10/cma/cma-troubleshooting.md index 0807dc82571d..5d2d27e75a42 100644 --- a/versioned_docs/version-26.10/cma/cma-troubleshooting.md +++ b/versioned_docs/version-26.10/cma/cma-troubleshooting.md @@ -157,6 +157,8 @@ The value **true** must be returned. ## Poller checks +You need to run these checks on every poller that receives data from CMA agents. + ### Check that the server is listening and that packets are arriving @@ -198,24 +200,19 @@ tcpdump -i any port 4317 This command must return results, showing that packets are exchanged between agent and poller. -### Enable the OpenTelemetry logs - -1. Edit the monitoring engine's configuration file: - - ```bash - /etc/centreon-engine/centengine.cfg - ``` +### Change the OpenTelemetry log level -2. Add the following line: +By default, the log level is **Error**. You may want to change this for debugging purposes. - ```bash - log_level_otl=trace - ``` +1. Go to **Configuration > Pollers > Engine Configuration**, then select the poller you want. +2. In the **Log options** tab, in the **Debug Configuration** section, select the log level you want for OpenTelemetry logs. The different log levels are: trace, debug, info, warning, error, critical, disabled. 3. Restart the monitoring engine. +> Remember to lower the log level once you've finished debugging, to avoid cluttering the poller with unnecessary logs. + ### Check that the engine log file does not contain any errors Execute the following command: @@ -232,8 +229,8 @@ Check in the **Monitoring > Resource status** page that all resources are up to ## Location of poller and agent logs -* Poller logs: `/var/log/centreon-engine/centengine.log` +* You can find the engine logs for each poller here: `/var/log/centreon-engine/centengine.log`. -* Agent logs: +* On each host monitored by CMA, the agent's logs can be found here: * Linux: by default, `/var/log/centreon-monitoring-agent/centagent.log` (this log location can be configured in **/etc/centreon-monitoring-agent/centagent.json**) * Windows: the location is the one you specified when installing the agent (by default, in the Windows Event Viewer). From 1c4f1bb0038258580602a721665c9df5b359777e Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 13:30:35 +0200 Subject: [PATCH 4/9] Update cma-troubleshooting.md --- .../version-24.10/cma/cma-troubleshooting.md | 23 ++++++++----------- 1 file changed, 10 insertions(+), 13 deletions(-) diff --git a/versioned_docs/version-24.10/cma/cma-troubleshooting.md b/versioned_docs/version-24.10/cma/cma-troubleshooting.md index 0807dc82571d..5d2d27e75a42 100644 --- a/versioned_docs/version-24.10/cma/cma-troubleshooting.md +++ b/versioned_docs/version-24.10/cma/cma-troubleshooting.md @@ -157,6 +157,8 @@ The value **true** must be returned. ## Poller checks +You need to run these checks on every poller that receives data from CMA agents. + ### Check that the server is listening and that packets are arriving @@ -198,24 +200,19 @@ tcpdump -i any port 4317 This command must return results, showing that packets are exchanged between agent and poller. -### Enable the OpenTelemetry logs - -1. Edit the monitoring engine's configuration file: - - ```bash - /etc/centreon-engine/centengine.cfg - ``` +### Change the OpenTelemetry log level -2. Add the following line: +By default, the log level is **Error**. You may want to change this for debugging purposes. - ```bash - log_level_otl=trace - ``` +1. Go to **Configuration > Pollers > Engine Configuration**, then select the poller you want. +2. In the **Log options** tab, in the **Debug Configuration** section, select the log level you want for OpenTelemetry logs. The different log levels are: trace, debug, info, warning, error, critical, disabled. 3. Restart the monitoring engine. +> Remember to lower the log level once you've finished debugging, to avoid cluttering the poller with unnecessary logs. + ### Check that the engine log file does not contain any errors Execute the following command: @@ -232,8 +229,8 @@ Check in the **Monitoring > Resource status** page that all resources are up to ## Location of poller and agent logs -* Poller logs: `/var/log/centreon-engine/centengine.log` +* You can find the engine logs for each poller here: `/var/log/centreon-engine/centengine.log`. -* Agent logs: +* On each host monitored by CMA, the agent's logs can be found here: * Linux: by default, `/var/log/centreon-monitoring-agent/centagent.log` (this log location can be configured in **/etc/centreon-monitoring-agent/centagent.json**) * Windows: the location is the one you specified when installing the agent (by default, in the Windows Event Viewer). From 43d7f731d70adb1c6f217cd7f84079565e7226cb Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 13:37:43 +0200 Subject: [PATCH 5/9] Update cma-troubleshooting.md --- .../version-26.10/cma/cma-troubleshooting.md | 23 ++++++++----------- 1 file changed, 10 insertions(+), 13 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/cma/cma-troubleshooting.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/cma/cma-troubleshooting.md index 308f6ff378f0..423c4d6d898f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/cma/cma-troubleshooting.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/cma/cma-troubleshooting.md @@ -158,6 +158,8 @@ La valeur **true** doit être retournée. ## Vérifications sur le collecteur +Vous devez effectuer ces vérifications sur chaque collecteur qui reçoit des données provenant des agents CMA. + ### Vérifiez que le serveur est en écoute et que des paquets sont échangés @@ -202,24 +204,19 @@ tcpdump -i any port 4317 Elle doit retourner des résultats, indiquant que des paquets circulent entre l'agent et le collecteur. -### Activez les logs OpenTelemetry - -1. Éditez le fichier de configuration du moteur de supervision : - - ```bash - /etc/centreon-engine/centengine.cfg - ``` +### Modifier le niveau de log d'OpenTelemetry -2. Ajoutez la ligne suivante : +Par défaut, le niveau de log est **Error**. Vous pouvez le modifier à des fins de débuggage. - ```bash - log_level_otl=trace - ``` +1. À la page **Configuration > Collecteurs > Configuration du moteur de collecte**, sélectionnez le collecteur souhaité. +2. Dans l'onglet **Options des logs**, dans la section **Configuration de débogage**, sélectionnez le niveau de log souhaité pour les logs OpenTelemetry. Les différents niveaux de log sont : trace, debug, info, warning, error, critical, disabled. 3. Redémarrez le moteur de supervision. +> N'oubliez pas de baisser le niveau de log une fois le débuggage terminé, afin d'éviter d'encombrer le collecteur avec des logs inutiles. + ### Vérifiez que le fichier de log engine ne contient pas d'erreur Exécutez la commande suivante : @@ -236,8 +233,8 @@ Aucune ligne concernant CMA ne doit être retournée. ## Emplacement des logs collecteur et agent -* Logs du collecteur : `/var/log/centreon-engine/centengine.log` +* Vous trouverez les journaux du moteur pour chaque collecteur ici : `/var/log/centreon-engine/centengine.log`. -* Logs de l'agent : +* Sur chaque hôte supervisé par CMA, les journaux de l'agent se trouvent ici : * Linux : par défaut, `/var/log/centreon-monitoring-agent/centagent.log` (cet emplacement de log est configurable dans **/etc/centreon-monitoring-agent/centagent.json**) * Windows : l'emplacement est celui que vous avez défini lors de l'installation de l'agent (par défaut, dans l'observateur d'évènements Windows). From 66c67718bfec48b8c8bd4c1bf72e92685962c134 Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 13:39:21 +0200 Subject: [PATCH 6/9] Update cma-troubleshooting.md --- .../version-25.10/cma/cma-troubleshooting.md | 23 ++++++++----------- 1 file changed, 10 insertions(+), 13 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-25.10/cma/cma-troubleshooting.md b/i18n/fr/docusaurus-plugin-content-docs/version-25.10/cma/cma-troubleshooting.md index 308f6ff378f0..423c4d6d898f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-25.10/cma/cma-troubleshooting.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-25.10/cma/cma-troubleshooting.md @@ -158,6 +158,8 @@ La valeur **true** doit être retournée. ## Vérifications sur le collecteur +Vous devez effectuer ces vérifications sur chaque collecteur qui reçoit des données provenant des agents CMA. + ### Vérifiez que le serveur est en écoute et que des paquets sont échangés @@ -202,24 +204,19 @@ tcpdump -i any port 4317 Elle doit retourner des résultats, indiquant que des paquets circulent entre l'agent et le collecteur. -### Activez les logs OpenTelemetry - -1. Éditez le fichier de configuration du moteur de supervision : - - ```bash - /etc/centreon-engine/centengine.cfg - ``` +### Modifier le niveau de log d'OpenTelemetry -2. Ajoutez la ligne suivante : +Par défaut, le niveau de log est **Error**. Vous pouvez le modifier à des fins de débuggage. - ```bash - log_level_otl=trace - ``` +1. À la page **Configuration > Collecteurs > Configuration du moteur de collecte**, sélectionnez le collecteur souhaité. +2. Dans l'onglet **Options des logs**, dans la section **Configuration de débogage**, sélectionnez le niveau de log souhaité pour les logs OpenTelemetry. Les différents niveaux de log sont : trace, debug, info, warning, error, critical, disabled. 3. Redémarrez le moteur de supervision. +> N'oubliez pas de baisser le niveau de log une fois le débuggage terminé, afin d'éviter d'encombrer le collecteur avec des logs inutiles. + ### Vérifiez que le fichier de log engine ne contient pas d'erreur Exécutez la commande suivante : @@ -236,8 +233,8 @@ Aucune ligne concernant CMA ne doit être retournée. ## Emplacement des logs collecteur et agent -* Logs du collecteur : `/var/log/centreon-engine/centengine.log` +* Vous trouverez les journaux du moteur pour chaque collecteur ici : `/var/log/centreon-engine/centengine.log`. -* Logs de l'agent : +* Sur chaque hôte supervisé par CMA, les journaux de l'agent se trouvent ici : * Linux : par défaut, `/var/log/centreon-monitoring-agent/centagent.log` (cet emplacement de log est configurable dans **/etc/centreon-monitoring-agent/centagent.json**) * Windows : l'emplacement est celui que vous avez défini lors de l'installation de l'agent (par défaut, dans l'observateur d'évènements Windows). From 666c09e8ffe8cc05dd42d70a68b9ddc2421d21e3 Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 13:41:17 +0200 Subject: [PATCH 7/9] Update cma-troubleshooting.md --- .../version-24.10/cma/cma-troubleshooting.md | 23 ++++++++----------- 1 file changed, 10 insertions(+), 13 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-24.10/cma/cma-troubleshooting.md b/i18n/fr/docusaurus-plugin-content-docs/version-24.10/cma/cma-troubleshooting.md index 308f6ff378f0..423c4d6d898f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-24.10/cma/cma-troubleshooting.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-24.10/cma/cma-troubleshooting.md @@ -158,6 +158,8 @@ La valeur **true** doit être retournée. ## Vérifications sur le collecteur +Vous devez effectuer ces vérifications sur chaque collecteur qui reçoit des données provenant des agents CMA. + ### Vérifiez que le serveur est en écoute et que des paquets sont échangés @@ -202,24 +204,19 @@ tcpdump -i any port 4317 Elle doit retourner des résultats, indiquant que des paquets circulent entre l'agent et le collecteur. -### Activez les logs OpenTelemetry - -1. Éditez le fichier de configuration du moteur de supervision : - - ```bash - /etc/centreon-engine/centengine.cfg - ``` +### Modifier le niveau de log d'OpenTelemetry -2. Ajoutez la ligne suivante : +Par défaut, le niveau de log est **Error**. Vous pouvez le modifier à des fins de débuggage. - ```bash - log_level_otl=trace - ``` +1. À la page **Configuration > Collecteurs > Configuration du moteur de collecte**, sélectionnez le collecteur souhaité. +2. Dans l'onglet **Options des logs**, dans la section **Configuration de débogage**, sélectionnez le niveau de log souhaité pour les logs OpenTelemetry. Les différents niveaux de log sont : trace, debug, info, warning, error, critical, disabled. 3. Redémarrez le moteur de supervision. +> N'oubliez pas de baisser le niveau de log une fois le débuggage terminé, afin d'éviter d'encombrer le collecteur avec des logs inutiles. + ### Vérifiez que le fichier de log engine ne contient pas d'erreur Exécutez la commande suivante : @@ -236,8 +233,8 @@ Aucune ligne concernant CMA ne doit être retournée. ## Emplacement des logs collecteur et agent -* Logs du collecteur : `/var/log/centreon-engine/centengine.log` +* Vous trouverez les journaux du moteur pour chaque collecteur ici : `/var/log/centreon-engine/centengine.log`. -* Logs de l'agent : +* Sur chaque hôte supervisé par CMA, les journaux de l'agent se trouvent ici : * Linux : par défaut, `/var/log/centreon-monitoring-agent/centagent.log` (cet emplacement de log est configurable dans **/etc/centreon-monitoring-agent/centagent.json**) * Windows : l'emplacement est celui que vous avez défini lors de l'installation de l'agent (par défaut, dans l'observateur d'évènements Windows). From 91813eba095082d212468362b59a84fa3bd77765 Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 14:12:07 +0200 Subject: [PATCH 8/9] Update cma-troubleshooting.md --- .../current/cma/cma-troubleshooting.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs-cloud/current/cma/cma-troubleshooting.md b/i18n/fr/docusaurus-plugin-content-docs-cloud/current/cma/cma-troubleshooting.md index 308f6ff378f0..4d863e0cf137 100644 --- a/i18n/fr/docusaurus-plugin-content-docs-cloud/current/cma/cma-troubleshooting.md +++ b/i18n/fr/docusaurus-plugin-content-docs-cloud/current/cma/cma-troubleshooting.md @@ -158,6 +158,8 @@ La valeur **true** doit être retournée. ## Vérifications sur le collecteur +Vous devez effectuer ces vérifications sur chaque collecteur qui reçoit des données provenant des agents CMA. + ### Vérifiez que le serveur est en écoute et que des paquets sont échangés @@ -202,7 +204,9 @@ tcpdump -i any port 4317 Elle doit retourner des résultats, indiquant que des paquets circulent entre l'agent et le collecteur. -### Activez les logs OpenTelemetry +### Modifier le niveau de log d'OpenTelemetry + +Par défaut, le niveau de log est **Error**. Vous pouvez le modifier à des fins de débuggage. 1. Éditez le fichier de configuration du moteur de supervision : @@ -220,6 +224,8 @@ Elle doit retourner des résultats, indiquant que des paquets circulent entre l' 3. Redémarrez le moteur de supervision. +> N'oubliez pas de baisser le niveau de log une fois le débuggage terminé, afin d'éviter d'encombrer le collecteur avec des logs inutiles. + ### Vérifiez que le fichier de log engine ne contient pas d'erreur Exécutez la commande suivante : @@ -236,8 +242,8 @@ Aucune ligne concernant CMA ne doit être retournée. ## Emplacement des logs collecteur et agent -* Logs du collecteur : `/var/log/centreon-engine/centengine.log` +* Vous trouverez les journaux du moteur pour chaque collecteur ici : `/var/log/centreon-engine/centengine.log`. -* Logs de l'agent : +* Sur chaque hôte supervisé par CMA, les journaux de l'agent se trouvent ici : * Linux : par défaut, `/var/log/centreon-monitoring-agent/centagent.log` (cet emplacement de log est configurable dans **/etc/centreon-monitoring-agent/centagent.json**) * Windows : l'emplacement est celui que vous avez défini lors de l'installation de l'agent (par défaut, dans l'observateur d'évènements Windows). From 1ac065fce1c83982b7a311bdb22899dbbb4813e6 Mon Sep 17 00:00:00 2001 From: cg-tw <83637804+cg-tw@users.noreply.github.com> Date: Thu, 30 Apr 2026 14:14:29 +0200 Subject: [PATCH 9/9] Update cma-troubleshooting.md --- cloud/cma/cma-troubleshooting.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/cloud/cma/cma-troubleshooting.md b/cloud/cma/cma-troubleshooting.md index 0807dc82571d..789466bad879 100644 --- a/cloud/cma/cma-troubleshooting.md +++ b/cloud/cma/cma-troubleshooting.md @@ -157,6 +157,8 @@ The value **true** must be returned. ## Poller checks +You need to run these checks on every poller that receives data from CMA agents. + ### Check that the server is listening and that packets are arriving @@ -198,7 +200,9 @@ tcpdump -i any port 4317 This command must return results, showing that packets are exchanged between agent and poller. -### Enable the OpenTelemetry logs +### Change the OpenTelemetry log level + +By default, the log level is **Error**. You may want to change this for debugging purposes. 1. Edit the monitoring engine's configuration file: @@ -216,6 +220,8 @@ This command must return results, showing that packets are exchanged between age 3. Restart the monitoring engine. +> Remember to lower the log level once you've finished debugging, to avoid cluttering the poller with unnecessary logs. + ### Check that the engine log file does not contain any errors Execute the following command: @@ -232,8 +238,8 @@ Check in the **Monitoring > Resource status** page that all resources are up to ## Location of poller and agent logs -* Poller logs: `/var/log/centreon-engine/centengine.log` +* You can find the engine logs for each poller here: `/var/log/centreon-engine/centengine.log`. -* Agent logs: +* On each host monitored by CMA, the agent's logs can be found here: * Linux: by default, `/var/log/centreon-monitoring-agent/centagent.log` (this log location can be configured in **/etc/centreon-monitoring-agent/centagent.json**) * Windows: the location is the one you specified when installing the agent (by default, in the Windows Event Viewer).