How to parse ONTAP SnapMirror audit logs with the NetApp PowerShell Toolkit
Applies to
- ONTAP 9
- NetApp PowerShell Toolkit
Description
The SnapMirror audit log provides a running log of SnapMirror relationships. It shows starting, restarting, and ending information for each SnapMirror relationship. This script reads in the log file(s) and parses the information into a usable CSV file. The output produces the following columns in the file:
Script Detail
- Source (the source of the SnapMirror relationship)
- Destination (the destination of the SnapMirror relationship
- Type (request, start, or end)
- KB Transferred (produced only for end type entries)
- Time Stamp (the time stamp associated with the log file entry)
Fields
- Row: A simple numbering of rows to help sort
- Source: The source SVM and volume
- Destination: The SVM and volume on the destination cluster
- KB Transferred: The total Kilobytes transferred during that SnapMirror update
- Request Time: The date/time that the SnapMirror update was requested
- Start Time: The date/time the SnapMirror update actually started which may be delayed after the actual request time
- End Time: The date/time the SnapMirror update completed
- Request to End: Number of seconds from the requested time to ending time of the SnapMirror update
- Start to End: Number of seconds from the start time to ending time of the SnapMirror update
- Request to Start: Number of seconds from the requested time to start time of the SnapMirror update
- Data Throughput KB/s: Throughput of data measured in Kilobytes
- Network Throughput Kb/s: Network throughput measured in kilobits taking in account the compression factor
- Concurrency: Number of other SnapMirror updates that were running during any time this SnapMirror update was running
- Network Compression Ratio: If network compression is enabled, the ratio achieved during this update
- SnapMirror Detail: How the SnapMirror update was started
Tips
- SnapMirror audit logs are maintained on the destination cluster of a SnapMirror relationship.
- Collecting the SnapMirror audit logs directly from the cluster using the script will take some time. As an alternative, download the snapmirror_audit.log files using the spi web interface or through raw AutoSupport in Active IQ and use the -UseLocalLogFile parameter.
- If using the -UseLocalLogFile parameter, multiple log files from multiple nodes in the cluster can be concatenated together in chronological order and the script will parse it all.
- When looking at the output for SnapMirror transfers that have a low amount of data and/or a very short transfer duration, there might be a skew in the calculations of throughput results.
Example Output
Row | Source | Destination | KB Transferred | Request Time | Start Time | End Time | Request to End | Start to End | Request to Start | Data Throughput KB/s | Network Throughput Kb/s | Concurrency | Network Compression Ratio | SnapMirror Detail |
1 | svm1:vol1 | svm1:vol1_dr | 8,771,035 | 09/08/2021 20:20:06 | 09/08/2021 20:20:06 | 09/08/2021 20:20:46 | 40 | 40 | 0 | 219,276 | 1,754,208 | 36 | 1.0:1 | ManualUpdate |
2 | svm2:vol2 | svm2:vol2_dr | 1,377,724 | 09/08/2021 22:02:30 | 09/08/2021 22:20:20 | 09/08/2021 22:20:33 | 1,083 | 13 | 1,070 | 105,979 | 847,832 | 21 | 1.0:1 | ManualUpdate |
Note: This is a community based script and therefore is supported by the community and not within the NetApp support organization. |