# Event

URL: https://docs.hanzo.ai/docs/cli/event

> The `hanzo event` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/event) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/event) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Product analytics: send an event, read back who did what.

[API reference →](https://docs.hanzo.ai/docs/openapi/event)

```bash
hanzo event top
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                  | What it does                                                                          |
| ------------------------ | ------------------------------------------------------------------------------------- |
| `hanzo event create`     | Capture product events into your org's warehouse                                      |
| `hanzo event errors`     | Returns the caller org's most recently captured errors, newest first.                 |
| `hanzo event health`     | Reports whether the event plane can take a write and the warehouse can answer a read. |
| `hanzo event overview`   | Returns the caller org's analytics KPIs for one time window.                          |
| `hanzo event replay`     | Record a session-replay snapshot batch                                                |
| `hanzo event tag.js`     | The Hanzo event tag — the one-line install for a surface with no bundler              |
| `hanzo event timeseries` | Returns the caller org's LLM usage over time as an evenly-spaced series.              |
| `hanzo event top`        | Returns the caller org's ranked lenses for one window, five of them at once.          |

### Insights

| Command                       | What it does                                                       |
| ----------------------------- | ------------------------------------------------------------------ |
| `hanzo event insights events` | Returns the caller org's most recent product events, newest first. |
| `hanzo event insights health` | Reports that the unified insights surface is serving.              |