Datadog connector instance value parameters

  • Release version: Zurich
  • Updated October 29, 2025
  • 1 minute to read

    • The following table displays the Datadog connector instance value parameters that you can fill in, as needed, when creating a Datadog connector instance.

    Table 1. Connector instance value parameters
    Parameter Description
    application_key (Mandatory) Enter the Application Key generated from your Datadog account, used for authentication.
    BaseApiPath The specific API path for querying metrics.

    The default is /api/v2/query/timeseries.
    debug Set to true to enable detailed, high-level logging for this instance during troubleshooting.

    Default: false
    hostApiPath The specific API path for retrieving the list of hosts. The default is /api/v1/hosts.
    hostBatchSize The number of hosts to retrieve in a single API call. The default is 500, and any value above 1000 is automatically capped at 1000.
    hostFilter

    (Optional) A comma-separated list of regular expressions (regex) to filter for specific hosts to monitor. or example, ^prod-db-.* is a regex pattern that means "match any host whose name starts with prod-db-".

    Example Use Case: To monitor only hosts starting with app-server- and the specific host critical-db-01, you would set the hostFilter to: ^app-server-.*, ^critical-db-01$.
    initialSyncInMins

    For the first run of the instance, the number of minutes of historical data to retrieve.

    The default is 15, and any value above 120 is capped at 120.
    logPayload Set to true to log the full request and response bodies for deep debugging. Use with caution as it can generate very large logs.
    metricBatchSize The number of metrics to query in a single API call. The default is 50, and any value above 50 is automatically capped at 50.
    port Port number for the Datadog server to connect to.

    This is typically not needed when using https.
    protocol The protocol for the connection.

    Default: https

    In the Connector Instance Metrics related list, specify which metrics to collect. To use all 23 out-of-the-box metrics, no action is needed.

    To go back to the procedure page, see Configure the Datadog metrics connector instance.