Cases Management Skill
A Case groups related alert events into one investigation unit with a status,
priority, category, and assignee. Use this skill to inspect cases and drive them
through their lifecycle (active → acknowledged → resolved → closed).
CLI Commands
| Command |
Purpose |
cx cases get <id> |
Get a single case by ID |
cx cases update <id> [--title] [--resolution-reason] |
Update mutable fields |
cx cases comment <id> --text <text> |
Add a comment to the case timeline |
cx cases assign <id> --user <email> |
Assign a case (email, or raw user ID) |
cx cases unassign <id> |
Remove the assignee |
cx cases acknowledge <id> |
Acknowledge (signals you're working it; stops re-notification) |
cx cases unacknowledge <id> |
Remove the acknowledgment |
cx cases resolve <id> --reason <text> |
Resolve a case (irreversible — see below) |
cx cases close <id> |
Close a case (terminal) |
cx cases set-priority <id> --priority <P1..P5> |
Override the computed priority |
cx cases clear-priority <id> |
Remove a priority override |
cx cases events list <case-id> |
Event timeline (status changes, comments, assignments) |
cx cases events get <event-id> |
A single event — drill in, e.g. to expand a comment thread |
cx cases notifications <case-id> [<case-id> ...] |
Notification deliveries (connector, status, time) |
Case Lifecycle
PENDING_ACTIVATION ──► ACTIVE ◄────────► ACKNOWLEDGED
│ ╲ │ ╲
│ ╲ │ ╲
▼ ╲ ▼ ╲
CLOSED ╲──► RESOLVED ◄─── (from ACK)
│
▼
CLOSED (terminal)
| From state |
Allowed transitions |
Notes |
PENDING_ACTIVATION |
→ ACTIVE |
System-driven activation; not user-controllable |
ACTIVE |
→ ACKNOWLEDGED, RESOLVED, CLOSED |
Ack is optional; for a false alarm, close directly (skip resolve) |
ACKNOWLEDGED |
→ ACTIVE, RESOLVED, CLOSED |
The only "back" transition: unacknowledge returns it to ACTIVE |
RESOLVED |
→ CLOSED only |
Irreversible — cannot reopen to ACTIVE/ACKNOWLEDGED |
CLOSED |
(none) |
Terminal |
Categories: AVAILABILITY or SECURITY. Priorities: P1 (highest) → P5.
Triage Workflow
- Inspect —
cx cases get <id>. The payload includes groupings,
labels, impactedEntities, kpiBreaches, aiSummary, and both
priorityDetails.system (computed) and priorityDetails.override (user-set).
- Investigate — Pull the underlying telemetry by querying the alert's DataPrime / PromQL to find root cause before acting.
Optionally export the investigation via
cx olly or pull the case's impactedEntities / groupings to confirm the impact.
See the cx-telemetry-querying skill.
- Claim —
cx cases assign <id> --user you@example.com then
cx cases acknowledge <id>.
- Record findings —
cx cases comment <id> --text "<note>" to leave
investigation notes on the timeline (root cause, links, next steps) as you go.
Comments appear as comment events in cx cases events list.
- Resolve or close — see below.
- Re-prioritize if impact differs from the computed value —
cx cases set-priority <id> --priority P1 / clear-priority. Only possible
while the case is still open; priority cannot be overridden once a case is
RESOLVED or CLOSED.
Resolving
Resolution is irreversible (a RESOLVED case can only move to CLOSED), so
the CLI requires both a reason and a confirmation:
- Pass
--reason "<text>" — a one-line postmortem (root cause, what fixed it,
follow-up) visible to teammates in the timeline. Use --no-reason only when a
reason genuinely doesn't apply.
- In agent / non-interactive mode, also pass
--yes; without it the command
refuses and must be handed to the user to run interactively.
If uncertain, stay in ACKNOWLEDGED (reversible via unacknowledge) until
confident. For non-resolution edits (title, post-hoc postmortem link), use
cx cases update.
Bulk Operations
There are no bulk endpoints. To act on many cases, pipe IDs through a loop, e.g.
... | jq -r '.[].id' | xargs -I {} cx cases acknowledge {}.
Key Principles
- Use emails, never user IDs — for
assign --user and in all output.
resolve is irreversible and close is terminal — confirm before resolving;
for false alarms close from ACTIVE directly.
- Always supply a resolution reason unless
--no-reason truly applies.
P1-style shorthand is accepted anywhere a priority/status/category is expected.
- Multi-profile fan-out with
-p <profile> (repeatable) for cross-environment triage.
- Link to a specific case — build
<base>/cases?id=<case_id>, where
<base> is the console URL already seen in a `View in Coralogix:
References
- Case analytics:
references/case-analytics.md
- Single case investigation:
references/single-case.md
Related Skills
cx-alerts — the alert definitions behind the events grouped into a case.
cx-slos — the SLO definitions whose breaches drive reliability cases.
cx-telemetry-querying — pivot from a case's impacted entities into logs/spans/metrics.
1---2name: cx-cases3description: >4 Triage and manage Coralogix Cases with the `cx cases` CLI — e.g. acknowledge,5 assign, resolve, or re-prioritize a case, or inspect its event timeline or6 notification deliveries.7metadata:8 source: https://skillmd.com/skills/coralogix/cx-cases9 version: "0.1.0"10---1112# Cases Management Skill1314A **Case** groups related alert events into one investigation unit with a status,15priority, category, and assignee. Use this skill to inspect cases and drive them16through their lifecycle (active → acknowledged → resolved → closed).1718## CLI Commands1920| Command | Purpose |21|---|---|22| `cx cases get <id>` | Get a single case by ID |23| `cx cases update <id> [--title] [--resolution-reason]` | Update mutable fields |24| `cx cases comment <id> --text <text>` | Add a comment to the case timeline |25| `cx cases assign <id> --user <email>` | Assign a case (email, or raw user ID) |26| `cx cases unassign <id>` | Remove the assignee |27| `cx cases acknowledge <id>` | Acknowledge (signals you're working it; stops re-notification) |28| `cx cases unacknowledge <id>` | Remove the acknowledgment |29| `cx cases resolve <id> --reason <text>` | Resolve a case (irreversible — see below) |30| `cx cases close <id>` | Close a case (terminal) |31| `cx cases set-priority <id> --priority <P1..P5>` | Override the computed priority |32| `cx cases clear-priority <id>` | Remove a priority override |33| `cx cases events list <case-id>` | Event timeline (status changes, comments, assignments) |34| `cx cases events get <event-id>` | A single event — drill in, e.g. to expand a comment thread |35| `cx cases notifications <case-id> [<case-id> ...]` | Notification deliveries (connector, status, time) |3637## Case Lifecycle3839```40PENDING_ACTIVATION ──► ACTIVE ◄────────► ACKNOWLEDGED41 │ ╲ │ ╲42 │ ╲ │ ╲43 ▼ ╲ ▼ ╲44 CLOSED ╲──► RESOLVED ◄─── (from ACK)45 │46 ▼47 CLOSED (terminal)48```4950| From state | Allowed transitions | Notes |51|---|---|---|52| `PENDING_ACTIVATION` | → `ACTIVE` | System-driven activation; not user-controllable |53| `ACTIVE` | → `ACKNOWLEDGED`, `RESOLVED`, `CLOSED` | Ack is optional; for a false alarm, `close` directly (skip `resolve`) |54| `ACKNOWLEDGED` | → `ACTIVE`, `RESOLVED`, `CLOSED` | The only "back" transition: `unacknowledge` returns it to `ACTIVE` |55| `RESOLVED` | → `CLOSED` only | **Irreversible** — cannot reopen to `ACTIVE`/`ACKNOWLEDGED` |56| `CLOSED` | (none) | **Terminal** |5758Categories: `AVAILABILITY` or `SECURITY`. Priorities: `P1` (highest) → `P5`.5960## Triage Workflow61621. **Inspect** — `cx cases get <id>`. The payload includes `groupings`,63 `labels`, `impactedEntities`, `kpiBreaches`, `aiSummary`, and both64 `priorityDetails.system` (computed) and `priorityDetails.override` (user-set).652. **Investigate** — Pull the underlying telemetry by querying the alert's DataPrime / PromQL to find root cause before acting.66 Optionally export the investigation via `cx olly` or pull the case's `impactedEntities` / `groupings` to confirm the impact. 67 See the `cx-telemetry-querying` skill.683. **Claim** — `cx cases assign <id> --user you@example.com` then69 `cx cases acknowledge <id>`.704. **Record findings** — `cx cases comment <id> --text "<note>"` to leave71 investigation notes on the timeline (root cause, links, next steps) as you go.72 Comments appear as `comment` events in `cx cases events list`.735. **Resolve or close** — see below.746. **Re-prioritize** if impact differs from the computed value —75 `cx cases set-priority <id> --priority P1` / `clear-priority`. Only possible76 while the case is still open; priority cannot be overridden once a case is77 `RESOLVED` or `CLOSED`.7879### Resolving8081Resolution is **irreversible** (a `RESOLVED` case can only move to `CLOSED`), so82the CLI requires both a reason and a confirmation:8384- Pass `--reason "<text>"` — a one-line postmortem (root cause, what fixed it,85 follow-up) visible to teammates in the timeline. Use `--no-reason` only when a86 reason genuinely doesn't apply.87- In agent / non-interactive mode, also pass `--yes`; without it the command88 refuses and must be handed to the user to run interactively.8990If uncertain, stay in `ACKNOWLEDGED` (reversible via `unacknowledge`) until91confident. For non-resolution edits (title, post-hoc postmortem link), use92`cx cases update`.9394## Bulk Operations9596There are no bulk endpoints. To act on many cases, pipe IDs through a loop, e.g.97`... | jq -r '.[].id' | xargs -I {} cx cases acknowledge {}`.9899## Key Principles100101- **Use emails, never user IDs** — for `assign --user` and in all output.102- **`resolve` is irreversible and `close` is terminal** — confirm before resolving;103 for false alarms `close` from `ACTIVE` directly.104- **Always supply a resolution reason** unless `--no-reason` truly applies.105- **`P1`-style shorthand** is accepted anywhere a priority/status/category is expected.106- **Multi-profile fan-out** with `-p <profile>` (repeatable) for cross-environment triage.107- **Link to a specific case** — build `<base>/cases?id=<case_id>`, where108 `<base>` is the console URL already seen in a `View in Coralogix:109 <base>/...` line printed by any `cx cases` command this session — never110 fabricate `<base>` yourself.111112## References113114- Case analytics: [`references/case-analytics.md`](references/case-analytics.md)115- Single case investigation: [`references/single-case.md`](references/single-case.md)116117## Related Skills118119- **`cx-alerts`** — the alert definitions behind the events grouped into a case.120- **`cx-slos`** — the SLO definitions whose breaches drive reliability cases.121- **`cx-telemetry-querying`** — pivot from a case's impacted entities into logs/spans/metrics.