Disk and network metrics, along with other useful information for Commvault HyperScale X nodes, can be collected using the cv_disk_net_monitor.py script.
The script generates the following outputs:
-
Network monitoring
Output from the ifconfig, nfsstat, and netstat commands.
-
Disk monitoring
Output from the df command for all data and metadata disks on the node.
Note
The script runs automatically on each node every 30 minutes. The output from the various commands is saved in the log directory.
Procedure
You can view the saved logs on each node by navigating to the following directory:
#cd /var/log/commvault/Log_Files/CVFSPerfMon/
Optionally, you can run the script manually as follows:
-
Navigate to the following directory:
# cd /opt/commvault/MediaAgent -
Run the following command:
# python3 cv_disk_net_monitor.py
Output
The logs are saved either as comma-separated values (CSV) files or as human-readable log files.
CSV files provide a curated view of relevant metrics, while log files contain the raw command outputs.
The following log files are generated on each node:
Network Monitoring
-
NetworkStatusFiltered.log
Contains output from the following commands:
-
Output from
ifconfig -a | grep 'flags\|RX errors\|TX errors'Captures flags, MTU, and TX/RX errors for all interfaces on the node. Useful for identifying network retransmissions and related issues.
-
Output from
netstat -s | grep -i retransCaptures retransmission statistics on the node. Useful for identifying network congestion or performance issues.
-
Output from
nfsstat -l | grep 'read\|write\|access\|getattr\|lookup\|readdir'Captures NFS calls such as read, write, access, getattr, setattr, lookup, lookup_root, and readdir. Useful for estimating and analyzing file operations over time.
-
-
ifconfigCSV.csv
A CSV file containing date, time, interface name, MTU, TX/RX statistics (total, errors, drops, and overruns), and flags for bond1, bond2, and their slave interfaces.
-
nfsstatCSV.csv
A CSV file containing date, time, and NFS call statistics for read, write, access, getattr, setattr, lookup, lookup_root, and readdir operations.
-
netstatCSV.csv
A CSV file containing date, time, and retransmission statistics (including retransmitted segments, TCPLostRetransmit, retransmits in slow start, SACK retransmits failed, TCPRetransFail, and TCPSynRetrans).
Disk Monitoring
-
DiskStatus.log
Contains
dfoutput for all data and metadata disks, reported in KB. Useful for monitoring disk usage. -
DiskStatusCsv.csv
Contains the same information as DiskStatus.log, but formatted as a CSV file.