agentengine debug logs

For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

agentengine debug logs

MongoDB Atlas Agent Engine is in Public Preview and intended for evaluation and prototyping purposes only. We do not recommend production deployments during preview and expect to communicate breaking changes with you periodically. To learn more about preview feature considerations, see Preview Features.

View CLI debug logs.

Synopsis

View the CLI’s own debug logs.

Each invocation writes a structured JSON log file unless --no-log is set. Log files are at:

  • macOS: ~/Library/Logs/agentengine/

  • Linux: ${XDG_STATE_HOME:-~/.local/state}/agentengine/logs/

  • Windows: %LOCALAPPDATA%\agentengine\Logs\

Flags and their environment variables:

--log-level AGENTENGINE_LOG_LEVEL (default info) --log-file AGENTENGINE_LOG_FILE --no-log AGENTENGINE_NO_LOG --verbose -v, -vv raise stderr verbosity --quiet -q silence stderr below error

AGENTENGINE_LOG_MAX_FILES sets the retained file count (default 20). AGENTENGINE_NO_LOG_PRUNE disables automatic pruning.

When a command fails, the final stderr line shows the active log path:

For details: ~/Library/Logs/agentengine/agentengine-2026-05-13T11-43-57Z-12345.log

Examples:

agentengine debug logs list
agentengine debug logs get --last --pretty

Options

-h, --help   help for logs

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)

SEE ALSO

  • [agentengine debug](https://www.mongodb.com/docs/agentengine/cli/agentengine_debug.md#std-label-agentengine_debug - CLI debug logs.

  • [agentengine debug logs get](https://www.mongodb.com/docs/agentengine/cli/agentengine_debug_logs_get.md#std-label-agentengine_debug_logs_get - Print a log file.

  • [agentengine debug logs list](https://www.mongodb.com/docs/agentengine/cli/agentengine_debug_logs_list.md#std-label-agentengine_debug_logs_list - List log files, most recent first.