@mastra/core/dist/docs/references/reference-core-listLogsByRunId.md

Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.

# Mastra.listLogsByRunId()

The `.listLogsByRunId()` method is used to retrieve logs for a specific run ID and transport ID. This method requires a configured logger that supports the `listLogsByRunId` operation.

## Usage example

```typescript
mastra.listLogsByRunId({ runId: '123', transportId: '456' })
```

## Parameters

**runId** (`string`): The run ID to retrieve logs for.

**transportId** (`string`): The transport ID to retrieve logs from.

**fromDate** (`Date`): Optional start date for filtering logs. e.g., new Date('2024-01-01').

**toDate** (`Date`): Optional end date for filtering logs. e.g., new Date('2024-01-31').

**logLevel** (`LogLevel`): Optional log level to filter by.

**filters** (`Record<string, any>`): Optional additional filters to apply to the log query.

**page** (`number`): Optional page number for pagination.

**perPage** (`number`): Optional number of logs per page for pagination.

## Returns

**logs** (`Promise<any>`): A promise that resolves to the logs for the specified run ID and transport ID.

## Related

- [Logging overview](https://mastra.ai/docs/observability/logging)
- [Logger reference](https://mastra.ai/reference/logging/pino-logger)