amfstat - Asynchronous Monitoring Framework (AMF) driver status reporting utility
amfstat
amfstat [-h]
amfstat [-g] [-t] [-v] [-n] [-I] [-s seconds]
The amfstat utility reports the current state of usage of the AMF driver. It can provide the following information:
o about the reapers registered with the AMF driver o about the container online, container offline, file online, and directory online only on Solaris10/AIX 6.1 and later o about the process online, process offline, mount online, and mount offline events registered with the AMF driver o about the number of events triggered while they were registered with the AMF driver o about the number of times AMFs kernel hooks were exercised in the system
Without any options, amfstat reports information about the reapers registered with the AMF driver and about the various events registered with the AMF driver.
-h Show the usage message. -v Show all information about the events. -g Show only the reapers registered with the AMF driver. -t Show only the events (monitors) registered with the AMF driver. -n Show information about the number of events triggered while they were registered with the AMF driver. This also shows information about the number of times the various AMF hooks were exercised in the system. These events are grouped by the type of monitoring that AMF did for those events. -I Interactive mode. The updated status is reported on every "enter" key press. -s Auto-update mode. Set the update frequency (in seconds) using this option. The updated status is reported every so often.
(1) The information about the reapers registered with AMF is displayed as follows:
Registered Reapers (2): ======================= RID PID MONITOR TRIGG REAPER 30 10234 5 0 processagent 34 13479 3 1 mountagentEach row represents one reaper registered with AMF. Total number of reapers registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for the reaper itself. The PID column contains the pid of the reaper. the MONITOR column contains the number of events that are being monitored by this reaper. The TRIGG column contains the number of events which are registered with AMF and have been triggered in the system but not yet reaped by the reaper. The REAPER column contains the name of the reaper.
(2) The information about the events (monitors) registered with AMF is displayed as follows.
(a) For process online events (monitors):
Process ONLINE Monitors (2): ============================ RID R_RID PID GROUP 43 42 4419 <none> 45 44 3908 grp_abcEach row represents a pron event. Total number of pron events registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for this pron event. The R_RID column contains the rid of the reaper under which this event was registered. The PID column contains the pid which AMF is monitoring for online. The GROUP column contains the group name under which this event was registered. Group can be <none> if no group name was specified while registering the event.
(b) For process offline events (monitors):
Process OFFLINE Monitors (3): ============================= RID R_RID PATH ARGV0 ARGS UID EUID GID EGID GROUP CONTAINER ACTION 34 30 /usr/sbin/who /usr/sbin/who <none> <any> <any> <any> <any> group_xyz <none> Allow 35 30 /usr/sbin/nscd /usr/sbin/nscd -x -t 20 121 <any> <any> 0 <none> Global Allow 37 30 /orcl/oracle ora_lmon_busdb <none> 20 <any> 20 <any> ORCL Global PreventEach row represents a proff event. Total number of proff events registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for this proff event. The R_RID column contains the rid of the reaper under which this event was registered. The rest of the columns specify the exact event that is being monitored. In some cases, the argv0 can be different than the path. The GROUP column contains the group name under which this event was registered. Group can be <none> if no group name was specified while registering the event. The CONTAINER column contains the wpar name on AIX and the zone name on Solaris. Container can be <none> if no container name was specified while registering the event. On Linux and HP-UX, this column is not applicable. The ACTION column indicates if the event is allowed to start outside of VCS control (used for prevention of concurrency violation). The value Allow indicates event will be allowed whereas the value Prevent indicates the event will be prevented from starting outside of VCS control. For events that have substring information, a + symbol in the ARGS and ARGV0 columns indicates the presence of more information. This additional information can be viewed using the -v option of the amfstat command. The following example illustrates the format of the additional information displayed using this verbose option.
ARGV0 Substring Option: FREE ARGS Global Option: MATCH_ANY ARGS Substring (1): "substr01" BOUNDRIGHT ARGS Substring (2): "substring02" FREE ARGS Substring (3): "substring03" BOUNDLEFT BOUNDRIGHTSubstring match options that are available are as follows:
By default, the ARGV0 substring option is exact match (that is, no substring information). For any other values, the ARGV0 column is marked with a + symbol. For ARGS field, if substrings are specified then it is marked with a + .
o MATCH_ANY: At least one of the specified substrings must match. This option applies to the set of substrings specified.
o MATCH_ALL: All of the specified substrings must match. This option applies to the set of substrings specified.
o FREE: This is the standard substring match. This option applies to the individual substring specified.
o BOUNDLEFT: The substring must be found and the character to the left of the substring must not be a word character. This option applies to the individual substring specified.
o BOUNDRIGHT: The substring must be found and the character to the right of the substring must not be a word character. This option applies to the individual substring specified.
(c) For mount online events (monitors):
Mount ONLINE Monitors (2): ========================== RID R_RID FSTYPE DEVICE MOUNTPOINT GROUP CONTAINER 49 48 nfs punevault:/re /mnt grp_pqr <none> 51 50 reiserfs /dev/sdb3 / <none> GlobalEach row represents a mnton event. Total number of mnton events registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for this mnton event. The R_RID column contains the rid of the reaper under which this event was registered. The rest of the columns specify the exact event that is being monitored. The GROUP column contains the group name under which this event was registered. Group can be <none> if no group name was specified while registering the event. The CONTAINER column contains the wpar name on AIX and the zone name on Solaris. Container can be <none> if no container name was specified while registering the event. On Linux and HP-UX, this column is not applicable.
(d) For mount offline events (monitors):
Mount OFFLINE Monitors (2): =========================== RID R_RID FSTYPE DEVICE MOUNTPOINT GROUP CONTAINER 53 52 vxfs /dev/sda5 /mnt grp_jkl <none> 55 54 ext3 /dev/sda2 /mnt4 <none> GlobalEach row represents a mntoff event. Total number of mntoff events registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for this mntoff event. The R_RID column contains the rid of the reaper under which this event was registered. The rest of the columns specify the exact event that is being monitored. The GROUP column contains the group name under which this event was registered. Group can be <none> if no group name was specified while registering the event. The CONTAINER column contains the wpar name on AIX and the zone name on Solaris. Container can be <none> if no container name was specified while registering the event. On Linux and HP-UX, this column is not applicable.
(e) For file online events (monitors):
File ONLINE Monitors (1): ========================== RID R_RID FILE GROUP 5 4 /tests/d1/a1 <none>Each row represents a fileon event. Total number of fileon events registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for this fileon event. The R_RID column contains the rid of the reaper under which this event was registered. FILE column contains the file being monitored for FileON. The GROUP column contains the group name under which this event was registered. Group can be <none> if no group name was specified while registering the event. File Online is currently supported only on Solaris10/AIX 6.1 and later.
(f) For directory online events (monitors):
Directory ONLINE Monitors (2): ========================== RID R_RID DIRECTORY GROUP 11 10 /tests/d2 <none> 15 14 /tests/d1 <none>Each row represents a diron event. Total number of diron events registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for this diron event. The R_RID column contains the rid of the reaper under which this event was registered. The DIRECTORY column specifies the exact directory event that is being monitored for DirON. The GROUP column contains the group name under which this event was registered. Group can be <none> if no group name was specified while registering the event. Directory Online is currently supported only on Solaris10/AIX 6.1 and later.
(g) For container online events (monitors):
Container ONLINE Monitors (1): ========================== RID R_RID CONTAINER GROUP 4 3 container1 <none>Each row represents a conton event. Total number of conton events registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for this conton event. The R_RID column contains the rid of the reaper under which this event was registered. The CONTAINER column specifies the container event that is being monitored for ContON. The GROUP column contains the group name under which this event was registered. Group can be <none> if no group name was specified while registering the event. Container Online is currently supported only on Solaris10/AIX 6.1 and later.
(h) For container offline events (monitors):
Container OFFLINE Monitors (1): ========================== RID R_RID CONTAINER GROUP 4 3 container1 <none>Each row represents a contoff event. Total number of contoff events registered with AMF are mentioned in the first line. In each row, the RID column contains the "resource id" provided by AMF for this contoff event. The R_RID column contains the rid of the reaper under which this event was registered. The CONTAINER column specifies the container event that is being monitored for ContOFF. The GROUP column contains the group name under which this event was registered. Group can be <none> if no group name was specified while registering the event. Container Offline is currently supported only on Solaris10/AIX 6.1 and later.
(3) The information about the number of registered events that got triggered and about the number of times the AMF hooks got exercised in the system is displayed as follows:
AMF Statistics: Hooks Called Events Triggered PRON 154 98 PROFF 14 4 MNTON 36 22 MNTOFF 123 69The hooks called need not be equal to events triggered.
o 0 The command was successful.
o non-0 An error occurred.
/opt/VRTSamf/bin/amfstat
Copyright ©) 2011 Symantec.
All rights reserved.
VCS 6.0 | AMFSTAT (1M) |