Gathering Appliance Diagnostics
A complete set of event broker diagnostic files and debug logs are sometimes required for Solace Support to determine the root cause of an operational problem.
You can use the gather diagnostics command to automatically gather and package all of this information. When the command completes, the retrieved files and logs are saved as a single compressed file, and the name of this diagnostics file and its location are printed to the screen.
A File Transfer User Account is required to access the generated diagnostic file. Refer to Configuring File Transfer User Accounts for information on account creation.
To gather event broker diagnostics, enter the following commands:
solace> enable
solace# admin
solace(admin)# gather-diagnostics [days-of-history <days>]
Where:
days-of-history <days>
specifies the number of days to gather diagnostics data for. By default, diagnostic data is gathered for one day.
Running gather-diagnostics
via legacy SEMPgather-diagnostics
completes. Running gather-diagnostics
normally takes several minutes. If this is a problem, we recommend that you run gather-diagnostics
via the Solace CLI.
Gathering Diagnostics from the Linux host shell
If the event broker CLI is not available, you can run the gather-diagnostics
command from the Linux host shell if you have root access (as of appliance release 8.2.0, this operation can also be performed by Sysadmin Users, refer to to Configuring Multiple Linux Shell Users
gather-diagnostics [num-days]
Where:
num-days
is the number of previous days diagnostic data to collect. The default is 1.
If you do not have root access, you can use sudo
to run the gather‑diagnostics
command from the Linux host shell using the support user account:
sudo gather-diagnostics [num-days]
If you are using a software event broker, you can gather diagnostics from the Linux host shell using the sysadmin user account:
sudo su -
gather-diagnostics-host [-d <num-days>]
Where:
-d <num-days>
specifies the number of days to gather diagnostics data for. By default, diagnostic data is gathered for one day.