cursor-plugin/viet-k-connect/skills/vkc-datadog-observability/SKILL.md
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)
npx skillsauth add LEE-SANG-BOK/VKC-2- vkc-datadog-observabilityInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Always pair with $vkc-repo-guardrails. For MCP connection issues, also use Cursor plugin skill ddsetup / ddconfig.
| 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) |
plugin-datadog-datadog only (never duplicate manual ~/.cursor/mcp.json datadog entries).DD_MCP_DOMAIN=mcp.us5.datadoghq.com (org: infoflowpartners).not-setup.npm run qa:datadog:preflight
npm run qa:monitoring:config
MONITORING_STRICT=true npm run qa:monitoring:config:strict
datadog.mcp.session.starts).search_datadog_monitors — alert/no-data monitors.aggregate_events or search_datadog_logs — only if log indexes exist.get_datadog_metric — route/API error metrics for service:viet-k-connect.OPEN_LOOPS.md (cloud automations: REPORT ONLY).| 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.
sanitizeDatadogTags() from src/lib/observability/datadog-config.ts..codex/skills/vkc-datadog-observability/references/runbook.md.codex/skills/vkc-datadog-observability/references/mcp-queries.mddocs/ops/datadog-observability-runbook.mddocs/ops/ci_monitoring_gate_contract.mdconfig/ops/datadog/monitors-contract.jsondevelopment
Build step-based wizard UIs (step UI, fixed bottom CTA with safe-area, localStorage draft save, runtime validation, submit event logging). Use for visa assessment, doc generation, admin queue inputs. (키워드= 위저드, 단계형 폼, 멀티스텝, 하단 고정 CTA, draft 저장, 제출 로그)
development
Design and implement the Viet K-Connect visa assessment engine (DB-driven ruleset JSON schema + versioning + effective dates). No hardcoded rules in code. Use for building /api/visa/assess and admin ruleset management. (키워드= 비자 평가, 룰셋, 규칙 엔진, DB-driven, 버전/적용일, /api/visa/assess)
testing
Run a VKC UX expert audit (Nielsen-style heuristic review + mobile-first flow check) and produce a prioritized issue list with severity and fixes. (키워드= UX 감사, 휴리스틱, 모바일 QA, 접근성, 사용성)
data-ai
Route VKC tasks to the correct domain skill from manifest.json. Always start with guardrails, shared-memory-router, loop-supervisor; then pick one domain skill by path/task keywords. (키워드=skill router, manifest, domain skill, which skill)