logs-files-reference.adoc

permalink	sidebar	keywords	summary
monitor/logs-files-reference.html	sidebar	log, logs, log files	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.

Log files reference

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:

• StorageGRID software logs

• Deployment and maintenance logs

• Logs for third-party software

• About the bycast.log

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.

To access the logs, you can collect log files and system data from one or more nodes as a single log file archive (SUPPORT > Tools > Logs). 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.

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 on 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 configuration files and logs. Also includes Grid Manager and Tenant Manager traffic logs.
nginx-gw	Load balancer 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 are not 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.
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.

Related information

Collect log files and system data