Skip to content
Percona Software for MongoDB Documentation

View backup logs

Version added: 1.4.0

You can see the logs from all pbm-agents in your MongoDB environment using pbm CLI. This reduces time for finding required information when troubleshooting issues.

Note

The log information about restores from physical backups is not available in pbm logs.

To view pbm-agent logs, run the pbm logs command and pass one or several flags to narrow down the search.

The following flags are available:

  • -t, --tail - Show the last N rows of the log
  • -e, --event - Filter logs by all backups or a specific backup
  • -n, --node - Filter logs by a specific node or a replica set

  • -s, --severity - Filter logs by severity level. The following values are supported (from low to high):

    • D - Debug
    • I - Info
    • W - Warning
    • E - Error
    • F - Fatal

  • -o, --output - Show log information as text (default) or in JSON format.

  • -i, --opid - Filter logs by the operation ID

Examples

The following are some examples of filtering logs:

Show logs for all backups

$ pbm logs --event=backup

Show the last 100 lines of the log about a specific backup 2020-10-15T17:42:54Z

$ pbm logs --tail=100 --event=backup/2020-10-15T17:42:54Z

Include only errors from the specific replica set

$ pbm logs -n rs1 -s E

The output includes log messages of the specified severity type and all higher levels. Thus, when ERROR is specified, both ERROR and FATAL messages are shown in the output.

Implementation details

pbm-agents write log information into the pbmLog collection in the PBM Control collections. Every pbm-agent also writes log information to stderr so that you can retrieve it when there is no healthy mongod node in your cluster or replica set. For how to view an individual pbm-agent log, see How to see the pbm-agent log.

Note

Log information from pbmLog collection is shown in the UTC timezone and from the stderr - in the server’s time zone.

Get expert help

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert

Last update: October 29, 2024
Created: October 29, 2024