Nimsoft Monitor db2 Guide

177 downloads 271 Views 1MB Size Report
db2 Guide v4.0 series. Nimsoft® Monitor ... with regard to this manual and any information contained herein, including but not limited to the implied warranties of .
Nimsoft® Monitor™

db2 Guide v4.0 series

Legal Notices Copyright © 2013, CA. All rights reserved. Warranty The material contained in this document is provided "as is," and is subject to being changed, without notice, in future editions. Further, to the maximum extent permitted by applicable law, Nimsoft LLC disclaims all warranties, either express or implied, with regard to this manual and any information contained herein, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. Nimsoft LLC shall not be liable for errors or for incidental or consequential damages in connection with the furnishing, use, or performance of this document or of any information contained herein. Should Nimsoft LLC and the user have a separate written agreement with warranty terms covering the material in this document that conflict with these terms, the warranty terms in the separate agreement shall control. Technology Licenses The hardware and/or software described in this document are furnished under a license and may be used or copied only in accordance with the terms of such license. No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Nimsoft LLC as governed by United States and international copyright laws. Restricted Rights Legend If software is for use in the performance of a U.S. Government prime contract or subcontract, Software is delivered and licensed as "Commercial computer software" as defined in DFAR 252.227-7014 (June 1995), or as a "commercial item" as defined in FAR 2.101(a) or as "Restricted computer software" as defined in FAR 52.227-19 (June 1987) or any equivalent agency regulation or contract clause. Use, duplication or disclosure of Software is subject to Nimsoft LLC’s standard commercial license terms, and non-DOD Departments and Agencies of the U.S. Government will receive no greater than Restricted Rights as defined in FAR 52.227-19(c)(1-2) (June 1987). U.S. Government users will receive no greater than Limited Rights as defined in FAR 52.227-14 (June 1987) or DFAR 252.227-7015 (b)(2) (November 1995), as applicable in any technical data. Trademarks Nimsoft is a trademark of CA. Adobe®, Acrobat®, Acrobat Reader®, and Acrobat Exchange® are registered trademarks of Adobe Systems Incorporated. Intel® and Pentium® are U.S. registered trademarks of Intel Corporation. Java(TM) is a U.S. trademark of Sun Microsystems, Inc. Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation. Netscape(TM) is a U.S. trademark of Netscape Communications Corporation. Oracle® is a U.S. registered trademark of Oracle Corporation, Redwood City, California. UNIX® is a registered trademark of the Open Group. ITIL® is a Registered Trade Mark of the Office of Government Commerce in the United Kingdom and other countries. All other trademarks, trade names, service marks and logos referenced herein belong to their respective companies. For information on licensed and public domain software, see the Nimsoft Monitor Third-Party Licenses and Terms of Use document at: http://docs.nimsoft.com/prodhelp/en_US/Library/index.htm?toc.htm?1981724.html.

Contact Nimsoft For your convenience, Nimsoft provides a single site where you can access information about Nimsoft products. At http://support.nimsoft.com/, you can access the following: ■

Online and telephone contact information for technical assistance and customer services



Information about user communities and forums



Product and documentation downloads



Nimsoft Support policies and guidelines



Other helpful resources appropriate for your product

Provide Feedback If you have comments or questions about Nimsoft product documentation, you can send a message to [email protected].

Contents Chapter 1: db2 4.0

7

db2 Overview ............................................................................................................................................................... 7

Chapter 2: db2 Probe Deployment

9

Supported Platforms .................................................................................................................................................... 9 System Requirements .................................................................................................................................................. 9 Software Requirements ............................................................................................................................................... 9 Monitoring System Requirements ............................................................................................................................. 10 Probe Deployment Information ................................................................................................................................. 10

Chapter 3: db2 Configuration

11

Probe Defaults ............................................................................................................................................................ 12 Probe Configuration Interface Installation ................................................................................................................. 13 Probe Configuration ................................................................................................................................................... 13 Setup Tab ............................................................................................................................................................ 13 Connections Tab .................................................................................................................................................. 18 Profiles Tab.......................................................................................................................................................... 22 Templates Tab ..................................................................................................................................................... 27 Status Tab ............................................................................................................................................................ 44 Group Tab ........................................................................................................................................................... 45 Checkpoints Metrics............................................................................................................................................ 46

Chapter 4: QoS Threshold Metrics

53

db2 QoS Metrics ......................................................................................................................................................... 53 db2 Alert Metrics Default Settings ............................................................................................................................. 58

Contents 5

Chapter 1: db2 4.0 This description applies to db2 version 4.0. This section contains the following topics: db2 Overview (see page 7) Documentation Changes (see page 8)

db2 Overview The db2 probe monitors DB2 instances, databases, table spaces and applications, using the DB2 snapshot and tablespace statistic APIs to extract vital information about your DB2 servers.

Chapter 1: db2 4.0 7

db2 Overview

Documentation Changes This table describes the version history for this document. Version

Date

What's New?

4.0

January 2013



Added Probe Defaults.



Added support for AIX 6.1 and 7.1 platforms.



Added check box to clear alarms on restart.



Added Timeout check box in the Edit Connection dialog.



Implementation of db2 probe based on V4 database framework; added new checkpoints and support for custom checkpoints.

Related Documentation Documentation for other versions of the db2 probe The Release Notes for the db2 probe Getting Started with CA Nimsoft® Probes Monitor Metrics Reference Information for CA Nimsoft Probes

8 db2 Guide

Chapter 2: db2 Probe Deployment This section contains the system requirements and deployment information for the db2 probe. This section contains the following topics: Supported Platforms (see page 9) System Requirements (see page 9) Software Requirements (see page 9) Monitoring System Requirements (see page 10) Probe Deployment Information (see page 10)

Supported Platforms The db2 probe supports the same set of operating systems and databases as supported by the Nimsoft Server solution. Please refer to the Nimsoft Compatibility Support Matrix for the latest information on supported platforms.

System Requirements The db2 probe should be installed on systems with the following minimum resources: ■

Memory: 2-4 GB of RAM. This probe OOTB configuration requires 256 MB of RAM.



CPU: 3 GHz dual-core processor, 32-bit or 64-bit

Software Requirements The db2 probe requires the following software environment: ■

Nimsoft Monitor Server 5.1.1 or later



Nimsoft Robot 5.23 or later



Java Virtual Machine 1.6 or later (typically installed with NMS 5.0 and above)

Note: For SOC functionality, NM Server 5.6 or later and UMP 2.5.2 or later is required.

Chapter 2: db2 Probe Deployment 9

Monitoring System Requirements

Monitoring System Requirements This probe monitors DB2 instances, databases, table spaces and applications, using the DB2 snapshot and tablespace statistics APIs to extract vital information about your DB2 servers.

Probe Deployment Information There are two ways to distribute archive packages. You can distribute the package within Infrastructure Manager or use the standalone Nimsoft Distribution application. See Probe Deployment for more information on deploying probes.

10 db2 Guide

Chapter 3: db2 Configuration The db2 probe can monitor about 280 DB2 snapshot and statistics counters and some calculated values like: ■

i_agents_created_ratio



i_piped_sorts_rejected



db_pool_hit_ratio



db_avg_sort_time



db_pct_sort_overflows



db_avg_sort_heap



db_pct_hjs_overflows



db_pool_sync_reads



db_pool_sync_writes



db_pool_sync_idx_writes



db_pool_sync_idx_reads



db_pool_avg_async_read_time



db_pool_avg_async_write_time



db_pool_sync_write_time



db_pool_avg_write_time



db_avg_direct_read_time



db_avg_direct_write_time



db_cat_cache_hit_rto



app_avg_sort_time



app_pct_sort_overflows



app_pool_hit_ratio



app_avg_direct_read_time



app_avg_direct_write_time



app_cat_cache_hit_rto



app_pkg_cache_hit_rto



app_locklist_util

Chapter 3: db2 Configuration 11

Probe Defaults



bp_pool_hit_ratio



bp_pool_avg_async_read_time



bp_pool_avg_async_write_time



bp_pool_sync_write_time



bp_pool_avg_write_time



bp_avg_direct_read_time



bp_avg_direct_write_time



bp_pool_sync_reads



bp_pool_sync_writes



bp_pool_sync_idx_writes



bp_pool_sync_idx_reads



ts_usable_pages_pct



ts_used_pages_pct



ts_free_pages_pct



ts_max_used_pages_pct



i_pct_active_connections

Initial configuration of the db2 probe is done by defining connections and profiles for monitored instances, using the GUI. The probe may be running locally on the database server, or it may be configured to run as a remote client. Every profile will run in its own thread. Note: All windows containing lists are resizable. Click Apply to activate any configuration modifications done. This section contains the following topics: Probe Defaults (see page 12) Probe Configuration Interface Installation (see page 13) Probe Configuration (see page 13)

Probe Defaults At the time of deploying a probe for the first time on robot, some default configuration will get deployed automatically. These probe defaults could be Alarms, QoS, Profiles and so on which save time to configure the default settings. These probe defaults will be seen on a fresh install, that is no instance of that probe is already available on that robot in activated or deactivated state.

12 db2 Guide

Probe Configuration Interface Installation

Probe Configuration Interface Installation The probe configuration interface is automatically downloaded and installed by the Nimsoft Infrastructure Manager when the probe is deployed on a robot.

Probe Configuration This section contains specific configuration for the probe.

Setup Tab The Setup tab contains two sub tabs - General and Message pool. By default, the General sub tab is selected.

General Tab The General tab enables to set the general run-time parameters regarding the db2 probe.

This tab contains the following fields: Generate status only Instructs the probe to only generate status, not to issue an alarm when a threshold is breached. Select the Status tab to see the status for the different checkpoints.

Chapter 3: db2 Configuration 13

Probe Configuration

Clear Alarm On Restart Allows you to clear alarms on restart. By default, this check box is selected. Alarm severity filter Sets a "filter" on which severity levels are considered as alarms. The db2 probe is capable of checking many areas of the databases. Some events that are generated are vital and key to the performance and availability of the database. As a database administrator, you may want to pass the important events on to the operations centre or helpdesk, so the event can trigger pagers, email etc. The Alarm severity filter will consider the events matching the selected severity level and higher as alarms, and pass these on whenever the Generate status only option is not selected. Example: If you set this to major, then only messages with severity major and upward are considered as alarms. Status Auto-Update Lets you activate/deactivate the Status Auto-Update functionality as described below: The Status Auto-Update parameter (number of seconds) specifies the automatic refresh interval of the Status Window on the Status tab. If you set this parameter to a value higher than 0 and then select a profile on the Status tab, the status will be automatically updated every x seconds. The checkpoints of the selected profile will be displayed until selecting another profile. Note: This parameter is a "dialog" value - it means it is not saved in the configuration file, but in the machine running the dialog (same as for example windows size). Log Size Sets the size of the probe’s log file to which probe-internal log messages are written. Default: 100 KB. When this size is reached, the contents of the file are cleared. Log Level Sets the level of details written to the log file. Log as little as possible during normal operation to minimize disk consumption. QoS V2 compatibility Provides backward-compatibility to V2 framework. All Database Status Provides the option to get the status of all database otherwise only for the default database.

14 db2 Guide

Probe Configuration

Message Pool Tab The Message pool tab contains a list of all the available alarm messages. You select messages from this list when editing the properties for a checkpoint.

Right-click the list to add, edit, copy or delete messages.

Chapter 3: db2 Configuration 15

Probe Configuration

Define a Message This functionality allows you to define a new message in the Message pool tab. Follow these steps: 1.

In the Templates tab, click the Message pool tab. The list of messages appear.

2.

Right-click in the list and select New.

The New message dialog appears. 3.

16 db2 Guide

Specify a name in the New message dialog and click OK.

Probe Configuration

Note: Use the name of the checkpoint for which you create the alarm message as name. This makes it easier to find the alarm message when selecting an alarm message in the properties dialog for the checkpoint. The Edit message dialog appears.

4.

Select the checkpoint for which you create the alarm message in the drop-down list All variables available for that check-point will be listed in the right part of the dialog.

5.

Type the message and pick the variables you need.

6.

Click the OK button when finished. The new message should now appear in the message pool.

Chapter 3: db2 Configuration 17

Probe Configuration

Connections Tab The Connections tab contains the list of various connections to instances that the db2 probe will monitor. You need to specify user name, password and service name you want to use to connect to the instance. The password information is encrypted and placed into the configuration file. A connection can be used by more than one profile.

The list contains one predefined connection that you may modify to your preferences. You may add, edit, delete and copy connections.

18 db2 Guide

Probe Configuration

Edit Connection Dialog Right-click a connection and select Edit. The Edit Connection dialog opens for editing.

This dialog contains the following fields: DSN Specifies the ODBC Data Source Name. For details, refer Define an ODBC Connection (see page 21). Description Provides short description of the connection. User ID Defines the user id with SYSADM, SYSCTRL or SYSMAINT authorization. Password Defines the valid password. Instance node Specifies the node name under which the instance you want to connect to is catalogued in the node directory. Default DB name Specifies the database name used for connection tests (for example in i_check_dbalive).

Chapter 3: db2 Configuration 19

Probe Configuration

Retry attempts Indicates the number of attempts the probe should try to repeat connection in case of failure. "0" means only the initial connection will be done. Retry delay Specifies the time for which the probe will wait between two connection attempts. Timeout Specifies the time for which the probe will wait for answer before it aborts the connection process. Test button Enables to test if the connection can be made. If successful, it will return the instance name and its version number. If not, an error message will be returned.

20 db2 Guide

Probe Configuration

Define an ODBC Connection You must create an ODBC connection to specify a DSN while defining a new connection. Follow these steps: 1.

In the Control Panel, select Administrative Tools.

2.

Select Data Sources (ODBC). The ODBC Data Source Administrator dialog appears.

3.

Select the System DSN tab and click the Add button. The Create New Data Source wizard is launched.

4.

Select the driver you want to use (for example IBM DB2 ODBC DRIVER) and click the Next button.

5.

Follow the steps through the wizard to finish the definition.

Chapter 3: db2 Configuration 21

Probe Configuration

Profiles Tab The Profiles tab contains the list of sample profile that you may modify to your preferences. Every profile will run as a separate thread and multiple profiles can be used to monitor one instance. This way the probe can be configured to deploy available resources the best way and allows independent monitoring of several instances simultaneously. Icons in the profile list ■

Green icon indicates that the profile is active and running.



Yellow icon indicates that the profile is active but suspended .The Suspended /Resumed button in the profile properties dialog allows stopping / starting profile monitoring dynamic, without deactivating /activating the probe.



Black icon indicates that the profile is inactive.

You may add, edit delete and copy profiles.

22 db2 Guide

Probe Configuration

Edit Profile Dialog Right-click the profile and select Edit. The Edit Profile dialog opens to edit the profile properties. The upper part of the dialog displays general profile properties and defaults whereas the lower part provides a list of available checkpoints. The Suspended / Resumed commands allows stopping / starting profile monitoring dynamic without deactivating /activating the probe.

This dialog contains the following fields: Description Provides short description of the profile. Heartbeat Defines the interval at which all profile checkpoints schedules will be tested and trigger eventual checkpoint execution. This number should be common denominator to all used check interval values. The higher the value the lower is the profile overhead.

Chapter 3: db2 Configuration 23

Probe Configuration

Connection Specifies the connection used in this profile. It has to be defined in Connections dialog before creating a profile. Check Interval Indicates the default value for check interval in the profile. This will be used if nothing else is defined in the checkpoint and overwrites the default checkpoint list setting. Clear message Specifies the message name for clear alarm. SQL Timeout Every checkpoint query run asynchronously. In case the query reaches the SQL timeout, the checkpoint processing will be terminated and the next checkpoint will be started. Alarm is issued. Message Specifies the message name used for SQL timeout alarm. Profile Timeout Defines the maximum processing time for all checkpoints in the profile. If this timeout is reached, the interval processing is finished and the probe waits for next heartbeat to evaluate any checkpoint schedules. Alarm message is issued. Message Specifies the message name used for profile timeout alarm. Timeout severity Defines severity for timeout messages. Suspended/Resumed (indicator) Indicates whether the profile is activated or not. This indicator is green when the profile is activated. The indicator changes to yellow when the profile is suspended and to black when deactivated. Alarm source Lets you override the source name of the alarm. If not used, default is assumed (robot IP). Profile checkpoints Provides the list of available checkpoints. When defining a new profile, all the available checkpoints (listed under the Checkpoints tab) will be listed here. Select the checkpoints you want for your new profile. The global and default checkpoint settings will be used unless you modify the settings locally for your profile (see section Checkpoints in Profile).

24 db2 Guide

Probe Configuration

Checkpoints in Profile After defining a profile, you can use two different strategies for handling checkpoints in a profile. You can decide to use checkpoint templates dynamic, which means that the checkpoints are defined globally (under the Templates tab) and represent the default settings. Every time you change the template value, it will reflect on all profiles using dynamic templates strategy. If you want to have specific settings valid just for one profile, you should right-click the checkpoint in the list and select Change to static.

Chapter 3: db2 Configuration 25

Probe Configuration

Now you can double-click the checkpoint to modify the properties and the settings will be valid for this profile only. Note: If you attempt to modify a template checkpoint in the Profile dialog without changing it to static as described above, you will receive the following warning:

There can be both template and static checkpoints mixed in one profile. If a checkpoint is managed as static, the checkpoint name will appear in the list with a blue color and it will be marked as static in the column Type. Type of Checkpoints ■

Static: Manages the properties for a checkpoint locally. Change the checkpoint to static in your profile before modifying it. When modified, the new settings will be valid for this profile only.



Template: Edits the properties for a checkpoint template. Double-click the checkpoint in the profile list or Templates tab. When modified, the new settings will be valid for all profiles, unless overruled by static settings in the profile.

Refer the section Edit a Checkpoint (see page 38) for a description of the checkpoint properties. When deciding which checkpoints to activate/deactivate for a profile, refer section Checkpoint Metrics (see page 46) for a description of the different checkpoints.

26 db2 Guide

Probe Configuration

Templates Tab The Templates tab contains the list of predefined set of checkpoints that you may use in your profiles. These checkpoints can be modified to your preferences.

By default, most checkpoints are active with a reasonable default threshold value. The checkpoint properties may be used in a profile either dynamic, using the template values, or they can be added to the profile and managed static in the profile. Static Edits the properties for a checkpoint locally for a profile. Right-click the profile in the checkpoints list in the Edit Profile dialog and change it to static. Double-click the checkpoint to modify it. When modified, the new settings will be valid for this profile only. Template Edits the properties for a checkpoint template. Double-click the checkpoint in the checkpoints list in the Edit Profile dialog or Templates tab. When modified, the new settings will be valid for all profiles, unless overruled by static settings in the profile.

Chapter 3: db2 Configuration 27

Probe Configuration

Define a New Checkpoint This functionality allows you to create a custom checkpoint for the DB2 probe. Follow these steps: 1.

In the Templates tab, right-click and select Create new from the context menu.

The Add New User Template dialog appears. 2.

28 db2 Guide

Enter a name for the custom checkpoint. Click OK.

Probe Configuration

The Edit template checkpoint dialog opens. 3.

By default, the General tab opens. Click the Query tab.

4.

Select the required connection from the Connection drop-down list, which displays a list of pre-configured connections, created from the Connections tab.

Chapter 3: db2 Configuration 29

Probe Configuration

5.

Enter the required query statement in the Query field and click the Test button to validate the query. The Query Result dialog appears, displaying the result of the query entered.

30 db2 Guide

Probe Configuration

6.

Click Edit to specify the Message Variables.

Chapter 3: db2 Configuration 31

Probe Configuration

7.

In the Query tab of Edit template checkpoint dialog, enter the values in the fields as described in section Query Tab (see page 37).

8.

Click OK.

9.

Now, click the General tab of Edit template checkpoint dialog and enter the details as described in section General Tab (see page 34).

10. Right-click inside the threshold section and select New from the context menu. Enter the field values.

11. Click the QoS List button. The QoS list dialog appears.

32 db2 Guide

Probe Configuration

12. Right-click inside the grid view and select New from the context menu. The Edit checkpoint dialog appears. 13. Enter the details such as Name, Description, Unit, Metric, Abbreviation, and Max value.

14. Click OK in the Edit, QoS list, and Edit Templates Checkpoint dialogs sequentially to save the settings. 15. Click Yes to save the checkpoint.

Chapter 3: db2 Configuration 33

Probe Configuration

General Tab

