By name: vkc-datadog-observability description: Datadog observability workflow for VKC — MCP triage (plugin-datadog-datadog), env/instrumentation setup, monitor contract, and privacy-safe logging. Use when debugging production issues, setting up Datadog, investigating errors/metrics/traces, or running observability automations. (키워드= Datadog, observability, MCP, us5, 모니터, 로그, 트레이스, APM, DD_API_KEY) metadata: short-description: Datadog MCP + runtime observability
VKC Datadog Observability
Always pair with $vkc-repo-guardrails. For MCP connection issues, also use Cursor plugin skill ddsetup / ddconfig.
Three layers (do not confuse)
| Layer | Where | Purpose |
|---|---|---|
| Cursor MCP | plugin-datadog-datadog + .cursor/settings.json |
Agent queries logs/metrics/monitors without browser |
| Runtime telemetry | Vercel env | App errors/traces/metrics in Datadog org |
| Monitor contract | config/ops/datadog/monitors-contract.json |
Required alert surfaces (operator creates monitors in UI) |
MCP rules
- Server id:
plugin-datadog-datadogonly (never duplicate manual~/.cursor/mcp.jsondatadog entries). - Site: US5 →
DD_MCP_DOMAIN=mcp.us5.datadoghq.com(org: infoflowpartners). - Cloud automations do not inherit local MCP OAuth — set Plugins Domain on cursor.com if cloud shows
not-setup.
Commands
npm run qa:datadog:preflight
npm run qa:monitoring:config
MONITORING_STRICT=true npm run qa:monitoring:config:strict
MCP triage sequence (interactive / automation)
- Confirm MCP connected (search dashboards or metric
datadog.mcp.session.starts). search_datadog_monitors— alert/no-data monitors.aggregate_eventsorsearch_datadog_logs— only if log indexes exist.get_datadog_metric— route/API error metrics forservice:viet-k-connect.- Append findings to
OPEN_LOOPS.md(cloud automations: REPORT ONLY).
Runtime env (Vercel / GitHub)
| Variable | Required | Default |
|---|---|---|
DD_API_KEY or DATADOG_API_KEY |
yes for telemetry | — |
DD_SITE |
recommended | us5.datadoghq.com |
DD_SERVICE |
recommended | viet-k-connect |
DD_ENV |
recommended | production / preview / development |
DD_VERSION |
optional | Vercel commit sha |
DD_MCP_DOMAIN |
Cursor only | mcp.us5.datadoghq.com |
[!WARNING] Vercel APM 불가, infra-only. APM is disabled. Use Sentry + Analytics for traces.
Privacy (non-negotiable)
- Never log passport, ARC, student ID, phone, private email, raw verification evidence.
- Use
sanitizeDatadogTags()fromsrc/lib/observability/datadog-config.ts. - E2E/synthetic traffic must not pollute production dashboards.
References
- Runbook:
.codex/skills/vkc-datadog-observability/references/runbook.md - MCP queries:
.codex/skills/vkc-datadog-observability/references/mcp-queries.md - Ops contract:
docs/ops/datadog-observability-runbook.md - CI gate:
docs/ops/ci_monitoring_gate_contract.md - Monitor SoT:
config/ops/datadog/monitors-contract.json