BMC and BlueField Logs

1.0

The BMC and NVIDIA® BlueField® logs can be collected using Redfish commands.

Two types of dumps are supported:

  • BMC dump, which is a collection of logs from BMC

  • System dump, which is a collection of logs from BlueField. To create a system dump, users must provide the BlueField credentials and IP address of the tmfifo_net0 network interface.

The following subsections list BMC dump operations.

Create BMC Dump Task

Create a BMC dump task and gets the task ID.

Note

This is important for the next stages.

Copy
Copied!
            

sudo curl -k -u root:'<password>' -d '{"DiagnosticDataType": "Manager"}' -X POST https://<ip_address>/redfish/v1/Managers/Bluefield_BMC/LogServices/Dump/Actions/LogService.CollectDiagnosticData

Where:

  • <ip-address> – BMC IP address

  • <password> – BMC password

Get Dump Task State

Get dump task state. When TaskState is Completed, then the dump is ready for download.

Copy
Copied!
            

sudo curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<ip_address>/redfish/v1/TaskService/Tasks/<task_id>

Where:

  • <ip-address> – BMC IP address

  • <password> – BMC password

  • <task_id> – task ID received from the first command

Download BMC Dump

Download BMC dump after TaskState is Completed. Dump is saved in the path given to --output.

Copy
Copied!
            

sudo curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<ip_address>/redfish/v1/Managers/Bluefield_BMC/LogServices/Dump/Entries/<entry_id>/attachment --output </path/to/tar/log_dump.tar.xz>

Where:

  • <ip-address> – BMC IP address

  • <password> – BMC password

  • <entry_id> – entry ID of the dump in redfish/v1/Managers/Bluefield_BMC/LogServices/Dump/Entries/

  • </path/to/tar/log_dump.tar.xz> – path to download the log dump log_dump.tar.xz

    Note

    After downloading, untar the file to view the logs.

Delete All Dump Entries

Clear all log dump entries.

Copy
Copied!
            

sudo curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<ip_address>/redfish/v1/ Managers/Bluefield_BMC /LogServices/Dump/Actions/LogService.ClearLog

Where:

  • <ip-address> – BMC IP address

  • <password> – BMC password

Specific log dump entry deletion can be done by using ‘curl’s DELETE instead of GET in the previous command.

The following subsections list system dump operations.

Create System Dump

Create a system dump and get task ID.

Copy
Copied!
            

sudo curl -k -u root:'<password>' -d '{"DiagnosticDataType": "OEM", "OEMDiagnosticDataType": "bf_ip=<bf_ip>;bf_username=<bf_username>;bf_password=<bf_password>"}' -X POST https://<ip_address>/redfish/v1/Systems/Bluefield/LogServices/Dump/Actions/LogService.CollectDiagnosticData

Where:

  • <ip-address> – BMC IP address

  • <password> – BMC password

  • <bf_ip> – BlueField IP address

  • <bf_username> – BlueField username

  • <bf_password> – BlueField password

Get Dump Task State

Get dump task state. The dump is ready for download when TaskState is Completed.

Copy
Copied!
            

sudo curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<ip_address>/redfish/v1/TaskService/Tasks/<task_id>

Where:

  • <ip-address> – BMC IP address

  • <password> – BMC password

  • <task_id> – task ID received from the first command

Download System Dump

Download the user-specified system dump.

Copy
Copied!
            

sudo curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<ip_address>/redfish/v1/Systems/Bluefield/LogServices/Dump/Entries/<entry_id>/attachment --output </path/to/tar/system_dump.tar.xz>

Where:

  • <ip-address> – BMC IP address

  • <password> – BMC password

  • <entry_id> – The entry ID of the dump can be found in redfish/v1/Managers/Bluefield_BMC/LogServices/Dump/Entries/

  • </path/to/tar/system_dump.tar.xz> – path to download the log dump system_dump.tar.xz

    Note

    After downloading, untar the file to view the logs.

Delete All Dump Entries

Clear all log dump entries.

Copy
Copied!
            

sudo curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<ip_address>/redfish/v1/Systems/Bluefield/LogServices/Dump/Actions/LogService.ClearLog

Where:

  • <ip-address> – BMC IP address

  • <password> – BMC password

Note

Specific log dump entry deletion can be done by using curl's DELETE instead of GET in the previous command.

The downloaded dump tar must be extracted to get the logs for BMC or BlueField.

Upon creating a dump, please allow the system ~5 mins to prepare the dump. The created dump will appear on the dump list when the system finishes dump creation. The created dump can be downloaded from the BMC using the retrieve command.

BMC captures the DPU console output and stores it in the BMC dump. Refer to section "BMC Dump Operations" for getting the log files in BMC dump.

Users may also check the log in /run/log/dpulogs/. The log is rotated if it is larger than 1M or older than 24 hours. The oldest console output is overwritten as new data is added.

© Copyright 2023, NVIDIA. Last updated on Mar 3, 2024.