Use StorageGRID support options
The Grid Manager provides options to help you work with technical support if an issue arises with your StorageGRID system.
The AutoSupport feature enables your StorageGRID system to send health and status messages to technical support. Using AutoSupport can significantly speed problem determination and resolution. Technical support can also monitor the storage needs of your system and help you determine if you need to add new nodes or sites. Optionally, you can configure AutoSupport messages to be sent to one additional destination.
You configure AutoSupport using the Grid Manager (SUPPORT > Tools > AutoSupport). The AutoSupport page has two tabs: Settings and Results.
Information included in AutoSupport messages
AutoSupport messages include information such as the following:
StorageGRID software version
Operating system version
System-level and location-level attribute information
Recent alerts and alarms (legacy system)
Current status of all grid tasks, including historical data
Admin Node database usage
Number of lost or missing objects
Grid configuration settings
Active ILM policy
Provisioned grid specification file
You can enable the AutoSupport feature and the individual AutoSupport options when you first install StorageGRID, or you can enable them later. If AutoSupport is not enabled, a message appears on the Grid Manager Dashboard. The message includes a link to the AutoSupport configuration page.
If you close the message, it will not appear again until your browser cache is cleared, even if AutoSupport remains disabled.
Use Active IQ
Active IQ is a cloud-based digital advisor that leverages predictive analytics and community wisdom from NetApp’s installed base. Its continuous risk assessments, predictive alerts, prescriptive guidance, and automated actions help you prevent problems before they occur, leading to improved system health and higher system availability.
You must enable AutoSupport if you want to use the Active IQ dashboards and functionality on the NetApp Support site.
Collect StorageGRID logs
To help troubleshoot a problem, you might need to collect log files and forward them to technical support.
StorageGRID uses log files to capture events, diagnostic messages, and error conditions. The bycast.log file is maintained for every grid node and is the primary troubleshooting file. StorageGRID also creates log files for individual StorageGRID services, log files related to deployment and maintenance activities, and log files related to third-party applications.
Users who have the appropriate permissions and who know the provisioning passphrase for your StorageGRID system can use the Logs page in the Grid Manager to gather log files, system data, and configuration data. When you collect logs, you select a node or nodes and specify a time period. Data is collected and archived in a
.tar.gz file, which you can download to a local computer. Inside this file, there is one log file archive for each grid node.
Use metrics and run diagnostics
When troubleshooting an issue, you can work with technical support to review detailed metrics and charts for your StorageGRID system. You can also run pre-constructed diagnostic queries to proactively assess key values for your StorageGRID system.
The Metrics page provides access to the Prometheus and Grafana user interfaces. Prometheus is open-source software for collecting metrics. Grafana is open-source software for metrics visualization.
|The tools available on the Metrics page are intended for use by technical support. Some features and menu items within these tools are intentionally non-functional and are subject to change.|
The link in the Prometheus section of the Metrics page allows you to query the current values of StorageGRID metrics and to view graphs of the values over time.
|Metrics that include private in their names are intended for internal use only and are subject to change between StorageGRID releases without notice.|
The links in the Grafana section of the Metrics page allow you to access pre-constructed dashboards containing graphs of StorageGRID metrics over time.
The Diagnostics page performs a set of pre-constructed diagnostic checks on the current state of the grid. In the example, all diagnostics have a Normal status.
Clicking a specific diagnostic lets you see details about the diagnostic and its current results.
In this example, the current CPU utilization for every node in a StorageGRID system is shown. All node values are below the Attention and Caution thresholds, so the overall status of the diagnostic is Normal.