> ## Documentation Index
> Fetch the complete documentation index at: https://www.adaline.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Log traces

# LogTracesClient

`adaline.logs.traces` searches traces with typed column filters — status, time window, name, attributes — and retroactively patches a trace's status, tags, or attributes after it has already been flushed.

## Access

```typescript theme={null}
import { Adaline } from '@adaline/client';

const adaline = new Adaline();
const traces = adaline.logs.traces; // LogTracesClient
```

The class is also exported directly:

```typescript theme={null}
import { LogTracesClient } from '@adaline/client';
```

Types from `@adaline/api`:

```typescript theme={null}
import type {
  SearchLogTracesRequest,
  SearchTracesResponse,
  UpdateLogTraceRequest,
} from '@adaline/api';
```

***

## search()

Paginated trace search with typed filter objects. Returns full trace metadata filtered by the provided filters — more expressive than [`logs.list`](/docs/reference/sdk/v2/typescript/classes/logs#list) because filters are typed column predicates rather than JSON-encoded strings.

```typescript theme={null}
search(options: { query: SearchLogTracesRequest }): Promise<SearchTracesResponse>
```

### Parameters

| Name    | Type                                                                    | Required | Description                                                                                                |
| ------- | ----------------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| `query` | [`SearchLogTracesRequest`](/docs/reference/api/v2/openapi/export-log-traces) | Yes      | Project, filters, sort, pagination. See [Export Logs](/docs/monitor/filter-and-search-logs) for filter grammar. |

### Returns

`Promise<SearchTracesResponse>` with `{ data: TraceRow[]; pagination: Pagination }`.

### Example

```typescript theme={null}
const { data, pagination } = await adaline.logs.traces.search({
  query: {
    projectId: 'project_abc123',
    filters: [
      { type: 'status', column: 'status', operator: 'equals', value: 'failure' },
      { type: 'startedAt', column: 'startedAt', operator: 'gte', value: Date.now() - 3600_000 },
    ],
    sort: 'startedAt:desc',
    limit: 100,
  },
});

for (const trace of data) {
  console.log(trace.id, trace.name, trace.status);
}
```

***

## update()

Retroactively patch a trace's status / endedAt and create or delete tags and attributes. Locate the trace by `traceId` **or** `referenceId` (at least one required). Useful for asynchronously marking a trace as succeeded / failed after some out-of-band signal.

```typescript theme={null}
update(options: { trace: UpdateLogTraceRequest }): Promise<unknown>
```

### Parameters

| Name    | Type                                                                  | Required | Description                                                                                             |
| ------- | --------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------- |
| `trace` | [`UpdateLogTraceRequest`](/docs/reference/api/v2/openapi/update-log-trace) | Yes      | `{ traceId? \| referenceId?, status?, endedAt?, tags?, attributes? }` — see OpenAPI for the full shape. |

### Returns

`Promise<unknown>` — an ack from the server (no typed shape; confirms the update landed).

### Example

```typescript theme={null}
await adaline.logs.traces.update({
  trace: {
    referenceId: 'user-session-123',
    status: 'success',
    attributes: {
      resolved: 'by-support',
    },
  },
});
```

***

## See Also

* [LogsClient](/docs/reference/sdk/v2/typescript/classes/logs) — parent client (owns the `list` method)
* [LogSpansClient](/docs/reference/sdk/v2/typescript/classes/log-spans) — sibling sub-client for span search
* API reference: [Search traces](/docs/reference/api/v2/openapi/export-log-traces) · [Update trace](/docs/reference/api/v2/openapi/update-log-trace)