feat(database): update folder about logs data platform

pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.en-gb.md

@@ -25,38 +25,86 @@ Public Cloud managed databases allow you to send logs of your service to your ow
 
 #### Retrieve your LDP destination `streamId`:
 
-- In the OVHcloud Control Panel, go to your LDP page.
-- Go to the `Data stream` tab.
-- Choose your target stream and click on `Copy stream ID`{.action}.
+Log in to the [OVHcloud Control Panel](/links/manager), go to the `Identity, Security & Operations`{.action} section. In the left-hand menu, select `Logs Data Platform`{.action} then click on the relevant LDP instance.
+
+![LDP list page](images/ldp_page.png)
+
+Go to the `Data stream` tab.
+
+![LDP details page](images/ldp_page_details.png)
+
+Choose your target stream and click on `Copy stream ID`{.action}.
 
 #### Retrieve your LDP destination `serviceName`:
 
-- It refers to your Public Cloud project ID.
+- This refers to your Public Cloud project ID. You can retrieve it in the Public Cloud section of your project.
+
+![LDP project id](images/ldp_project_id.png)
 
 #### Retrieve your `clusterId`:
 
-- In the OVHcloud Control Panel, go to your database.
-- You can see the field `Cluster ID`.
+Log in to the [OVHcloud Control Panel](/links/manager), open the `Public Cloud`{.action} section and select the Public Cloud project concerned. In the left-hand menu, click on `Databases`{.action}, then choose the database instance you want to manage.
 
-### Step 2 - Create your subscription
+In the cluster details, you can find the `Service ID` field, which corresponds to the cluster ID.
 
-Use the following API call:
+![LDP database details](images/ldp_database_details.png)
 
-> [!api]
->
-> @api {v1} /cloud POST /cloud/project/{serviceName}/database/{engine}/{clusterId}/log/subscription
->
+### Step 2 - Create your subscription
 
-```console
-body : {
-    streamId: <LDP destination stream ID>
-}
-```
-Then logs will start to be forwarded to your LDP stream.
+> [!tabs]
+> Via the OVHcloud Control Panel
+>> On the database instance page, go to the `Logs`{.action} section and click the `Subscribe`{.action} button.
+>>
+>> ![LDP database subscription](images/ldp_database_subscription.png)
+>>
+>> Select the relevant LDP account by clicking the Subscribe button.
+>>
+>> ![LDP database subscription 2](images/ldp_database_subscription2.png)
+>>
+>> Then logs will start to be forwarded to your LDP stream.
+>>
+> Via the OVHcloud API
+>> 1. Start by retrieving the types of logs available for your database cluster with the following API call:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /cloud GET /cloud/project/{serviceName}/database/{engine}/{clusterId}/log/kind
+>> >
+>>
+>> This will return the list of valid kind values you can use when subscribing to logs.
+>>
+>> 2. Once you know the valid kind, use it to subscribe to a log stream with this API call:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /cloud POST /cloud/project/{serviceName}/database/{engine}/{clusterId}/log/subscription
+>> >
+>>
+>> ```console
+>> body : {
+>>     kind: <log_type_from_previous_call>
+>>     streamId: <your_stream_id>
+>> }
+>> ```
+>>
+>> Then logs will start to be forwarded to your LDP stream.
+>>
 
 ### Find logs in Graylog
 
-To find logs of your service in your graylogs stream you can use the following graylog queries:
+On the LDP page, click the `sample-data-stream`{.action} button (the last data stream modified when you previously subscribed to it), or click the `Graylog`{.action} button.
+
+![LDP database go to graylog](images/ldp_database_go_to_graylogs.png)
+
+You need to log in using your Graylog credentials. You can retrieve them from the LDP details page, in the Configuration section. The login corresponds to the value shown on the `Logs Data Platform service` line, and the password is displayed under `Password`.
+
+![LDP database ldp details](images/ldp_database_ldp_details.png)
+
+Once connected, you can view your service logs in your Graylog stream.
+
+![LDP database graylogs result](images/ldp_database_graylogs_result.png)
+
+You can also use the following Graylog queries for more granular filtering:
 
 #### MongoDB
 
@@ -80,12 +128,21 @@ You can find this `HostID` in your OVHcloud Control Panel:
 
 You have 2 methods to delete a subscription:
 
-- You can delete subscriptions using the `subscriptionId` concerned in this API call:
-
-> [!api]
->
-> @api {v1} /cloud DELETE /cloud/project/{serviceName}/database/mongodb/{clusterId}/log/subscription/{subscriptionId}
->
+> [!tabs]
+> Via the OVHcloud Control Panel
+>> In the subscription page of the database instance, click on `Unsubscribe`{.action} button.
+>>
+>> ![LDP database unsubscribe](images/ldp_database_unsubscribe.png)
+>>
+> Via the OVHcloud API
+>>
+>> - You can delete subscriptions using the `subscriptionId` concerned in this API call:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /cloud DELETE /cloud/project/{serviceName}/database/mongodb/{clusterId}/log/subscription/{subscriptionId}
+>> >
+>>
 
 - If you delete your database service, all subscriptions of this service are deleted automatically.
 
@@ -95,4 +152,4 @@ We would love to help answer questions and appreciate any feedback you may have.
 
 If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for a custom analysis of your project.
 
-Are you on Discord? Connect to our channel at <https://discord.gg/ovhcloud> and interact directly with the team that builds our databases service!
+Are you on Discord? Connect to our channel at <https://discord.gg/ovhcloud> and interact directly with the team that builds our databases service!

pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.fr-fr.md

@@ -1,5 +1,5 @@
 ---
