test veritas logo


AMFSTAT(1M)

NAME

amfstat - Asynchronous Monitoring Framework (AMF) driver status reporting utility

SYNOPSIS

amfstat

amfstat [-h]

amfstat [-g] [-t] [-v] [-n] [-i] [-s seconds]

DESCRIPTION

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 AMF’s kernel hooks were exercised in the system

OPTIONS

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.

OUTPUT

(1) The information about IMFD is displayed as follows:

IMFD
======================
RID PID
11 19595460

If IMFD is running and is registered with AMF, then amfstat displays the registration information as the first section in its output. The information displays the resource id (RID) and PID of IMFD that is provided by AMF.

(2) 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 mountagent

Each 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.

(3) 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_abc

Each 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 Prevent

Each 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 BOUNDRIGHT

Substring match options that are available are as follows:
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.

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 ’+ ’.

(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> Global

Each 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> Global

Each 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.

(i) For user space events (monitors):

Certain event notifications are generated in user space. These notifications are relayed to AMF through the Intelligent Monitoring Framework Daemon (IMFD).

amfstat displays the different types of user space events in the respective user space sections. The first line in every user space section displays the name of the event type and the number of registrations of that type.

In a user space section, each row represents an event. In each row, the RID column contains the "resource id" provided by AMF for this event. The R_RID column contains the rid of the reaper under which this event was registered. Group can be <none> if no group name was specified while registering the event. The rest of the columns are specific to the type of event and are not predefined.

DG offline Monitors (2):
==========================
 RID R_RID GROUP DGName
 12 3 abc_grp dg123
 16 3 xyz_grp dg234

(4) 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 69

The hooks called need not be equal to events triggered.

RETURN VALUES

o 0

The command was successful.

o non-0

An error occurred.

FILES

/opt/VRTSamf/bin/amfstat


VCS 7.4.3 AMFSTAT(1M)