Docker logs — `docker_logs`

Tails a running container’s logs, one event per line — all lines by default, with optional match/drop regex filters. Supports discovery, and the dedicated discover_docker tool scans the whole local Docker environment for candidate containers.

Prerequisites: access to the Docker daemon — run navflowd on the host, or mount the Docker socket and include the Docker CLI in the image.

Set up

Agent

Ask a connected agent:

Use navflow to find my running containers and ingest the api-server’s logs.

The agent calls discover_docker (scans running containers, proposes one source per candidate) or discover_source for a known container, test_source (dry-run — tails a few lines), then create_source.

Console

Sources → Add source → docker_logs. Set:

container: the container (or compose service) name

Discover lists the running containers to pick from. If the container runs under Compose, set compose_file so the tail follows restarts. Save.

YAML / API


- name: logs
  connector: docker_logs
  poll: 5s
  config:
    container: navflow-demo-api-server   # the container name (docker ps)
    labels:
      - { name: service, const: api-server, primary: true }

If the container runs under Compose without a fixed container_name, set container to the service name and add compose_file (an absolute path, or relative to where the daemon runs) so the tail follows restarts.

Or POST /api/sources with the same object.

Configuration

field	type	description
`container`*	string	container (or compose service) name
`compose_file`	string	path to `docker-compose.yml` if the container runs under Compose
`match`	string	keep only lines matching this regex (default: all), e.g. `ERROR\|WARN`
`drop`	string	skip lines matching this regex, e.g. `HTTP/1.1"` to drop access logs
`label_pattern`	string	regex with named groups → per-line label context

Verify

Open the source in the console: Recent events shows lines on the next poll. If nothing arrives, check that navflowd can run docker logs <container> — the same access it needs.

Docker logs — docker_logs