Get Workload Logs
get_workload_logsQuery the logs of workloads in a GVC (gvc, workload, container, location) or of an mk8s cluster with the logs add-on (cluster, namespace, pod, container, node, job), OR pass a raw LogQL query, which REPLACES the structured params, so it must embed ALL labels itself. Workload labels: gvc, workload, container, location, provider, replica, stream (replica and stream only via a raw query). Cluster labels: cluster_name, namespace, pod, container, node, job; Control Plane workloads on a cluster log under their gvc. filter is a literal substring match (|=), not regex; for regex use a raw query with |~. Cron run logs: scope a raw query by the replica from list_deployments jobExecutions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_workload_logs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Absolute end time (exclusive, ISO 8601). | |
| gvc | No | GVC name. Required unless `cluster` or a raw `query` is provided. | |
| job | No | With `cluster`: log source (all when omitted). | |
| org | No | Organization slug. | |
| pod | No | With `cluster`: pod name. | |
| from | No | Absolute start time (inclusive, ISO 8601). Overrides `since`. Must be earlier than `to`. | |
| node | No | With `cluster`: node name. | |
| limit | No | Maximum log entries to return (default: 30, max: 999). | |
| order | No | Sort order (default: "oldest_first"). | |
| query | No | Raw LogQL query. REPLACES the structured params entirely, so it must embed ALL labels itself (gvc, workload, location, …) — required for the replica/stream labels, which have no structured param. Not sanitized — use structured params when possible. | |
| since | No | Lookback window as relative duration (default: "1h"). Examples: "30m", "2h", "1d". | |
| filter | No | Literal substring filter (LogQL `|=`) — only return log lines containing this exact text. NOT a regex; for regex matching use a raw `query` with `|~`. | |
| cluster | No | mk8s cluster name, in place of `gvc`: the cluster's own logs (logs add-on). | |
| location | No | Location to filter logs for (e.g., "aws-us-east-1"). | |
| workload | No | Workload name to filter logs for. | |
| container | No | Container name to filter logs for (e.g., "main", "_accesslog"). | |
| namespace | No | With `cluster`: Kubernetes namespace. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | The full result. Read this, not only the summary. | |
| details | No | ||
| summary | Yes | ||
| nextSteps | No |