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