# Axiom

Log and error analytics on Axiom — APL queries over event datasets, MPL metrics queries, and dataset, monitor, and notifier management.

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

## datasets

| Command | What it does | Kind |
|---|---|---|
| `omni-cli axiom dataset create` | Create a dataset. | write |
| `omni-cli axiom dataset get` | Get one dataset. | read |
| `omni-cli axiom dataset list` | List datasets — the containers APL queries read from (discovers dataset names and ids; also the login validation call). | read |
| `omni-cli axiom dataset update` | Update a dataset's description (the only updatable field). | write |

## metrics

| Command | What it does | Kind |
|---|---|---|
| `omni-cli axiom metric query` | Run an MPL (Metrics Processing Language) query over OpenTelemetry metrics — error-rate, latency-percentile, throughput, CPU/memory time series. Edge-only, pass --host with your edge-deployment domain on every call. | read |

## monitors

| Command | What it does | Kind |
|---|---|---|
| `omni-cli axiom monitor create` | Create an alerting monitor over query results (APL for log/event alerts, MPL for metric alerts). | write |
| `omni-cli axiom monitor delete` | Delete a monitor (configuration only — no event data is lost). | write |
| `omni-cli axiom monitor get` | Get one monitor. | read |
| `omni-cli axiom monitor history` | Get a monitor's check history — how it has evaluated over time (spot trends and anomalies, confirm whether an alert fired). | read |
| `omni-cli axiom monitor list` | List alerting monitors with their current configuration. | read |
| `omni-cli axiom monitor update` | Update a monitor — PUT replaces the whole monitor, so fetch it with monitor.get first and send every field you want to keep. | write |

## alerts

| Command | What it does | Kind |
|---|---|---|
| `omni-cli axiom notifier create` | Create a notifier monitors can alert through. | write |
| `omni-cli axiom notifier delete` | Delete a notifier (configuration only — monitors referencing it stop alerting through it). | write |
| `omni-cli axiom notifier get` | Get one notifier. | read |
| `omni-cli axiom notifier list` | List notifiers — the notification targets (Slack, email, PagerDuty, Opsgenie, webhook, ...) monitors alert through. | read |
| `omni-cli axiom notifier update` | Update a notifier — PUT replaces it, so send both name and properties. | write |

## logs

| Command | What it does | Kind |
|---|---|---|
| `omni-cli axiom query run` | Run an APL query across one or more datasets and return a tabular result (the monitoring and troubleshooting entry point for logs, errors, and traces). | read |