This tab contains the following fields: Description Provides short description of the purpose of the checkpoint. Active Allows to activate the checkpoint. Condition Provides information describing how the threshold values are evaluated. Check Interval Specifies the interval value used for this checkpoint. Every checkpoint can have a different check interval value. Default is taken from the profile definition, if not defined than from the default checkpoint list.

34 db2 Guide

Probe Configuration

Send Quality of Service Activates QoS values being send into the QoS database. If not available in a checkpoint, checkbox is disabled. QoS List Opens the QoS list showing the current QoS definitions (default is one definition per checkpoint). Right-clicking in the list lets you add new QoS definitions and copy, edit or delete an existing QoS definition. The Edit QoS dialog offers available metrics (numerical variables which could be reported as QoS) and available object variables (if any - to be added to the QoS source). The name of the QoS has to start with the checkpoint name. QoS can be activated/deactivated as usual. Note: Some of the checkpoints have no QoS possibilities - from these checkpoints the QoS dialog cannot be activated. Samples Saves the number of samples specified here and calculate an average value. This average value will be compared to the alarm threshold specified. Setting "Samples = 1", no sampling is done. Setting "Samples = 3", the average of the 3 last samples will be used. Setting "Samples = 0" (in profile), number of samples will be taken from the template. If not set there, no sampling is done. Initially after start-up, the probe calculates the average value from the number of samples available. Example, Samples=3: In the first interval the first sample value is used In the second interval, the average of sample 1 and 2 will be used etc. Note: Many checkpoints calculate an "interval value", therefore in the first interval there is no value at all (no threshold checking). Use excludes Provides the option to add excludes to the Excludes list to some of the checkpoints (as it does not make sense for all checkpoints). Using excludes, you can define objects that you do NOT want to monitor on the checkpoint. The excludes patterns found if clicking the Excludes list button will be used for the checkpoint.

Chapter 3: db2 Configuration 35

Probe Configuration

Excludes list Opens the list that shows if excludes are defined for the checkpoint. The excludes found in the list will be used for the checkpoint if the Use excludes option is checked. Right-clicking in the list lets you add new excludes or edit, copy or delete existing excludes. When adding (or editing) an exclude pattern, a Match expression dialog is opened, letting you edit or define the exclude pattern. Excludes are defined using regular expression patterns. A test button lets you test the exclude pattern defined. This test is possible only for running active profiles and checkpoints. The test uses the status list (on the status tab) as input: Note: If there already are active excludes, the excluded objects are excluded from the status list BEFORE the test. When clicking the Test button, an Exclude test list pops up, showing the result of the test. Red text lines show the objects which would be excluded using the tested pattern. The "object thresholds" are functioning as an "include list". This means if there are special thresholds defined for a special object, this object will always stay in, even if the exclude pattern would eliminate it normally. This is considered also in the test function. Scheduling This field lets you select how to use the schedules settings, if any (see description below the table). rules Selecting rules means to run according the rules described in the Schedules settings. exceptions Selecting exceptions means to run except the rules described in the Schedules settings. Clear message Specifies the message name used for clear alarm message. Clear severity Severity used for message issued in normal state. Thresholds/Schedules Refer Thresholds (see page 42) and Schedules (see page 43).

36 db2 Guide

Probe Configuration

Query Tab

Checked value Specifies the name of the columns for which reporting should be done. Condition Specifies one of the comparison operators (=, , etc.) Row identification Defines the row number for which you are reporting. Message variables Specifies one or more message variables using the Edit button. Query File Defines the name of the file to store the query entered in the Query field.

Chapter 3: db2 Configuration 37

Probe Configuration

Edit a Checkpoint The checkpoint properties may be used in a profile either dynamic, using the template values, or they can be added to the profile and managed static in the profile. Static Edits the properties for a checkpoint locally for a profile. Right-click the profile in the list of checkpoints in the Edit Profile dialog and change it to static. Double-click the checkpoint to modify it. When modified, the new settings will be valid for this profile only. Template Edits the properties for a checkpoint template. Double-click the checkpoint in the Edit Profile dialog or Templates tab. When modified, the new settings will be valid for all profiles, unless overruled by static settings in the profile. The properties for checkpoints are described below:

38 db2 Guide

Probe Configuration

The upper part of the dialog contains general checkpoint settings whereas the lower part contains two lists with threshold and schedule settings. Description Provides short description of the purpose of the checkpoint. Active Allows to activate the checkpoint. Condition Provides information describing how the threshold values are evaluated. Check Interval Specifies the interval value used for this checkpoint. Every checkpoint can have a different check interval value. Default is taken from the profile definition, if not defined than from the default checkpoint list. Send Quality of Service Activates QoS values being send into the QoS database. If not available in a checkpoint, check box is disabled. QoS List Opens the QoS list showing the current QoS definitions (default is one definition per checkpoint). Right-clicking in the list lets you add new QoS definitions and copy, edit or delete an existing QoS definition. The Edit QoS dialog offers available metrics (numerical variables that could be reported as QoS) and available object variables (if any - to be added to the QoS source). The name of the QoS has to start with the checkpoint name. QoS can be activated/deactivated as usual. Note: Some of the checkpoints have no QoS possibilities - from these checkpoints, the QoS dialog cannot be activated.

Chapter 3: db2 Configuration 39

Probe Configuration

Samples Saves the number of samples specified here and calculate an average value. This average value will be compared to the alarm threshold specified (see threshold description below the table). Setting "Samples = 1", no sampling is done. Setting "Samples = 3", the average of the 3 last samples will be used. Setting "Samples = 0" (in profile), number of samples will be taken from the template. If not set there, no sampling is done. Initially after start-up, the probe calculates the average value from the number of samples available. Example, Samples=3: In the first interval the first sample value is used In the second interval, the average of sample 1 and 2 will be used etc. Note: Many checkpoints calculate an "interval value", therefore in the first interval there is no value at all (no threshold checking). Use excludes Provides the option to add excludes to the Exclude list to some of the checkpoints (as it does not make sense for all checkpoints). Using excludes, you can define objects that you do NOT want to monitor on the checkpoint. The excludes patterns found if clicking the Excludes list button will be used for the checkpoint.

40 db2 Guide

Probe Configuration

Excludes list Opens the list that displays if excludes are defined for the checkpoint. The excludes found in the list will be used for the checkpoint if the Use excludes option is checked. Right-clicking in the list lets you add new excludes or edit, copy or delete existing excludes. When adding (or editing) an exclude pattern, a Match expression dialog is opened, letting you edit or define the exclude pattern. Excludes are defined using regular expression patterns. A test button lets you test the exclude pattern defined. This test is possible only for running active profiles and checkpoints. The test uses the status list (on the status tab) as input: Note: If there already are active excludes, the excluded objects are excluded from the status list BEFORE the test. When clicking the test button, an exclude test list pops up, showing the result of the test. Red text lines show the objects which would be excluded using the tested pattern. The "object thresholds" are functioning as an "include list" - it means, if there are special thresholds defined for a special object, this object will always stay in, even if the exclude pattern would eliminate it normally. This is considered also in the test function. Scheduling Lets you select how to use the Schedules settings, if any. rules Selecting rules means to run according the rules described in the Schedules settings. exceptions Selecting exceptions means to run except the rules described in the Schedules settings. Clear message Specifies the message name used for clear alarm message. Clear severity Severity used for message issued in normal state. Thresholds/Schedules Refer Thresholds (see page 42) and Schedules (see page 43).

Chapter 3: db2 Configuration 41

Probe Configuration

Thresholds The list contains the predefined set of monitoring profiles that you may use in your profiles and that you can modify to your preferences. By default, most profiles are active with a reasonable default threshold value. The threshold values may be defined by modifying checkpoints in the respective profile. Every checkpoint has to have at least one threshold, but there can be additional thresholds defined. The threshold identification consists of an object name (if applicable), like tablespace name, userid etc. and a threshold ID, numbered from 0. Threshold values have to be descending or ascending, depending on condition used in a checkpoint, starting with the highest severity threshold condition.

This section contains the following fields: Threshold object name Indicates the monitoring object name, if applicable or default. Some special checkpoints have a second threshold called ‘count" (e.g. "locked_users"). Threshold value Specifies the value used for threshold evaluation. Current value If invoked from the status report, it contains the last measured value. Severity Specifies the alarm severity.

42 db2 Guide

Probe Configuration

Message Defines the name of message used for threshold alarm. Message text Displays the text of the message, containing variables, which will be replaced in run time. If the message text is changed from a profile list, you will be forced to create new message. Variables Lists variables available in the checkpoint.

Schedules If the schedules list is empty, the checkpoint will be executed on interval, 24 hours a day. You can also define several schedules per checkpoint, each defining additional rules to the check interval or exceptions of it. The rules and exceptions cannot be mixed in one checkpoint.

In principle, a schedule is a definition of an execution period (or execution break if exceptions used) with specified days, including time from/to and date from/to values. If only Date from and Time from is defined, first execution can be defined. Run once will cause the checkpoint run only once a day in the defined period (unlike multiple times if Run interval is used).

Chapter 3: db2 Configuration 43

Probe Configuration

Status Tab The Status tab displays contents in a hierarchal fashion with the profile name nodes and one or more checkpoint nodes (only active checkpoints are considered here). The highest status is propagated. Select the checkpoint in the navigation tree (to your left) to bring up the corresponding events.

The properties for an individual checkpoint object can also be modified here. Select a profile and a monitored checkpoint in the left pane. Then double-click an object in the right pane. If the object belongs to a template object, you will be warned that a modification will make the checkpoint static for the selected profile.

44 db2 Guide

Probe Configuration

Group Tab This tab lets you create multiple groups which can be associated with profiles.

You can add, copy, modify, or delete a group.

Chapter 3: db2 Configuration 45

Probe Configuration

Checkpoints Metrics There are five kind of metrics used: Count Absolute number of events in the interval. It is calculated as delta between count at the beginning of the interval and at the end. In the first interval, counts are not checked because their interval value cannot be calculated. If there is a "total" value in the message, it means "since the start of the instance". Gauge Absolute number describing the actual state of the system. Ratio Calculated percentage using interval counts. In the first interval, it is calculated from total counts (as the interval count cannot be calculated). Average Calculated using interval counts. In the starting interval, it is calculated from absolute counts. Status Absolute value like ‘ONLINE’ etc.

