Deployments.ai Docs
Command reference

deployments observability

Hot observability metrics, tools, and exports

CommandSummary
deployments observability metricsShow trace or model metrics by time bucket, optionally grouped
deployments observability toolsShow tool calls, errors, and latency
deployments observability exportExport 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 (SDK getObservabilityMetrics).
  • Needs an organization: --org or the saved context.
  • Paginated. --page-size sets the page size; pass the returned cursor as --cursor for the next page.
FlagTypeRequiredDefaultDescription
--cursorstring (cursor)Pagination cursor
--page-sizestring (number)Page size
--fromstringStart of the bounded window (RFC 3339)
--tostringEnd of the bounded window (RFC 3339)
--intervalstringBucket width: hour or day
--group-bystringGroup 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 (SDK getObservabilityToolMetrics).
  • Needs an organization: --org or the saved context.
  • Paginated. --page-size sets the page size; pass the returned cursor as --cursor for the next page.
FlagTypeRequiredDefaultDescription
--cursorstring (cursor)Pagination cursor
--page-sizestring (number)Page size
--fromstringStart of the bounded window (RFC 3339)
--tostringEnd of the bounded window (RFC 3339)
--deploymentstringOnly 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
FlagTypeRequiredDefaultDescription
--limitstringMaximum exported traces

Also accepts the global flags.

On this page