service_logs
Retrieve a bounded snapshot of a Docker swarm service's logs, aggregated across all tasks. Avoids blocking or unbounded output with configurable tail and byte limits.
Instructions
Get a bounded snapshot of a swarm service's logs (never follows).
follow is intentionally not exposed: the stream is joined into one string before returning, so
following would block forever and grow unbounded. Collection is capped at max_bytes (ValueError
if exceeded) so a noisy service can't OOM the server. The default is a bounded tail=200;
tail="all" returns the whole buffer, which can be huge on long-running services and exceed
the agent's context — prefer an integer, or since, to constrain output. Logs aggregate
across all the service's tasks — container_logs reads a single container, and the
service-logs://{id_or_name} resource is the resource-flavored equivalent of this tool.
args: id_or_name - The service id or name details - Show extra details stdout - Include stdout stderr - Include stderr since - Show logs since this Unix timestamp timestamps - Include timestamps tail - Number of lines from the end (default 200), or the literal "all" for everything max_bytes - Abort with ValueError if the buffered logs exceed this many bytes (default 32 MiB) returns: str - Decoded log output
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tail | No | ||
| since | No | ||
| stderr | No | ||
| stdout | No | ||
| details | No | ||
| max_bytes | No | ||
| id_or_name | Yes | ||
| timestamps | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |