Datadog integration

You can use the Datadog polling integration to ingest Datadog metrics and events into Express. This integration performs anomaly detection on all metrics and generates events for detected anomalies before ingestion.

See the Datadog documentation for details on Datadog components.

Before You Begin

This integration was validated in Datadog on May 22, 2020. Before you set up your integration, ensure you have met the following requirements for each Datadog instance:

  • The port for your Datadog server is open and accessible from Express.

  • Your Datadog system can accept HTTPS requests.

  • You know your Datadog server URL.

  • You know your Datadog API key and Application Key.

Recommendations and best practices

Moogsoft recommends the following:

  • To minimize latencies in the transfer of data from Datadog to Express, use this integration to ingest metrics and the Datadog Webhook integration to ingest events.

  • To observe AWS CloudWatch, ingest the data directly using the Express CloudWatch integration rather than ingesting CloudWatch data collected via Datadog. This will reduce latencies between CloudWatch and Datadog.AWS CloudWatch pre-DOCS-2583

Set up the Integration in Express

  1. Set up your Datadog credentials:

    1. Choose Settings > Credentials Store > Datadog.

    2. Create a new profile with your Datadog API Key and Application Key.

  2. Go to Integrations > Datadog and create a new integration:

    1. Name -- Enter a unique name. You cannot edit or update this name once you create the integration.

    2. Credentials -- Select the Credentials Store profile you created previously.

    3. Data Types -- Select the data you want to collect (events and/or metrics).

The UI shows the integration status after setup. The status can be one of the following:

  • Starting - The integration is scheduled to begin polling for data from Datadog.

  • Running - integration is polling Datadog successfully.

  • Disconnected -- The integration has been disconnected due to credential issues. Confirm your Credentials Store definition has the correct Datadog API and application keys.

  • Limited -- The integration has temporarily stopped collecting data due to hourly polling limits in Datadog.

  • Stopped -- The integration stopped running due to an internal issue.

You do not need to perform any integration-specific steps on your Datadog systems. After you set up the integration, it polls each Datadog server at regular intervals to collect metrics and events.