Single Counter Description Most of the checkpoints are measuring single DB2 snapshot counter values. Description of these counters can be found in the IBM DB2 "System Monitor Guide and Reference" manual or in DB2 Information Center under "Monitor elements": http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/index.jsp http://publib.boulder.ibm.com/infocenter/db2luw/v9r5/index.jsp The IBM used counter names are hierarchically organized and therefore not unique. For this reason, the probe is adding to every name a prefix, depending on its source: ■

"i_" for instance snapshot



"db_" for database



"bp_" for bufferpool



"app_" for application



"ts_" for tablespace statistics counter.

So the description for the counter "i_comm_private_mem" can be found under "comm_private_mem" in the IBM sources.

46 db2 Guide

Probe Configuration

Calculated Checkpoints Description The app_ checkpoints do not generate QoS. i_agents_created_ratio – ratio Calculated as: (i_agents_created_empty_pool / i_agents_from_pool) * 100. Description: Monitors % of agents created due to empty agent pool by agents assigned from pool. i_piped_sorts_rejected – count Calculated as: i_piped_sorts_requested - i_piped_sorts_accepted. Description: Monitors number of piped sort requests rejected. db_pool_hit_ratio – ratio Calculated as: (1.0 - ((db_pool_data_p_reads + db_pool_index_p_reads) / (db_pool_data_l_reads + db_pool_index_l_reads))) * 100. Description: Monitors percentage of time a page was found in buffer pool on request. db_avg_sort_time – average Calculated as: (db_total_sort_time / db_total_sorts) / 1000. Description: Monitors average sort time in interval in seconds. db_pct_sort_overflows – ratio Calculated as: (db_sort_overflows / db_total_sorts) * 100. Description: Monitors % of sort overflows in interval. db_avg_sort_heap – average Calculated as: db_sort_heap_allocated / db_active_sorts. Description: Monitors average number of pages allocated to sort heap in interval. db_pct_hjs_overflows – ratio Calculated as: (db_hash_join_small_overflows / db_hash_join_overflows) * 100. Description: Monitors percentage of hash join small overflows. db_pool_sync_reads – count Calculated as: db_pool_data_p_reads - db_pool_async_data_reads. Description: Monitors number of synchronous data reads per interval. db_pool_sync_writes – count Calculated as: db_pool_data_writes - db_pool_async_data_writes Description: Monitors number of synchronous data writes per interval.

Chapter 3: db2 Configuration 47

Probe Configuration

db_pool_sync_idx_reads – count Calculated as: db_pool_index_p_reads - db_pool_async_index_reads Description: Monitors number of synchronous index page reads per interval. db_pool_sync_idx_writes – count Calculated as: db_pool_index_writes - db_pool_async_index_writes Description: Monitors number of synchronous index page writes per interval. db_pool_avg_async_read_time – average Calculated as: db_pool_async_read_time / db_pool_async_data_reads Description: Monitors average asynchronous read time in ms in interval. db_pool_avg_async_write_time – average Calculated as: db_pool_async_write_time / (db_pool_async_data_writes + db_pool_async_index_writes) Description: Monitors average asynchronous write time in ms in interval. db_pool_sync_write_time – count Calculated as: db_pool_write_time - db_pool_async_write_time Description: Monitors synchronous write time in ms in interval. db_pool_avg_write_time – average Calculated as: db_pool_async_write_time / (db_pool_async_data_writes + db_pool_async_index_writes) Description: Monitors average write time in ms in interval. db_avg_direct_read_time – average Calculated as: db_direct_read_time / db_direct_reads Description: Monitors average time for direct read in ms. db_avg_direct_write_time – average Calculated as: db_direct_write_time / db_direct_writes Description: Monitors average time for direct write in ms. db_cat_cache_hit_rto - ratio Calculated as: (1- (db_cat_cache_inserts / db_cat_cache_lookups)) * 100. Description: Monitors percent of times, information was found in catalog cache. db_log_util_rto - ratio Calculated as: (db_total_log_used / (db_total_log_used + db_total_log_available)) * 100. Description: Monitors database log utilization.

48 db2 Guide

Probe Configuration

db_since_last_backup - count Calculated as: (tNow - ((elapsed_exec_time_s + (elapsed_exec_time_ms / 1000000.0)))) / 3600. Description: Monitors number of hours since last backup. db_status - status Calculated as: db_status based on the below values. Description: Monitors database status. #. State Value Alarm QoS 1. ACTIVE 0 Yes Yes 2. QUIESCE_PEND 1Yes Yes 3. QUIESCED 2 Yes Yes 4. ROLLFWD 3 Yes Yes 5. Not defined Log No Yes app_avg_sort_time – average Calculated as: app_total_sort_time / app_total_sorts Description: Monitors the average sort time in interval in ms. app_pct_sort_overflows – ratio Calculated as: (app_sort_overflows / app_total_sorts) * 100. Description: Monitors the percentage of sort overflows per interval. app_pool_hit_ratio – ratio Calculated as: (1 - ((app_pool_data_p_reads + app_pool_index_p_reads) / (app_pool_data_l_reads + app_pool_index_l_reads))) * 100. Description: Monitors percentage of time a page was found in buffer pool on application request. app_avg_direct_read_time – average Calculated as: app_direct_read_time / app_direct_reads. Description: Monitors the average time for direct read in ms. app_avg_direct_write_time – average Calculated as: app_direct_write_time / app_direct_writes Description: Monitors the average time for direct write in ms. app_cat_cache_hit_rto – ratio Calculated as: (1 - (app_cat_cache_inserts / app_cat_cache_lookups)) * 100. Description: Monitors percentage of time table descriptor was found in catalog cache.

Chapter 3: db2 Configuration 49

Probe Configuration

app_pkg_cache_hit_rto Calculated as: (1 - (app_pkg_cache_inserts / app_pkg_cache_lookups)) * 100. Description: Monitors percentage of time package section was found in package cache. app_locklist_util – ratio Calculated as: ((app_locks_held * locksize) / (app_dbcfg_lock_list * 4096)) * 100. Description: Monitors lock list utilization by application in percent. app_sys_cpu_time - count Calculated as: agent_sys_cpu_time_s + (agent_sys_cpu_time_ms / 1000000.0). Description: Monitors the total system CPU time (in seconds) used by database manager agent process. app_usr_cpu_time - count Calculated as: agent_usr_cpu_time_s + (agent_usr_cpu_time_ms / 1000000.0). Description: Monitors the total user CPU time (in seconds) used by database manager agent process. app_uow_elapsed_time - count Calculated as: uow_elapsed_time_s + (uow_elapsed_time_ms / 1000000.0). Description: Monitors the elapsed execution time of the most recently completed UOW. bp_pool_hit_ratio – ratio Calculated as: (1 - ((bp_pool_data_p_reads + bp_pool_index_p_reads) / (bp_pool_data_l_reads + bp_pool_index_l_reads))) * 100. Description: Monitors percentage of time a page was found in buffer pool. bp_pool_avg_async_read_time – average Calculated as: bp_pool_async_read_time / bp_pool_async_data_reads. Description: Monitors average asynchronous read time in ms in interval. bp_pool_avg_async_write_time – average Calculated as: (bp_pool_async_write_time / (bp_pool_async_data_writes + bp_pool_async_index_writes)). Description: Monitors average asynchronous write time in ms in interval. bp_pool_sync_write_time – count Calculated as: bp_pool_write_time - bp_pool_async_write_time. Description: Monitors synchronous write time in ms in interval.

50 db2 Guide

Probe Configuration

bp_pool_avg_write_time – average Calculated as: bp_pool_async_write_time / (bp_pool_async_data_writes + bp_pool_async_index_writes). Description: Monitors average asynchronous write time in ms in interval. bp_avg_direct_read_time – average Calculated as: bp_direct_read_time / bp_direct_reads. Description: Monitors average time for direct read in ms in interval. bp_avg_direct_write_time – average Calculated as: bp_direct_write_time / bp_direct_writes. Description: Monitors average time for direct write in ms in interval. bp_pool_sync_reads – count Calculated as: bp_pool_data_p_reads - bp_pool_async_data_reads. Description: Monitors number of synchronous data reads in interval. bp_pool_sync_writes – count Calculated as: bp_pool_data_writes - bp_pool_async_data_writes. Description: Monitors number of synchronous data writes in interval. bp_pool_sync_idx_writes – count Calculated as: bp_pool_index_writes - bp_pool_async_index_writes. Description: Monitors number of synchronous index page writes in interval. bp_pool_sync_idx_reads – count Calculated as: bp_pool_index_p_reads - bp_pool_async_index_reads. Description: Monitors number of synchronous index page reads in interval. ts_usable_pages_pct – ratio Calculated as: (ts_usable_pages / ts_total_pages) * 100. Description: Monitors percent of usable pages in DMS table space (exlc. overhead). ts_used_pages_pct – ratio Calculated as: (ts_used_pages / ts_total_pages) * 100. Description: Monitors percent of used pages in table space. ts_free_pages_pct – ratio Calculated as: (ts_free_pages / ts_total_pages) * 100. Description: Monitors percent of free pages in DMS table space.

Chapter 3: db2 Configuration 51

Probe Configuration

ts_max_used_pages_pct – ratio Calculated as: (ts_max_used_pages / ts_total_pages) * 100. Description: Monitors maximum of used pages in % reached in DMS table space. ts_max_used_pages – count Calculated as: ts_max_used_pages for DMS type only. Description: Monitors maximum of used pages reached in DMS table space. ts_free_pages – count Calculated as: ts_free_pages for DMS type only. Description: Monitors number of free pages in DMS table space. ts_usable_pages – count Calculated as: ts_usable_pages for DMS type only. Description: Monitors number of usable pages in table space (exlc. overhead). ts_status - status Calculated as: ts_state Description: Monitors status of the tablespace. i_pct_active_connections - ratio Calculated as: ((i_rem_cons_in + i_rem_cons_in_exec + i_local_cons + i_local_cons_in_exec) / i_max_connections) * 100. Description: Monitors % of active connections to total allowed connections.

52 db2 Guide

Chapter 4: QoS Threshold Metrics Many Nimsoft Monitor probes ship with default QoS threshold values set. The default threshold values provide an idea of the type of values to be entered in the fields and are not necessarily recommended best practice values. To aid in tuning thresholds and reducing false-positive alarms, this section describes the QoS metrics and provides the default QoS thresholds.

