Trigger the Diagnostic Archive via file
This article guides you through the process of creating a Diagnostic Archive for your HiveMQ cluster.
The Diagnostic Archive functionality becomes accessible with the introduction of HiveMQ broker version 4.12.0.
Instructions
There are three methods to generate a Diagnostic Archive:
Control Center WebUI:
Navigate to the Control Center WebUI.
Select "Admin" and then "Support" in the left navigation links.
Click on "Diagnostic Archive" and subsequently hit the "Create Archive" button.
REST API:
Utilize the REST API, accessible at HiveMQ 4.35.0 REST API documentation (Note: The REST API is an Enterprise feature).
Manual File Creation:
Generate an empty file named "TRIGGER_DIAGNOSTIC" in the
$HIVEMQ_HOME
directory (also known as the HiveMQ broker root directory).
# Create a file named "TRIGGER_DIAGNOSTIC" touch $HIVEMQ_HOME/TRIGGER_DIAGNOSTIC
Upon triggering the Diagnostic Archive, you will observe the following log entries in the log file:
INFO - Creating diagnostic archive ... INFO - Created diagnostic zip '/opt/hivemq/log/diagnostic/diagnostic-20231120-095328-SEQPg.zip' successfully.
Diagnostic archive files are located in the
$HIVEMQ_HOME/log
folder
To facilitate further investigation, copy the generated zip file and upload it to the associated support ticket. This Diagnostic Archive provides valuable insights for diagnosing and addressing issues within the HiveMQ environment.
Related articles
Filter by label
There are no items with the selected labels at this time.