diff --git a/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.en-gb.md b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.en-gb.md index f54ee15ef59..9c864ead88a 100644 --- a/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.en-gb.md +++ b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.en-gb.md @@ -25,9 +25,15 @@ 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`: @@ -35,12 +41,24 @@ Public Cloud managed databases allow you to send logs of your service to your ow #### 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. + +In the cluster details, you can find the `Service ID` field, which corresponds to the cluster ID. + +![LDP database details](images/ldp_database_details.png) ### Step 2 - Create your subscription -Use the following API call: +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] > @@ -49,9 +67,11 @@ Use the following API call: ```console body : { - streamId: + kind: + streamId: } ``` + Then logs will start to be forwarded to your LDP stream. ### Find logs in Graylog diff --git a/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.fr-fr.md b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.fr-fr.md index 12b2c179667..9c864ead88a 100644 --- a/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/guide.fr-fr.md +++ b/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,9 +25,15 @@ 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`: @@ -35,12 +41,24 @@ Public Cloud managed databases allow you to send logs of your service to your ow #### 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. + +In the cluster details, you can find the `Service ID` field, which corresponds to the cluster ID. + +![LDP database details](images/ldp_database_details.png) ### Step 2 - Create your subscription -Use the following API call: +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] > @@ -49,9 +67,11 @@ Use the following API call: ```console body : { - streamId: + kind: + streamId: } ``` + Then logs will start to be forwarded to your LDP stream. ### Find logs in Graylog diff --git a/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_database_details.png b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_database_details.png new file mode 100644 index 00000000000..70853f65294 Binary files /dev/null and b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_database_details.png differ diff --git a/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_page.png b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_page.png new file mode 100644 index 00000000000..ec4b9561f9e Binary files /dev/null and b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_page.png differ diff --git a/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_page_details.png b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_page_details.png new file mode 100644 index 00000000000..88b17bf9087 Binary files /dev/null and b/pages/public_cloud/public_cloud_databases/databases_16_logs_to_customer/images/ldp_page_details.png differ