# Agents and modules generated by the plugin

The plugin will create an agent for each target database. That agent will contain the following modules:

If **database\_summary** is activated:

<table border="1" id="bkmrk-agent_wait_time_perc" style="border-collapse: collapse; width: 100%; height: 348px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">AGENT\_WAIT\_TIME\_PERCENT</td><td style="width: 50%; height: 29px;">Represents the percentage of time that DB2 agents are waiting for some activity, such as locks or external requests.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">APP\_RQSTS\_COMPLETED\_TOTAL</td><td style="width: 50%; height: 29px;">Indicates the total number of application requests completed in the DB2 database.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">AVG\_RQST\_CPU\_TIME</td><td style="width: 50%; height: 29px;">Represents the average CPU time used by each application request on the database.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">CF\_WAIT\_TIME\_PERCENT</td><td style="width: 50%; height: 29px;">Shows the percentage of time that DB2 agents are waiting for shared resources on multi-node systems.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">IO\_WAIT\_TIME\_PERCENT</td><td style="width: 50%; height: 29px;">Indicates the percentage of time that DB2 agents are waiting for input/output (I/O) operations.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">LOCK\_WAIT\_TIME\_PERCENT</td><td style="width: 50%; height: 29px;">Represents the percentage of time that DB2 agents are waiting for resource locks.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">NETWORK\_WAIT\_TIME\_PERCENT</td><td style="width: 50%; height: 29px;">Shows the percentage of time that DB2 agents are waiting for network operations.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">RECLAIM\_WAIT\_TIME\_PERCENT</td><td style="width: 50%; height: 29px;">Indicates the percentage of time that DB2 agents are waiting for resource releases.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">ROUTINE\_TIME\_RQST\_PERCENT</td><td style="width: 50%; height: 29px;">Represents the percentage of time used by stored routines (stored procedures, functions, etc.) in each application request.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">RQST\_WAIT\_TIME\_PERCENT</td><td style="width: 50%; height: 29px;">Shows the percentage of time that application requests are waiting to be executed by DB2 agents.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">TOTAL\_BP\_HIT\_RATIO\_PERCENT</td><td style="width: 50%; height: 29px;">Indicates the percentage of hits in the buffer cache (buffer pool), which represents the efficiency in accessing data in memory.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">TOTAL\_BP\_HIT\_RATIO\_PERCENT</td><td style="width: 50%; height: 29px;">Represents the percentage of time used by transaction completion operations in each application request.</td></tr></tbody></table>

If **transactional\_log** is activated:

<table border="1" id="bkmrk-log-utilization-perc" style="border-collapse: collapse; width: 100%; height: 29px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Log utilization percent</td><td style="width: 50%; height: 29px;">Percentage of log used in Kilobytes</td></tr></tbody></table>

  
If **db\_size** is activated:

<table border="1" id="bkmrk-database-size-tama%C3%B1o" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%;">Database size</td><td style="width: 50%;">Database size in Megabytes</td></tr></tbody></table>

If **analyze\_connections** is activated:

<table border="1" id="bkmrk-active-connections-n" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%;">Active connections</td><td style="width: 50%;">Number of active connections</td></tr></tbody></table>

If **cache\_stats** is activated:

<table border="1" id="bkmrk-cache-hit-ratio-%3Cnom" style="border-collapse: collapse; width: 100%; height: 29px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">cache hit ratio &lt;buffer cache name of each row&gt;</td><td style="width: 50%; height: 29px;"> Cache hit ratio for each BP\_NAME. By combining the cache hit ratio with "bp\_name" (buffer cache name), you can evaluate the buffer cache performance for each of the existing caches in the DB2 database. You can monitor and compare the cache hit ratio for each buffer cache individually, allowing you to identify which buffer caches are operating most efficiently and which may require adjustments.</td></tr></tbody></table>

The plugin will also create a module for each custom query defined in the configuration file.