This section contains the following topics: db2 QoS Metrics (see page 53) db2 Alert Metrics Default Settings (see page 58)

db2 QoS Metrics The following table describes the QoS metrics that can be configured using the db2 probe. Monitor Name

Units

Description

QOS_DB2_ACTIVE_CONNECTIONS_PERCENTA % GE

Active connections percentage

QOS_DB2_ACTIVE_SORTS

count

Database Active Sorts

QOS_DB2_AGENTS_CREATED_EMPTY_POOL

count

Agents Created Empty Pool

QOS_DB2_AGENTS_CREATED_RATIO

%

Agents Created Ratio

QOS_DB2_AGENTS_FROM_POOL

count

Agents from Pool

QOS_DB2_AGENTS_REGISTERED

count

Agents curr. Registered

QOS_DB2_AGENTS_REGISTERED_TOP

count

Agents Registered Top

QOS_DB2_AGENTS_STOLEN

count

Agents Stolen

QOS_DB2_AGENTS_TOP

count

Database Agents Top

QOS_DB2_AGENTS_WAITING_ON_TOKEN

count

Agents Waiting on Token

QOS_DB2_AGENTS_WAITING_TOP

count

Agents Waiting Top

QOS_DB2_APPL_SECTION_INSERTS

count

Database SQL Section Inserts

QOS_DB2_APPL_SECTION_LOOKUPS

count

Database SQL Section Lookups

Chapter 4: QoS Threshold Metrics 53

db2 QoS Metrics

Monitor Name

Units

Description

QOS_DB2_APPLS_CUR_CONS

count

Database Connected

QOS_DB2_APPLS_IN_DB2

count

Database Active Connections

QOS_DB2_AVG_DIRECT_READ_TIME

ms

Average Direct Read Time

QOS_DB2_AVG_DIRECT_WRITE_TIME

ms

Average Direct Write Time

QOS_DB2_AVG_SORT_HEAP

count

Database Average Sort Heap

QOS_DB2_AVG_SORT_TIME

sec

Database Average Sort Time

QOS_DB2_BINDS_PRECOMPILES

count

Database Binds/Precompiles

QOS_DB2_CAT_CACHE_HEAP_FULL

count

Database Catalog Cache Overflows Full Heap

QOS_DB2_CAT_CACHE_HIT_RTO

%

Database Catalog Cache Hit Ratio

QOS_DB2_CAT_CACHE_INSERTS

count

Database Catalog Cache Inserts

QOS_DB2_CAT_CACHE_LOOKUPS

count

Database Catalog Cache Lookups

QOS_DB2_CAT_CACHE_OVERFLOWS

count

Database Catalog Cache Overflows

QOS_DB2_CHECK_DBALIVE

Availability

DB2 Instance Availability

QOS_DB2_COMM_PRIVATE_MEM

Byte

Comitted Private Memory

QOS_DB2_COMMIT_SQL_STMTS

count

Database Commits

QOS_DB2_CON_LOCAL_DBASES

count

Databases with Connections

QOS_DB2_CONNECTIONS_TOP

count

Database Connections Top

QOS_DB2_COORD_AGENTS_TOP

count

Coordinating Agents Top

QOS_DB2_DB_CONNECT_TIME

seconds

Database Connection Time

QOS_DB2_DB_HEAP_TOP

Bytes

Database Memory Usage

QOS_DB2_DB_LOG_UTIL_RTO

%

Database Log Utilization

QOS_DB2_DB_STATUS

status

Database Status

QOS_DB2_DDL_SQL_STMTS

count

Database DDL SQL

QOS_DB2_DEADLOCKS

count

Database Deadlocks

QOS_DB2_DIRECT_READ_REQS

count

Direct Read Requests

QOS_DB2_DIRECT_READ_TIME

ms

Direct Read Time

QOS_DB2_DIRECT_READS

count

Direct Reads

QOS_DB2_DIRECT_WRITE_REQS

count

Direct Write Requests

QOS_DB2_DIRECT_WRITE_TIME

ms

Direct Write Time

54 db2 Guide

db2 QoS Metrics

Monitor Name

Units

Description

QOS_DB2_DIRECT_WRITES

count

Direct Writes

QOS_DB2_DYNAMIC_SQL_STMTS

count

Database Dynamic SQL

QOS_DB2_FAILED_SQL_STMTS

count

Database Failed SQL

QOS_DB2_FILES_CLOSED

count

Bufferpool File Close

QOS_DB2_FREE_PAGES

count

Tablespace Free Pages

QOS_DB2_FREE_PAGES_PCT

%

Tablespace Pct. Free Pages

QOS_DB2_GW_CONS_WAIT_CLIENT

count

Connections Waiting on Client

QOS_DB2_GW_CONS_WAIT_HOST

count

Connections Waiting on Host

QOS_DB2_GW_CUR_CONS

count

Gateway Current Connections

QOS_DB2_GW_TOTAL_CONS

count

Gateway Connection Attempts

QOS_DB2_HASH_JOIN_OVERFLOWS

count

Database Hash Join Overflows

QOS_DB2_HASH_JOIN_SMALL_OVERFLOWS

count

Database Hash Join Small Overflows

QOS_DB2_IDLE_AGENTS

count

Unassigned Agents

QOS_DB2_INT_AUTO_REBINDS

count

Database Auto Rebinds

QOS_DB2_INT_COMMITS

count

Database Internal Commits

QOS_DB2_INT_DEADLOCK_ROLLBACKS

count

Database Internal Deadlock Rollbacks

QOS_DB2_INT_ROLLBACKS

count

Database Internal Rollbacks

QOS_DB2_INT_ROWS_DELETED

count

Database Internal Deletes

QOS_DB2_INT_ROWS_INSERTED

count

Database Internal Inserts

QOS_DB2_INT_ROWS_UPDATED

count

Database Internal Updates

QOS_DB2_LOCAL_CONS

count

Current Local Connections

QOS_DB2_LOCAL_CONS_IN_EXEC

count

Current Local Connections Executing

QOS_DB2_LOCK_ESCALS

count

Database Lock Escalations

QOS_DB2_LOCK_LIST_IN_USE

Bytes

Database Lock List Use

QOS_DB2_LOCK_TIMEOUTS

count

Database Locks Waiting

QOS_DB2_LOCK_WAIT_TIME

ms

Database Lock Wait Time

QOS_DB2_LOCK_WAITS

count

Database Lock Waits

QOS_DB2_LOCKS_HELD

count

Database Locks Held

QOS_DB2_LOCKS_WAITING

count

Database Locks Waiting

QOS_DB2_LOG_READS

count

Database Log Pages Read

Chapter 4: QoS Threshold Metrics 55

db2 QoS Metrics

Monitor Name

Units

Description

QOS_DB2_LOG_WRITES

count

Database Log Pages Written

QOS_DB2_MAX_AGENT_OVERFLOWS

count

MAXAGENT Overflows

QOS_DB2_MAX_USED_PAGES

count

Tablespace Max Used Pages

QOS_DB2_MAX_USED_PAGES_PCT

%

Tablespace Pct. Max Used Pages

QOS_DB2_NEW_CHECKPOINT_12345

M

test checkpoint

QOS_DB2_NUM_ASSOC_AGENTS

count

Database Agents

QOS_DB2_PCT_HJS_OVERFLOWS

%

Database Hash Join Small Overflows

QOS_DB2_PCT_SORT_OVERFLOWS

%

Database Sort Overflows

QOS_DB2_PIPED_SORTS_ACCEPTED

count

Piped Sorts Accepted

QOS_DB2_PIPED_SORTS_REJECTED

count

Piped Sorts Rejected

QOS_DB2_PIPED_SORTS_REQUESTED

count

Piped Sorts Requested

QOS_DB2_PKG_CACHE_INSERTS

count

Database Package Cache Inserts

QOS_DB2_PKG_CACHE_LOOKUPS

count

Database Package Cache Lookups

QOS_DB2_POOL_ASYNC_DATA_READ_REQS

count

Bufferpool Async. Read Requests

QOS_DB2_POOL_ASYNC_DATA_READS

count

Bufferpool Async. Page Reads

QOS_DB2_POOL_ASYNC_DATA_WRITES

count

Bufferpool Async. Data Writes

QOS_DB2_POOL_ASYNC_INDEX_READS

count

Bufferpool Async. Index Reads

QOS_DB2_POOL_ASYNC_INDEX_WRITES

count

Bufferpool Async. Index Writes

QOS_DB2_POOL_ASYNC_READ_TIME

ms

Bufferpool Async. Read Time

QOS_DB2_POOL_ASYNC_WRITE_TIME

ms

Bufferpool Async. Write Time

QOS_DB2_POOL_AVG_ASYNC_READ_TIME

ms

Bufferpool Avg. Async. Read Time

QOS_DB2_POOL_AVG_ASYNC_WRITE_TIME

ms

Bufferpool Avg. Async. Write Time

QOS_DB2_POOL_AVG_WRITE_TIME

ms

Bufferpool Avg. Write Time

QOS_DB2_POOL_DATA_FROM_ESTORE

count

Bufferpool Index Pages from Estore

QOS_DB2_POOL_DATA_L_READS

count

Bufferpool Logical Reads

QOS_DB2_POOL_DATA_P_READS

count

Bufferpool Physical Reads

QOS_DB2_POOL_DATA_TO_ESTORE

count

Bufferpool Data Pages to Estore

QOS_DB2_POOL_DATA_WRITES

count

Bufferpool Physical Writes

QOS_DB2_POOL_DRTY_PG_STEAL_CLNS

count

Database Dirty Page Cleans

QOS_DB2_POOL_DRTY_PG_THRSH_CLNS

count

Database Dirty Page Thd. Reached

56 db2 Guide

db2 QoS Metrics

Monitor Name

Units

Description

QOS_DB2_POOL_HIT_RATIO

%

Bufferpool Hit Ratio

QOS_DB2_POOL_INDEX_FROM_ESTORE

count

Bufferpool Index Pages from Estore

QOS_DB2_POOL_INDEX_L_READS

count

Bufferpool Logical Index Reads

QOS_DB2_POOL_INDEX_P_READS

count

Bufferpool Physical Index Reads

QOS_DB2_POOL_INDEX_TO_ESTORE

count

Bufferpool Index Pages to Estore

QOS_DB2_POOL_INDEX_WRITES

count

Bufferpool Index Writes

QOS_DB2_POOL_LSN_GAP_CLNS

