Stream agent runtime logs.
Synopsis
View agent and tool runtime logs for a workspace.
Interactive queries cover at most 6 hours; query longer ranges in multiple windows of at most 6 hours. --since takes a duration (1h by default) or an RFC3339 timestamp. --tail returns the most recent entries, capped at 5000; use --all for the full window.
Logs exist only after the workspace has been deployed. For the CLI’s own diagnostics, use agentengine debug logs.
Examples:
agentengine logs --followagentengine logs --source agent --level error --grep "connection refused"agentengine logs [flags]Options
--all Fetch all logs in the time range (auto-paginates through all pages within the 6-hour interactive window) --base-url string Platform base URL --context string Named context to target (see 'agentengine context list') --execution-id string Filter by execution ID-f, --follow Continuously poll for new logs --grep string Search log messages (case-insensitive substring match)-h, --help help for logs --json Output logs as JSON --level string Log level(s) to match exactly (debug, info, warn, error), comma- or space-separated --org-id string Organization ID --project-id string Project ID --session-id string Filter by session ID --since string Start time as duration (e.g. 30m, 2h) or RFC3339 timestamp (default "1h", maximum "6h") --source string Filter by source sandbox(s) (agent, tool), comma- or space-separated --tail int Number of most-recent entries to return (capped at 5000; use --all for the full window) (default 500) --until string End time as duration (e.g. 5m) or RFC3339 timestamp (default: now) --workspace string Monorepo: select a specific workspace by name (from root agent.yaml) --workspace-id string Workspace IDOptions inherited from parent commands
--log-file string override log file path --log-level string file log verbosity (error|warn|info|debug) (default "info") --no-log disable file logging-q, --quiet silence stderr below error-v, --verbose count raise stderr verbosity (-v info, -vv debug)See Also
agentengine - Agent Engine local development CLI.
agentengine logs export - Export up to 24 hours of runtime logs.