Skip to content

Latest commit

 

History

History
83 lines (48 loc) · 4.24 KB

DataDog-AWS_Integration.md

File metadata and controls

83 lines (48 loc) · 4.24 KB

Datadog AWS Integration

Overview

As an Automate HA customer, you need to integrate Datadog with AWS to receive metrics from the AWS services. In the case of an Automate HA deployment with managed services and AWS S3 being used for backup, these services need to be integrated with Datadog to ensure monitoring and alerting for them.

Connect to Amazon Web Services (AWS) to:

  • See automatic AWS status updates in your Events Explorer

  • Get CloudWatch metrics for EC2 hosts without installing the Agent

  • Tag your EC2 hosts with EC2-specific information

  • See EC2 scheduled maintenance events in your stream

  • Collect CloudWatch metrics and events from many other AWS products

  • See CloudWatch alarms in your Events Explorer

Note: Datadog’s Amazon Web Services integration collects logs, events, and all metrics from CloudWatch for over 90 AWS services.

Setup Methods

Setup

  1. Go to the AWS integration configuration page in Datadog and click Add AWS Account.

    AWS-Integration

  2. Configure the integration settings automatically using the CloudFormation option.

    Datadog-aws-new-account-form

    • Select the AWS regions to integrate with.

    • Add your Datadog API key.

  3. Select Launch CloudFormation Template. This opens the AWS Console and loads the CloudFormation stack. All the parameters are filled in based on your selections in the prior Datadog form, so you do not need to edit those unless desired.

    Datadog-customize-cloudformation-setup

    Note: The DatadogAppKey parameter enables the CloudFormation stack to make API calls to Datadog to add and edit the Datadog configuration for this AWS account. The key is automatically generated and tied to your Datadog account.

    aws-cloudformation-template

  4. Check the required boxes from AWS and click Create Stack. This launches the creation process for the Datadog stack and three nested stacks, which could take several minutes. Ensure that the stack is successfully created before proceeding.

  5. After the stack is created, go back to the AWS integration tile in Datadog and select Ready!

  6. Select the AWS account and select the relevant AWS resources whose metrics we want at Datadog

    AWS-Metrics-Select

  7. Wait up to 10 minutes for data to start being collected, and then view the out-of-the-box AWS overview dashboard to see metrics sent by your AWS services and infrastructure:

    AWS-RDS-Dashboard

    AWS-Dashboard

Tags

The following tags are collected using AWS integration. Note: Some tags only display on specific metrics.

INTEGRATION DATADOG TAG KEYS
All region
EBS volumeid, volume-name, volume-type
EC2 autoscaling_group, availability-zone, image, instance-id, instance-type, kernel, name, security_group_name
ElastiCache cachenodeid, cache_node_type, cacheclusterid, cluster_name, engine, engine_version, preferred_availability-zone, replication_group
ELB availability-zone, hostname, loadbalancername, name, targetgroup
ES dedicated_master_enabled, ebs_enabled, elasticsearch_version, instance_type, zone_awareness_enabled
Health event_category, status, service
RDS auto_minor_version_upgrade, dbinstanceclass, dbclusteridentifier, dbinstanceidentifier, dbname, engine, engineversion, hostname, name, publicly_accessible, secondary_availability-zone
Route 53 healthcheckid
S3 bucket name, filterid, storagetyp
VPC nategatewayid, vpnid, tunnelipaddress