count

Database Log Space Cleans

QOS_DB2_POOL_READ_TIME

ms

Bufferpool Total Read Time

QOS_DB2_POOL_SYNC_IDX_READS

count

Bufferpool Sync. Index Reads

QOS_DB2_POOL_SYNC_IDX_WRITES

count

Bufferpool Synchronous Index Writes

QOS_DB2_POOL_SYNC_READS

count

Bufferpool Synchronous Reads

QOS_DB2_POOL_SYNC_WRITE_TIME

ms

Bufferpool Sync. Write Time

QOS_DB2_POOL_SYNC_WRITES

count

Bufferpool Sync. Writes

QOS_DB2_POOL_WRITE_TIME

ms

Bufferpool Physical Write Time

QOS_DB2_POST_THRESHOLD_HASH_JOINS

count

Post Treshold Hash Joins

QOS_DB2_POST_THRESHOLD_SORTS

count

Post Threshold Sorts

QOS_DB2_PREFETCH_WAIT_TIME

ms

Database Prefetch Wait Time

QOS_DB2_REM_CONS_IN

count

Current Remote Connections

QOS_DB2_REM_CONS_IN_EXEC

count

Current Remote Connections Executing

QOS_DB2_ROLLBACK_SQL_STMTS

count

Database Rollbacks

QOS_DB2_ROWS_DELETED

count

Database Rows Deleted

QOS_DB2_ROWS_INSERTED

count

Database Rows Inserted

QOS_DB2_ROWS_SELECTED

count

Database Rows Selected

QOS_DB2_ROWS_UPDATED

count

Database Rows Updated

QOS_DB2_SEC_LOG_USED_TOP

Bytes

Database Secondary Logspace Top

QOS_DB2_SEC_LOGS_ALLOCATED

count

Database Secondary Logs

QOS_DB2_SELECT_SQL_STMTS

count

Database Select SQL

QOS_DB2_SINCE_LAST_BACKUP

hours

Hours Since Last Backup

QOS_DB2_SORT_HEAP_ALLOCATED

count

Sort Heap Allocated

QOS_DB2_SORT_OVERFLOWS

count

Database Sort Overflows

Chapter 4: QoS Threshold Metrics 57

db2 Alert Metrics Default Settings

Monitor Name

Units

Description

QOS_DB2_STATIC_SQL_STMTS

count

Database Static SQL

QOS_DB2_TOT_LOG_USED_TOP

Bytes

Database Total Logspace Top

QOS_DB2_TOTAL_CONS

count

Database Connects

QOS_DB2_TOTAL_HASH_JOINS

count

Database Hash Joins

QOS_DB2_TOTAL_HASH_LOOPS

count

Database Hash Loops

QOS_DB2_TOTAL_PAGES

count

Tablespace Total Pages

QOS_DB2_TOTAL_SEC_CONS

count

Database Secondary Connections

QOS_DB2_TOTAL_SORT_TIME

ms

Database Total Sort Time

QOS_DB2_TOTAL_SORTS

count

Database Total Sorts

QOS_DB2_TS_DATA_PARTITIONING

%

Data partitioning free percent

QOS_DB2_TS_STATUS

status

Tablespace Status

QOS_DB2_UID_SQL_STMTS

count

Database UID SQL

QOS_DB2_USABLE_PAGES

count

Tablespace Total Pages

QOS_DB2_USABLE_PAGES_PCT

%

Tablespace Pct. Usable Pages

QOS_DB2_USED_PAGES

count

Tablespace Used Pages

QOS_DB2_USED_PAGES_PCT

%

Tablespace Pct. Used Pages

QOS_DB2_X_LOCK_ESCALS

count

Database X-Lock Escalations

db2 Alert Metrics Default Settings This section contains the QoS metric default settings for the db2 probe.

Alert Metric

app_acc_curs_blk

app_agents_stolen

58 db2 Guide

Warning Threshold

500

500

Warning Severity

Warning

Warning

Error Threshold

-

-

Error Severity

Description

-

Monitors the number of times that a request for an I/O block was accepted

-

Monitors the number of agents stolen from app. in interval

db2 Alert Metrics Default Settings

Alert Metric

app_appl_idle_time

Warning Threshold

60

Warning Severity

Warning

Error Threshold

-

Error Severity

Description

-

Monitors the number of seconds since an application has issued any requests to the server

app_asoc_agents_top

500

Warning

-

-

Monitors the maximum number of subagents associated with this application

app_avrg_direct_read_time

500

Warning

-

-

Monitors the average time for direct read in ms

app_avrg_direct_write_time

500

Warning

-

-

Monitors the average time for direct write in ms

app_avrg_sort_time

500

Warning

-

-

Monitors the average sort time in interval in ms

app_binds_precomplies

500

Warning

-

-

Monitors number of binds precompiles

-

Monitors the number of overflows due to db heap full

app_cat_cache_heap_full

500

Warning

-

app_cat_cache_hit_rho

75

Warning

-

-

Monitors percentage of time table descriptor was found in catalog cache

app_cat_cache_inserts

500

Warning

-

-

Monitors the number of table descriptors inserted

app_cat_cache_lookups

500

Warning

-

-

Monitors the number of table descriptor lookups

app_cat_cache_overflows

500

Warning

-

-

Monitors the number of catalog cache overflows

app_commit_sql_stmts

500

Warning

-

-

Monitors number of commit SQL statements

app_ddl_sql_stmts

500

Warning

-

-

Monitors number of DDL SQL statements

app_deadlocks

1

Warning

-

-

Monitors number of deadlocks that have occurred

app_direct_read_reqs

500

Warning

-

-

Monitors direct read requests

app_direct_read_time

500

Warning

-

-

Monitors direct read time

Chapter 4: QoS Threshold Metrics 59

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

app_direct_reads

500

Warning

-

-

Monitors direct reads

app_direct_write_reqs

500

Warning

-

-

Monitors direct write requests

app_direct_write_time

500

Warning

-

-

Monitors direct write time

app_direct_writes

500

Warning

-

-

Monitors direct writes

app_dynamic_sql_stmts

500

Warning

-

-

Monitors number of dynamic SQL statements

app_failed_sql_stmts

500

Warning

-

-

Monitors number of failed SQL statements

-

Monitors the number of times hash join data exceeded available space

-

Monitors the number of times hash join data exceeded available space by less than 10%

app_hash_join_overflows

500

app_hash_join_small_overflows 500

Warning

Warning

-

-

app_int_auto_rebinds

500

Warning

-

-

Monitors the number of automatic rebinds (or recompiles) that have been attempted

app_int_commits

500

Warning

-

-

Monitors number of internal commits

app_int_deadlock_rollbacks

500

Warning

-

-

Monitors number of internal deadlock rollbacks

app_int_ rollbacks

500

Warning

-

-

Monitors number of internal rollbacks

app_int_rows_deleted

500

Warning

-

-

Monitors number of internal rows deleted

app_int_rows_inserted

500

Warning

-

-

Monitors the number of internal inserts

app_int_rows_updated

500

Warning

-

-

Monitors number of internal rows updated

-

Monitors number of times that locks have been escalated from several row locks to a table lock

app_lock_escals

60 db2 Guide

1

Warning

-

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

app_lock_timeouts

500

Warning

-

-

Monitors the number of timeouts

-

Monitors total elapsed time waited for a lock in ms

-

Monitors number of times that application waited for locks

app_lock_wait_time

app_lock_waits

1000

90

Warning

Warning

-

-

app_locklist_util

50

Warning

-

-

Monitors locklist utilization by application in percent

app_locks_held

100

Warning

-

-

Monitors number of locks currently held

-

Monitors the number of concurrent agents currently executing a statement or subsection

-

Monitors the number of agents associated with the application

-

Monitors the number of local cursors currently open for this application

-

Monitors the number of local blocking cursors currently open for this application

-

Monitors the number of remote cursors currently open for this application

app_num_agents

app_num_asoc_agents

app_open_loc_curs

app_open_loc_curs_blk

app_open_rem_curs

500

500

500

500

500

Warning

Warning

Warning

Warning

Warning

-

-

-

-

-

app_open_rem_curs_blk

500

Warning

-

-

Monitors the number of remote blocking cursors currently open for this application

app_pct_sort_overflows

25

Warning

-

-

Monitors percentage of sort owerflows per interval

-

Monitors percentage of time package section was found in package cache

app_pkg_cache_hit_rto

75

Warning

-

Chapter 4: QoS Threshold Metrics 61

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

app_pkg_cache_inserts

500

Warning

-

-

Monitors the number of sections inserted into cache

app_pkg_cache_lookups

500

Warning

-

-

Monitors the number of section lookups

app_pool_data_I_reads

500

Warning

-

-

Monitors number of logical read requests

app_pool_data_p_reads

500

Warning

-

-

Monitors number of reads, requiring physical I/O

-

Monitors number of times, data was physicaly written to disk

-

Monitors the percentage of time a page was found in buffer pool on application request

-

Monitors number of logical read req. for index pages

-

Monitors number of req. for index page req. physical I/O

-

Monitors number of times, index page was written to disk

-

Monitors total el.time for ph. read of data/ix. pages in ms

-

Monitors total el.time for ph. read of data/ix. pages in ms

app_pool_data_writes

app_pool_hit_ratio

app_pool_index_l_reads

app_pool_index_p_reads

app_pool_index_writes

app_pool_read_time

app_pool_write_time

500

85

500

500

500

500

500

Warning

Warning

Warning

Warning

Warning

Warning

Warning

-

-

-

-

-

-

-

app_rej_curs_blk

500

Warning

-

-

Monitors the number of times that a request for an I/O block at server was rejected

app_rollback_sql_stmts

500

Warning

-

-

Monitors number of rollback SQL statements

app_rows_deleted

500

Warning

-

-

Monitors number of rows deleted

62 db2 Guide

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

app_rows_inserted

500

Warning

-

-

Monitors number of rows inserted

app_rows_read

500

Warning

-

-

Monitors number of rows read

app_rows_selected

500

Warning

-

-

Monitors number of rows selected

app_rows_updated

500

Warning

-

-

Monitors number of rows updated

app_rows_written

500

Warning

-

-

Monitors number of rows written

app_select_sql_stmts

500

Warning

-

-

Monitors number of select SQL statements

app_sort_overflows

50

Warning

-

-

Monitors the total number of sorts that ran out of sort heap

