For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/ovhcloud.md. A documentation index is available at /llms.txt.

OVHcloud

Supported OS Linux

Integration version1.0.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

An overview of logs captured from OVHcloud
An overview of HTTP logs captured from OVHcloud

Overview

Use this integration to collect logs from OVHcloud Logs Data Platform (LDP) and forward them to Datadog. After ingestion, you can search, filter, and monitor your OVHcloud logs in Datadog Log Management.

Setup

Prerequisites

Before you begin, make sure you have:

  • An OVHcloud account
  • An active Logs Data Platform (LDP) service with IAM enabled and at least one data stream subscribed to an alias
  • An OVHcloud service account with an IAM policy that grants read access to your LDP aliases
  • A Datadog account with permission to configure integrations

For LDP setup instructions, see the OVHcloud LDP documentation. If your service uses legacy token-based authentication, follow the IAM migration guide. For IAM policy setup, see IAM for Logs Data Platform.

OVHcloud LDP configuration

Before enabling log collection, create a service account in OVHcloud and grant it access to your LDP streams:

  1. In the OVHcloud Control Panel, navigate to Identities > Service accounts and create an OAuth2 client. Save the generated Username and Password.

    1. Create an IAM policy and attach the service account to it.

  3. Select the Logs Data Platform: Alias product type.

  4. Add one or more aliases to the resource list, or add an applicable resource group.

  5. Add the following actions to allow Datadog to read from those aliases:

    ldp:apiovh:output/opensearch/alias/get
ldp:apiovh:output/opensearch/alias/index/get
ldp:apiovh:output/opensearch/alias/stream/get
ldp:apiovh:output/opensearch/alias/url/get
ldp:opensearch:alias/read

Datadog configuration

  1. Go to the OVHcloud integration tile in Datadog.
  2. Click Add Account.
  3. Enter an account name.
  4. Select your API zone:
    • OVH Europe (ovh-eu) for the European API
    • OVH US (ovh-us) for the US API
    • OVH Canada (ovh-ca) for the Canadian API
  5. Enter the Access point hostname for your LDP cluster. You can find this in the OVHcloud LDP console under your cluster details (for example, gra2.logs.ovh.com).
  6. Enter your LDP ID. You can find this on your LDP service overview page (for example, ldp-ra-xxxxx).
  7. (Optional) Enter one or more Aliases to ingest. Leave this field empty to ingest logs from all aliases on the service. Alias names are case-sensitive.
  8. Enter the Service User Username and Password from the service account you created.
  9. Click Save.

Note: Datadog polls your LDP OpenSearch endpoint every 10 minutes. Logs appear in Datadog about 10 to 15 minutes after they are written to LDP.

Validation

After you save the configuration, wait up to 15 minutes for log collection to begin. Then:

  1. Go to the Log Explorer in Datadog.
  2. Search for source:ovhcloud to confirm that logs are flowing.

Uninstallation

To stop collecting logs and remove an OVHcloud account from Datadog:

  1. Go to the OVHcloud integration tile in Datadog.
  2. From the left panel, select the account you want to remove.
  3. Click Delete Account at the bottom of the account configuration panel.
  4. In the confirmation dialog, click Confirm.

Deleting an account stops further log collection for that account. Data that was already collected is not removed from Datadog.

To fully revoke access, delete or disable the service account in the OVHcloud Control Panel after removing the account from Datadog.

Support

Need help? Contact Datadog Support.