ark logs

Tail logs from agent pods running in a live Kubernetes cluster — live streaming and pod selection.

Tail logs from agent pods in a live Kubernetes cluster.

ark logs <team-name> [flags]

Flags

FlagDefaultDescription
-n, --namespacedefaultNamespace of the ArkTeam
--followfalseStream logs live (like kubectl logs -f)
--pod—Select a specific pod by name. If omitted, logs from all role pods are merged.
--role—Show logs only from pods belonging to a specific role
--tail100Number of recent lines to show before following
--kubeconfig~/.kube/configPath to kubeconfig

Examples

# Recent logs for all agents in a team
ark logs content-pipeline -n my-org

# Follow live
ark logs content-pipeline -n my-org --follow

# Logs for a specific role
ark logs content-pipeline -n my-org --role researcher --follow

# Logs for a specific pod
ark logs content-pipeline -n my-org --pod content-pipeline-researcher-7d9f-xk2p8 --follow

Log format

Agent pods emit structured JSON logs. ark logs pretty-prints them:

[researcher] 2026-03-17T10:00:01Z INFO  task started    task_id=1710000001-0
[researcher] 2026-03-17T10:00:01Z INFO  llm call        model=llama3.2 in_tokens=320
[researcher] 2026-03-17T10:00:05Z INFO  tool call       tool=web-search__search
[researcher] 2026-03-17T10:00:06Z INFO  tool result     tool=web-search__search ok=true
[researcher] 2026-03-17T10:00:09Z INFO  task completed  task_id=1710000001-0 tokens=1560 duration=8.2s

See also