API Reference
Complete endpoint reference for the Observability API. All endpoints require JWT authentication and X-Tenant-ID header. The service runs on port 8088. Most endpoints return reactive Mono types.
Metrics
| Method | Path | Description |
|---|---|---|
POST | /api/v1/observability/metrics/query | Execute custom PromQL query |
GET | /api/v1/observability/metrics | List available metrics |
GET | /api/v1/observability/metrics/:metricName | Get pre-defined metric |
GET | /api/v1/observability/metrics/request-rate | Service request rates |
GET | /api/v1/observability/metrics/error-rate | Service error rates |
GET | /api/v1/observability/metrics/latency | Service latency percentiles |
GET | /api/v1/observability/metrics/overview | Metrics overview dashboard |
Logs
| Method | Path | Description |
|---|---|---|
POST | /api/v1/observability/logs | Query logs with filters |
GET | /api/v1/observability/logs | Query logs via query params |
GET | /api/v1/observability/logs/recent | Get recent logs |
GET | /api/v1/observability/logs/errors | Get error logs |
GET | /api/v1/observability/logs/services | List services with logs |
GET | /api/v1/observability/logs/levels | List log levels |
Tracing
| Method | Path | Description |
|---|---|---|
POST | /api/v1/observability/traces/search | Search traces |
GET | /api/v1/observability/traces/:traceId | Get trace by ID |
GET | /api/v1/observability/traces/dependencies | Service dependencies |
GET | /api/v1/observability/traces/correlate/:traceId | Correlated observability |
Dashboards
| Method | Path | Description |
|---|---|---|
GET | /api/v1/observability/dashboards/templates | List templates |
POST | /api/v1/observability/dashboards | Create dashboard |
GET | /api/v1/observability/dashboards/:dashboardId | Get dashboard |
PUT | /api/v1/observability/dashboards/:dashboardId | Update dashboard |
DELETE | /api/v1/observability/dashboards/:dashboardId | Delete dashboard |
GET | /api/v1/observability/dashboards/tenants/:tenantId | List tenant dashboards |
Alerting
| Method | Path | Description |
|---|---|---|
POST | /api/v1/observability/alerts/rules | Create alert rule |
GET | /api/v1/observability/alerts/rules | List alert rules |
PUT | /api/v1/observability/alerts/rules/:ruleId | Update alert rule |
DELETE | /api/v1/observability/alerts/rules/:ruleId | Delete alert rule |
GET | /api/v1/observability/alerts/active | List active alerts |
POST | /api/v1/observability/alerts/:alertId/acknowledge | Acknowledge alert |
POST | /api/v1/observability/alerts/:alertId/resolve | Resolve alert |
GET | /api/v1/observability/alerts/history | Alert history |
SLOs
| Method | Path | Description |
|---|---|---|
POST | /api/v1/observability/slos | Create SLO |
GET | /api/v1/observability/slos | List SLOs |
GET | /api/v1/observability/slos/:sloId | Get SLO |
PUT | /api/v1/observability/slos/:sloId | Update SLO |
DELETE | /api/v1/observability/slos/:sloId | Delete SLO |
GET | /api/v1/observability/slos/:sloId/status | Get SLO status |
GET | /api/v1/observability/slos/dashboard | SLO dashboard |
Anomaly Detection
| Method | Path | Description |
|---|---|---|
POST | /api/v1/observability/anomalies/configs | Configure detection |
GET | /api/v1/observability/anomalies/configs | List configurations |
GET | /api/v1/observability/anomalies/active | Active anomalies |
GET | /api/v1/observability/anomalies/report | Anomaly report |
Capacity Planning
| Method | Path | Description |
|---|---|---|
GET | /api/v1/observability/capacity/utilization | Resource utilization |
GET | /api/v1/observability/capacity/forecast | Capacity forecast |
POST | /api/v1/observability/capacity/plans | Create capacity plan |
Cost Allocation
| Method | Path | Description |
|---|---|---|
GET | /api/v1/observability/costs/allocation | Cost allocation report |
GET | /api/v1/observability/costs/optimization | Optimization recommendations |
GET | /api/v1/observability/costs/budgets | List cost budgets |
POST | /api/v1/observability/costs/budgets | Create cost budget |
GET | /api/v1/observability/costs/trends | Cost trends |
Custom Metrics
| Method | Path | Description |
|---|---|---|
POST | /api/v1/observability/custom-metrics | Register custom metric |
GET | /api/v1/observability/custom-metrics | List custom metrics |
GET | /api/v1/observability/custom-metrics/:metricName | Get metric definition |
DELETE | /api/v1/observability/custom-metrics/:metricName | Delete custom metric |
POST | /api/v1/observability/custom-metrics/:metricName/data | Record data |
GET | /api/v1/observability/custom-metrics/:metricName/query | Query data |
Profiling
| Method | Path | Description |
|---|---|---|
POST | /api/v1/observability/profiling/start | Start profile |
GET | /api/v1/observability/profiling/:profileId | Get profile results |
GET | /api/v1/observability/profiling/compare | Compare profiles |
POST | /api/v1/observability/profiling/continuous | Enable continuous profiling |
GET | /api/v1/observability/profiling/history | Profile history |