List Logs
list-logsRetrieve recent RawTree insert, query, describe, and explain logs to debug errors, verify activity, and view exact SQL executed. Filter by time, type, status, origin, or table.
Instructions
Purpose: List recent RawTree insert/query/describe/explain activity for the configured project.
NOT for: Reading application log files from disk or infrastructure logs. This tool reads RawTree's product query and insert logs.
Returns: Log entries with time, type, status, origin, query, exception, rows, duration, bytes, tables, projections, hints, and pagination.
When to use:
An insert or query failed and you need the RawTree exception or hints
You need to verify whether an agent, CLI, API, or UI call reached RawTree
You need recent activity for a table
You want the exact SQL RawTree saw
Workflow: Start with status=error for the last hour. Narrow by table or type if needed. Use next_offset for pagination.
Key trigger phrases: "check RawTree logs", "why did the insert fail", "show query history", "recent errors"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| startTime | No | Inclusive lower bound as an ISO datetime. Defaults to one hour before endTime. | |
| endTime | No | Inclusive upper bound as an ISO datetime. Defaults to now. | |
| limit | No | Number of logs to return. Default: 50. Max: 200. | |
| offset | No | Number of logs to skip for pagination. | |
| search | No | Optional raw RawTree search string, for example "type:insert status:error table:events". Structured filters are appended to it. | |
| types | No | Filter by log type. | |
| statuses | No | Filter by status. | |
| origins | No | Filter by origin. | |
| tables | No | Filter by one or more table names. | |
| hints | No | Filter to logs with any hints or no hints. |