> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valkyrie.vals.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Logs resource
> Fetch, filter, and follow benchmark logs through the tracker.
Access these methods through `client.logs`.
`client.logs.page_task`
Fetch one page from a task's current log stream, including IDs containing `/`.
```python Signature theme={null}
async def page_task(
run_id: UUID,
task_id: str,
*,
query: str | None = None,
start_time: datetime | None = None,
end_time: datetime | None = None,
cursor: str | None = None,
limit: int = 1000,
) -> LogPage
```
**Parameters**
{"run_id"}required · UUID
{"task_id"}required · str
{"query"}optional · str | None · default: {"None"}
{"start_time"}optional · datetime | None · default: {"None"}
{"end_time"}optional · datetime | None · default: {"None"}
{"cursor"}optional · str | None · default: {"None"}
{"limit"}optional · int · default: {"1000"}
**Returns**
LogPage
For examples, see the [Python SDK guide](/sdk/resources).
`client.logs.fetch_task`
Fetch every matching event from a task stream, including IDs containing `/`.
```python Signature theme={null}
async def fetch_task(
run_id: UUID,
task_id: str,
*,
query: str | None = None,
start_time: datetime | None = None,
end_time: datetime | None = None,
) -> list[LogEvent]
```
**Parameters**
{"run_id"}required · UUID
{"task_id"}required · str
{"query"}optional · str | None · default: {"None"}
{"start_time"}optional · datetime | None · default: {"None"}
{"end_time"}optional · datetime | None · default: {"None"}
**Returns**
list\[LogEvent]
For examples, see the [Python SDK guide](/sdk/resources).
`client.logs.page_run`
Fetch one page across every stream in a run.
```python Signature theme={null}
async def page_run(
run_id: UUID,
*,
query: str | None = None,
start_time: datetime | None = None,
end_time: datetime | None = None,
cursor: str | None = None,
limit: int = 1000,
) -> LogPage
```
**Parameters**
{"run_id"}required · UUID
{"query"}optional · str | None · default: {"None"}
{"start_time"}optional · datetime | None · default: {"None"}
{"end_time"}optional · datetime | None · default: {"None"}
{"cursor"}optional · str | None · default: {"None"}
{"limit"}optional · int · default: {"1000"}
**Returns**
LogPage
For examples, see the [Python SDK guide](/sdk/resources).
`client.logs.fetch_run`
Fetch every matching event across a run.
```python Signature theme={null}
async def fetch_run(
run_id: UUID,
*,
query: str | None = None,
start_time: datetime | None = None,
end_time: datetime | None = None,
) -> list[LogEvent]
```
**Parameters**
{"run_id"}required · UUID
{"query"}optional · str | None · default: {"None"}
{"start_time"}optional · datetime | None · default: {"None"}
{"end_time"}optional · datetime | None · default: {"None"}
**Returns**
list\[LogEvent]
For examples, see the [Python SDK guide](/sdk/resources).
`client.logs.stream_task`
Yield events from one task stream, including task IDs containing `/`.
```python Signature theme={null}
async def stream_task(
run_id: UUID,
task_id: str,
*,
query: str | None = None,
start_time: datetime | None = None,
end_time: datetime | None = None,
) -> AsyncIterator[LogEvent]
```
**Parameters**
{"run_id"}required · UUID
{"task_id"}required · str
{"query"}optional · str | None · default: {"None"}
{"start_time"}optional · datetime | None · default: {"None"}
{"end_time"}optional · datetime | None · default: {"None"}
**Returns**
AsyncIterator\[LogEvent]
For examples, see the [Python SDK guide](/sdk/resources).