{"_id":"@alerthq/provider-datadog","_rev":"2-85d247069a7852cda4c949ca81b02543","name":"@alerthq/provider-datadog","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@alerthq/provider-datadog","version":"0.0.1","keywords":["alerthq","provider","datadog","alerts","monitoring"],"license":"MIT","_id":"@alerthq/provider-datadog@0.0.1","maintainers":[{"name":"rsafaya","email":"rsafaya@edrv.io"}],"homepage":"https://github.com/ai-software-agency/alerthq#readme","bugs":{"url":"https://github.com/ai-software-agency/alerthq/issues"},"dist":{"shasum":"3131855590a425599a6bb0504220738c35e92dc0","tarball":"https://registry.npmjs.org/@alerthq/provider-datadog/-/provider-datadog-0.0.1.tgz","fileCount":5,"integrity":"sha512-t3i3wxqeARqA8j2+iEL9bCioeMbDzCm52haGHzK767eauodqbTSA71bATgIzDl18SlQ7LVAxIriG86rxaqwSYA==","signatures":[{"sig":"MEUCIH9GP/pzdiXumI/4PUEtddGfbVfdcFx1H5Bmz4JDeXu2AiEA6GEQ/y0MsCKU1jZNkdHmiLOg5g2wG7XvSWd4YhBT/fQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12525},"main":"./dist/index.js","type":"module","_from":"file:alerthq-provider-datadog-0.0.1.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"scripts":{"lint":"eslint src/","test":"vitest run --passWithNoTests","build":"tsup src/index.ts --format esm --dts","typecheck":"tsc --noEmit"},"_npmUser":{"name":"rsafaya","email":"rsafaya@edrv.io"},"_resolved":"/private/var/folders/y_/sbbsfnm54k310t77b7c43cdm0000gn/T/fdf1b50301b95ad6c0035e4b52bf82d7/alerthq-provider-datadog-0.0.1.tgz","_integrity":"sha512-t3i3wxqeARqA8j2+iEL9bCioeMbDzCm52haGHzK767eauodqbTSA71bATgIzDl18SlQ7LVAxIriG86rxaqwSYA==","repository":{"url":"git+https://github.com/ai-software-agency/alerthq.git","type":"git","directory":"packages/provider-datadog"},"_npmVersion":"11.7.0","description":"Datadog alert provider for alerthq","directories":{},"_nodeVersion":"25.4.0","dependencies":{"zod":"^3.24.0","@datadog/datadog-api-client":"^1.53.0"},"_hasShrinkwrap":false,"peerDependencies":{"@alerthq/core":"0.0.1"},"_npmOperationalInternal":{"tmp":"tmp/provider-datadog_0.0.1_1775722588344_0.4886345544912738","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-04-09T08:16:28.216Z","modified":"2026-04-09T09:10:03.857Z","0.0.1":"2026-04-09T08:16:28.476Z"},"bugs":{"url":"https://github.com/ai-software-agency/alerthq/issues"},"license":"MIT","homepage":"https://github.com/ai-software-agency/alerthq#readme","keywords":["alerthq","provider","datadog","alerts","monitoring"],"repository":{"url":"git+https://github.com/ai-software-agency/alerthq.git","type":"git","directory":"packages/provider-datadog"},"description":"Datadog alert provider for alerthq","maintainers":[{"email":"dpipalia@edrv.io","name":"dhruvin-edrv"},{"email":"rsafaya@edrv.io","name":"rsafaya"}],"readme":"# @alerthq/provider-datadog\n\nDatadog alert provider for [alerthq](https://github.com/edrv/alerthq).\n\n## Supported Alert Types\n\n| Alert Type | API Source | Notes |\n|------------|-----------|-------|\n| All Datadog monitor types | `v1.MonitorsApi.listMonitors()` via `@datadog/datadog-api-client` | Includes metric, log, anomaly, composite, forecast, outlier, APM, process, network, event, synthetics, and more |\n\n## Authentication\n\nRequires a Datadog API key and Application key:\n\n1. **API Key** — authenticates API requests (`DD-API-KEY` header)\n2. **Application Key** — scopes access to your organization (`DD-APPLICATION-KEY` header)\n\nBoth can be created in the Datadog organization settings under **API Keys** and **Application Keys**.\n\n## Configuration\n\nAdd to your `alerthq.yaml`:\n\n```yaml\nproviders:\n  datadog:\n    enabled: true\n    apiKey: ${DD_API_KEY}\n    appKey: ${DD_APP_KEY}\n    # Optional: Datadog site (defaults to datadoghq.com)\n    # site: datadoghq.eu\n```\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `apiKey` | `string` | Yes | — | Datadog API key |\n| `appKey` | `string` | Yes | — | Datadog Application key |\n| `site` | `string` | No | `datadoghq.com` | Datadog site (`datadoghq.com`, `datadoghq.eu`, `us5.datadoghq.com`, etc.) |\n\n## Required Permissions\n\nThe API key and Application key need the `monitors_read` scope (read-only access to monitors). No write permissions are required.\n\n## Field Mapping\n\n| AlertDefinition Field | Source |\n|-----------------------|--------|\n| `id` | `generateAlertId('datadog', String(monitor.id))` |\n| `sourceId` | `String(monitor.id)` |\n| `name` | `monitor.name` |\n| `description` | `monitor.message` |\n| `enabled` | Always `true` |\n| `severity` | From `monitor.priority`: P1/P2 → critical, P3 → warning, P4/P5 → info, null → unknown |\n| `conditionSummary` | `\"${monitor.type}: ${monitor.query}\"` |\n| `notificationTargets` | @-mentions extracted from `monitor.message` |\n| `tags` | `monitor.tags` split on `:` into key/value pairs |\n| `owner` | `monitor.creator.handle` |\n| `lastModifiedAt` | `monitor.modified` |\n\n## Limitations\n\n- **Severity from priority**: Not all Datadog monitors have a priority set. When unset, severity defaults to `unknown`.\n- **Notification targets**: Extracted by parsing @-mentions from the message text, which may miss targets configured through Datadog integrations that don't appear in the message.\n- **Enabled state**: Datadog monitors can be muted but not disabled. All monitors are reported as `enabled: true`.\n- **Pagination**: Uses offset-based pagination with a page size of 1000. Very large monitor counts are handled automatically.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}