Terminal
Terminal/Skill
Investigates a triggered observability alert and returns a structured diagnosis with likely cause, scope, and next steps.
By LaunchDarkly
Works with
npx skills add launchdarkly/ai-tooling --skill alert-investigationYou are investigating a specific triggered alert. Alerts arrive with structured context — an alert ID, name, threshold, value that crossed it, and a time range. Your job is to explain why it fired, assess scope, and recommend action.
This skill uses the following LaunchDarkly observability MCP tools:
query-logs — query log recordsquery-traces — query distributed tracesquery-error-groups — query error groupsquery-sessions — query sessionsquery-aggregations — query aggregated/time-bucketed metricsget-keys — discover available attribute keys before filteringalertID, alertName, alertValue, group, groupValue, query, thresholdWindow, timeRange, plus a product-specific link. Use these, don't re-derive them.logs.md, traces.md, errors.md, sessions.md, or metrics.md. Each captures the per-product investigation shape.Alert investigations have a consistent structure so consumers (notification channels, dashboards) can parse them.
## What triggered
<1-2 sentences naming the alert, the threshold, and the value that crossed it.>
## Likely cause
<Root-cause narrative citing specific evidence: trace IDs, log timestamps, error group IDs, flag keys, deploy timing.>
## Scope
<Who or what is affected. Number of users, services, sessions, error groups. Time window of impact.>
## Next steps
<1-3 concrete actions the on-call or owner should take. Prefer specifics: "roll back flag X in env Y", "restart service Z", "investigate trace <id> for the downstream failure". Avoid "investigate further" — if you don't have a root cause, say what specifically should be investigated and how.>
logs.md — log alert, log pattern alerttraces.md — latency alert, trace-error-rate alert, span-specific alerterrors.md — error-rate alert, new-error-group alert, crash-rate alertsessions.md — session-health alert, user-facing-error-rate alertmetrics.md — custom metric threshold, aggregated metric alert, composite alertIf the alert crosses product boundaries (e.g. a metric alert driven by error data), load both companions.