---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Log entries"
description: "The `log_entries` collection of Sylphx Observability: A Log Entry is one typed, bounded log record of a project environment, correlated to a trace."
type: reference
product: monitoring
summary: "A Log Entry is one typed, bounded log record of a project environment, correlated to a trace."
updated: 2026-09-28
order: 900
---

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

A Log Entry is one typed, bounded log record of a project environment, correlated to a trace. Entries are immutable; ingest is idempotent per batch.

**Service** Sylphx Observability · **Resource type** `observability.sylphx.com/LogEntry` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/log_entries/{log_entry}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/log_entries/{log_entry}`. |
| `uid` | `string` | `log_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `log_time` | `timestamp` | When the event happened. Required. |
| `severity` | `LogSeverity` | The severity. Required. One of `trace`, `debug`, `info`, `warn`, `error`, `fatal`. |
| `body` | `string` | The message. Required. |
| `service_name` | `string` | The emitting service, for example `checkout-api`. |
| `attributes` | `map<string, string>` | Typed attributes, at most 64. |
| `trace_id` | `string` | W3C trace id (32 hex). |
| `span_id` | `string` | W3C span id (16 hex). |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/log_entries#get) | Gets a log entry. |
| `POST` | [`write`](/docs/api/log_entries#write) | Ingests a batch of log entries atomically. The same `Idempotency-Key` and digest replays the same batch; a different digest under the key conflicts. |
| `POST` | [`query`](/docs/api/log_entries#query) | Queries the environment's log entries over a bounded interval; follow a trace with `trace_id = "..."`. |

## get

Gets a log entry.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/log_entries/log-entry` · scope `observability:read` · effect `read` · [Request, response and examples](/docs/api/log_entries/get)

## write

Ingests a batch of log entries atomically. The same `Idempotency-Key` and digest replays the same batch; a different digest under the key conflicts.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/log_entries:write` · scope `observability:ingest` · effect `write` · [Request, response and examples](/docs/api/log_entries/write)

## query

Queries the environment's log entries over a bounded interval; follow a trace with `trace_id = "..."`.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/log_entries:query` · scope `observability:read` · effect `read` · [Request, response and examples](/docs/api/log_entries/query)