About this task
For example:
VPlexcli:/monitoring/directors/director-1-1-B/monitors> monitor destroy director-1-1-B_TestMonitor
WARNING: The following items will be destroyed:
Context
------------------------------------------------------------------------
/monitoring/directors/director-1-1-B/monitors/director-1-1-B_TestMonitor
Do you wish to proceed? (Yes/No) y
Create an SNMP monitor
SNMP sinks can be added only to monitors configured to collect fe-lu or disk statistics.
All the statistics in the fe-lu statistics category must be included in the monitor.
In the following example:
- The
monitor stat-list fe-lu
command displays all the statistics in the fe-lu category
- The
monitor create
command creates a monitor to collect all fe-lu statistics
- The
cd
command changes the context to the new monitor
- The
add-snmp-sink command adds an SNMP sink to the monitor
VPlexcli:/monitoring/directors/director-1-1-B/monitors> monitor stat-list fe-lu
Name Target Type Units
--------------- -------------- ------- --------
fe-lu.ops virtual-volume counter counts/s
fe-lu.read virtual-volume counter KB/s
fe-lu.read-lat virtual-volume bucket us
fe-lu.write virtual-volume counter KB/s
fe-lu.write-lat virtual-volume bucket us
VPlexcli:/monitoring/directors/director-1-1-B/monitors> monitor create --name SNMPTestMonitor --director director-1-1-B --stats fe-lu.read,fe-lu.read-lat,fe- lu.write,fe-lu.write-lat,fe-lu.ops --targets /clusters/cluster-1/virtual-volumes/polyvol_e4_extent_Symm0487_393
Successfully created 1 monitor(s) out of 1.
VPlexcli:/monitoring/directors/director-1-1-B/monitors> cd director-1-1-B_SNMPTestMonitor
VPlexcli:/monitoring/directors/director-1-1-B/monitors/director-1-1-B_ SNMPTestMonitor> add-snmp-sink --name fe-lu-stats
Displaying monitors
Use the
ls /monitoring/directors/*/monitors command to display the names of all monitors configured on the system:
VPlexcli:/> ls /monitoring/directors/*/monitors
/monitoring/directors/director-1-1-A/monitors:
DEFAULT_director-1-1-A_PERPETUAL_vplex_sys_perf_mon_v8
director-1-1-A_Billy35_FE_A0-FC00_stats
director-1-1-A_director-fe-21112011
director-1-1-A_diskReportMonitor
.
.
.
/monitoring/directors/director-1-1-B/monitors:
DEFAULT_director-1-1-B_PERPETUAL_vplex_sys_perf_mon_v8
.
.
.
Use the
ll /monitoring/directors/*/monitors command to display summarized information about all the monitors for the specified context and object:
VPlexcli:/> ll /monitoring/directors/director-1-1-A/monitors
/monitoring/directors/director-1-1-A/monitors:
Name Ownership Collecting Period Average Idle Bucket Bucket Bucket Bucket
----------------------------- --------- Data ------ Period For Min Max Width Count
------------------------------- --------- ---------- ------ ------- ---- ------ ------ ------ ------
director-1-1-A_FE_A0-FC00 false false 5s - - - - - 64
director-1-1-A_director-fe false false 5s - - - - - 64
director-1-1-A_ipcom-21112011 false false 5s - - - - - 64
director-1-1-A_portReportMon false false 5s - - - - - 64
.
.
.
Use the
ll /monitoring/directors/*/monitors/monitor-name command to display detailed information about all the specified monitor:
VPlexcli: ll /monitoring/directors/director-2-1-B/monitors/director-2-1-B_volumeReportMonitor
Attributes:
Name Value
--------------- --------------------------------------------------------------
average-period -
bucket-count 64
bucket-max -
bucket-min -
bucket-width -
collecting-data true
firmware-id 9
idle-for 5.44days
ownership true
period 0s
statistics [virtual-volume.ops, virtual-volume.read,
virtual-volume.write]
targets DR1_C1-C2_1gb_dev10_vol, DR1_C1-C2_1gb_dev11_vol,
DR1_C1-C2_1gb_dev12_vol, DR1_C1-C2_1gb_dev13_vol,
DR1_C1-C2_1gb_dev14_vol, DR1_C1-C2_1gb_dev15_vol,
DR1_C1-C2_1gb_dev16_vol, DR1_C1-C2_1gb_dev17_vol,
DR1_C1-C2_1gb_dev18_vol, DR1_C1-C2_1gb_dev19_vol, ... (1300
total)
Contexts:
Name Description
----- ------------------------------------------------------------------------
sinks Contains all of the sinks set up to collect data from this performance
monitor.
Use the
ll /monitoring/directors/*/monitors/monitor-name/sinks command to display the sinks associated with the specified monitor:
VPlexcli: ll /monitoring/directors/director-2-1-B/monitors/director-2-1-B_volumeReportMonitor/sinks
/monitoring/directors/bob70/monitors/bob70_volumeReportMonitor/sinks:
Name Enabled Format Sink-To
---- ------- ------ --------------------------------------------------------
file true csv /var/log/VPlex/cli/reports/volumeReportMonitor_bob70.csv
Table 1. Monitor and sink field descriptions
Field
|
Description
|
average-period
|
The actual average sampling period.
|
collecting-data
|
Whether or not this performance monitor is collecting data. A monitor collects data if it has at least one enabled sink.
|
firmware-id
|
The firmware ID of the monitor.
|
idle-for
|
The elapsed time since this performance monitor was accessed in the firmware.
|
name
|
A director-wide unique name for this performance monitor intended to be meaningful to the user.
|
ownership
|
Whether or not this monitor was created in this instance of metro node Management Console.
|
period
|
Sampling period in seconds.
|
statistics
|
List of performance statistics that are being monitored.
|
targets
|
List of targets that apply to the monitored performance statistics. A target can be a port, storage volume, or virtual volume. Not all statistics require targets.
|
Monitor sink display fields
|
Name
|
For file sinks, the name of the created sink context. Default is 'file'.
|
Enabled
|
Whether the monitor sink is enabled or disabled.
|
Format
|
The required output format. Can be
csv or
table. Default is
csv for file sinks and
table for console sinks.
|
Sink-To
|
For file sinks, the filename to sink data to.
|