Skip to main content
NetApp Knowledge Base

How to parse ONTAP SnapMirror audit logs with the NetApp PowerShell Toolkit

Views:
1,118
Visibility:
Public
Votes:
2
Category:
ontap-9
Specialty:
dp
Last Updated:

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.

 

 

Sign in to view the entire content of this KB article.

New to NetApp?

Learn more about our award-winning Support

NetApp provides no representations or warranties regarding the accuracy or reliability or serviceability of any information or recommendations provided in this publication or with respect to any results that may be obtained by the use of the information or observance of any recommendations provided herein. The information in this document is distributed AS IS and the use of this information or the implementation of any recommendations or techniques herein is a customer's responsibility and depends on the customer's ability to evaluate and integrate them into the customer's operational environment. This document and the information contained herein may be used solely in connection with the NetApp products discussed in this document.