Skip to main content

Log files reference: Overview

Contributors netapp-lhalbert netapp-perveilerk netapp-madkat ssantho3
PDFs

StorageGRID provides logs that are used to capture events, diagnostic messages, and error conditions. You might be asked to collect log files and forward them to technical support to assist with troubleshooting.

The logs are categorized as follows:

Important The details provided for each log type are for reference only. The logs are intended for advanced troubleshooting by technical support. Advanced techniques that involve reconstructing the problem history using the audit logs and the application log files are beyond the scope of these instructions.

Access the logs

To access the logs, you can collect log files and system data from one or more nodes as a single log file archive. Or, if the primary Admin Node is unavailable or unable to reach a specific node, you can access individual log files for each grid node as follows:

  1. Enter the following command: ssh admin@grid_node_IP

  2. Enter the password listed in the Passwords.txt file.

  3. Enter the following command to switch to root: su -

  4. Enter the password listed in the Passwords.txt file.

Log file categories

The StorageGRID log file archive contains the logs described for each category and additional files that contain metrics and debug command output.

Archive location Description

audit

Audit messages generated during normal system operation.

base-os-logs

Base operating system information, including StorageGRID image versions.

bundles

Global configuration information (bundles).

cassandra

Cassandra database information and Reaper repair logs.

ec

VCSs information about the current node and EC group information by profile ID.

grid

General grid logs including debug (bycast.log) and servermanager logs.

grid.xml

Grid configuration file shared across all nodes.

hagroups

High availability groups metrics and logs.

install

Gdu-server and install logs.

lumberjack.log

Debug messages related to log collection.

Lambda-arbitrator

Logs related to the S3 Select proxy request.

Metrics

Service logs for Grafana, Jaeger, node exporter, and Prometheus.

miscd

Miscd access and error logs.

mysql

The mariaDB database configuration and related logs.

net

Logs generated by networking-related scripts and the Dynip service.

nginx

Load balancer and grid federation configuration files and logs. Also includes Grid Manager and Tenant Manager traffic logs.

nginx-gw

Load balancer and grid federation configuration files and logs.

ntp

NTP configuration file and logs.

os

Node and grid state file, including services pid.

other

Log files under /var/local/log that aren't collected in other folders.

perf

Peformance information for CPU, networking, and disk I/O.

prometheus-data

Current Prometheus metrics, if the log collection includes Prometheus data.

provisioning

Logs related to grid provisioning process.

raft

Logs from Raft cluster used in platform services.

ssh

Logs related to SSH configuration and service.

snmp

SNMP agent configuration and alarm allow/deny lists used for sending SNMP notifications.

sockets-data

Sockets data for network debug.

system-commands.txt

Output of StorageGRID container commands. Contains system information, such as networking and disk usage.