# PostHog

Log search and error tracking on PostHog — OpenTelemetry log search and discovery, error-issue triage (search, update, assign, merge, split, bulk), routing and mute rules, linked external tickets, and the project audit log.

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

## audit

| Command | What it does | Kind |
|---|---|---|
| `omni-cli posthog audit list` | Project activity log — who changed what and when (correlate incidents with config changes). | read |

## issues

| Command | What it does | Kind |
|---|---|---|
| `omni-cli posthog grouping list` | List error grouping signatures — which exception shapes map to which issue (feeds issue.split). | read |
| `omni-cli posthog issue assign` | Assign an issue to a user or role (or unassign it). | write |
| `omni-cli posthog issue bulk-update` | Set status or assignee on many issues at once. | write |
| `omni-cli posthog issue get` | Get one error issue, including its linked external tickets and cohort. | read |
| `omni-cli posthog issue list-events` | Sampled exception events for an issue (stack traces via verbosity=stack). | read |
| `omni-cli posthog issue merge` | Merge duplicate issues into one surviving issue. | write |
| `omni-cli posthog issue search` | Search error issues with filters and aggregates (the triage entry point). | read |
| `omni-cli posthog issue split` | Split grouping signatures out of an issue into new issues (fixes over-grouping). | write |
| `omni-cli posthog issue update` | Update an issue's status (resolve, reopen, or suppress/mute it), name, or description. | write |

## logs

| Command | What it does | Kind |
|---|---|---|
| `omni-cli posthog log list-attributes` | Discover attribute keys present on logs (for building log.search filters). | read |
| `omni-cli posthog log list-services` | Per-service log volumes and error rates in a window (finds the noisy service). | read |
| `omni-cli posthog log list-values` | Distinct values observed for a log attribute key (with occurrence counts). | read |
| `omni-cli posthog log search` | Search OpenTelemetry log entries by text, severity, service, time window, and attribute filters. | read |

## muting

| Command | What it does | Kind |
|---|---|---|
| `omni-cli posthog mute-rule create` | Create a mute rule — matching exception events are dropped at ingestion (use for confirmed noise only). | write |
| `omni-cli posthog mute-rule delete` | Delete a mute rule so matching exception events are ingested again. | write |
| `omni-cli posthog mute-rule list` | List mute rules — matching exception events are dropped at ingestion (explains missing errors/alerts). | read |

## discovery

| Command | What it does | Kind |
|---|---|---|
| `omni-cli posthog org list` | List organizations visible to the API key (discovers organization ids; needs an org-wide key — project-scoped keys get permission_denied). | read |
| `omni-cli posthog project list` | List an organization's projects (discovers the project-id every other action needs; needs an org-wide key — project-scoped keys get permission_denied and pass project-id directly). | read |

## routing

| Command | What it does | Kind |
|---|---|---|
| `omni-cli posthog routing-rule create` | Create a rule that auto-assigns matching new error issues to a user or role. | write |
| `omni-cli posthog routing-rule delete` | Delete an issue-routing rule. | write |
| `omni-cli posthog routing-rule list` | List rules that auto-assign matching new error issues to a user or role. | read |

## tickets

| Command | What it does | Kind |
|---|---|---|
| `omni-cli posthog ticket create` | File a ticket in a connected tracker (GitHub/GitLab/Linear/Jira) and link it to an error issue. | write |
| `omni-cli posthog ticket list` | List external tickets (GitHub/GitLab/Linear/Jira) linked to error issues. | read |