In display mode, the statistics that have been collected from fetch are analyzed, filtered, and formatted into .tsv (tab separated value) files. The .tsv report files can be reviewed using third party data analysis tools (such as MS Excel) or the data can be directed to standard output.

Script Infrastructure

[admin]$ python3 sct.py display -h


usage: sct.py display-statistics

    [-h] [-o OUTPUTDIR] [-v DRVANAMES]

    [-r ROCVANAMES] [-s STATS] [-D DOMAINNAMES]

    [-n VMNAMES] [-ov | -oD | -on | -or] [-p]

optional arguments:

    -h, --help     show this help message and exit

    -o OUTPUTDIR, --stats-directory OUTPUTDIR     Directory into which collected statistics files

        are stored (default sct-stats)

    -v DRVANAMES, --drva-names DRVANAMES     Comma separated drva names, e.g drva01

    -r ROCVANAMES, --rocva-names ROCVANAMES     Comma separated rocva VM names in recovery site

    -s STATS, --stats STATS     Comma separated list of queryable stats.

        Supported stats are ['CPU', 'Memory',

        'avgReads', 'avgWrites',

        'avgReadIops', 'avgWriteIops',

        'totalWritesSizeDuration',

        'totalWritesDuration',

        'avgReadsDomain', 'avgWritesDomain',

        'avgReadIopsDomain', 'avgWriteIopsDomain',

        'totalWritesSizeDurationDomain',

        'totalWritesDurationDomain', 'fgCount',

        'fgSize', 'bgCount', 'bgSize', 

        'totalGcCacheSize', 'btreePageReadsDuration',

        'btreePageReadsPerSec',

        'btreePageWritesDuration',

        'btreePageWritesPerSec',

        'gcHotDataWA', 'gcColdDataWA',

        'activeGcBudget', 'allocatedGcBudget',

        'throttledGcBudget', 'rlTotalSize',

        'rlDirtySize', 'dataRereadsPercent',

        'bufferUsg', 'metaspaceInfo', 'histogramBG',

        'histogramFG', 'histogramBGDuration',

        'histogramFGDuration', 'vmReadMbps',

        'vmWriteMbps', 'vmReadIops', 'vmWriteIops',

        'wbStats', 'estimatedTotalDataBytes',

        'recoveredDataBytes',

        'recoveredDataBytesDuration',

        'recoveredDataBytesPerSec',

        'recoveredObjectsDuration', 'activeWriteBytes',

        'allocResumedCount', 'avgObjGetLatencyMsec',

        'maxObjGetLatencyMsec', 'minObjGetLatencyMsec',

        'numDisPlaced', 'numDisRemoved',

        'numDisUnlinked', 'numObjStructsInUse',

        'numObjsDownloaded', 'numObjsFoundDeleted',

        'numWritesAllocSuspended',

        'numWritesCompleted', 'numWritesIssued',

        'objBufsFree', 'objBufsInUse',

        'totalPostUncompressBytes',

        'totalPreUncompressBytes']

    -D DOMAINNAMES, --domain-names DOMAINNAMES     Comma separated domain names in drva

    -n VMNAMES, --vm-names VMNAMES     Comma separated protected VM names in domain

    -ov, --drva-only     Print only DRVA-related stats

    -oD, --domain-only     Print only domain-related stats

    -on, --vm-only     Print only VM-related stats

    -or, --rocva-only     Print only RocVa-related stats

-p, --print-to-stdout     Print the results on stdout

Input Qualifiers

Three types of qualifiers can be applied to control the output generated by the display mode:

  • By Name: Specifying JetStream DR components by name will limit the reported data to the named components only. Data from all other components will be omitted from the generated output.

-v DRVANAMES

Name or comma separated names of DRVA(s).

-r ROCVANAMES

Name or comma separated names of domains being recovered at the recovery site.

-D DOMAINNAMES

Name or comma separated names of domains in primary site DRVA(s).

-n VMNAMES      

Name or comma separated names of VMs being protected by JetStream DR.
  • By Component: Using the qualifier *-only restricts the data reported to the specified component type only; excluding data from any sub-components. For example, using the qualifier --drva-only includes statistics for DR virtual appliances while omitting statistics from all constituent sub-components such as domains or protected VMs. (Note: This qualifier can be used in conjunction with the “name” qualifier to refine reported output.)

-ov, --drva-only

Generate only DRVA specific stats.

-oD, --domain-only

Generate only domain specific stats for the DRVA.

-on, --vm-only

Generate only protected VM specific stats for the DRVA.

-or, --rocva-only

