---
# @generated by sylphx-gen. Do not edit.
title: "sylphx observability traces"
description: "The sylphx observability traces commands of Sylphx Observability: every verb, with its argument, its flags and a run line."
type: reference
product: monitoring
summary: "Every sylphx observability traces command: its argument, its flags and a run line."
updated: 2026-09-28
nav: false
---

> **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](/docs/api/traces), typed for the
shell. [Install, sign in and the grammar](/docs/cli) are on the CLI index.

## get

Gets a trace.

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

**CLI**

```bash
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](/docs/api/traces/get)

## 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**

```bash
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](/docs/api/traces/write_spans)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--spans` | `json` | The 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**

```bash
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](/docs/api/traces/query)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--filter` | `string` | AIP-160 filter over the typed, allowlisted fields. |
| `--start-time` | `timestamp` | The interval start; required, at most 31 days before `end_time`. Required. |
| `--end-time` | `timestamp` | The interval end; default now. |
| `--order-by` | `string` | `time desc` (default) or `time asc`. |
| `--page-size` | `int` | At most this many; default 100, clamped to 1000. |
| `--page-token` | `string` | `next_page_token` of the previous page; bound to tenant, interval, filter, and order. |