Send System Log Report
When opening a new support ticket OSNEXUS will almost always ask for the system's configuration and log information. QuantaStor collects and uploads that bundle for you from the Send Support Logs dialog, so there is no need to gather files by hand.
It is also on the right-click context menu for a Storage System, as Send Log Report....
Sending a log report
The General tab covers the common case:
- Select Storage System(s) -- tick each system to collect from. The grid shows each system's service, kernel and distribution version, so you can confirm you are collecting from the right nodes. In a grid, collect from every node involved in the problem rather than just the one showing symptoms; most issues worth a support case span more than one system.
- Support Ticket -- your existing case number. Filling this in is what attaches the bundle to the right case rather than leaving it to be matched up by hand.
- Contact Email -- who to reply to.
- Message/Reason -- a short description of the problem. Worth writing properly: it is the first thing the engineer reads alongside the logs.
- Skip log server ping pre-checks -- bypasses the outbound connectivity test. Use it in environments where the test does not reflect real reachability, for example where ICMP is blocked but HTTPS is permitted.
An Advanced Settings tab holds additional options for less common collection scenarios.
Press OK to collect and upload.
What is collected
The collection gathers:
- the system log
- system hardware configuration information
- much of what is under
/var/log/
QuantaStor never collects data files from your Storage Pools. Only system log and configuration files are included -- no volume, share or bucket contents.
GDPR compliance and PII scrubbing
To ensure no personally-identifiable information (PII) is transmitted, the log collection scrubs usernames and other security related information from the logs before they are sent to OSNEXUS. This is what makes the Send Support Logs path GDPR compliant, and this is the default mode, nothing to enable. Data written to Storage Pools is never collected, the log bundle only contains system diagnostics and system log files rather than anything identifying users or their data.
Outbound access and proxies
The upload goes out over HTTPS to the OSNEXUS log server, so the system needs outbound access.
Where appliances reach the internet through a proxy, configure it once in Storage System Modify --> Proxy Settings and the log upload uses it automatically, along with license activation and the Upgrade Manager. If the proxy is configured but internal traffic should bypass it, put your grid nodes in the No Proxy list.
Systems on a private network
If an appliance has no route to the internet at all, generate the report at the console or over SSH and retrieve the file yourself.
Run this, replacing companyname with your organization's name, with no spaces:
sudo qs-sendlogs companyname
The command attempts the upload and will fail without outbound access -- that is expected. It still leaves the bundle in the current directory, named like:
qs_bug_report_<timestamp>.companyname.tgz
Copy that file off the system with any SFTP/SCP client -- WinSCP and FileZilla both work -- and email it to your support contact.
Related pages
- Alert Manager -- ongoing alert delivery by email, ITSM webhook and SNMP, which is separate from support log collection
- Security Configuration -- audit logging, and the security settings the scrubbing protects
- Storage System Modify -- proxy configuration used by the upload
- QuantaStor Touch Files --
qs_logs.no_upload, which permanently disables the upload on a secure-site installation
Return to Using the Web Interface
Verified against QuantaStor 6.9.0.