app_static_sql_stmts

500

Warning

-

-

Monitors number of static SQL statements

-

Monitors the total system CPU time (in seconds) used by database manager agent process

-

Monitors the number of hash joins executed in interval

-

Monitors the number of hash joins executed in interval

-

Monitors the total elapsed time (in ms) for all sorts that have been executed

app_sys_cpu_time

app_total_hash_joins

app_total_hash_loops

app_total_sort_time

500

500

500

50

Warning

Warning

Warning

Warning

-

-

-

-

app_total_sorts

1

Warning

-

-

Monitors the total number of sorts that have been executed

app_uid_sql_stmts

500

Warning

-

-

Monitors number of UID SQL statements

-

Monitors the elapsed execution time of the most recently completed UOW

app_uow_elapsed_time

500

Warning

-

Chapter 4: QoS Threshold Metrics 63

db2 Alert Metrics Default Settings

Alert Metric

app_uow_lock_wait_time

app_uow_log_space_used

app_usr_cpu_time

app_x_lock_escals

bp_avg_direct_read_time

Warning Threshold

500

500

500

1

65

Warning Severity

Warning

Warning

Warning

Warning

Warning

Error Threshold

-

-

-

-

-

Error Severity

Description

-

Monitors the total amount of elapsed time this unit of work has spent waiting for locks in ms

-

Monitors the amount of log space (in bytes) used in the current UOW

-

Monitors the total user CPU time (in seconds) used by database manager agent process

-

Monitors number of times that (x) locks have been escalated from several row locks to one exclusive table lock

-

Monitors average time for direct read in ms in interval

bp_avg_direct_write_time

65

Warning

-

-

Monitors average time for direct write in ms in interval

bp_direct_read_reqs

85

Warning

-

-

Monitors number of direct read requests

bp_direct_read_time

85

Warning

-

-

Monitors direct read time

bp_direct_reads

85

Warning

-

-

Monitors number of direct reads

bp_direct_write_reqs

85

Warning

-

-

Monitors number of direct write requests

bp_direct_write_time

85

Warning

-

-

Monitors direct write time

bp_direct_writes

85

Warning

-

-

Monitors number of direct writes

bp_files_closed

85

Warning

-

-

Monitors number of file close operations

-

Monitors number of asynchronous read requests

bp_pool_async_data_read_reqs 85

64 db2 Guide

Warning

-

db2 Alert Metrics Default Settings

Alert Metric

bp_pool_async_data_reads

Warning Threshold

85

Warning Severity

Warning

Error Threshold

-

Error Severity

Description

-

Monitors number of pages read asynchronously into the bufferpool

bp_pool_async_data_writes

85

Warning

-

-

Monitors number of pages written asynchronously into the bufferpool

bp_pool_async_index_reads

85

Warning

-

-

Monitors number of asynchronous index reads

-

Monitors number of index pages written asynchronously into the bufferpool

-

Monitors elapsed time spent reading by prefetcher

-

Monitors elapsed time spent asynchronously writing

-

Monitors average asynchronous read time in ms in interval

-

Monitors average asynchronous write time in ms in interval

-

Monitors average asynchronous write time in ms in interval

-

Monitors number of of data pages copied from extended sotrage

-

Monitors number of logical read requests in interval

-

Monitors number of physical read requests in interval

-

Monitors number of of data pages copied to extended sotrage

bp_pool_async_index_writes

bp_pool_async_read_time

bp_pool_async_write_time

bp_pool_avg_async_read_time

85

85

85

15

bp_pool_avg_async_write_time 25

bp_pool_avg_write_time

bp_pool_data_from_estore

bp_pool_data_l_reads

bp_pool_data_p_reads

bp_pool_data_to_estore

65

85

100000

85

85

Warning

Warning

Warning

Warning

Warning

Warning

Warning

Warning

Warning

Warning

-

-

-

-

-

-

-

-

-

-

Chapter 4: QoS Threshold Metrics 65

db2 Alert Metrics Default Settings

Alert Metric

bp_pool_data_writes

bp_pool_hit_ratio

bp_pool_index_from_estore

bp_pool_index_l_reads

bp_pool_index_p_reads

bp_pool_index_to_estore

bp_pool_index_writes

bp_pool_read_time

bp_pool_sync_idx_reads

bp_pool_sync_idx_writes

Warning Threshold

85

85

85

85

85

85

85

10

65

65

Warning Severity

Warning

Warning

Warning

Warning

Warning

Warning

Warning

Warning

Warning

Warning

Error Threshold

-

-

-

-

-

-

-

-

-

-

Error Severity

Description

-

Monitors number of physical write requests in interval

-

Monitors percentage of time a page was found in buffer pool

-

Monitors number of of index pages copied from extended sotrage

-

Monitors number of logical read requests for index pages in interval

-

Monitors number of physical read requests for index pages in interval

-

Monitors number of of index pages copied to extended sotrage

-

Monitors number of write requests for index pages in interval

-

Monitors total elapsed time for physical read of data/ixdex pages

-

Monitors number of synchronous index page reads in interval

-

Monitors number of synchronous index page writes in interval

bp_pool_sync_reads

65

Warning

-

-

Monitors number of synchronous data reads in interval

bp_pool_sync_write_time

65

Warning

-

-

Monitors synchronous write time in ms in interval

-

Monitors number of synchronous data writes in interval

bp_pool_sync_writes

66 db2 Guide

65

Warning

-

db2 Alert Metrics Default Settings

Alert Metric

bp_pool_write_time

db_active_sorts

Warning Threshold

85

800

Warning Severity

Warning

Warning

Error Threshold

-

-

Error Severity

Description

-

Monitors elapsed time for physical write of data/index pages

-

Monitors # of sorts currently having heap allocated

db_agents_top

5

Warning

-

-

Monitors max # of agents associated at once with the database

db_appl_section_inserts

5

Warning

-

-

Monitors # of inserts due SQL section not found

db_appl_section_lookups

5

Warning

-

-

Monitors # of references to SQL work area

-

Monitors number of applications currently connected

db_appls_cur_cons

25

Warning

-

db_appls_in_db2

25

Warning

-

-

Monitors number of applications currently connected

db_avg_direct_read_time

15

Warning

-

-

Monitors average time for direct read in ms

db_avg_direct_write_time

25

Warning

-

-

Monitors average time for direct write in ms

db_avg_sort_heap

100

Warning

-

-

Monitors average number of pages allocated to sort heap in interval

db_avg_sort_time

10

Warning

-

-

Monitors average sort time in interval in sec

db_binds_precomplies

25

Warning

-

-

Monitors number of binds/precompiles

-

Monitors number of of overflows due to databae heap full

db_cat_cache_heap_full

25

Warning

-

db_cat_cache_hit_rto

50

Warning

-

-

Monitors percent of times, information was found in catalog cache

db_cat_cache_inserts

25

Warning

-

-

Monitors number of catalog cache inserts

Chapter 4: QoS Threshold Metrics 67

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

db_cat_cache_lookups

25

Warning

-

-

Monitors number of catalog cache lookups

db_cat_cache_overflows

25

Warning

-

-

Monitors number of catalog cache overflows

db_commit_sql_stmts

25

Warning

-

-

Monitors number of commit SQL statements

-

Monitors database connection time in seconds

db_connect_time

0.1

Warning

-

db_connections_top

25

Warning

-

-

Monitors maximum number of connections

db_coord_agents_top

5

Warning

-

-

Monitors max # of coordinating agents

db_ddl_sql_stmts

25

Warning

-

-

Monitors number of DDL SQL statements

db_deadlocks

1

Warning

-

-

Monitors # of deadlocks occured in interval

db_direct_read_reqs

25

Warning

-

-

Monitors number of direct read requests

db_direct_read_time

25

Warning

-

-

Monitors direct read time

db_direct_reads

25

Warning

-

-

Monitors number of direct reads

db_direct_write_reqs

25

Warning

-

-

Monitors number of direct write requests

db_direct_write_time

25

Warning

-

-

Monitors direct write time

db_direct_writes

25

Warning

-

-

Monitors number of direct writes

db_dynamic_sql_stmts

25

Warning

-

-

Monitors number of rollback SQL statements

db_failed_sql_stmts

25

Warning

-

-

Monitors number of failed SQL statements

db_files_closed

3

Warning

-

-

Monitors number of file-close operations

-

Monitors # of times hash join data exceeded the available sort heap space

db_hash_join_overflows

68 db2 Guide

1

Warning

-

db2 Alert Metrics Default Settings

Alert Metric

db_hash_join_small_overflows

Warning Threshold

1

Warning Severity

Warning

Error Threshold

-

Error Severity

Description

-

Monitors # of times hash join data exceeded the available sort heap space by less than 10%

db_heap_top

100000

Warning

-

-

Monitors maximum database memory usage (in bytes)

db_int_auto_rebinds

25

Warning

-

-

Monitors number of auto rebinds

db_int_commits

25

Warning

-

-

Monitors number of internal commits

db_int_deadlock_rollbacks

25

Warning

-

-

Monitors number of rollbacks due to deadlock

db_int_rollbacks

25

Warning

-

-

Monitors number of internal rollbacks

db_int_rows_deleted

25

Warning

-

-

Monitors number of internal deletes

db_int_rows_inserted

25

Warning

-

-

Monitors number of internal inserts

db_int_rows_updated

25

Warning

-

-

Monitors number of internal updates

db_lock_escals

1

Warning

-

-

Monitors # of lock escalations (row->table)

db_lock_list_in_use

124000

Warning

-

-

Monitors total lock list memory in use (bytes)

db_lock_timeouts

1

Warning

-

-

Monitors # of timeouts in interval

db_lock_wait_time

1

Warning

-

-

Monitors total time dbase waited on locks in ms

db_lock_waits

1

Warning

-

-

Monitors # of times app. or connection waited for a lock

db_locks_held

80

Warning

-

-

Monitors # of locks currently held

-

Monitors number of agents currently waiting on lock

db_locks_waiting

1

Warning

-

Chapter 4: QoS Threshold Metrics 69

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

db_logs_read

25

Warning

-

-

Monitors number of log pages read

db_log_util_rto

25

Warning

-

-

Monitors database log utilization

db_log_writes

25

Warning

-

-

Monitors number of log pages written

-

Monitors current number of agents associated with the database

db_num_assoc_agents

5

Warning

-