-title: Public Cloud Databases - Comment mettre en place le transfert de logs (EN)
+title: Public Cloud Databases - How to setup logs forwarding
 excerpt: Find out how to forward logs of your database service to your Logs Data Platform data stream
 updated: 2024-09-25
 ---
@@ -25,38 +25,86 @@ Public Cloud managed databases allow you to send logs of your service to your ow
 
 #### Retrieve your LDP destination `streamId`:
 
-- In the OVHcloud Control Panel, go to your LDP page.
-- Go to the `Data stream` tab.
-- Choose your target stream and click on `Copy stream ID`{.action}.
+Log in to the [OVHcloud Control Panel](/links/manager), go to the `Identity, Security & Operations`{.action} section. In the left-hand menu, select `Logs Data Platform`{.action} then click on the relevant LDP instance.
+
+![LDP list page](images/ldp_page.png)
+
+Go to the `Data stream` tab.
+
+![LDP details page](images/ldp_page_details.png)
+
+Choose your target stream and click on `Copy stream ID`{.action}.
 
 #### Retrieve your LDP destination `serviceName`:
 
-- It refers to your Public Cloud project ID.
+- This refers to your Public Cloud project ID. You can retrieve it in the Public Cloud section of your project.
+
+![LDP project id](images/ldp_project_id.png)
 
 #### Retrieve your `clusterId`:
 
-- In the OVHcloud Control Panel, go to your database.
-- You can see the field `Cluster ID`.
+Log in to the [OVHcloud Control Panel](/links/manager), open the `Public Cloud`{.action} section and select the Public Cloud project concerned. In the left-hand menu, click on `Databases`{.action}, then choose the database instance you want to manage.
 
-### Step 2 - Create your subscription
+In the cluster details, you can find the `Service ID` field, which corresponds to the cluster ID.
 
-Use the following API call:
+![LDP database details](images/ldp_database_details.png)
 
-> [!api]
->
-> @api {v1} /cloud POST /cloud/project/{serviceName}/database/{engine}/{clusterId}/log/subscription
->
+### Step 2 - Create your subscription
 
-```console
-body : {
-    streamId: <LDP destination stream ID>
-}
-```
-Then logs will start to be forwarded to your LDP stream.
+> [!tabs]
+> Via the OVHcloud Control Panel
+>> On the database instance page, go to the `Logs`{.action} section and click the `Subscribe`{.action} button.
+>>
+>> ![LDP database subscription](images/ldp_database_subscription.png)
+>>
+>> Select the relevant LDP account by clicking the Subscribe button.
+>>
+>> ![LDP database subscription 2](images/ldp_database_subscription2.png)
+>>
+>> Then logs will start to be forwarded to your LDP stream.
+>>
+> Via the OVHcloud API
+>> 1. Start by retrieving the types of logs available for your database cluster with the following API call:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /cloud GET /cloud/project/{serviceName}/database/{engine}/{clusterId}/log/kind
+>> >
+>>
+>> This will return the list of valid kind values you can use when subscribing to logs.
+>>
+>> 2. Once you know the valid kind, use it to subscribe to a log stream with this API call:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /cloud POST /cloud/project/{serviceName}/database/{engine}/{clusterId}/log/subscription
+>> >
+>>
+>> ```console
+>> body : {
+>>     kind: <log_type_from_previous_call>
+>>     streamId: <your_stream_id>
+>> }
+>> ```
+>>
+>> Then logs will start to be forwarded to your LDP stream.
+>>
 
 ### Find logs in Graylog
 
-To find logs of your service in your graylogs stream you can use the following graylog queries:
+On the LDP page, click the `sample-data-stream`{.action} button (the last data stream modified when you previously subscribed to it), or click the `Graylog`{.action} button.
+
+![LDP database go to graylog](images/ldp_database_go_to_graylogs.png)
+
+You need to log in using your Graylog credentials. You can retrieve them from the LDP details page, in the Configuration section. The login corresponds to the value shown on the `Logs Data Platform service` line, and the password is displayed under `Password`.
+
+![LDP database ldp details](images/ldp_database_ldp_details.png)
+
+Once connected, you can view your service logs in your Graylog stream.
+
+![LDP database graylogs result](images/ldp_database_graylogs_result.png)
+
+You can also use the following Graylog queries for more granular filtering:
 
 #### MongoDB
 
@@ -80,12 +128,21 @@ You can find this `HostID` in your OVHcloud Control Panel:
 
 You have 2 methods to delete a subscription:
 
-- You can delete subscriptions using the `subscriptionId` concerned in this API call:
-
-> [!api]
->
-> @api {v1} /cloud DELETE /cloud/project/{serviceName}/database/mongodb/{clusterId}/log/subscription/{subscriptionId}
->
+> [!tabs]
+> Via the OVHcloud Control Panel
+>> In the subscription page of the database instance, click on `Unsubscribe`{.action} button.
+>>
+>> ![LDP database unsubscribe](images/ldp_database_unsubscribe.png)
+>>
+> Via the OVHcloud API
+>>
+>> - You can delete subscriptions using the `subscriptionId` concerned in this API call:
+>>
+>> > [!api]
+>> >
+>> > @api {v1} /cloud DELETE /cloud/project/{serviceName}/database/mongodb/{clusterId}/log/subscription/{subscriptionId}
+>> >
+>>
 
 - If you delete your database service, all subscriptions of this service are deleted automatically.
 
@@ -95,4 +152,4 @@ We would love to help answer questions and appreciate any feedback you may have.
 
 If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for a custom analysis of your project.
 
-Are you on Discord? Connect to our channel at <https://discord.gg/ovhcloud> and interact directly with the team that builds our databases service!
+Are you on Discord? Connect to our channel at <https://discord.gg/ovhcloud> and interact directly with the team that builds our databases service!