Log package

This section provides a quick overview of the log packages of the IBM Storage Fusion HCI System.

By default, every log package contains a Must Gather folder. For more details about Must Gather, see Must Gather section.
Note:
  • The Must Gather folder contains the common data that is collected for all the log packages except Data Cataloging and backup and restore.
  • The isf-serviceability-operator-manager service account uses cluster admin role as it is required to collect oc adm must-gather logs.

Nodes

Logs related to compute nodes, firmware upgrades, and node health. The nodes log package mainly contains the folders for the following namespace:

ibm-spectrum-fusion-ns
It contains the logs and object definition files for all of the major resources under this namespace. For example, routes, pods logs, deployments, deamon sets, persistent volumes, and config maps.
Note: It includes the Kubernetes events that are associated with the resource. If any resource does not exist, then it can be skipped.

Network switches

Logs related to appliance network errors and connectivity. The network switches log package mainly contains the folders for the following namespaces:

ibm-spectrum-fusion-ns
It contains the logs and object definition files for all of the major resources under this namespace. For example, routes, pods logs, deployments, deamon sets, persistent volumes, and config maps.
Note: It includes the Kubernetes events that are associated with the resource. If any resource does not exist, then it can be skipped.
openshift-monitoring
It contains the logs and object definition files for all of the major resources under this namespace. For example, routes, pods logs, deployments, deamon sets, persistent volumes, and config maps.
Vlans
The Vlans folder contains a vlans.json file that includes a Vlan list.
Links
The Links directory contains a links.json file that includes a link list.
Switch
The Switch directory contains a switches.json file that includes only the definition of the switches.
Switch logs
The switch logs contain three directories: clncl, genic, and scpcl that includes actual switch logs.

Storage

Logs related to storage availability. The storage log package mainly contains the folders for the following namespaces:

  • ibm-spectrum-fusion-ns
  • ibm-spectrum-scale-namespace
  • ibm-spectrum-scale-csi-namespace
  • ibm-spectrum-scale-operator-namespace
  • openshift-monitoring
It also includes the GPFS snap logs and must-gather that is related to IBM Spectrum Scale.
Important: To obtain GPFS logs, gather them from IBM Storage Fusion HCI System user interface and not from OpenShift® Container Platform.

System health check

Logs related to overall assessment of the health of IBM Storage Fusion HCI System. The system health check log package mainly contains the folders for the following namespace:

Node Metrics
It contains the object definition files for the NodeMetricsList type.
ibm-spectrum-fusion-pod-metric
It contains the PodMetrics files for every pod present in this namespace.
ibm-spectrum-scale-pod-metric
It contains the PodMetrics files for every pod present in this namespace.
ibm-spectrum-scale-csi-pod-metric
It contains the PodMetrics files for every pod present in this namespace.
IMM-logs
The IMM logs folder contains the IMM_NAME.ffdc and IMM_NAME.inventory files for every IMM.
Switch logs
The switch logs contain three directories: clncl, genic, and scpcl that includes actual switch logs.

It also includes the Baremetalhosts, Machinesets, Machines, and Node network configuration policy folders with the relevant log files.

Backup and restore (Legacy)

Logs related to backup and restore of your workload applications. The backup and restore log package mainly contains the folders for the following namespace.

ibm-spectrum-protect-plus-ns
It contains the logs and object definition files for all of the major resources in the namespace.
baas namespace
It includes the Kubernetes events that are associated with the resource. If any resource does not exist, then it can be skipped.
SPP logs
It contains diagnostic logs that are collected by using the API provided by the IBM Spectrum Protect Plus server.
ibm-spectrum-fusion-ns
It contains the logs and object definition files for all of the major resources under this namespace. For example, routes, pods logs, deployments, deamon sets, persistent volumes, and config maps.
Note: It includes the Kubernetes events that are associated with the resource. If any resource does not exist, then it can be skipped.

It also includes the IBM Spectrum Protect Plus manager, Control plane backups, and Backup manager folders with the relevant log files.

Administration

Logs related to OpenShift, administration, and audit logging. The administration log package mainly contains the folders for the following namespace.

OCP must gather
The folder contains OCP must gather logs for analysis.
Audit logs
Audit logs contains the Control-0-rack, Kube, OAuth and Openshift folders with the relevant log files.

Backup and restore

Logs related to backup and restore of your workload applications. The backup and restore log package mainly contains the folders for the following namespace.

ibm-backup-restore
It contains the logs and object definition files for all of the major resources under this namespace. For example, routes, pods logs, deployments, deamon sets, persistent volumes, and config maps.
Note: It includes the Kubernetes events that are associated with the resource. If any resource does not exist, then it can be skipped.

Data Cataloging

Logs related to Data Cataloging service. The Data cataloging log package mainly contains the folders for the following namespace.

ibm-data-cataloging
It contains the logs and object definition files for all of the major resources under this namespace. For example, routes, pods logs, deployments, deamon sets, persistent volumes, and config maps.
Note: It includes the Kubernetes events that are associated with the resource. If any resource does not exist, then it can be skipped.

Must Gather

The Must Gather folder contains the common data that is collected for all the log packages. It mainly contains the following files, which might be helpful in debugging to get more information about the environment. It contains information about nodes, nodes config, kickstart.json , rackinfo configmap and persistent volumes related files.