agentengine logs

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 --follow
agentengine 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 ID

Options 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)

agentengine logs

Synopsis

Options

Options inherited from parent commands

SEE ALSO