AWS CDK Datadog Resources

An AWS CDK construct library that wraps DataDog/datadog-cloudformation-resources.

Requirements

Before using this library, register datadog-cloudformation-resources to your AWS account.

You need to register the correct version listed in Supported Resources.

Supported CDK Languages

TypeScript
Python
~~Java~~ Sorry, there is a problem with the release. (#22)

Supported Resources

Supported?	Resource	Datadog CF Resource Name	Description	Datadog CF Version
✅	Dashboards	`Datadog::Dashboards::Dashboard`	Create, update, and delete Datadog dashboards.	1.0.0
✅	Datadog-AWS integration	`Datadog::Integrations::AWS`	Manage your Datadog-Amazon Web Service integration.	1.1.0
✅	Monitors	`Datadog::Monitors::Monitor`	Create, update, and delete Datadog monitors.	3.0.0
✅	Downtimes	`Datadog::Monitors::Downtime`	Enable or disable downtimes for your monitors.	2.0.0
✅	Users	`Datadog::IAM::User`	Create and manage Datadog users.	1.2.0

Installation

TypeScript

npm install @nomadblacky/cdk-datadog-resources

Python

pip install cdk-datadog-resources

Java

<dependency>
    <groupId>dev.nomadblacky</groupId>
    <artifactId>cdk-datadog-resources</artifactId>
    <version>x.y.z</version>
</dependency>

Usage

Below are examples of TypeScript.

Dashboards

# Example automatically generated. See https://github.com/aws/jsii/issues/826
import fs as fs
from nomadblacky.cdk_datadog_resources import DatadogDashboard

DatadogDashboard(your_stack, "TestDashboard",
    datadog_credentials={
        "api_key": process.env.DATADOG_API_KEY,
        "application_key": process.env.DATADOG_APP_KEY
    },
    dashboard_definition=fs.read_file_sync(f"{__dirname}/path/to/your/dashboard-definition.json").to_string()
)

Monitors

# Example automatically generated. See https://github.com/aws/jsii/issues/826
from nomadblacky.cdk_datadog_resources import DatadogMonitor

DatadogMonitor(your_stack, "TestMonitor",
    datadog_credentials={
        "api_key": process.env.DATADOG_API_KEY,
        "application_key": process.env.DATADOG_APP_KEY
    },
    query="avg(last_1h):sum:system.cpu.system{host:host0} > 100",
    type=MonitorType.QueryAlert,
    name="Test Monitor",
    options={
        "thresholds": {
            "critical": 100,
            "warning": 80,
            "o_k": 90
        },
        "notify_no_data": True,
        "evaluation_delay": 60
    }
)

Downtimes

# Example automatically generated. See https://github.com/aws/jsii/issues/826
from nomadblacky.cdk_datadog_resources import DatadogDowntime

DatadogDowntime(stack, "TestMonitor",
    datadog_credentials={
        "api_key": "DATADOG_API_KEY",
        "application_key": "DATADOG_APP_KEY"
    },
    scope=["host:myserver", "service:myservice"],
    start=1624542715,
    end=1624546321
)

Users

# Example automatically generated. See https://github.com/aws/jsii/issues/826
from nomadblacky.cdk_datadog_resources import DatadogIAMUser

DatadogIAMUser(stack, "TestUser",
    datadog_credentials={
        "api_key": "DATADOG_API_KEY",
        "application_key": "DATADOG_APP_KEY"
    },
    email="jane.doe@example.com",
    name="name_example",
    handle="title_example",
    disabled=False
)

DataDog Integration

# Example automatically generated. See https://github.com/aws/jsii/issues/826
from nomadblacky.cdk_datadog_resources import DatadogIntegrationAWS

DatadogIntegrationAWS(self, "DataDogIntegration",
    datadog_credentials={
        "api_key": "DATADOG_API_KEY",
        "application_key": "DATADOG_APP_KEY"
    },
    account_id="ACCOUNT_ID",
    role_name="DatadogIntegrationRole"
)

Release files for cdk-datadog-resources 0.2.43

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cdk-datadog-resources 0.2.43
File	Size	Uploaded
cdk-datadog-resources-0.2.43.tar.gz	51.7 kB	Nov 8, 2021	Details

Built distribution (wheel)

Table of built distributions (wheels) for cdk-datadog-resources 0.2.43
File	Interpreter	ABI	Platform	Reset
cdk_datadog_resources-0.2.43-py3-none-any.whl 50.1 kB Nov 8, 2021	Python 3	none	any	Details

Total release size: 101.9 kB

Release files / cdk-datadog-resources-0.2.43.tar.gz

Download URL	cdk-datadog-resources-0.2.43.tar.gz
Size	51.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`be8855ac415c7fa7bdf6abe854109cc2db8e516374a3f2cd589f36826f212e82`
BLAKE2b-256 checksum How to use checksums	`eb5cf86e0914326d7ba3ef64841b032a370f29f0200ae22649c82cfdbb0ad282`
Upload date	Nov 8, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.5.0 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.7.3`

Release files / cdk_datadog_resources-0.2.43-py3-none-any.whl

Download URL	cdk_datadog_resources-0.2.43-py3-none-any.whl
Size	50.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`665a3660a9ecaa8f7c1a43d4a10ec81e3ad8b03ca86264ab30e983752dccdf71`
BLAKE2b-256 checksum How to use checksums	`9c061c0a8b5e0cb8c8d65a030f6e9a42cc28b6e05afedc99f96e0dda9ba3ce5d`
Upload date	Nov 8, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.5.0 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.7.3`