Monitoring InterSystems IRIS Using the irisstat Utility
C:\>cd C:\iris-install-dir\Bin> C:\iris-install-dir\Bin>irisstat C:\>cd C:\iris-install-dir\mgr C:\iris-install-dir\mgr>ctstat C:>\iris-install-dir\Bin\irisstat -s\iris-install-dir\mgr
bash-3.00$ ./bin/irisstat -smgr
bash-3.00$ iris stat iris_instance_name
bash-3.00$ ./irisstat -p-1
bash-3.00$ ./irisstat -a0 -f-1 -p-1 -m3
|a[0/1]||Displays “all” information as described in the Running irisstat with Options section of this chapter.|
Displays information about global buffer descriptors blocks (BDBs). You can specify a combination of the following bits:
See also l.
Running irisstat -b64 may require extra time.
Displays counters, which are statistics on system performance. You can specify a combination of the following bits:
Creates dump of InterSystems IRIS processes. You can specify the following options:
Displays the InterSystems IRIS system error log (see InterSystems IRIS System Error Log in the “Monitoring InterSystems IRIS Using the Management Portal” chapter); e2 displays additional process information (in hex).
Displays global module flags. You can specify a combination of the following bits:
Displays ^GLOSTAT information; for information see the “Gathering Global Activity Statistics Using ^GLOSTAT” chapter in this document.
Displays irisstat usage information.
Displays the journal system master structure, which lists information about journaling status. j32 displays mirror server information.
|-k||Displays information about prefetch daemons used by the $PREFETCHON function; see $PREFETCHON in the ObjectScript Reference.|
Displays information about least recently used (LRU) global buffer descriptor block (BDB) queue, but not the contents of the BDBs. You can specify a combination of the following bits:
See also b.
Displays Global File Table (GFILETAB), which contains information about all databases, listed by SFN, that have been mounted since the instance of InterSystems IRIS started up. You can specify a combination of the following bits:
Displays information about network structures and local/remote SFN translations; irisstat -n-1 also displays namespace structures.
|-o1||Clears the resource statistics displayed by irisstat -c to reestablish a base situation without rebooting InterSystems IRIS. No output is produced.|
Displays information about processes that are running in InterSystems IRIS. The information is obtained from the process ID table (PIDTAB). You can specify a combination of the following flags:
Displays information about hibernation semaphores.
|-s[dir]||Specifies the directory containing the irisstat executable when running the command from other than the mgr or bin directories.|
|-t[seconds]||Runs irisstat repeatedly in a loop every seconds seconds until halted. Only the global module flags section is displayed, as when -f1 is specified.|
Displays information about InterSystems IRIS locks stored in the lock table (see Monitoring Locks in the “Monitoring InterSystems IRIS Using the Management Portal” chapter of this guide). You can specify a combination of the following bits:
|-v1||Ensures that the InterSystems IRIS executable associated with the shared memory segment irisstat is being run on and the irisstat executable are from the same version; if not, irisstat will not run.|
Displays information about BDBs in write daemon queues.
Displays, in hex, the contents of blocks held in GBFSPECQ.
Displays configuration information for inter-job communication (IJC) devices.
Displays resource statistics over an interval of ‘secs’ seconds. Sample block collisions ever ‘msec’ milliseconds.
Resource information same as c.
The ^BLKCOL utility, described in the “Monitoring Block Collisions Using ^BLKCOL” chapter of this guide, provides more detailed information about block collisions.
Displays status of cluster on platforms that support clustering. You can specify a combination of the following bits:
Displays, in hex, the contents of the global buffer descriptors and the global buffer for a specific buffer descriptor block (BDB).
Same as H except that the information is displayed by BDB.
Displays, in hex, the contents of the global buffer descriptors and the global buffer for a specific system file number (sfn) and block number (blk) pair.
Same as G except that the information is displayed by system file number and block number pair.
The block must be in the buffer pool.
Displays the incremental backup data structures.
Displays the license.
Displays the mailbox log.
Disabled by default. A special build is required to capture and log the mailbox messages; additional logging may be required.
Displays ECP network information. You can specify a combination of the following values:
Displays information about routine buffers in use (or changing), class control blocks (CCB), and least recently used (LRU) queues. You can specify a combination of the following values:
Displays information about the cause of a hang based on a self diagnosis of whether or not the system is hung. You can specify a combination of the following bits:
In a cluster, this option should be run all cluster members.
Displays hex values of many in-memory tables, including National Language Settings (NLS) tables.
Displays variables that are part of the process memory structures; of limited value unless you have access to the source code.
Windows only. Run from the directory that contains the pid.dmp file.
|-W||Performs the same function as the Backup.General.ExternalThaw() classmethod, and may be used to resume the write daemon after Backup.General.ExternalFreeze() has been called in cases in which a new InterSystems IRIS session cannot be started. (See External Backup in the “Backup and Restore” chapter of the Data Integrity Guide for information on the use of these methods.) This option will not unfreeze the write daemon from any hang or suspension caused by anything other than a backup. Use of this option is recorded in the messages log.|
Displays the contents of the device translation table. It is organized by device number and shows both the numeric and plaintext class identifiers.
irisstat -e2 -f-1 -m-1 -n3 -j5 -g1 -L1 -u-1 -v1 -p-1 -c-1 -q1 -w2 -E-1 -N65535