{"_id":"@alerthq/provider-mongodb-atlas","_rev":"2-dff207a550f1a37211222766168f04f4","name":"@alerthq/provider-mongodb-atlas","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@alerthq/provider-mongodb-atlas","version":"0.0.1","keywords":["alerthq","provider","mongodb","atlas","alerts","monitoring"],"license":"MIT","_id":"@alerthq/provider-mongodb-atlas@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":"3c56ecbbcca40057c8992285194df030c0afbb8f","tarball":"https://registry.npmjs.org/@alerthq/provider-mongodb-atlas/-/provider-mongodb-atlas-0.0.1.tgz","fileCount":5,"integrity":"sha512-KwC8/DrPh0oP75MRwnGgd5V07wX4pd69SXfbErfciSrfMPHuZKRMHEpSqxoPWkDDBJNzvEdPxhvygZTMnJdnCw==","signatures":[{"sig":"MEUCIQCasF2ltZlA+siWQPSVvM8U8Guwjyawber+lAve4SE6+QIgCeRL4VdC2jRgE+udxxszDaY7jw6A6qGmi/TpJuRCt2M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19000},"main":"./dist/index.js","type":"module","_from":"file:alerthq-provider-mongodb-atlas-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/8a1f0547f1cb83c82a7fbd0826f8c7e3/alerthq-provider-mongodb-atlas-0.0.1.tgz","_integrity":"sha512-KwC8/DrPh0oP75MRwnGgd5V07wX4pd69SXfbErfciSrfMPHuZKRMHEpSqxoPWkDDBJNzvEdPxhvygZTMnJdnCw==","repository":{"url":"git+https://github.com/ai-software-agency/alerthq.git","type":"git","directory":"packages/provider-mongodb-atlas"},"_npmVersion":"11.7.0","description":"MongoDB Atlas alert provider for alerthq","directories":{},"_nodeVersion":"25.4.0","dependencies":{"zod":"^3.24.0"},"_hasShrinkwrap":false,"peerDependencies":{"@alerthq/core":"0.0.1"},"_npmOperationalInternal":{"tmp":"tmp/provider-mongodb-atlas_0.0.1_1775722593396_0.5504307379956792","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-04-09T08:16:33.248Z","modified":"2026-04-09T09:10:25.284Z","0.0.1":"2026-04-09T08:16:33.523Z"},"bugs":{"url":"https://github.com/ai-software-agency/alerthq/issues"},"license":"MIT","homepage":"https://github.com/ai-software-agency/alerthq#readme","keywords":["alerthq","provider","mongodb","atlas","alerts","monitoring"],"repository":{"url":"git+https://github.com/ai-software-agency/alerthq.git","type":"git","directory":"packages/provider-mongodb-atlas"},"description":"MongoDB Atlas alert provider for alerthq","maintainers":[{"email":"dpipalia@edrv.io","name":"dhruvin-edrv"},{"email":"rsafaya@edrv.io","name":"rsafaya"}],"readme":"# @alerthq/provider-mongodb-atlas\n\nMongoDB Atlas alert provider for [alerthq](https://github.com/edrv/alerthq).\n\n## Supported Alert Types\n\n| Alert Type | API Source | Notes |\n|------------|-----------|-------|\n| Alert Configurations | `GET /api/atlas/v2/groups/{projectId}/alertConfigs` | Includes metric threshold, threshold, and event-based alerts |\n\nAll Atlas alert configuration types are fetched, including host, replica set, sharded cluster, and user-defined alerts.\n\n## Authentication\n\nUses MongoDB Atlas **programmatic API keys** with HTTP Digest authentication.\n\n1. Go to your Atlas organization or project settings\n2. Create an API key with the appropriate permissions\n3. Note the public key and private key\n\nSee: [Atlas API Keys documentation](https://www.mongodb.com/docs/atlas/configure-api-access/)\n\n## Configuration\n\nAdd to your `alerthq.yaml`:\n\n```yaml\nproviders:\n  mongodb-atlas:\n    enabled: true\n    publicKey: your-public-key\n    privateKey: your-private-key\n    projectIds:\n      - 60c7abcd1234567890abcdef\n      - 60c7abcd1234567890abcdeg\n    # baseUrl: https://cloud.mongodb.com  # optional, for private cloud\n    # pageSize: 100                       # optional\n```\n\n| Field | Type | Required | Default | Description |\n|-------|------|----------|---------|-------------|\n| `publicKey` | `string` | Yes | — | Atlas API public key |\n| `privateKey` | `string` | Yes | — | Atlas API private key |\n| `projectIds` | `string[]` | Yes | — | Atlas project (group) IDs to scan |\n| `baseUrl` | `string` | No | `https://cloud.mongodb.com` | Atlas API base URL |\n| `pageSize` | `number` | No | `100` | Number of alerts per API page |\n\n## Required Permissions\n\nThe API key needs the **Project Read Only** role (or higher) on each project listed in `projectIds`.\n\nMinimum required permission: `GROUP_READ_ONLY`\n\n## Field Mapping\n\n| AlertDefinition Field | Source |\n|-----------------------|--------|\n| `id` | `generateAlertId('mongodb-atlas', id)` |\n| `sourceId` | `id` (alert config ID) |\n| `name` | Built from `eventTypeName` + `metricThreshold.metricName` |\n| `description` | Empty string (Atlas alert configs have no description) |\n| `enabled` | `enabled` |\n| `severity` | `'unknown'` (Atlas has no native severity field) |\n| `conditionSummary` | Built from `metricThreshold` (metric, operator, threshold, units), `threshold`, and `matchers` |\n| `notificationTargets` | Extracted from `notifications` array by type (EMAIL, SMS, SLACK, WEBHOOK, PAGER_DUTY, DATADOG, OPS_GENIE, VICTOR_OPS, MICROSOFT_TEAMS, TEAM, GROUP, ORG) |\n| `tags` | Empty (Atlas alert configs have no native tags) |\n| `owner` | Empty string |\n| `lastModifiedAt` | `updated` timestamp |\n\n## Limitations\n\n- Severity is always `'unknown'` — Atlas alert configurations have no native severity concept.\n- Description is always empty — the API does not provide a description field.\n- Tags are not available — Atlas uses a different labeling model not exposed on alert configs.\n- Digest authentication requires two HTTP requests per API call (challenge + authenticated request).\n\n## License\n\nMIT\n","readmeFilename":"README.md"}