Skip to content
Console
Menu

Getting Started

Authentication

KV Store

sylphx observability traces

Every sylphx observability traces command: its argument, its flags and a run line.

This method is not served on the public API. api.sylphx.com does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

The traces commands of Sylphx Observability, as the CLI spells them: the same calls as the traces API page, typed for the shell. Install, sign in and the grammar are on the CLI index.

#get

Gets a trace.

NAME — the resource's name; a bare id is enough below the linked project.

CLI

Shell
sylphx observability traces get orgs/acme/projects/shop/envs/production/traces/trace

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/traces/trace · scope observability:read · effect read · Request, response and examples

#write-spans

Ingests a batch of spans atomically; a span's parent and time invariants are validated. Replay rules are those of WriteLogEntries.

NAME — the resource's name; a bare id is enough below the linked project.

CLI

Shell
sylphx observability traces write-spans orgs/acme/projects/shop/envs/production

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/traces:writeSpans · scope observability:ingest · effect write · Request, response and examples

Flags

FlagTypeWhat it does
--spansjsonThe spans, at most 1000. Required. Repeat the flag for each value.

#query

Queries the environment's traces over a bounded interval, returning summaries without spans.

NAME — the resource's name; a bare id is enough below the linked project.

CLI

Shell
sylphx observability traces query orgs/acme/projects/shop/envs/production

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/traces:query · scope observability:read · effect read · Request, response and examples

Flags

FlagTypeWhat it does
--filterstringAIP-160 filter over the typed, allowlisted fields.
--start-timetimestampThe interval start; required, at most 31 days before end_time. Required.
--end-timetimestampThe interval end; default now.
--order-bystringtime desc (default) or time asc.
--page-sizeintAt most this many; default 100, clamped to 1000.
--page-tokenstringnext_page_token of the previous page; bound to tenant, interval, filter, and order.