From d40c71e0f7d13e0036b020689f89c69c2b93030d Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Tue, 3 Feb 2026 14:02:28 +0100 Subject: [PATCH 1/6] CDP monolog channel described --- docs/cdp/cdp_monolog_configuration.md | 50 +++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 docs/cdp/cdp_monolog_configuration.md diff --git a/docs/cdp/cdp_monolog_configuration.md b/docs/cdp/cdp_monolog_configuration.md new file mode 100644 index 0000000000..6414986bb0 --- /dev/null +++ b/docs/cdp/cdp_monolog_configuration.md @@ -0,0 +1,50 @@ +--- +description: CDP Monolog channel +edition: experience +--- + +# CDP Monolog channel + +CDP Monolog channel handles webhook logs for easier separation of logs. + +```bash +- { name: monolog.logger, channel: ibexa.cdp.webhook } +``` + +It's possible to configure `ibexa.cdp.webhook` Monolog channels to direct all logs to specific stream, file, or service. +This allows webhook logs to be stored separately from the main application logs for easier debugging and analysis. + +To do it, in `config/packages/monolog.yaml` file, define a new handler for the `ibexa.cdp.webhook` channel that directs CPD Webhook events to a separate file. +it can be configured in both `dev` and `prod` environments, for example: + +=== "Dev" + + ```yaml + when@dev: + monolog: + handlers: + cdp_webhook: + type: stream + path: "%kernel.logs_dir%/cdp_webhook_%kernel.environment%.log" + level: debug + channels: [ 'ibexa.cdp.webhook' ] + ``` + +=== "Prod" + + ```yaml + when@prod: + monolog: + handlers: + cdp_webhook: + type: stream + path: "%kernel.logs_dir%/cdp_webhook_%kernel.environment%.log" + level: debug + channels: [ 'ibexa.cdp.webhook' ] + ``` + +If you want to avoid redundant or duplicate entries in the other log, exclude the webhook channel by: + +```yaml +channels: ["!ibexa.cdp.webhook"] +``` From b75e800cbb90139b6b1372c3b67d047e1dcaca6c Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Tue, 3 Feb 2026 14:06:20 +0100 Subject: [PATCH 2/6] mkdocs updated --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index 77a37fda43..e07a4a1470 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -499,6 +499,7 @@ nav: - CDP add client-side tracking: cdp/cdp_activation/cdp_add_clientside_tracking.md - CDP data export schedule: cdp/cdp_data_export_schedule.md - CDP data customization: cdp/cdp_data_customization.md + - CDP Monolog channel: cdp/cdp_monolog_channel.md - Search: - Search: search/search.md - Search engines: From 9a74171839c46084e13ffdb6cedb6603ac62fa30 Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Tue, 3 Feb 2026 14:06:56 +0100 Subject: [PATCH 3/6] typo fix --- docs/cdp/cdp_monolog_configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cdp/cdp_monolog_configuration.md b/docs/cdp/cdp_monolog_configuration.md index 6414986bb0..964d570a8b 100644 --- a/docs/cdp/cdp_monolog_configuration.md +++ b/docs/cdp/cdp_monolog_configuration.md @@ -11,7 +11,7 @@ CDP Monolog channel handles webhook logs for easier separation of logs. - { name: monolog.logger, channel: ibexa.cdp.webhook } ``` -It's possible to configure `ibexa.cdp.webhook` Monolog channels to direct all logs to specific stream, file, or service. +It's possible to configure `ibexa.cdp.webhook` Monolog channel to direct all logs to specific stream, file, or service. This allows webhook logs to be stored separately from the main application logs for easier debugging and analysis. To do it, in `config/packages/monolog.yaml` file, define a new handler for the `ibexa.cdp.webhook` channel that directs CPD Webhook events to a separate file. From 5afce6aad5fdd3252cda871eb2e8580674cda1f3 Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Tue, 3 Feb 2026 14:13:58 +0100 Subject: [PATCH 4/6] name fix --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index e07a4a1470..33c9e08728 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -499,7 +499,7 @@ nav: - CDP add client-side tracking: cdp/cdp_activation/cdp_add_clientside_tracking.md - CDP data export schedule: cdp/cdp_data_export_schedule.md - CDP data customization: cdp/cdp_data_customization.md - - CDP Monolog channel: cdp/cdp_monolog_channel.md + - CDP Monolog channel: cdp/cdp_monolog_configuration.md - Search: - Search: search/search.md - Search engines: From 19ef1c92589e39ce27fa478e18d6cf7def2eefd0 Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Wed, 4 Feb 2026 13:40:18 +0100 Subject: [PATCH 5/6] name fixes after review --- docs/cdp/cdp_activation/cdp_data_export.md | 30 +++++++++++++ docs/cdp/cdp_monolog_configuration.md | 50 ---------------------- mkdocs.yml | 1 - 3 files changed, 30 insertions(+), 51 deletions(-) delete mode 100644 docs/cdp/cdp_monolog_configuration.md diff --git a/docs/cdp/cdp_activation/cdp_data_export.md b/docs/cdp/cdp_activation/cdp_data_export.md index cbc932559d..2e965c1fb0 100644 --- a/docs/cdp/cdp_activation/cdp_data_export.md +++ b/docs/cdp/cdp_activation/cdp_data_export.md @@ -133,3 +133,33 @@ Finally, you can specify the audiences you wish to include. !!! note "CDP requests" All CDP requests are logged in with `debug` severity. + +## CDP Monolog channel + +CDP Monolog channel handles webhook logs for easier separation of logs. + +```bash +- { name: monolog.logger, channel: ibexa.cdp.webhook } +``` + +It's possible to configure `ibexa.cdp.webhook` Monolog channel to direct all logs to specific stream, file, or service. +This allows webhook logs to be stored separately from the main application logs for easier debugging and analysis. + +To do it, in `config/packages/monolog.yaml` file, define a new handler for the `ibexa.cdp.webhook` channel that directs CPD Webhook events to a separate file. +It can be configured in both `dev` and `prod` environments, for example: + +```yaml +monolog: + handlers: + cdp_webhook: + type: stream + path: "%kernel.logs_dir%/cdp_webhook_%kernel.environment%.log" + level: debug + channels: [ 'ibexa.cdp.webhook' ] +``` + +If you want to avoid redundant or duplicate entries in the other log, exclude the webhook channel by: + +```yaml +channels: ["!ibexa.cdp.webhook"] +``` diff --git a/docs/cdp/cdp_monolog_configuration.md b/docs/cdp/cdp_monolog_configuration.md deleted file mode 100644 index 964d570a8b..0000000000 --- a/docs/cdp/cdp_monolog_configuration.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -description: CDP Monolog channel -edition: experience ---- - -# CDP Monolog channel - -CDP Monolog channel handles webhook logs for easier separation of logs. - -```bash -- { name: monolog.logger, channel: ibexa.cdp.webhook } -``` - -It's possible to configure `ibexa.cdp.webhook` Monolog channel to direct all logs to specific stream, file, or service. -This allows webhook logs to be stored separately from the main application logs for easier debugging and analysis. - -To do it, in `config/packages/monolog.yaml` file, define a new handler for the `ibexa.cdp.webhook` channel that directs CPD Webhook events to a separate file. -it can be configured in both `dev` and `prod` environments, for example: - -=== "Dev" - - ```yaml - when@dev: - monolog: - handlers: - cdp_webhook: - type: stream - path: "%kernel.logs_dir%/cdp_webhook_%kernel.environment%.log" - level: debug - channels: [ 'ibexa.cdp.webhook' ] - ``` - -=== "Prod" - - ```yaml - when@prod: - monolog: - handlers: - cdp_webhook: - type: stream - path: "%kernel.logs_dir%/cdp_webhook_%kernel.environment%.log" - level: debug - channels: [ 'ibexa.cdp.webhook' ] - ``` - -If you want to avoid redundant or duplicate entries in the other log, exclude the webhook channel by: - -```yaml -channels: ["!ibexa.cdp.webhook"] -``` diff --git a/mkdocs.yml b/mkdocs.yml index 33c9e08728..77a37fda43 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -499,7 +499,6 @@ nav: - CDP add client-side tracking: cdp/cdp_activation/cdp_add_clientside_tracking.md - CDP data export schedule: cdp/cdp_data_export_schedule.md - CDP data customization: cdp/cdp_data_customization.md - - CDP Monolog channel: cdp/cdp_monolog_configuration.md - Search: - Search: search/search.md - Search engines: From 3d49a7ad3f3e0fada4ac0fa87fe856ea448dfe70 Mon Sep 17 00:00:00 2001 From: julitafalcondusza Date: Wed, 4 Feb 2026 14:16:45 +0100 Subject: [PATCH 6/6] fixes --- docs/cdp/cdp_activation/cdp_data_export.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/cdp/cdp_activation/cdp_data_export.md b/docs/cdp/cdp_activation/cdp_data_export.md index 2e965c1fb0..8941a83e86 100644 --- a/docs/cdp/cdp_activation/cdp_data_export.md +++ b/docs/cdp/cdp_activation/cdp_data_export.md @@ -134,7 +134,7 @@ Finally, you can specify the audiences you wish to include. All CDP requests are logged in with `debug` severity. -## CDP Monolog channel +### CDP Monolog channel CDP Monolog channel handles webhook logs for easier separation of logs. @@ -158,7 +158,7 @@ monolog: channels: [ 'ibexa.cdp.webhook' ] ``` -If you want to avoid redundant or duplicate entries in the other log, exclude the webhook channel by: +If you want to avoid redundant or duplicate entries in the other logs, exclude the webhook channel by: ```yaml channels: ["!ibexa.cdp.webhook"]