ark logs

Tail logs from agent pods in a live Kubernetes cluster.

ark logs <team-name> [flags]

---

Flags

Flag	Default	Description
-n, --namespace	default	Namespace of the ArkTeam
--follow	false	Stream 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
--tail	100	Number of recent lines to show before following
--kubeconfig	~/.kube/config	Path 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

• ark status — overview of all teams and agents
• Observability concept — structured events and traces