Command reference
deployments observability
Hot observability metrics, tools, and exports
| Command | Summary |
|---|---|
deployments observability metrics | Show trace or model metrics by time bucket, optionally grouped |
deployments observability tools | Show tool calls, errors, and latency |
deployments observability export | Export a bounded recent trace set |
deployments observability metrics
Show trace or model metrics by time bucket, optionally grouped.
deployments observability metrics- Calls
GET /v1/observability/metrics(SDKgetObservabilityMetrics). - Needs an organization:
--orgor the saved context. - Paginated.
--page-sizesets the page size; pass the returned cursor as--cursorfor the next page.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--cursor | string (cursor) | Pagination cursor | ||
--page-size | string (number) | Page size | ||
--from | string | Start of the bounded window (RFC 3339) | ||
--to | string | End of the bounded window (RFC 3339) | ||
--interval | string | Bucket width: hour or day | ||
--group-by | string | Group by agentDefinitionId, agentDeploymentId, agentReleaseId, model, or provider |
Also accepts the global flags.
deployments observability tools
Show tool calls, errors, and latency.
deployments observability tools- Calls
GET /v1/observability/tools(SDKgetObservabilityToolMetrics). - Needs an organization:
--orgor the saved context. - Paginated.
--page-sizesets the page size; pass the returned cursor as--cursorfor the next page.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--cursor | string (cursor) | Pagination cursor | ||
--page-size | string (number) | Page size | ||
--from | string | Start of the bounded window (RFC 3339) | ||
--to | string | End of the bounded window (RFC 3339) | ||
--deployment | string | Only tool calls of this agent deployment's runs |
Also accepts the global flags.
deployments observability export
Export a bounded recent trace set.
deployments observability export- Calls
POST /v1/observability/exports(SDKcreateObservabilityExport). - Needs an organization:
--orgor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--limit | string | Maximum exported traces |
Also accepts the global flags.