API Reference
Hanzo O11y API
Hanzo O11y provides unified observability with logs, metrics, and traces
Hanzo O11y provides unified observability with logs, metrics, and traces
Hanzo O11y API · Guide & examples → · All API references →
| Base URL | https://o11y.hanzo.ai |
| Version | 1.0.0 |
| Operations | 30 |
| Guide | Hanzo O11y API guide |
Authentication
bearerAuth— HTTP bearerBearerAuth— HTTP bearer
All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions.
curl -H "Authorization: Bearer $HANZO_API_KEY" https://o11y.hanzo.aiEndpoints
Alerts
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/o11y/rules | List alert rules |
POST | /v1/o11y/rules | Create alert rule |
GET | /v1/o11y/rules/{id} | Get alert rule |
PUT | /v1/o11y/rules/{id} | Update alert rule |
DELETE | /v1/o11y/rules/{id} | Delete alert rule |
GET | /v1/o11y/channels | List notification channels |
POST | /v1/o11y/channels | Create notification channel |
PUT | /v1/o11y/channels/{id} | Update notification channel |
DELETE | /v1/o11y/channels/{id} | Delete notification channel |
Dashboards
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/o11y/dashboards | List dashboards |
POST | /v1/o11y/dashboards | Create dashboard |
GET | /v1/o11y/dashboards/{uid} | Get dashboard |
PUT | /v1/o11y/dashboards/{uid} | Update dashboard |
DELETE | /v1/o11y/dashboards/{uid} | Delete dashboard |
Logs
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/o11y/logs/query | Instant LogQL query |
GET | /v1/o11y/logs/query_range | Range LogQL query |
GET | /v1/o11y/logs/labels | List log labels |
GET | /v1/o11y/logs/labels/{name}/values | Get label values |
POST | /v1/o11y/logs/push | Push log entries |
GET | /v1/o11y/logs/tail | Live tail logs (WebSocket) |
Metrics
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/o11y/query | Instant PromQL query |
GET | /v1/o11y/query_range | Range PromQL query |
GET | /v1/o11y/series | Find series by label matchers |
GET | /v1/o11y/labels | List metric label names |
GET | /v1/o11y/label/{name}/values | Get metric label values |
Traces
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/o11y/traces | Search traces |
GET | /v1/o11y/traces/{traceId} | Get trace by ID |
GET | /v1/o11y/services | List traced services |
GET | /v1/o11y/services/{name}/operations | List service operations |
GET | /v1/o11y/dependencies | Get service dependency graph |
How is this guide?