{"id":16453421,"url":"https://github.com/blimmer/cdk-datadog-integration","last_synced_at":"2026-03-12T10:03:19.018Z","repository":{"id":38209479,"uuid":"256777451","full_name":"blimmer/cdk-datadog-integration","owner":"blimmer","description":"Amazon Cloud Development Kit (CDK) logic to integrate your AWS account with Datadog","archived":false,"fork":false,"pushed_at":"2024-04-05T00:17:57.000Z","size":570,"stargazers_count":20,"open_issues_count":7,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-16T04:31:45.819Z","etag":null,"topics":["aws","aws-cdk","aws-cdk-construct","aws-cloudformation","aws-integration","cloudformation","datadog","datadog-integration","hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blimmer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-04-18T14:44:38.000Z","updated_at":"2025-02-28T08:34:36.000Z","dependencies_parsed_at":"2024-02-22T01:28:12.334Z","dependency_job_id":"ebe07d21-f7fb-4f8e-9b9a-a41a50be886f","html_url":"https://github.com/blimmer/cdk-datadog-integration","commit_stats":{"total_commits":50,"total_committers":4,"mean_commits":12.5,"dds":0.14,"last_synced_commit":"6c48f1537f409e5c98432cb0330f5eb7b3c3fc4b"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blimmer%2Fcdk-datadog-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blimmer%2Fcdk-datadog-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blimmer%2Fcdk-datadog-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blimmer%2Fcdk-datadog-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blimmer","download_url":"https://codeload.github.com/blimmer/cdk-datadog-integration/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243909107,"owners_count":20367532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","aws-cdk","aws-cdk-construct","aws-cloudformation","aws-integration","cloudformation","datadog","datadog-integration","hacktoberfest"],"created_at":"2024-10-11T10:15:34.230Z","updated_at":"2026-03-12T10:03:11.590Z","avatar_url":"https://github.com/blimmer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS Cloud Development Kit (CDK) Datadog Integration\n\nThis construct makes it easy to integrate your AWS account with Datadog. It\ncreates nested stacks based on the official\n[Datadog Cloudformation templates](https://github.com/DataDog/cloudformation-template/blob/master/aws/main.yaml)\nusing [Amazon Cloud Development Kit (CDK)](https://aws.amazon.com/cdk/).\n\n## Warning\n\n:warning: This construct does not use the newest Datadog CloudFormation template because sensitive\nparameters must be hard-coded. See https://github.com/DataDog/cloudformation-template/issues/68 for an upstream\nfeature request. :warning:\n\nThis construct will still work, but it cannot be updated to the latest integration template until the upstream\nissue is fixed. Please add a +1 to https://github.com/DataDog/cloudformation-template/issues/68 to help\nprioritize it.\n\n## Basic Usage\n\n1. Install the package\n\n   ```console\n   npm i --save cdk-datadog-integration\n   ```\n\n   Or via [pypi](https://pypi.org/project/cdk-datadog-integration/),\n   [NuGet](https://www.nuget.org/packages/BenLimmer.CdkDatadogIntegration/), or\n   [GitHub Packages](https://github.com/blimmer/cdk-datadog-integration/packages).\n\n1. Import the stack and pass the required parameters.\n\n   ```ts\n   import * as cdk from \"aws-cdk-lib\";\n   import { MonitoringInfrastructureStack } from \"../lib/monitoring-infrastructure-stack\";\n\n   const app = new cdk.App();\n   new MonitoringInfrastructureStack(app, \"MonitoringInfrastructure\");\n   ```\n\n   ```ts\n   import * as cdk from \"aws-cdk-lib\";\n   import * as secrets from \"aws-cdk-lib/aws-secretsmanager\";\n   import { DatadogIntegration } from \"cdk-datadog-integration\";\n\n   export class MonitoringInfrastructureStack extends cdk.Stack {\n     constructor(scope: cdk.App, id: string, props?: cdk.StackProps) {\n       super(scope, id, props);\n\n       const datadog = new DatadogIntegration(this, \"Datadog\", {\n         // Generate an ID here: https://app.datadoghq.com/account/settings#integrations/amazon-web-services\n         externalId: \"\",\n\n         // Create or lookup a `Secret` that contains your Datadog API Key\n         // See https://docs.aws.amazon.com/cdk/api/latest/docs/aws-secretsmanager-readme.html for details on Secrets in CDK\n         // Get your API key here: https://app.datadoghq.com/account/settings#api\n         apiKey: secrets.Secret.fromSecretNameV2(\n           this,\n           \"DatadogApiKey\",\n           \"\u003cyour secret name\u003e\"\n         ),\n       });\n     }\n   }\n   ```\n\n## Configuration\n\nUse `DatadogIntegrationConfig` to set additional configuration parameters. Check\nout\n[docs](/API.md#cdk-datadog-integration.DatadogIntegrationConfig)\nfor more details on what's available.\n\nAdditionally, a CDK `Construct` is exposed, should you want to add additional\ncustomizations vs. using the out-of-the-box `Stack`.\n\n## CDK Version Compatibility\n\nThis package is expected to work with all recent versions of CDK v2. It has been\ntested with 2.1.0 so almost certainly works will all newer versions, and\nprobably works with some older versions too, but is untested.\n\nIf you're still on CDK v1, you can use `cdk-datadog-integration@1`, but this\nversion is unmaintained. Please upgrade to CDKv2.\n\n## How it Works\n\nThis module uses the\n[`CfnStack` CDK Construct](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudformation.CfnStack.html)\nto import the three CloudFormation stacks referenced by the\n[main Datadog CloudFormation template](https://github.com/DataDog/cloudformation-template/tree/master/aws).\nBy referencing the Datadog-provided templates, you can be confident that the\nintegration works exactly as Datadog intends.\n\n## Author\n\nThis package is created and maintained by\n[Ben Limmer](https://www.linkedin.com/in/blimmer/), a\n[freelance architect and consultant](https://benlimmer.com/freelance/). I love\nhelping businesses of all sizes solve their hardest technology problems. Let's\n[connect](https://benlimmer.com/freelance/contact/) if I can be of help!\n\n## Contributing\n\nPRs are welcome!\n\n### Releasing\n\nTo release, merge your PR to `main`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblimmer%2Fcdk-datadog-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblimmer%2Fcdk-datadog-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblimmer%2Fcdk-datadog-integration/lists"}