Skip to content

aws

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

aws

README.md

Datadog AWS Integration

Launch Stack

Installation

  1. Open the AWS integration tile within the Datadog platform.
    1. Click "Add an account".
    2. Enter your AWS Account ID, e.g., 123456789012.
    3. Enter IAM Role name DatadogIntegrationRole (needs to match the value of IAMRoleName in the next step).
    4. Copy the External ID for the next step to use.
  2. Log into your admin AWS account/role and deploy the CloudFormation Stack with the button above.
    1. Fill in all the Required parameters.
    2. Optinally edit LogArchives and CloudTrails to configure Log Archives and CloudTrail integration.
    3. On a rare occasion, if you already have a stack deployed in the same AWS account using this template (e.g., monitor the same AWS account in multiple Datadog accounts), You MUST use a different role name for IAMRoleName and set InstallDatadogPolicyMacro to false.
    4. Click Create stack.

AWS Resources

This template creates the following AWS resources required by the Datadog AWS integration:

  • An IAM role for Datadog to assume for data collection (e.g., CloudWatch metrics)
  • The Datadog Forwarder Lambda function to ship logs from S3 and CloudWatch, custom metrics and traces from Lambda functions to Datadog
    • The Datadog Forwarder only deploy to the AWS region where the AWS integration CloudFormation stack is launched. If you operate in multiple AWS regions, you can deploy the Forwarder stack (without the rest of the AWS integration stack) directly to other regions as needed.
    • The Datadog Forwarder is installed with default settings as a nested stack, edit the nested stack directly to update the forwarder specific settings.

Datadog::Integrations::AWS

This CloudFormation stack only manages AWS resources required by the Datadog AWS integration. The actual integration configuration within Datadog platform can also be managed in CloudFormation using the custom resource Datadog::Integrations::AWS if you like.

Terraform

If you prefer managing the AWS resources using Terraform, check out the sample Terraform configuration datadog_aws_integration.tf.