Generate only imported domain (RocVA) specific stats for the recovery site.
  • By Stat: Specifying a specific stat or a list of comma-separated stats using the --stats option will limit the reported data to the named stats only. Data from all other stats will be omitted from the generated report. The list of reportable stats includes:

CPU

Minimum/average/maximum CPU usage.

Memory

Minimum/average/maximum memory usage.

avgReads

Average read bandwidth of the DRVA in MBps.

avgWrites

Average write bandwidth of the DRVA in MBps.

avgReadIops

Average read IOPS of the DRVA.

avgWriteIops

Average write IOPS of the DRVA.

totalWritesSizeDuration 

Total data written during fetch interval for DRVA in MB.

totalWritesDuration

Total number of write IOs during fetch interval for DRVA.

avgReadsDomain

Average read bandwidth of a DRVA’s domain in MBps.

avgWritesDomain

Average write bandwidth of a DRVA’s domain in MBps.

avgReadIopsDomain

Average read IOPS of the DRVA’s domain.

avgWriteIopsDomain

Average write IOPS of the DR virtual appliance.

totalWritesSizeDurationDomain

Total data written during fetch interval for DRVA’s domain in MB.

totalWritesDurationDomain  

Total number of write IOs during fetch interval for DRVA’s domain.

fgCount

Total number of foreground IOs.

fgSize

Total size of foreground IOs in MB.

bgCount

Total number of background IOs.

bgSize

Total size of background IOs in MB.

totalGcCacheSize

Total GC Cache Size in MB.

btreePageReadsDuration

Total number of Page-ins during fetch interval.

btreePageReadsPerSec

Total number of Page-ins per second during fetch interval.

btreePageWritesDuration

Total number of Page-outs during fetch interval.

btreePageWritesPerSec

Total number of Page-outs per second during fetch interval.

gcHotDataWA

HOT data write amplification (valid:total ratio %).

gcColdDataWA

COLD data write amplification (valid:total ratio %).

activeGcBudget

Active GC budget in Bytes per second.

allocatedGcBudget

Allocated GC budget (Bytes per second).

throttledGcBudget

Throttled GC budget (Bytes per second).

rlTotalSize

Replication log total size in MB.

rlDirtySize

Replication log dirty size in MB.

dataRereadsPercent

% of data rereads from replication log in reader.

bufferUsg

Number of replication buffers used.

metaspaceInfo

GCDB metaspace info.

histogramBG

Histogram of all background IOs.

histogramFG

Histogram of all foreground IOs.

histogramBGDuration

Histogram of all background IOs during fetch interval.

histogramFGDuration

Histogram of all foreground IOs during fetch interval.

vmReadMbps

Protected data VM’s average read bandwidth in MBps.

vmWriteMbps

Protected data VM’s average write bandwidth in MBps.

vmReadIops

Protected data VM’s average read IOPS.

vmWriteIops

Protected data VM’s average write IOPS.

wbStats

Write Back mode specific stats.

estimatedTotalDataBytes

Estimated total data at recovery site in MB.

recoveredDataBytes

Recovered total data at recovery site in MB.

recoveredDataBytesDuration

Recovered total data at recovery site during fetch interval in MB.

recoveredDataBytesPerSec

Recovered rate of data at recovery site during fetch interval in MB.

recoveredObjectsDuration

Recovered total object count at recovery site during fetch interval in MB.

activeWriteBytes

Active writes in bytes.

allocResumedCount

Number of allocations resumed.

avgObjGetLatencyMsec

Average object GET latency in milliseconds.

maxObjGetLatencyMsec

Maximum object GET latency in milliseconds.

minObjGetLatencyMsec

Minimum object GET latency in milliseconds.

numDisPlaced

Number of data items placed.

numDisRemoved

Number of data items removed.

numDisUnlinked

Number of data items unlinked.

numObjStructsInUse

Number of object structs in use.

numObjsDownloaded

Number of objects downloaded.

numObjsFoundDeleted

Number of objects found and deleted.

numWritesAllocSuspended

Number of write allocations suspended.

numWritesCompleted

Number of writes completed.

numWritesIssued

Number of writes issued.

objBufsFree

Number of free objects.

objBufsInUse

Number of objects in use.

totalPostUncompressBytes

Total post uncompressed bytes.

totalPreUncompressBytes

Total pre uncompressed bytes.

Operation Parameters

If a custom directory was used to store collected stats (from fetch) or the data are moved, use the -o option to point to that location. By default, the local sct-stats directory is checked.

-o OUTPUTDIR

Directory in which the collected statistics files are stored.


The -p option allows output from the display mode to be directed to standard output. The generated report file will still be created.

-p r--print-to-stdout

Prints the results on stdout along with generating the report file.


Files created by Display mode

Display mode example usage