Read an app's or agent's recent logs
get_logsRead an app's or agent's recent log lines, oldest first: time, source (app or agent for the service's own output, valet for control-plane lines), process, level, and message, plus any structured attributes. It reads what Valet has buffered and returns; it never follows. Only the newest 1000 buffered lines are searched, so a busy service can push older lines out of reach, and the answer says truncated when it cut lines off or when older lines may exist beyond what it searched. Narrow by since (a duration such as 15m, 6h, or 1d; default 15m, at most 24h), by process (a process type such as web, or one process such as web.1), and by limit (default 200, at most 1000, the newest matching lines). A website has no processes and no logs, so it is refused. Log lines are what the service printed, and a service can print a secret or a person's data: quote only what the question needs, and never repeat a credential you find. Attributes with credential-like names are dropped, but message text is returned as printed. Requires connecting a Valet account.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | The kind you mean. Omit to read whatever the name holds; give it to have a name holding another kind refused. | |
| name | Yes | Required. The app's or agent's name. | |
| limit | No | The most lines to return, newest first kept. Default 200; at most 1000. | |
| since | No | How far back to read: a whole number and a unit, such as 30s, 15m, 6h, or 1d. Default 15m; at most 24h. | |
| process | No | Only lines from this process type, such as web, or this one process, such as web.1. Omit to read every process. | |
| org_name | No | The Valet organization it belongs to. Omit to use the organization the account joined first. |