list_logs
Filter and retrieve LLM request logs using server-side filters for precise analysis. Supports pagination, sorting, time ranges, and environment selection.
Instructions
List and filter LLM request logs. Supports pagination, sorting, time range, and server-side filtering.
IMPORTANT: Use the "filters" parameter to filter results server-side. Do NOT fetch all logs and filter client-side.
PARAMETERS:
page_size: Number of logs per page (1-50, default 20)
page: Page number (default 1)
sort_by: Sort field with optional - prefix for descending (e.g. "-cost", "latency")
start_time / end_time: ISO 8601 time range (default: last 1 hour, max: 1 week ago)
is_test: Filter by test (true) or production (false) environment
all_envs: Include all environments
include_fields: Array of field names to return (defaults to summary fields). Use get_log_detail for full data.
filters: Array of server-side filter objects. Each filter has: field (string), operator (string), value (array). See below.
FILTERS - supported operators: "" (exact match), "not", "lt", "lte", "gt", "gte", "icontains", "startswith", "endswith", "in", "isnull"
FILTERS - supported fields: customer_identifier, custom_identifier, thread_identifier, prompt_id, unique_id, organization_id, organization_key_id, organization_key_name, customer_email, customer_name, trace_unique_id, span_name, span_workflow_name, model, deployment_name, provider_id, prompt_name, status_code, status, error_message, failed, cost, latency, tokens_per_second, time_to_first_token, prompt_tokens, completion_tokens, total_request_tokens, environment, log_type, stream, temperature, max_tokens, metadata__, scores__
EXAMPLE - find all error logs (status_code != 200): { "filters": [{"field": "status_code", "operator": "not", "value": [200]}], "sort_by": "-id", "page_size": 20 }
EXAMPLE - find logs for a specific model and customer: { "filters": [ {"field": "model", "operator": "", "value": ["gpt-4"]}, {"field": "customer_identifier", "operator": "icontains", "value": ["user"]}, {"field": "cost", "operator": "gt", "value": [0.01]} ] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default 1) | |
| filters | No | Array of server-side filters. Each filter has field, operator, and value. Example: [{"field": "status_code", "operator": "not", "value": [200]}] | |
| is_test | No | Filter by test environment (true) or production (false) | |
| sort_by | No | Sort field. Prefix with - for descending order. Options: id, -id, cost, -cost, latency, -latency, time_to_first_token, -time_to_first_token, prompt_tokens, -prompt_tokens, completion_tokens, -completion_tokens, all_tokens, -all_tokens, total_request_tokens, -total_request_tokens, tokens_per_second, -tokens_per_second. Also supports scores__<evaluator_id> for sorting by evaluation scores. | |
| all_envs | No | Include logs from all environments | |
| end_time | No | End time in ISO 8601 format. Default: current time | |
| page_size | No | Number of logs per page (1-50, default 20) | |
| start_time | No | Start time in ISO 8601 format. Default: 1 hour ago. Maximum: 1 week ago | |
| include_fields | No | Fields to include in response. Defaults to summary fields (unique_id, model, cost, status_code, latency, timestamp, customer_identifier, prompt_tokens, completion_tokens, status, error_message, log_type). Use get_log_detail for full log data. |