/log-check

name: log-check
description: Investigate logs in ELK — time window, KQL, error patterns, redacted samples, correlation, report. Primary log-ops skill. Evidence-only.
user-invocable: true
argument-hint: "<service or symptom> [--env prod] [--since 1h] [--level ERROR] [@paste-or-export]"

/log-check — Log Investigation

Examples

/log-check booking-api --env prod --since 1h --level ERROR
/log-check "timeout payment" --since 30m
/log-check booking-api @logs-sample.ndjson

Process

1. Frame

Symptom, service, env, window, timezone, data view (or TBD), available paste?

2. Query plan (READ-ONLY)

service.name: "{{service}}" and env: "{{env}}" and log.level: error

Refine with symptom keywords. See `@references/kql-cheat.md`.

3. Analyze evidence only

Timeline, top patterns (`log-patterns.md`), ≤10 redacted samples, deploy window, correlate metrics/deps.

4. Conclude

Findings, ranked hypotheses, READ-ONLY next steps, MUTATIVE human-only options, escalate if user-facing impact.

5. Output

Chat summary always; optional L1 save → `docs/ops/elk/log-checks/{id}.md`

Definition of done

See `ELK-BRAIN.md` — query, evidence, hypothesis, next step.

Output template

`@_templates/log-check-report.md`

Rules

• No invented counts/stacks; redact secrets; no delete-index “fixes”
• @.claude/rules/elk-conventions.md
• @.claude/rules/approval-gate.md