container_top
Read-only
List the processes running in a Docker container directly from the host, without needing a shell or ps binary in the image.
Instructions
List the processes running inside a container (the daemon runs ps on the host).
Works on any running container without executing anything in it, so it needs no shell or ps
binary in the image — unlike container_exec with ps. Use container_stats for resource
usage rather than process lists. Fails if the container is not running.
args: id_or_name - The container id or name ps_args - Extra ps arguments (e.g. "aux"); default is the daemon's standard ps invocation returns: dict - {"Titles": [ps column names], "Processes": [[one row of values per process]]}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ps_args | No | ||
| id_or_name | Yes |