Dell InsightIQ 4.3.0.0 Administration Guide

Syntax

iiq_data_export perf export --cluster<cluster-name> | --data-module <data-module>
  --cluster <cluster-name>
  --data-module <data-module> 
  [--breakout-by <breakout>]
  [--number-breakouts <integer>]
  [--name <name>]
  [--path <path>] 
  [--filter-rule <breakout>:<filter>...]
  [--interval <integer> <units>]
  [--end {<timestamp> | now}]
  [--min-max]
  [--fmt-time]

Options

{--cluster | -c} <cluster-name>

Exports performance data about the specified cluster.

{--data-module | -d} <data-module>

Exports the specified performance data module.

Table 1. Performance data module values

Module description	Module value
Active Clients	client_active
Average Cached Data Age	cache_oldest_page_age
Average Disk Hardware Latency	disk_adv_access_latency
Average Disk Operation Size	disk_adv_op_size
Average Pending Disk Operations Count	disk_adv_io_queue
Blocking File System Events Rate	ifs_blocked
Cache Hits	cache_hits
Cluster Capacity	ifs_cluster_capacity
Connected Clients	client_connected
Contended File System Events Rate	ifs_contended
CPU %Use	cpu_use
CPU Usage Rate	cpu_usage_rate
Deadlocked File System Events Rate	ifs_deadlocked
Deduplication Summary (Logical)	dedupe_logical
Deduplication Summary (Physical)	dedupe_physical
Disk Activity	disk_adv_busy
Disk IOPS	disk_iops
Disk Operations Rate	disk_adv_op_rate
Disk Throughput Rate	disk_adv_bytes
External Network Errors	ext_error
External Network Packets Rate	ext_packet
External Network Throughput Rate	ext_net_bytes
File System Events Rate	ifs_heat
File System Throughput Rate	ifs_total_rate
Job Workers	worker
Jobs	job
L1 and L2 Cache Prefetch Throughput Rate	cache_all_prefetch
L1 Cache Throughput Rate	cache_l1_read
L2 Cache Throughput Rate	cache_l2_read
L3 Cache Throughput Rate	cache_l3_read
Locked File System Events Rate	ifs_lock
Overall Cache Hit Rate	cache_all_read_hitrate
Overall Cache Throughput Rate	cache_all_read
Pending Disk Operations Latency	disk_adv_io_latency
Protocol Operations Average Latency	proto_latency
Protocol Operations Rate	proto_op_rate
Slow Disk Access Rate	disk_adv_access_slow
Workload CPU Time	pp_cpu_use
Workload IOPS	pp_iops
Workload L2/L3 Cache Hits	pp_cache_hits
Workload Latency	pp_latency
Workload Throughput	pp_throughput

{--breakout-by | -b} <breakout>...

Applies the specified breakouts to the exported data.

Table 2. Breakout values

Breakout description	Breakout value
Client	remote_addr
Direction	direction
Disk	disk
Disk Pool	disk_pool
Event	event_name
Interface	interface
Job ID	job_id
Job Type	job_name
Node (logical node number)	node
Node Pool	nodepool
Operation Class	op_class
Path	path
Protocol	protocol
Service	service
Tier	tier
Workload	iiq_dataset_id
Workloads by Average	workload_keygen
Workloads by Max Values	workload_keygen_for_max
Pinned Workloads by Average	pinned_key

{--number-breakouts | -m} <integer>}

Specifies the number of breakout components to include for each breakout. For example, if you break out a performance data module by client, specifying --number-breakouts 5 exports data about the top five clients. The default number is 12.

{--name | -n} <name>

Specifies the name of the .csv file. A timestamp is appended to the specified name.

{--path | -p} <path>

Specifies where to create the .csv file. Specify a full directory path. If no name is specified, the file is named according to the following pattern:

<data_module>_[<breakout_by>_]<report_id>_<time_generated>.csv

<breakout_by> is included only if the option is specified.

{--filter-rule | -r} <breakout>:<filter>...

Applies the specified filter rule to the exported data. To specify a filter, specify the breakout that the filter applies to.

Table 3. Filter values

Breakout description	Breakout value	Filter values
Client	remote_addr	The hostname or IP address of a client. For example: --filter-rule remote_addr:client.ip.com
Direction	direction	out in For example: --filter-rule direction:out
Disk	disk	The disk number in the following format: <devid>/bay <number> For this filter, enclose both the breakout value and the filter value in quotation marks. For example: --filter-rule "disk:1/bay 1"
Disk Pool	disk_pool	The name of a disk pool. For example: --filter-rule disk_pool:pool1
Event	event_name	lookup getattr read write setattr rename link unlink For example: --filter-rule event_name:write
Interface	interface	The interface number and type in the following format: <devid>/<type> The format mirrors the output format of the isi networks list interfaces command, except that the ":" is replaced with a "/". For example, if the following interface name appears in the output of the isi networks list interfaces command: l:ext-1 The following filter value would be valid: --filter-rule interface:1/ext-1
Job ID	job_id	The numeric ID of a job. For example: --filter-rule job_id:4
Job Type	job_name	AutoBalance AutoBalanceLin AVScan Collect Dedupe DedupeAssessment DomainMark FlexProtect FlexProtectLin FSAnalyze IntegrityScan MediaScan MultiScan PermissionRepair QuotaScan SetProtectPlus ShadowStoreDelete SmartPools SnapRevert SnapshotDelete TreeDelete For example: --filter-rule job_name:AVScan
Node	node	The logical node number (LNN) of a node. For example: --filter-rule node:1
Node Pool	nodepool	The name of the node pool. For example: --filter-rule nodepool:pool1
Operation Class	op_class	read write other namespace_read file_state create namespace_write delete session_state For example: --filter-rule op_class:delete
Path	path	The path of a directory beginning with /ifs. For example: --filter-rule path:/ifs/data/media
Protocol	proto_name	nfs3 nfs4 smb2 http papi siq For example: --filter-rule proto_name:siq
Service	service
Tier	tier	The name of the tier. For example: --filter-rule tier:archive
Workload	iiq_dataset_id
Workloads by Average	workload_keygen
Workloads by Max Values	workload_keygen_for_max
Pinned Workloads by Average	pinned_key

{--interval | -i} <integer> <units>

Specifies the length of the data collection period.

The default interval is one hour, or 1H. The following units are valid:

Y

Specifies years

M

Specifies months

W

Specifies weeks

D

Specifies days

H

Specifies hours

m

Specifies minutes

s

Specifies seconds

{--end | -e} {<timestamp> | now}

Specifies the end of the data collection period. The default is now, which specifies the current time.

Specify <timestamp> in the following format:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

{--min-max | -x}

Includes the maximum and minimum values for each 10 minute interval.

{--fmt-time | -f}

Creates an easily readable timestamp in the CSV file. If this option is not specified, the timestamp is in POSIX format.

Examples

The following command exports data about active clients over the past hour, broken out by node:

iiq_data_export perf export --cluster cluster1 \
--data-module client_active --path /home/exports --name disk-act \
--breakout-by node

The following command exports data about active clients during January of 2015:

iiq_data_export perf export --cluster cluster1 \
--data-module client_active --path /home/exports --name used \
--end 2022-10-31 --interval 1M