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

# LogSpansClient

`adaline.logs.spans` searches individual spans and returns their full payloads — content, parsed content, attributes, tags, status, and timestamps. Use this when a trace-level search isn't granular enough for the filter you need.

## Access

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

const adaline = new Adaline();
const spans = adaline.logs.spans; // LogSpansClient
```

The class is also exported directly:

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

Types from `@adaline/api`:

```typescript theme={null}
import type {
  SearchLogSpansRequest,
  SearchSpansResponse,
} from '@adaline/api';
```

***

## search()

Paginated span search with typed filter objects. Returns full span payloads — `content`, `attributes`, `parsedContent`, tags, status, timestamps — so you can filter by model, provider, promptId, or any attribute.

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

### Parameters

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

### Returns

`Promise<SearchSpansResponse>` with `{ data: SpanRow[]; pagination: Pagination }`. Each `SpanRow` includes the full `content` (model/tool/retrieval/etc.) and parsed attributes.

### Example

```typescript theme={null}
const { data, pagination } = await adaline.logs.spans.search({
  query: {
    projectId: 'project_abc123',
    filters: [
      { type: 'model', column: 'model', operator: 'equals', value: 'gpt-4o' },
      { type: 'status', column: 'status', operator: 'equals', value: 'failure' },
    ],
    sort: 'startedAt:desc',
    limit: 50,
  },
});

for (const span of data) {
  console.log(span.id, span.name, span.content.type);
}
```

***

## See Also

* [LogsClient](/docs/reference/sdk/v2/typescript/classes/logs) — parent client
* [LogTracesClient](/docs/reference/sdk/v2/typescript/classes/log-traces) — sibling sub-client for trace search
* API reference: [Search spans](/docs/reference/api/v2/openapi/export-log-spans)