# Sentry

Error and log troubleshooting on Sentry — issues, error events, structured logs, traces, alerts, detectors, and cron monitors, with issue triage and alert management.

Run these through `omni-cli` once a human has connected the platform (`omni-cli sentry login`). Full parameter and output schemas come from `omni-cli discovery sentry`.

## alerts

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry alert create` | Create an alert (notification workflow) wired to detectors. | write |
| `omni-cli sentry alert get` | Get one alert's triggers, action filters, connected detectors, and last-triggered time. | read |
| `omni-cli sentry alert list` | List alerts (notification workflows) with their triggers and enabled state (discovers alert ids). | read |
| `omni-cli sentry alert update` | Edit an alert — triggers, actions, detectors, or enabled state (enable/disable lives here). | write |

## crons

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry cron get` | Get one cron monitor's schedule config, environments, and status. | read |
| `omni-cli sentry cron list` | List cron monitors with status and mute state (discovers cron slugs). | read |
| `omni-cli sentry cron list-checkins` | List a cron monitor's check-ins — status, duration, and expected time ("why did this cron alert" evidence). | read |
| `omni-cli sentry cron update` | Edit a cron monitor — mute a noisy one, disable it, or change its schedule config. | write |

## discovery

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry environment list` | List an organization's environments (names used by environment filters). | read |
| `omni-cli sentry org list` | List organizations visible to the token (discovers org slugs). | read |
| `omni-cli sentry project list` | List an organization's projects (discovers project slugs). | read |
| `omni-cli sentry tag list` | List tag keys available for query building (discovers tag keys). | read |

## errors

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry event aggregate` | Error-rate timeseries — spot spikes and regressions, optionally grouped into top-N series. | read |
| `omni-cli sentry event search` | Query error events in table format — select columns and aggregates (count(), count_unique(user)) across all errors. | read |

## issues

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry issue get` | Get one issue's full detail — stats, releases first/last seen in, assignee, and counts. | read |
| `omni-cli sentry issue get-event` | Get one error event with stacktrace, breadcrumbs, contexts, and tags — the root-cause payload. | read |
| `omni-cli sentry issue get-tag` | Get one tag's value distribution on an issue (which release/browser/user segment is affected). | read |
| `omni-cli sentry issue list` | List issues (grouped errors) with counts and status — the error-triage entry point (discovers issue ids). | read |
| `omni-cli sentry issue list-events` | List the error events grouped into an issue (discovers event ids; full=true includes stacktraces). | read |
| `omni-cli sentry issue update` | Triage an issue — resolve, unresolve, or ignore; assign; set priority. Only submitted fields change. | write |

## logs

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry log aggregate` | Log volume timeseries — track level/severity trends over a window, optionally grouped. | read |
| `omni-cli sentry log search` | Search structured log events in table format (Sentry Logs). | read |

## monitors

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry monitor create` | Create a detector (monitor) for a project. | write |
| `omni-cli sentry monitor get` | Get one detector's condition group, data sources, connected alerts, and latest triggered group. | read |
| `omni-cli sentry monitor list` | List detectors (metric/error monitors) with their conditions and enabled state (discovers detector ids). | read |
| `omni-cli sentry monitor update` | Edit a detector — conditions, config, or enabled state (enable/disable lives here). | write |

## releases

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry release list` | List releases newest-first ("which release introduced this" context). | read |

## traces

| Command | What it does | Kind |
|---|---|---|
| `omni-cli sentry trace get` | Get the spans and errors that make up one trace (follow an error event's contexts.trace.trace_id). | read |