db_pct_hjs_overflows

10

Warning

-

-

Monitors percentage of hash join small overflows

db_pct_sort_overflows

10

Warning

-

-

Monitors % of sort owerflows in interval

db_pkg_cache_inserts

25

Warning

-

-

Monitors number of sections inserted into cache

db_pkg_cache_lookups

25

Warning

-

-

Monitors number of package or section lookups

-

Monitors number of asynchronous read requests

-

Monitors number of pages read asynchronously into the buffer pool

-

Monitors number of data pages asynchronously written to disk

-

Monitors number of times index was asynchronously read

-

Monitors number of index pages asynchronously written to disk

-

Monitors total elapsed time spent reading by prefetcher

db_pool_async_data_read_reqs 100

db_pool_async_data_reads

db_pool_async_data_writes

db_pool_async_index_reads

db_pool_async_index_writes

db_pool_async_read_time

70 db2 Guide

100

100

3

100

100

Warning

Warning

Warning

Warning

Warning

Warning

-

-

-

-

-

-

db2 Alert Metrics Default Settings

Alert Metric

db_pool_async_write_time

db_pool_avg_async_read_time

Warning Threshold

100

15

Warning Severity

Warning

Warning

Error Threshold

-

-

Error Severity

Description

-

Monitors total elapsed time spent asychronously writing

-

Monitors average asynchronous read time in ms in interval

db_pool_avg_async_write_time 25

Warning

-

-

Monitors average asynchronous write time in ms in interval

db_pool_avg_write_time

Warning

-

-

Monitors average write time in ms in interval

25

db_pool_data_from_estore

100

Warning

-

-

Monitors number of data pages copied from extended sotrage

db_pool_data_l_reads

10

Warning

-

-

Monitors number of logical read requests

db_pool_data_p_reads

10

Warning

-

-

Monitors number of reads, requiring physical I/O

-

Monitors number of data pages copied to extended sotrage

-

Monitors number of times, data was physicaly written to disk

-

Monitors number of times victim page cleaner was triggered

-

Monitors number of times dirty page threshold reached

-

Monitors percentage of time a page was found in buffer pool

-

Monitors number of index pages copied from extended storage

-

Monitors number of logical read requests for index pages

db_pool_data_to_estore

db_pool_data_writes

db_pool_drty_pg_steal_clns

db_pool_drty_pg_thrsh_clns

db_pool_hit_ratio

db_pool_index_from_estore

db_pool_index_l_reads

3

10

100

100

75

3

10

Warning

Warning

Warning

Warning

Warning

Warning

Warning

-

-

-

-

-

-

-

Chapter 4: QoS Threshold Metrics 71

db2 Alert Metrics Default Settings

Alert Metric

db_pool_index_p_reads

db_pool_index_to_estore

db_pool_index_writes

db_pool_lsn_gap_clns

db_pool_read_time

db_pool_sync_idx_reads

db_pool_sync_idx_writes

Warning Threshold

10

3

10

100

10

10

10

Warning Severity

Warning

Warning

Warning

Warning

Warning

Warning

Warning

Error Threshold

-

-

-

-

-

-

-

Error Severity

Description

-

Monitors number of index reads, page requiring physical I/O

-

Monitors number of index pages copied to extended sotrage

-

Monitors number of times, index page was written to disk

-

Monitors number of times logging space used reached threshold

-

Monitors total elapsed time for physical read of data/ixdex pages

-

Monitors number of synchronous index page reads per interval

-

Monitors number of synchronous index page writes per interval

db_pool_sync_reads

75

Warning

-

-

Monitors number of synchronous data reads per interval

db_pool_sync_idx_write_time

15

Warning

-

-

Monitors synchronous write time in ms in interval

-

Monitors number of synchronous data writes per interval

db_pool_sync_writes

10

Warning

-

db_pool_write_time

10

Warning

-

-

Monitors total elapsed time for physical write of data/ixdex pages

db_prefetch_wait_time

25

Warning

-

-

Monitors time waited for prefetch

db_rollback_sql_stmts

25

Warning

-

-

Monitors number of rollback SQL statements

db_rows_deleted

25

Warning

-

-

Monitors number of rows deleted

72 db2 Guide

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

db_rows_inserted

25

Warning

-

-

Monitors number of rows inserted

db_rows_selected

25

Warning

-

-

Monitors number of rows selected

db_rows_updated

25

Warning

-

-

Monitors number of rows inserted

-

Monitors maximum secondary log space used (in bytes)

db_sec_log_used_top

25

Warning

-

db_sec_logs_allocated

25

Warning

-

-

Monitors number of secondary logs allocated at the moment

db_select_sql_stmts

25

Warning

-

-

Monitors number of select SQL statements

db_since_last_backup

24

Warning

-

-

Monitors number of hours since last backup

db_sort_heap_allocated

1

Warning

-

-

Monitors current number of pages allocated to sort heap

db_sort_overflows

800

Warning

-

-

Monitors # of sort overflows to disk

db_static_sql_stmts

25

Warning

-

-

Monitors number of rollback SQL statements

db_status

0

Warning

-

-

Monitors database status

db_tot_log_used_top

25

Warning

-

-

Monitors maximum total log space used (in bytes)

db_total_cons

25

Warning

-

-

Monitors number of connects

db_total_hash_joins

5

Warning

-

-

Monitors # of hash joins executed in interval

db_total_hash_loops

1

Warning

-

-

Monitors # of times single partition of hash join was larger than the available sort heap space

db_total_sec_cons

25

Warning

-

-

Monitors max. number of secondary connections

Chapter 4: QoS Threshold Metrics 73

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

db_total_sort_time

800

Warning

-

-

Monitors total elapsed time in ms

db_total_sorts

4

Warning

-

-

Monitors # of sorts executed

db_uid_sql_stmts

25

Warning

-

-

Monitors number of Update, Insert, Delete SQL statements

db_x_lock_escals

1

Warning

-

-

Monitors # of x-lock escalations (row->table)

-

Monitors number of agents created because the agent pool was empty

i_agents_created_empty_pool

5

Warning

-

i_agents_created_ratio

50

Warning

-

-

Monitors Agents Created Due to Empty Agent Pool by Agents Assigned From Pool in %

i_agents_from_pool

20

Warning

-

-

Monitors number of agents assigned from pool

i_agents_registered

150

Warning

-

-

Monitors # of agents curr. registered in instance

-

Monitors max. # of agents ever registered since DB2 start

-

Monitors # of agents stolen from applications in interval

-

Monitors # of agents waiting for free token in instance

i_agents_registered_top

i_agents_stolen

i_agents_waiting_on_token

150

5

10

Warning

Warning

Warning

-

-

-

i_agents_waiting_top

10

Warning

-

-

Monitors max. # of agents ever waiting for token since DB2 start

i_agents_dbalive

1

Warning

-

-

Monitors connectivity to the db2 databases

-

Monitors amount of committed private memory

i_comm_private_memory

74 db2 Guide

1000000

Warning

-

db2 Alert Metrics Default Settings

Alert Metric

i_con_local_dbases

i_coord_agents_top

i_gw_cons_wait_client

Warning Threshold

5

5

5

Warning Severity

Warning

Warning

Warning

Error Threshold

-

-

-

Error Severity

Description

-

Monitors # of local databases having open connections

-

Monitors max. # of coordinating agents since DB2 start

-

Monitors # if gateway connections waiting for client reply

i_gw_cons_wait_host

5

Warning

-

-

Monitors # of gateway connections waiting for host reply

i_gw_cur_cons

5

Warning

-

-

Monitors current number of gateway connections

i_gw_total_cons

5

Warning

-

-

Monitors number of gateway connection attempts

i_idle_agents

5

Warning

-

-

Monitors number of unassigned agents in pool

-

Monitors curr. # of local connections to the instance

-

Monitors curr. # of local connections to the instance executing

-

Monitors # of times MAXAGENT parameter was reached (for DB2 before v9.5)

i_local_cons

i_local_cons_in_exec

i_max_agent_overflows

5

5

3

Warning

Warning

Warning

-

-

-

i_pct_active_connections

5

Warning

-

-

Monitors percentage of active connections to total allowed connections

i_piped_sorts_accepted

5

Warning

-

-

Monitors number of piped sort requests accepted

i_piped_sorts_rejected

5

Warning

-

-

Monitors number of of piped sort requests rejected

i_piped_sorts_requested

5

Warning

-

-

Monitors number of of piped sort requests

Chapter 4: QoS Threshold Metrics 75

db2 Alert Metrics Default Settings

Alert Metric

i_post_threshold_hash_joins

i_post_threshold_sorts

i_rem_cons_in

i_rem_cons_in_exec

i_sort_heap_allocated

Warning Threshold

5

10

5

5

8000

Warning Severity

Warning

Warning

Warning

Warning

Warning

Error Threshold

-

-

-

-

-

Error Severity

Description

-

Monitors # of hash joins started after sort heap threshold exceeded

-

Monitors number of of times sort heap threshold has been reached

-

Monitors curr. # of remote connections to the instance

-

Monitors curr. # of remote connections to the instance executing

-

Monitors number of pages allocated for sort-heap at the moment

ts_data_partitioning

15

Warning

-

-

Monitors the data partitioning feature that is enabled in DB2 servers

ts_free_pages

1000

Warning

-

-

Monitors number of free pages in DMS table space

ts_free_pages_pct

10

Warning

-

-

Monitors percent of free pages in DMS table space

-

Monitors maximum of used pages reached in DMS table space

ts_max_used_pages

10000

Warning

-

ts_max_used_pages_pct

95

Warning

-

-

Monitors maximum of used pages in % reached in DMS table space

ts_status

-

-

2114060287

Major

Monitors status of the tablespace

ts_total_pages

3500

Warning

-

-

Monitors total number of pages in table space

-

Monitors number of usable pages in table space (exlc. overhead)

-

Monitors percent of usable pages in DMS table space (exlc. overhead)

ts_usable_pages

ts_usable_pages_pct

76 db2 Guide

2500

10

Warning

Warning

-

-

db2 Alert Metrics Default Settings

Alert Metric

Warning Threshold

Warning Severity

Error Threshold

Error Severity

Description

ts_used_pages

2500

Warning

-

-

Monitors number of used pages in table space

ts_used_pages_pct

85

Warning

-

-

Monitors percent of used pages in table space

Chapter 4: QoS Threshold Metrics 77