Forwarding Logs to Custom Destinations

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Log forwarding is not available for the Government site. Contact your account representative for more information.

Overview

Log Forwarding allows you to send logs from Datadog to custom destinations like Splunk, Elasticsearch, and HTTP endpoints. This means that you can use Log Pipelines to centrally collect, process, and standardize your logs in Datadog. Then, send the logs from Datadog to other tools to support individual teams’ workflows. You can choose to forward any of the ingested logs, whether or not they are indexed, to custom destinations. Logs are forwarded in JSON format and compressed with GZIP.

Note: Only Datadog users with the logs_write_forwarding_rules permission can create, edit, and delete custom destinations for forwarding logs.

The Log Forwarding page, showing custom destinations highlighted. The list of destinations includes Splunk (filtered by service:logs-processing), HTTP Endpoint (filtered by source:okta OR source:paloalto), and Elasticsearch (filtered by team:acme env:prod).

If a forwarding attempt fails (for example: if your destination temporarily becomes unavailable), Datadog retries periodically for 2 hours using an exponential backoff strategy. The first attempt is made following a 1-minute delay. For subsequent retries, the delay increases progressively to a maximum of 8-12 minutes (10 minutes with 20% variance).

The following metrics report on logs that have been forwarded successfully, including logs that were sent successfully after retries, as well as logs that were dropped.

  • datadog.forwarding.logs.bytes
  • datadog.forwarding.logs.count

Set up log forwarding to custom destinations

  1. Add webhook IPs from the IP ranges list to the allowlist.
  2. Navigate to Log Forwarding.
  3. Select Custom Destinations.
  4. Click New Destination.
  5. Enter the query to filter your logs for forwarding. See Search Syntax for more information.
  6. Select the Destination Type.
The destination configuration page, showing the steps to set up a new destination.
  1. Enter a name for the destination.
  2. In the Define endpoint field, enter the endpoint to which you want to send the logs. The endpoint must start with https://.
  3. In the Configure Authentication section, select one of the following authentication types and provide the relevant details:
    Authentication TypeDescriptionExample
    Basic AuthenticationProvide the username and password for the account to which you want to send logs.Username: myaccount
    Password: mypassword
    Request HeaderProvide the header name and value. Example for Authorization:
    - Enter Authorization for Header Name.
    - Use a header value formatted as Basic username:password, encoded in base64.
    Header Name: Authorization
    Header Value: Basic bXlhY2NvdW50Om15cGFzc3dvcmQ=
  1. Enter a name for the destination.
  2. In the Configure Destination section, enter the endpoint to which you want to send the logs. The endpoint must start with https://. For example, enter https://<your_account>.splunkcloud.com:8088.
    Note: /services/collector/event is automatically appended to the endpoint.
  3. In the Configure Authentication section, enter the Splunk HEC token. See Set up and use HTTP Event Collector for more information about the Splunk HEC token.
    Note: The indexer acknowledgment needs to be disabled.
  1. Enter a name for the destination.
  2. In the Configure Destination section, enter the following details:
    SettingDescriptionExample
    EndpointEnter the endpoint to which you want to send the logs. The endpoint must start with https://.https://<your_account>.us-central1.gcp.cloud.es.io (Elasticsearch)
    Destination Index NameSpecify the name of the destination index where you want to send the logs.your_index_name
    Index RotationOptionally, select how often to create a new index: No Rotation, Every Hour, Every Day, Every Week, Every Month. The default is No Rotation.Every Day
  3. In the Configure Authentication section, enter the username and password for your Elasticsearch account.
Log forwarding to Microsoft Sentinel is in Preview. To access this feature, register here.
  1. Enter a name for the destination.
  2. Authentication for the Microsoft Sentinel Forwarder requires configuring an App Registration through the Datadog Azure Integration.
  3. In the Configure Destination section, enter the following details:
    SettingDescriptionExample
    Logs Ingestion EndpointEnter the endpoint on the Data Collection Endpoint (DCE) where logs are sent. This is labeled “Logs Ingestion” on the DCE Overview page.https://my-dce-5kyl.eastus-1.ingest.monitor.azure.com
    Immutable IDSpecify the immutable ID of the Data Collection Rule (DCR) where logging routes are defined, as found on the DCR Overview page as “Immutable Id”. Note: Ensure the Monitoring Metrics Publisher role is assigned in the DCR IAM settings.dcr-000a00a000a00000a000000aa000a0aa
    Stream Declaration NameProvide the name of the target Stream Declaration found in the Resource JSON of the DCR under streamDeclarations.Custom-MyTable
  1. In the Select Tags to Forward section: a. Select whether you want All tags, No tags, or Specific Tags to be included. b. Select whether you want to Include or Exclude specific tags, and specify which tags to include or exclude.
  2. Click Save.

On the Log Forwarding page, hover over the status for a destination to see the percentage of logs that matched the filter criteria and have been forwarded in the past hour.

Edit a destination

  1. Navigate to Log Forwarding.
  2. Select Custom Destinations to view a list of all existing destinations.
  3. Click the Edit button for the destination you want to edit.
  4. Make the changes on the configuration page.
  5. Click Save.

Delete a destination

  1. Navigate to Log Forwarding.
  2. Select Custom Destinations to view a list of all existing destinations.
  3. Click the Delete button for the destination that you want to delete, and click Confirm. This removes the destination from the configured list of destinations and logs are no longer forwarded to it.

Further reading