/datadog-cloudformation-resources

Primary LanguagePythonApache License 2.0Apache-2.0

Datadog-AWS CloudFormation

AWS CloudFormation gives you templates to describe, configure, and provision all of the AWS resources in your environment at once. The Datadog-AWS CloudFormation Resources allow you to interact with the supported Datadog resources. To get started:

  1. In your terminal, use the aws-cli tool to register a Datadog resource.

    aws cloudformation register-type \
    --region "<REGION>" \
    --type RESOURCE \
    --type-name "<DATADOG_RESOURCE_NAME>" \
    --schema-handler-package "<LINK_TO_S3>"

  2. View the version of the newly registered resource by running the following in your terminal:

    aws cloudformation list-type-versions \
--region "<REGION>" \
--type RESOURCE \
--type-name "<DATADOG_RESOURCE_NAME>"

  3. Set this newly registered version as the default by running the following in your terminal:

    aws cloudformation set-type-default-version \
    --region "<REGION>" \
    --type RESOURCE \
    --version-id <VERSION_ID> \
    --type-name "<DATADOG_RESOURCE_NAME>"

    With the following required placeholders:

    • <REGION>: Your AWS region.
    • <DATADOG_RESOURCE_NAME>: The name of the resource to register, refer to the table below to see the Datadog supported resources.
    • <LINK_TO_S3>: S3 link to the resource.
      • S3 link: s3://datadog-cloudformation-resources/<RESOURCE_FOLDER>/<RESOURCE_FOLDER>-<RESOURCE_VERSION>.zip
      • See the Resources Available section, which links to examples of the latest supported S3 links.
    • VERSION_ID: The underlying version of the resource as returned by the command in step 2.

  4. In your AWS account, create your AWS stack that includes any of the registered Datadog resources.

For more information about the available commands and workflows, see the the official AWS documentation.

Resources available

The following Datadog resources can be registered within your AWS account, refer to their specific documentation to see how to configure them:

Resource Name Description Folder S3 Package Links
Dashboards Datadog::Dashboards::Dashboard Create, update, and delete Datadog dashboards datadog-dashboards-dashboard Schema Handler Versions
Datadog-AWS integration Datadog::Integrations::AWS Manage your Datadog-Amazon Web Service integration datadog-integrations-aws Schema Handler Versions
Monitors Datadog::Monitors::Monitor Create, update, and delete Datadog monitors. datadog-monitors-monitor Schema Handler Versions
Downtimes Datadog::Monitors::Downtime Enable or disable downtimes for your monitors. datadog-monitors-downtime Schema Handler Versions
User Datadog::IAM::User Create and manage Datadog users. datadog-iam-user Schema Handler Versions

Troubleshooting

Need help? Contact Datadog support.