List log label values
render_list_logs_valuesRead-onlyIdempotent
Retrieve all distinct values for a specified log label from matching log entries. Use filters to narrow down logs by host, path, service, or time range.
Instructions
List log label values. List all values for a given log label in the logs matching the provided filters. Calls GET /logs/values on the Render Public API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Filter request logs by their host. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| path | No | Filter request logs by their path. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| task | No | Filter logs by their task(s) | |
| text | No | Filter by the text of the logs. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| type | No | Filter logs by their type. Types include `app` for application logs, `request` for request logs, and `build` for build logs. You can find the full set of types available for a query by using the `GET /logs/values` endpoint. | |
| label | Yes | The label to query logs for | |
| level | No | Filter logs by their severity level. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| limit | No | The maximum number of items to return. For details, see [Pagination](https://api-docs.render.com/reference/pagination). | |
| method | No | Filter request logs by their requests method. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. | |
| endTime | No | Epoch/Unix timestamp of end of time range to return. Defaults to `now()`. | |
| ownerId | Yes | The ID of the workspace to return log label values for | |
| taskRun | No | Filter logs by their task run id(s) | |
| instance | No | Filter logs by the instance they were emitted from. An instance is the id of a specific running server. | |
| resource | Yes | Filter logs by their resource. A resource is the id of a server, cronjob, job, postgres, redis, or workflow. | |
| direction | No | The direction to query logs for. Backward will return most recent logs first. Forward will start with the oldest logs in the time range. | backward |
| startTime | No | Epoch/Unix timestamp of start of time range to return. Defaults to `now() - 1 hour`. | |
| statusCode | No | Filter request logs by their status code. [Wildcards and regex](https://render.com/docs/logging#wildcards-and-regular-expressions) are supported. |