Monitoring Agent for PostgreSQL 1.0.0 Fix Pack 10 Reference IBM
Monitoring Agent for PostgreSQL 1.0.0 Fix Pack 10 Reference IBM
Note Before using this information and the product it supports, read the information in Notices on page 33. This edition applies to version 1.00.10 of the Monitoring Agent for PostgreSQL and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2014, 2016. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents Figures............... v Tables............... vii Chapter 1. Monitoring Agent for PostgreSQL............. 1 Chapter 2. Dashboards........ 3 Default dashboards............ 3 Group widgets for the Default dashboards.... 3 Custom charts and tables.......... 6 Chapter 3. Eventing thresholds..... 7 Predefined eventing thresholds........ 7 Customized eventing thresholds........ 9 Chapter 4. Attributes......... 11 Data sets for the monitoring agent....... 12 Attribute descriptions........... 13 Availability data set.......... 13 Connection Num data set......... 16 Database Query Counts data set...... 16 Db Buff Hit Rate data set......... 17 Db CPU data set............ 18 Db Memory data set.......... 18 Db Num data set........... 19 DB Size data set............ 19 Lock Detail data set.......... 20 Locks data set............ 21 Performance Object Status data set..... 22 Server Info data set........... 24 SQL Response Time data set........ 25 SQL Statement Perf data set........ 26 Take Action Status data set........ 26 Thread Pool Status data set........ 28 Accessibility features........ 31 Notices.............. 33 Trademarks.............. 35 Terms and conditions for product documentation.. 35 IBM Online Privacy Statement........ 36 Index............... 37 Copyright IBM Corp. 2014, 2016 iii
iv PostgreSQL agent Reference
Figures Copyright IBM Corp. 2014, 2016 v
vi PostgreSQL agent Reference
Tables Copyright IBM Corp. 2014, 2016 vii
viii PostgreSQL agent Reference
Chapter 1. Monitoring Agent for PostgreSQL The Monitoring Agent for PostgreSQL offers a central point of management for your PostgreSQL environment or application. The software provides a comprehensive means for gathering the information that is required to detect problems early and to prevent them. Information is standardized across the system. You can monitor multiple servers from a single console. By using the PostgreSQL agent you can easily collect and analyze PostgreSQL specific information. Installing and configuring the agent Install the monitoring agent on the system where the application that you want to monitor is located. For more information, see the following documentation in IBM Knowledge Center: v IBM Performance Management v IBM Performance Management on Cloud Copyright IBM Corp. 2014, 2016 1
2 PostgreSQL agent Reference
Chapter 2. Dashboards Open the Application Performance Dashboard in the Performance Management console to see a status summary of all your applications. As you drill down to dashboards for specific applications and their supporting elements, more details are available about the selected item. Use the PostgreSQL agent dashboards to proactively monitor your PostgreSQL deployment. Each dashboard contains one or more group widgets with key performance indicators. After you select an application that includes PostgreSQL managed systems, you can see PostgreSQL KPIs in the application dashboard: v At the application level, the Current Component Status stacked bar chart shows an average of the critical, warning, and normal status severities from all the PostgreSQL managed systems in the application. v Click the PostgreSQL bar in the Current Component Status chart or expand Components in the navigator Groups section and click PostgreSQL to see a summary group widget for each PostgreSQL managed system in the application. v Click inside a PostgreSQL summary group widget or click a PostgreSQL managed system from the navigator PostgreSQL instances section to open a dashboard with details from the selected managed system. For more information about the KPIs, click in the group widget or click in the upper-right corner of the dashboard. Default dashboards PostgreSQL Select the PostgreSQL managed component to drill down to more detailed metrics. Postgres Detail Dashboard Select a PostgreSQL managed instance to drill down to more detailed metrics. Additional group widgets These pop-up group widgets are displayed after you click a group widget for more details. Some group widgets have links to more granular information in a popup widget, described here. Group widgets for the Default dashboards PostgreSQL Select the PostgreSQL managed component to drill down to more detailed metrics. The following group widgets are available in this dashboard: PostgreSQL Status This group widget displays the PostgreSQL component summary and provides metrics to indicate the overall health of the PostgreSQL databases. The following KPIs for the group widget are derived from the attributes as described: v Active Connections: The total number of active connections, which is the total number of rows in the pg_stat_activity table. This data is derived from the Connection Num attribute in the KPN CONNECTION NUM data set. v Current CPU used: The total CPU usage percentage, out of the system, of datbase processes ("postgres") since they started. This data is derived from the CPU Value attribute in the KPN DB CPU data set. Copyright IBM Corp. 2014, 2016 3
v Disconnected DB: The total number of databases that cannot be connected to or are inactive. This data is derived from the Inactive Db Num attribute in the KPN DB NUM data set. v Normal DB: The total number of databases that can be connected to or are active. This data is derived from the Active Db Num attribute in the KPN DB NUM data set. v Physical memory used: The memory usage of all database processes ("postgres") in MB. This data is derived from the Memory attribute in the KPN DB MEMORY data set. v Total instance size: Total instance size: The total number of all databases size in the current PostgreSQL instance. v Waiting locks: The number of locks on which transactions are waiting. This data is derived from the Lock Sum attribute in the KPN LOCKS data set. v Worst buffer hit rate(%): The database buffer hit percentage. 101 represents 'No active connections'. This data is derived from the Buffer Hit Percent attribute in the KPN DB BUFF HIT RATE data set. v Worst SQL exec time: The execution time of the SQL statement. This data is derived from the Exec Time attribute in the KPN SQL STATEMENT PERF data set. Postgres Detail Dashboard Select a PostgreSQL managed instance to drill down to more detailed metrics. The following group widgets are available in this dashboard: Average Response Time by Operation(ms) - Top 10 This group widget displays the top 10 average response times of the SQL statements by database and operation. This widget includes the select, insert, update, and delete operations by database. The following KPIs for the group widget are derived from the attributes as described: v DB Name: The database name. This data is derived from the Db Name attribute in the KPN SQL RESPONSE TIME data set. v Response Time: The response time of the SQL statement. This data is derived from the SQL Response Time attribute in the KPN SQL RESPONSE TIME data set. Buffer Hit Rate - Lowest 5 This group widget displays the buffer hit rates for the five worst databases. Information about whether the database allows connection and the number of active connections is also provided. The following KPIs for the group widget are derived from the attributes as described: v Active Connections: The number of active connections to the respective database. This data is derived from the Number Active Connections attribute in the KPN DB BUFF HIT RATE data set. v Allow Connections: Indicates whether the database allows connections. This data is derived from the Db Allow Conn attribute in the KPN DB BUFF HIT RATE data set. v DB Name: The name of the database. This data is derived from the Database Name attribute in the KPN DB BUFF HIT RATE data set. v Hit Rate: The database buffer hit percentage. 101 represents 'No active connections'. This data is derived from the Buffer Hit Percent attribute in the KPN DB BUFF HIT RATE data set. Database Size - Top 5 This group widget displays the top five databases sorted by size and includes all related tablespace names. This widget includes the select, insert, update, and delete operations by database. The following KPIs for the group widget are derived from the attributes as described: 4 PostgreSQL agent Reference
v DB Name: The name of the database. This data is derived from the Database Name attribute in the KPN DB SIZE data set. v DB Size: The size of the table space in MB. This data is derived from the Table Space Size MB attribute in the KPN DB SIZE data set. v Tablespace Used: The name of the table space. This data is derived from the Table Space Name attribute in the KPN DB SIZE data set. Request Number by Operation - Top 5 databases This group widget displays the top five execution counts of SQL statements by database. This widget includes the select, insert, update, and delete operations by database. The following KPIs for the group widget are derived from the attributes as described: v DB Name: The name of the database. This data is derived from the Database Name attribute in the KPN DATABASE QUERY COUNTS data set. v Deletes: The number of DELETE SQL statements that ran since the last pg_stat_statements module was enabled or reset. This data is derived from the Delete SQL Count attribute in the KPN DATABASE QUERY COUNTS data set. v Inserts: The number of INSERT SQL statements that ran since the last pg_stat_statements module was enabled or reset. This data is derived from the Insert SQL Count attribute in the KPN DATABASE QUERY COUNTS data set. v Selects: The number of SELECT SQL statements that ran since the last pg_stat_statements module was enabled or reset. This data is derived from the Select SQL Count attribute in the KPN DATABASE QUERY COUNTS data set. v Updates: The number of UPDATE SQL statements that ran since the last pg_stat_statements module was enabled or reset. This data is derived from the Update SQL Count attribute in the KPN DATABASE QUERY COUNTS data set. SQL Stmt Exec Time - Slowest 5 This group widget displays the five slowest SQL statement execution times from all databases. The following KPIs for the group widget are derived from the attributes as described: v Affect Rows: The rows that are affected by the SQL statement. This data is derived from the Affect Rows attribute in the KPN SQL STATEMENT PERF data set. v Avg Time: The execution time of the SQL statement. This data is derived from the Exec Time attribute in the KPN SQL STATEMENT PERF data set. v DB Name: The database name. This data is derived from the Database Name attribute in the KPN SQL STATEMENT PERF data set. v SQL Stmt: The SQL statement. This data is derived from the SQL Text attribute in the KPN SQL STATEMENT PERF data set. Waiting Lock Time - Top 5 This group widget displays the top five waiting lock times. This widget includes the select, insert, update, and delete operations by database. The following KPIs for the group widget are derived from the attributes as described: v DB Name: The name of the database. This data is derived from the Database Name attribute in the KPN LOCK DETAIL data set. v Lock Mode: The lock mode to control concurrent access to data in tables. These modes can be used for application-controlled locking in situations where MVCC does not give the desired behavior. This data is derived from the Lock Mode attribute in the KPN LOCK DETAIL data set. v Waiting Pid: The process id of the transaction process that is waiting for a lock. This data is derived from the Wait PID attribute in the KPN LOCK DETAIL data set. Chapter 2. Dashboards 5
v Waiting Time: The waiting time of the lock. This data is derived from the Wait Time attribute in the KPN LOCK DETAIL data set. Additional group widgets These pop-up group widgets are displayed after you click a group widget for more details. Some group widgets have links to more granular information in a popup widget, described here. The following group widgets are available in this dashboard: Lock Detail This group widget displays information about the top five waiting lock times. Click any row to see a tooltip window that contains lock detail information. The following KPIs for the group widget are derived from the attributes as described: v DB name: The name of the database. This data is derived from the Database Name attribute in the KPN LOCK DETAIL data set. v Holding lock pid: The PID of the transcation process that is holding the lock. This data is derived from the Hold PID attribute in the KPN LOCK DETAIL data set. v Holding lock sql stmt: The SQL Statement for the transaction that is holding the lock, limited to the first 256 characters of the query. This data is derived from the Hold SQL attribute in the KPN LOCK DETAIL data set. v ID: The object ID that is waiting for a lock, for example, if the lock type is tuple, it is the ID of tuple. This data is derived from the Lock Type ID attribute in the KPN LOCK DETAIL data set. v Lock mode: The lock mode to control concurrent access to data in tables. These modes can be used for application-controlled locking in situations where MVCC does not give the desired behavior. This data is derived from the Lock Mode attribute in the KPN LOCK DETAIL data set. v Lock type: The type of the lock object. This data is derived from the Lock Type attribute in the KPN LOCK DETAIL data set. v Waiting pid: The process id of the transaction process that is waiting for a lock. This data is derived from the Wait PID attribute in the KPN LOCK DETAIL data set. v Waiting time(ms): The waiting time of the lock. This data is derived from the Wait Time attribute in the KPN LOCK DETAIL data set. Custom charts and tables After you select a PostgreSQL managed system instance, the Attribute Details tab is displayed in the dashboard. Open the tab to display options for creating a custom table or chart with attribute values from the PostgreSQL data set that you select. 6 PostgreSQL agent Reference
Chapter 3. Eventing thresholds Thresholds test for certain conditions on your managed systems, such as memory usage over 95%, and raise an event when the conditions have been met. The agent comes with predefined thresholds that you can use to monitor your PostgreSQL environment. You can create additional thresholds for the areas of interest. After you click System Configuration > Threshold Manager, select PostgreSQL as the data source type to see all the available thresholds. Predefined eventing thresholds The thresholds are organized by the data set for which they were written. The PostgreSQL agent has the following predefined thresholds: KPN_Active_Connections_Crit The number of active connections are greater than the critical threshold of 80 or there are no connections. The default configuration has the following SQL syntax: *IF *VALUE KPN_CONNECTION_NUM.Connection_Num *GT 80 *OR *VALUE KPN_CONNECTION_NUM.Connection_Num *EQ 0 This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KPN_Active_Connections_Warn The number of active connections are greater than the warning threshold of 60. The default configuration has the following SQL syntax: *IF *VALUE KPN_CONNECTION_NUM.Connection_Num *GT 60 *AND *VALUE KPN_CONNECTION_NUM.Connection_Num *LE 80 This threshold is evaluated every 5 minutes. The severity of this threshold is Warning. KPN_Buff_Hit_Percent_Crit The buffer hit rate of PostgreSQL is lower than 75 percent. The default configuration has the following SQL syntax: *IF *VALUE KPN_DB_BUFF_HIT_RATE.Buffer_Hit_Percent *LT 75 *AND *VALUE KPN_DB_BUFF_HIT_RATE.Number_Active_Connections *NE 0 This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KPN_Buff_Hit_Percent_Warn The buffer hit rate of PostgreSQL is lower than 90 percent. The default configuration has the following SQL syntax: *IF *VALUE KPN_DB_BUFF_HIT_RATE.Buffer_Hit_Percent *LT 90 *AND *VALUE KPN_DB_BUFF_HIT_RATE.Buffer_Hit_Percent *GE 75 Copyright IBM Corp. 2014, 2016 7
This threshold is evaluated every 5 minutes. The severity of this threshold is Warning. KPN_High_CPU_Crit The processor usage is greater than the critical threshold of 80 percent.the processor usage is calculated by adding the processor usage of all the processes that run on the processor cores. The processor usage can exceed 100% for multi-core processors. The default configuration has the following SQL syntax: *IF *VALUE KPN_DB_CPU.CPU_Value *GT 80 This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KPN_High_CPU_Warn The processor usage is greater than the warning threshold of 50 percent.the processor usage is calculated by adding the processor usage of all the processes that run on the processor cores. The processor usage can exceed 100% for multi-core processors. The default configuration has the following SQL syntax: *IF *VALUE KPN_DB_CPU.CPU_Value *GT 50 *AND *VALUE KPN_DB_CPU.CPU_Value *LE 80 This threshold is evaluated every 5 minutes. The severity of this threshold is Warning. KPN_Inactive_DBs_Warn Some databases cannot be accessed because of connection problem or the databases are inactive. The default configuration has the following SQL syntax: *IF *VALUE KPN_DB_NUM.Inactive_Db_Num *GT 0 This threshold is evaluated every 5 minutes. The severity of this threshold is Warning. KPN_Physical_Memory_High_Crit The physical memory that the database processes use is greater than the critical threshold of one GB. The default configuration has the following SQL syntax: *IF *VALUE KPN_DB_MEMORY.Memory *GT 1024 This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KPN_Physical_Memory_High_Warn The physical memory that the database processes use is greater than the warning threshold of 600 MB. The default configuration has the following SQL syntax: *IF *VALUE KPN_DB_MEMORY.Memory *GT 600 *AND *VALUE KPN_DB_MEMORY.Memory *LE 1024 This threshold is evaluated every 5 minutes. The severity of this threshold is Warning. KPN_PostgreSQL_Locks_Crit The number of waiting locks in PostgreSQL are greater than the critical threshold. The default configuration has the following SQL syntax: 8 PostgreSQL agent Reference
*IF *VALUE KPN_LOCKS.Lock_Sum *GT 5 This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KPN_PostgreSQL_Locks_Warn The number of waiting locks in PostgreSQL are greater than the warning threshold. The default configuration has the following SQL syntax: *IF *VALUE KPN_LOCKS.Lock_Sum *GT 0 *AND *VALUE KPN_LOCKS.Lock_Sum *LE 5 This threshold is evaluated every 5 minutes. The severity of this threshold is Warning. KPN_SQL_Statement_Perf_Crit The execution time of the SQL statement is greater than five seconds. The default configuration has the following SQL syntax: *IF *VALUE KPN_SQL_STATEMENT_PERF.Exec_Time *GT 5000 This threshold is evaluated every 5 minutes. The severity of this threshold is Critical. KPN_SQL_Statement_Perf_Warn The execution time of the SQL statement is greater than one second. The default configuration has the following SQL syntax: *IF *VALUE KPN_SQL_STATEMENT_PERF.Exec_Time *GT 1000 *AND *VALUE KPN_SQL_STATEMENT_PERF.Exec_Time *LE 5000 This threshold is evaluated every 5 minutes. The severity of this threshold is Warning. Customized eventing thresholds You can use the predefined eventing thresholds as a starting point for event monitoring, and create your own eventing thresholds as conditions arise that you want to monitor. Hover your mouse over a help icon to get user assistance for the field. Click the help tool to open the help system for the Threshold Manager help topic. The PostgreSQL agent has many data sets that you can use to create eventing thresholds to monitor for specific conditions. Tip: If you are an IBM Tivoli Monitoring user, data sets are equivalent to attribute groups. Chapter 3. Eventing thresholds 9
10 PostgreSQL agent Reference
Chapter 4. Attributes Attributes are the application properties that are being measured and reported by the Monitoring Agent for PostgreSQL. Attributes make up the key performance indicators (KPIs) that are reported, and you can use them to create eventing thresholds for conditions that you want to monitor. About attributes Attributes are organized into data sets (also referred to as attribute groups). The values can be selectively displayed in dashboards or used to define a threshold. When you view dashboards and use thresholds, data samples of the attributes in the data set are taken. Dashboards Attributes are displayed in the dashboards. The widgets specify which attribute values to request from a monitoring agent. You can edit the Components group widgets that display in the Application Performance Dashboard to control how the group widgets are displayed, their positioning, and to adjust the summary thresholds. After you select a defined application, select the group that is named Components, and click Actions > Edit to open the editor. The Attribute Details tab is displayed after you select a component instance from the navigator Instances section (renamed to the selected subgroup name). Alternative, you can click inside a summary group widget. Use the tools in the Attribute Details tab to create custom charts and tables with data samples from the available data sets. Eventing thresholds You can define thresholds that monitor the state of your operating system, database, or application and open an event when the threshold is exceeded. You use attributes to define thresholds that describe a condition that you want to test. After the threshold is started, the values that are specified in the threshold definition are compared with the values that are collected by the PostgreSQL agent. After the condition is met, an event is registered and you are alerted by indicator icons in the Application Performance Dashboard navigator and the Events tab. The PostgreSQL agent comes with predefined thresholds that are enabled and started with the agent. If you edit a predefined threshold definition, such as to change a condition or severity, it is no longer treated as a predefined threshold but considered a custom threshold. When the sampled values for the attributes that are referenced in a threshold meet the condition (such as attribute A is greater than 80%), an event is opened. Note the following conditions: v v v When no data can be collected for a data set, an empty result is returned (no rows of data) When a specific attribute cannot be collected, the value 0 or is returned unless otherwise specified in a particular attribute (for example, N/A ) Any numeric attribute value that is greater than the largest (positive or negative) number that can be represented by that type returns the corresponding maximum or minimum value. For example, the maximum value for a 32-bit number is 2,147,483,647. These values are displayed as text values that are defined by the data set, such as Value Exceeds Maximum or Value Exceeds Minimum. Copyright IBM Corp. 2014, 2016 11
Additional information about attributes For a list of the data sets, a list of the attributes in each data set, and descriptions of the attributes in the PostgreSQL agent, see Data sets for the monitoring agent and Attribute descriptions on page 13. Data sets for the monitoring agent The PostgreSQL agent contains the following data sets. v Data set name: Availability Table name: KPNAVAIL Historical table name: KPN_AVAILABILITY or KPNAVAIL v Data set name: Connection Num Table name: KPNCONNSUM Historical table name: KPN_CONNECTION_NUM or KPNCONNSUM v Data set name: Database Query Counts Table name: KPNDATABAS Historical table name: KPN_DATABASE_QUERY_COUNTS or KPNDATABAS v Data set name: Db Buff Hit Rate Table name: KPNDBBUFFH Historical table name: KPN_DB_BUFF_HIT_RATE or KPNDBBUFFH v Data set name: Db CPU Table name: KPNDBCPU Historical table name: KPN_DB_CPU or KPNDBCPU v Data set name: Db Memory Table name: KPNDBMEM Historical table name: KPN_DB_MEMORY or KPNDBMEM v Data set name: Db Num Table name: KPNDBNUM Historical table name: KPN_DB_NUM or KPNDBNUM v Data set name: DB Size Table name: KPNDBSIZE Historical table name: KPN_DB_SIZE or KPNDBSIZE v Data set name: Lock Detail Table name: KPNLOCKDET Historical table name: KPN_LOCK_DETAIL or KPNLOCKDET v Data set name: Locks Table name: KPNLOCKS Historical table name: KPN_LOCKS v Data set name: Performance Object Status Table name: KPNPOBJST Historical table name: KPN_PERFORMANCE_OBJECT_STATUS or KPNPOBJST v Data set name: Server Info Table name: KPNSVRINFO Historical table name: KPN_SERVER_INFO or KPNSVRINFO v Data set name: SQL Response Time 12 PostgreSQL agent Reference
Table name: KPNSQLRESP Historical table name: KPN_SQL_RESPONSE_TIME or KPNSQLRESP v Data set name: SQL Statement Perf Table name: KPNSQLPERF Historical table name: KPN_SQL_STATEMENT_PERF or KPNSQLPERF v Data set name: Take Action Status Table name: KPNTACTST Historical table name: KPN_TAKE_ACTION_STATUS or KPNTACTST v Data set name: Thread Pool Status Table name: KPNTHPLST Historical table name: KPN_THREAD_POOL_STATUS or KPNTHPLST Attribute descriptions Attributes in each PostgreSQL agent data set collect data that the agent uses for monitoring. The descriptions of the data sets contain information such as description, type, and names for each attribute in the data set. Some attributes are designated as key attributes. A key attribute is an identifier attribute for the data set. Availability data set The Availability data set contains the availability data for all processes and services that make up this application. This data set contains the following attributes: Application Component attribute The descriptive name of a part of the application. This attribute is a key attribute. The type is string. The following names are defined for this attribute: APPLICATION_COMPONENT or COMPONENT (historical name), Application Component (caption), Application_Component (attribute name), and COMPONENT (column name). Command Line attribute The program name and any arguments specified on the command line when the process was started. For Service or Functionality test, this attribute has the value N/A. The type is string with enumerated values. The following values are defined: N/A (N/A). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: COMMAND_LINE or CMDLINE (historical name), Command Line (caption), Command_Line (attribute name), and CMDLINE (column name). Full Name attribute The full name of the process that includes the path. The type is string with enumerated values. The following values are defined: N/A (N/A). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: FULL_NAME or FULLNAME (historical name), Full Name (caption), Full_Name (attribute name), and FULLNAME (column name). Functionality Test Message attribute The text message that corresponds to the Functionality Test Status. This attribute is only valid for functionality tests. The type is string with enumerated values. The following values are defined: N/A (N/A). Any value that does not have a definition here is displayed in the User Interface. Chapter 4. Attributes 13
The following names are defined for this attribute: FUNCTIONALITY_TEST_MESSAGE or FUNCMSG (historical name), Functionality Test Message (caption), Functionality_Test_Message (attribute name), and FUNCMSG (column name). Functionality Test Status attribute The return code of the functionality test. When the monitored application is running correctly, 'SUCCESS' is displayed. 'NOT_RUNNING' is displayed when it is not running correctly. 'N/A' is displayed when the row does not represent a functionality test. The type is integer with enumerated values. The following values are defined: SUCCESS (0), N/A (1), GENERAL ERROR (2), WARNING (3), NOT RUNNING (4), DEPENDENT NOT RUNNING (5), ALREADY RUNNING (6), PREREQ NOT RUNNING (7), TIMED OUT (8), DOESNT EXIST (9), UNKNOWN (10), DEPENDENT STILL RUNNING (11), INSUFFICIENT USER AUTHORITY (12). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: FUNCTIONALITY_TEST_STATUS or FUNCSTATUS (historical name), Functionality Test Status (caption), Functionality_Test_Status (attribute name), and FUNCSTATUS (column name). Name attribute The name of the process, service, or functionality test. This name matches the executable name of the process, the service short name or the name of the process used to test the application. The type is string with enumerated values. The following values are defined: N/A (N/A). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: NAME (historical name), Name (caption), Name (attribute name), and NAME (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Page Faults per Sec attribute The rate of page faults for the process measured in faults per second. This attribute contains only valid data for processes. The type is integer (32-bit gauge). The following names are defined for this attribute: PAGE_FAULTS_PER_SEC or PAGEFAULTS (historical name), Page Faults per Sec (caption), Page_Faults_per_Sec (attribute name), and PAGEFAULTS (column name). Percent Privileged Time attribute The percentage of the available CPU time being used by this process for privileged operation. The type is integer (32-bit gauge). The following names are defined for this attribute: PERCENT_PRIVILEGED_TIME or PERCPRIV (historical name), Percent Privileged Time (caption), Percent_Privileged_Time (attribute name), and PERCPRIV (column name). Percent Processor Time attribute The percentage of the elapsed time that this process used the processor to execute instructions. The type is integer (32-bit gauge). The following names are defined for this attribute: PERCENT_PROCESSOR_TIME or PERCPROC (historical name), Percent Processor Time (caption), Percent_Processor_Time (attribute name), and PERCPROC (column name). Percent User Mode Time attribute The percentage of the available CPU time being used by this process for user mode operation. The type is integer (32-bit gauge). 14 PostgreSQL agent Reference
The following names are defined for this attribute: PERCENT_USER_MODE_TIME or PERCUSER (historical name), Percent User Mode Time (caption), Percent_User_Mode_Time (attribute name), and PERCUSER (column name). PID attribute The process ID associated with the process. This attribute contains only valid data for processes. The type is integer (32-bit gauge). The following names are defined for this attribute: PID (historical name), PID (caption), PID (attribute name), and PID (column name). Status attribute The status of the application component. v v v For processes 'UP', 'DOWN', 'WARNING', or 'PROCESS_DATA_NOT_AVAILABLE': 'PROCESS_DATA_NOT_AVAILABLE' is displayed for a process when the matching process is running but the resource use information cannot be collected for that process. For services 'UP', 'DOWN', or 'UNKNOWN': 'UNKNOWN' is displayed when the service is not installed. For functionality tests: 'PASSED' or 'FAILED' is displayed. The type is integer with enumerated values. The following values are defined: DOWN (0), UP (1), WARNING (2), UNKNOWN (3), PASSED (4), FAILED (5), PROCESS DATA NOT AVAILABLE (6). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: STATUS (historical name), Status (caption), Status (attribute name), and STATUS (column name). Thread Count attribute The number of threads currently allocated by this process. This attribute contains only valid data for processes. The type is integer (32-bit gauge). The following names are defined for this attribute: THREAD_COUNT or THREADS (historical name), Thread Count (caption), Thread_Count (attribute name), and THREADS (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Type attribute The type of the application component. Components are processes, services, or functionality tests. The type is integer with enumerated values. The following values are defined: PROCESS (0), SERVICE (1), FUNCTIONALITY TEST (2). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: TYPE (historical name), Type (caption), Type (attribute name), and TYPE (column name). Virtual Size attribute The virtual size (in MB) of the process. The type is integer (32-bit gauge). The following names are defined for this attribute: VIRTUAL_SIZE or VIRTSIZE (historical name), Virtual Size (caption), Virtual_Size (attribute name), and VIRTSIZE (column name). Working Set Size attribute The working set size of the process in MB. This attribute contains only valid data for processes. The type is integer (32-bit gauge). The following names are defined for this attribute: WORKING_SET_SIZE or WORKSET (historical name), Working Set Size (caption), Working_Set_Size (attribute name), and WORKSET (column name). Chapter 4. Attributes 15
Connection Num data set The data set provides the number of active connections. This data set contains the following attributes: Connection Num attribute The total number of active connections, which is the total number of rows in the pg_stat_activity table. This attribute is a key attribute. The type is integer (64-bit gauge). The following names are defined for this attribute: CONNECTION_NUM or CONNNUM (historical name), Connection Num (caption), Connection_Num (attribute name), and CONNNUM (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Database Query Counts data set The execution count of SQL statements by the respective databases. This data set contains the following attributes: Database Name attribute The name of the database. This attribute is a key attribute. The type is string. The following names are defined for this attribute: DATABASE_NAME or DBNAME (historical name), Database Name (caption), Database_Name (attribute name), and DBNAME (column name). Delete SQL Count attribute The number of DELETE SQL statements that ran since the last pg_stat_statements module was enabled or reset. The type is integer with enumerated values. The following values are defined: No Value (-1). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: DELETE_SQL_COUNT or DELETE_SQL (historical name), Delete SQL Count (caption), Delete_SQL_Count (attribute name), and DELETE_SQL (column name). Insert SQL Count attribute The number of INSERT SQL statements that ran since the last pg_stat_statements module was enabled or reset. The type is integer with enumerated values. The following values are defined: No Value (-1). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: INSERT_SQL_COUNT or INSERT_SQL (historical name), Insert SQL Count (caption), Insert_SQL_Count (attribute name), and INSERT_SQL (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). 16 PostgreSQL agent Reference
Select SQL Count attribute The number of SELECT SQL statements that ran since the last pg_stat_statements module was enabled or reset. The type is integer with enumerated values. The following values are defined: No Value (-1). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: SELECT_SQL_COUNT or SELECT_SQL (historical name), Select SQL Count (caption), Select_SQL_Count (attribute name), and SELECT_SQL (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Total Count attribute The number of SQL statements that ran since the last pg_stat_statements module was enabled or reset. The type is integer (64-bit gauge). The following names are defined for this attribute: TOTAL_COUNT or TOTAL_PER_ (historical name), Total Count (caption), Total_Count (attribute name), and TOTAL_PER_ (column name). Update SQL Count attribute The number of UPDATE SQL statements that ran since the last pg_stat_statements module was enabled or reset. The type is integer with enumerated values. The following values are defined: No Value (-1). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: UPDATE_SQL_COUNT or UPDATE_SQL (historical name), Update SQL Count (caption), Update_SQL_Count (attribute name), and UPDATE_SQL (column name). Db Buff Hit Rate data set The buffer hit percentage data set provides information about the hit percentage of all buffers that are available for the database. This data set contains the following attributes: Buffer Hit Percent attribute The database buffer hit percentage. 101 represents 'No active connections' The type is real number (32-bit gauge) with two decimal places of precision. The following names are defined for this attribute: BUFFER_HIT_PERCENT or BUFFER_HIT (historical name), Buffer Hit Percent (caption), Buffer_Hit_Percent (attribute name), and BUFFER_HIT (column name). Database Name attribute The name of the database. This attribute is a key attribute. The type is string. The following names are defined for this attribute: DATABASE_NAME or DBNAME (historical name), Database Name (caption), Database_Name (attribute name), and DBNAME (column name). Db Allow Conn attribute Indicates whether the database allows connections. The type is string with enumerated values. The following values are defined: true (true), false (false). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: DB_ALLOW_CONN or DBAWCONN (historical name), Db Allow Conn (caption), Db_Allow_Conn (attribute name), and DBAWCONN (column name). Chapter 4. Attributes 17
Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Number Active Connections attribute The number of active connections to the respective database. The type is integer (32-bit gauge). The following names are defined for this attribute: NUMBER_ACTIVE_CONNECTIONS or NUMBER_ACT (historical name), Number Active Connections (caption), Number_Active_Connections (attribute name), and NUMBER_ACT (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Db CPU data set The total CPU usage percentage, out of the system, of database processes ("postgres") since they started. This data set contains the following attributes: CPU Value attribute The total CPU usage percentage, out of the system, of datbase processes ("postgres") since they started. This attribute is a key attribute. The type is real number (32-bit gauge) with one decimal places of precision. The following names are defined for this attribute: CPU_VALUE or CPUVALUE (historical name), CPU Value (caption), CPU_Value (attribute name), and CPUVALUE (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Db Memory data set The memory usage of all database processes ("postgres") in MB. This data set contains the following attributes: Memory attribute The memory usage of all database processes ("postgres") in MB. This attribute is a key attribute. The type is real number (32-bit gauge) with one decimal places of precision. The following names are defined for this attribute: MEMORY (historical name), Memory (caption), Memory (attribute name), and MEMORY (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). 18 PostgreSQL agent Reference
Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Db Num data set The total number of databases, both inactive and active. This data set contains the following attributes: Active Db Num attribute The total number of databases that can be connected to or are active. This attribute is a key attribute. The type is integer (32-bit gauge). The following names are defined for this attribute: ACTIVE_DB_NUM or DBNUMAC (historical name), Active Db Num (caption), Active_Db_Num (attribute name), and DBNUMAC (column name). Inactive Db Num attribute The total number of databases that cannot be connected to or are inactive. This attribute is a key attribute. The type is integer (32-bit gauge). The following names are defined for this attribute: INACTIVE_DB_NUM or DBNUMIN (historical name), Inactive Db Num (caption), Inactive_Db_Num (attribute name), and DBNUMIN (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). DB Size data set Data size information for respective databases in MB. This data set contains the following attributes: Database Name attribute The name of the database. This attribute is a key attribute. The type is string. The following names are defined for this attribute: DATABASE_NAME or DBNAME (historical name), Database Name (caption), Database_Name (attribute name), and DBNAME (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Table Space Name attribute The name of the table space. This attribute is a key attribute. The type is string. Chapter 4. Attributes 19
The following names are defined for this attribute: TABLE_SPACE_NAME or TSNAME (historical name), Table Space Name (caption), Table_Space_Name (attribute name), and TSNAME (column name). Table Space Size MB attribute The size of the table space in MB. The type is integer (32-bit gauge). The following names are defined for this attribute: TABLE_SPACE_SIZE_MB or TSSIZE (historical name), Table Space Size MB (caption), Table_Space_Size_MB (attribute name), and TSSIZE (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Lock Detail data set The data set provides detailed information about the database locks. This data set contains the following attributes: Database Name attribute The name of the database. This attribute is a key attribute. The type is string. The following names are defined for this attribute: DATABASE_NAME or DBNAME (historical name), Database Name (caption), Database_Name (attribute name), and DBNAME (column name). Hold App Name attribute The name of the application that is holding the lock. The type is string. The following names are defined for this attribute: HOLD_APP_NAME or HOLDAPPNAM (historical name), Hold App Name (caption), Hold_App_Name (attribute name), and HOLDAPPNAM (column name). Hold PID attribute The PID of the transcation process that is holding the lock. This attribute is a key attribute. The type is integer (32-bit numeric property). The following names are defined for this attribute: HOLD_PID or HOLDPID (historical name), Hold PID (caption), Hold_PID (attribute name), and HOLDPID (column name). Hold SQL attribute The SQL Statement for the transaction that is holding the lock, limited to the first 256 characters of the query. The type is string. The following names are defined for this attribute: HOLD_SQL or HOLDSQL (historical name), Hold SQL (caption), Hold_SQL (attribute name), and HOLDSQL (column name). Lock Mode attribute The lock mode to control concurrent access to data in tables. These modes can be used for application-controlled locking in situations where MVCC does not give the desired behavior. The type is string. The following names are defined for this attribute: LOCK_MODE or LOCKMODE (historical name), Lock Mode (caption), Lock_Mode (attribute name), and LOCKMODE (column name). Lock Type attribute The type of the lock object. The type is string. The following names are defined for this attribute: LOCK_TYPE or LOCKTYPE (historical name), Lock Type (caption), Lock_Type (attribute name), and LOCKTYPE (column name). 20 PostgreSQL agent Reference
Lock Type ID attribute The object ID that is waiting for a lock, for example, if the lock type is tuple, it is the ID of tuple. The type is string. The following names are defined for this attribute: LOCK_TYPE_ID or LOCKTYPEID (historical name), Lock Type ID (caption), Lock_Type_ID (attribute name), and LOCKTYPEID (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Wait App Name attribute The name of the application that is waiting for the lock. The type is string. The following names are defined for this attribute: WAIT_APP_NAME or WAITAPPNAM (historical name), Wait App Name (caption), Wait_App_Name (attribute name), and WAITAPPNAM (column name). Wait PID attribute The process id of the transaction process that is waiting for a lock. This attribute is a key attribute. The type is integer (32-bit numeric property). The following names are defined for this attribute: WAIT_PID or WAITPID (historical name), Wait PID (caption), Wait_PID (attribute name), and WAITPID (column name). Wait Time attribute The waiting time of the lock. The type is string. The following names are defined for this attribute: WAIT_TIME or WAITTIME (historical name), Wait Time (caption), Wait_Time (attribute name), and WAITTIME (column name). Locks data set The number of locks on which one or more transactions are waiting. This data set contains the following attributes: Lock Sum attribute The number of locks on which transactions are waiting. This attribute is a key attribute. The type is integer (64-bit gauge). The following names are defined for this attribute: LOCK_SUM or LOCKSUM (historical name), Lock Sum (caption), Lock_Sum (attribute name), and LOCKSUM (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Chapter 4. Attributes 21
Performance Object Status data set The Performance Object Status data set contains information that reflects the status of other data sets so you can see the status of all performance objects that make up this application all at once. Each of these other performance data sets is represented by a row in this table (or other type of view). The status for a data set reflects the result of the last attempt to collect data for that data set, so you can see whether the agent is collecting data correctly. Unlike other data sets, the Performance Object Status data set does not reflect the state of the monitored application. This data set is most often used to determine why data is not available for one of the performance data sets. This data set contains the following attributes: Average Collection Duration attribute The average duration of all data collections of this group in seconds. The type is real number (32-bit counter) with two decimal places of precision with enumerated values. The following values are defined: NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: AVERAGE_COLLECTION_DURATION or COLAVGD (historical name), Average Collection Duration (caption), Average_Collection_Duration (attribute name), and COLAVGD (column name). Cache Hit Percent attribute The percentage of external data requests for this group that were satisfied from the cache. The type is real number (32-bit counter) with two decimal places of precision. The following names are defined for this attribute: CACHE_HIT_PERCENT or CACHPCT (historical name), Cache Hit Percent (caption), Cache_Hit_Percent (attribute name), and CACHPCT (column name). Cache Hits attribute The number of times an external data request for this group was satisfied from the cache. The type is integer (32-bit counter). The following names are defined for this attribute: CACHE_HITS or CACHEHT (historical name), Cache Hits (caption), Cache_Hits (attribute name), and CACHEHT (column name). Cache Misses attribute The number of times an external data request for this group was not available in the cache. The type is integer (32-bit counter). The following names are defined for this attribute: CACHE_MISSES or CACHEMS (historical name), Cache Misses (caption), Cache_Misses (attribute name), and CACHEMS (column name). Error Code attribute The error code associated with the query. The type is integer with enumerated values. The following values are defined: NO ERROR (0), GENERAL ERROR (1), OBJECT NOT FOUND (2), COUNTER NOT FOUND (3), NAMESPACE ERROR (4), OBJECT CURRENTLY UNAVAILABLE (5), COM LIBRARY INIT FAILURE (6), SECURITY INIT FAILURE (7), PROXY SECURITY FAILURE (9), NO INSTANCES RETURNED (10), ASSOCIATOR QUERY FAILED (11), REFERENCE QUERY FAILED (12), NO RESPONSE RECEIVED (13), CANNOT FIND JOINED QUERY (14), CANNOT FIND JOIN ATTRIBUTE IN QUERY 1 RESULTS (15), CANNOT FIND JOIN ATTRIBUTE IN QUERY 2 RESULTS (16), QUERY 1 NOT A SINGLETON (17), QUERY 2 NOT A SINGLETON (18), NO INSTANCES RETURNED IN QUERY 1 (19), NO INSTANCES RETURNED IN QUERY 2 (20), CANNOT FIND ROLLUP QUERY (21), CANNOT FIND ROLLUP ATTRIBUTE (22), FILE OFFLINE (23), NO HOSTNAME (24), MISSING LIBRARY (25), ATTRIBUTE COUNT MISMATCH (26), ATTRIBUTE NAME MISMATCH (27), COMMON DATA PROVIDER NOT STARTED (28), CALLBACK REGISTRATION ERROR (29), MDL LOAD ERROR (30), AUTHENTICATION FAILED (31), CANNOT RESOLVE HOST NAME (32), SUBNODE UNAVAILABLE (33), SUBNODE NOT FOUND IN CONFIG (34), ATTRIBUTE ERROR (35), CLASSPATH ERROR (36), CONNECTION FAILURE (37), FILTER SYNTAX ERROR (38), FILE 22 PostgreSQL agent Reference
NAME MISSING (39), SQL QUERY ERROR (40), SQL FILTER QUERY ERROR (41), SQL DB QUERY ERROR (42), SQL DB FILTER QUERY ERROR (43), PORT OPEN FAILED (44), ACCESS DENIED (45), TIMEOUT (46), NOT IMPLEMENTED (47), REQUESTED A BAD VALUE (48), RESPONSE TOO BIG (49), GENERAL RESPONSE ERROR (50), SCRIPT NONZERO RETURN (51), SCRIPT NOT FOUND (52), SCRIPT LAUNCH ERROR (53), CONF FILE DOES NOT EXIST (54), CONF FILE ACCESS DENIED (55), INVALID CONF FILE (56), EIF INITIALIZATION FAILED (57), CANNOT OPEN FORMAT FILE (58), FORMAT FILE SYNTAX ERROR (59), REMOTE HOST UNAVAILABLE (60), EVENT LOG DOES NOT EXIST (61), PING FILE DOES NOT EXIST (62), NO PING DEVICE FILES (63), PING DEVICE LIST FILE MISSING (64), SNMP MISSING PASSWORD (65), DISABLED (66), URLS FILE NOT FOUND (67), XML PARSE ERROR (68), NOT INITIALIZED (69), ICMP SOCKETS FAILED (70), DUPLICATE CONF FILE (71), DELETED CONFIGURATION (72). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: ERROR_CODE or ERRCODE (historical name), Error Code (caption), Error_Code (attribute name), and ERRCODE (column name). Intervals Skipped attribute The number of times a background data collection for this group was skipped because the previous collection was still running when the next one was due to start. The type is integer (32-bit counter). The following names are defined for this attribute: INTERVALS_SKIPPED or INTSKIP (historical name), Intervals Skipped (caption), Intervals_Skipped (attribute name), and INTSKIP (column name). Last Collection Duration attribute The duration of the most recently completed data collection of this group in seconds. The type is real number (32-bit counter) with two decimal places of precision. The following names are defined for this attribute: LAST_COLLECTION_DURATION or COLDURA (historical name), Last Collection Duration (caption), Last_Collection_Duration (attribute name), and COLDURA (column name). Last Collection Finished attribute The most recent time a data collection of this group finished. The type is timestamp with enumerated values. The following values are defined: NOT COLLECTED (0691231190000000), NOT COLLECTED (0000000000000001). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: LAST_COLLECTION_FINISHED or COLFINI (historical name), Last Collection Finished (caption), Last_Collection_Finished (attribute name), and COLFINI (column name). Last Collection Start attribute The most recent time a data collection of this group started. The type is timestamp with enumerated values. The following values are defined: NOT COLLECTED (0691231190000000), NOT COLLECTED (0000000000000001). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: LAST_COLLECTION_START or COLSTRT (historical name), Last Collection Start (caption), Last_Collection_Start (attribute name), and COLSTRT (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Chapter 4. Attributes 23
Number of Collections attribute The number of data collections for this group since the agent started. The type is integer (32-bit counter). The following names are defined for this attribute: NUMBER_OF_COLLECTIONS or NUMCOLL (historical name), Number of Collections (caption), Number_of_Collections (attribute name), and NUMCOLL (column name). Object Name attribute The name of the performance object. The type is string. The following names are defined for this attribute: OBJECT_NAME or OBJNAME (historical name), Object Name (caption), Object_Name (attribute name), and OBJNAME (column name). Object Status attribute The status of the performance object. The type is integer with enumerated values. The following values are defined: ACTIVE (0), INACTIVE (1). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: OBJECT_STATUS or OBJSTTS (historical name), Object Status (caption), Object_Status (attribute name), and OBJSTTS (column name). Object Type attribute The type of the performance object. The type is integer with enumerated values. The following values are defined: WMI (0), PERFMON (1), WMI ASSOCIATION GROUP (2), JMX (3), SNMP (4), SHELL COMMAND (5), JOINED GROUPS (6), CIMOM (7), CUSTOM (8), ROLLUP DATA (9), WMI REMOTE DATA (10), LOG FILE (11), JDBC (12), CONFIG DISCOVERY (13), NT EVENT LOG (14), FILTER (15), SNMP EVENT (16), PING (17), DIRECTOR DATA (18), DIRECTOR EVENT (19), SSH REMOTE SHELL COMMAND (20). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: OBJECT_TYPE or OBJTYPE (historical name), Object Type (caption), Object_Type (attribute name), and OBJTYPE (column name). Query Name attribute The name of the attribute group. This attribute is a key attribute. The type is string. The following names are defined for this attribute: QUERY_NAME or ATTRGRP (historical name), Query Name (caption), Query_Name (attribute name), and ATTRGRP (column name). Refresh Interval attribute The interval at which this group is refreshed in seconds. The type is integer (32-bit counter). The following names are defined for this attribute: REFRESH_INTERVAL or REFRINT (historical name), Refresh Interval (caption), Refresh_Interval (attribute name), and REFRINT (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Server Info data set Software server information for OSLC. This data set contains the following attributes: Database Name attribute Name of the database. This attribute is a key attribute. The type is string. 24 PostgreSQL agent Reference
The following names are defined for this attribute: DATABASE_NAME or DBNAME (historical name), Database Name (caption), Database_Name (attribute name), and DBNAME (column name). FQDN attribute Fully qualified domain name of this server. This attribute is a key attribute. The type is string. The following names are defined for this attribute: FQDN (historical name), FQDN (caption), FQDN (attribute name), and FQDN (column name). Hostname attribute Short host name of this server. This attribute is a key attribute. The type is string. The following names are defined for this attribute: HOSTNAME (historical name), Hostname (caption), Hostname (attribute name), and HOSTNAME (column name). IP Address attribute IP address of this server. This attribute is a key attribute. The type is string. The following names are defined for this attribute: IP_ADDRESS or IPADDR (historical name), IP Address (caption), IP_Address (attribute name), and IPADDR (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Port attribute TCP port for this server. This attribute is a key attribute. The type is integer (32-bit numeric property). The following names are defined for this attribute: PORT (historical name), Port (caption), Port (attribute name), and PORT (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). SQL Response Time data set The response time of the SQL statement. This data set contains the following attributes: Db Name attribute The database name. This attribute is a key attribute. The type is string. The following names are defined for this attribute: DB_NAME or DBNAME (historical name), Db Name (caption), Db_Name (attribute name), and DBNAME (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). SQL Response Time attribute The response time of the SQL statement. The type is real number (64-bit gauge) with two decimal places of precision. Chapter 4. Attributes 25
The following names are defined for this attribute: SQL_RESPONSE_TIME or RESPTIME (historical name), SQL Response Time (caption), SQL_Response_Time (attribute name), and RESPTIME (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). SQL Statement Perf data set The performance of SQL statements. This data set contains the following attributes: Affect Rows attribute The rows that are affected by the SQL statement. The type is integer (64-bit counter). The following names are defined for this attribute: AFFECT_ROWS or AFFECTROW (historical name), Affect Rows (caption), Affect_Rows (attribute name), and AFFECTROW (column name). Database Name attribute The database name. This attribute is a key attribute. The type is string. The following names are defined for this attribute: DATABASE_NAME or DBNAME (historical name), Database Name (caption), Database_Name (attribute name), and DBNAME (column name). Exec Time attribute The execution time of the SQL statement. The type is integer (64-bit gauge). The following names are defined for this attribute: EXEC_TIME or EXECTIME (historical name), Exec Time (caption), Exec_Time (attribute name), and EXECTIME (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Query Info attribute The database name and the SQL query. The type is string. The following names are defined for this attribute: QUERY_INFO or QUERYINFO (historical name), Query Info (caption), Query_Info (attribute name), and QUERYINFO (column name). SQL Text attribute The SQL statement. This attribute is a key attribute. The type is string. The following names are defined for this attribute: SQL_TEXT or SQLTEXT (historical name), SQL Text (caption), SQL_Text (attribute name), and SQLTEXT (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Take Action Status data set The Take Action Status data set contains information about the results of actions this agent ran. This data set contains the following attributes: 26 PostgreSQL agent Reference
Action App Return Code attribute The application return code of the action is the actual return code of the command run. The type is integer (32-bit numeric property). The following names are defined for this attribute: ACTION_APP_RETURN_CODE or TSKAPRC (historical name), Action App Return Code (caption), Action_App_Return_Code (attribute name), and TSKAPRC (column name). Action Command attribute The command that was run by the action. The type is string. The following names are defined for this attribute: ACTION_COMMAND or TSKCMND (historical name), Action Command (caption), Action_Command (attribute name), and TSKCMND (column name). Action ID attribute The id of the action. The type is integer (32-bit numeric property). The following names are defined for this attribute: ACTION_ID or TSKID (historical name), Action ID (caption), Action_ID (attribute name), and TSKID (column name). Action Instance attribute The instance that is associated with the output produced by running the action. The type is string. The following names are defined for this attribute: ACTION_INSTANCE or TSKINST (historical name), Action Instance (caption), Action_Instance (attribute name), and TSKINST (column name). Action Message attribute The message that is associated with the return code of the action. The type is string. The following names are defined for this attribute: ACTION_MESSAGE or TSKMSGE (historical name), Action Message (caption), Action_Message (attribute name), and TSKMSGE (column name). Action Name attribute The name of the action that was run. The type is string. The following names are defined for this attribute: ACTION_NAME or TSKNAME (historical name), Action Name (caption), Action_Name (attribute name), and TSKNAME (column name). Action Node attribute The node where the action ran. The type is string. The following names are defined for this attribute: ACTION_NODE or TSKORGN (historical name), Action Node (caption), Action_Node (attribute name), and TSKORGN (column name). Action Owner attribute The name of the situation or user that initiated the action. The type is string. The following names are defined for this attribute: ACTION_OWNER or TSKOWNR (historical name), Action Owner (caption), Action_Owner (attribute name), and TSKOWNR (column name). Action Results attribute The output that is produced by running the action. The type is string. The following names are defined for this attribute: ACTION_RESULTS or TSKOUTP (historical name), Action Results (caption), Action_Results (attribute name), and TSKOUTP (column name). Action Status attribute The return code from the Action Status dialog, which is the return code category that is defined for the application return code. The type is integer (32-bit numeric property) with enumerated values. The following values are defined: OK (0), NOT APPLICABLE (1), GENERAL ERROR (2), WARNING (3), NOT RUNNING (4), DEPENDENT NOT RUNNING (5), ALREADY RUNNING (6), PREREQ NOT RUNNING (7), TIMED OUT (8), DOESNT EXIST (9), UNKNOWN (10), Chapter 4. Attributes 27
DEPENDENT STILL RUNNING (11), INSUFFICIENT USER AUTHORITY (12). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: ACTION_STATUS or TSKSTAT (historical name), Action Status (caption), Action_Status (attribute name), and TSKSTAT (column name). Action Subnode attribute The subnode where the action ran. The type is string. The following names are defined for this attribute: ACTION_SUBNODE or TSKSBND (historical name), Action Subnode (caption), Action_Subnode (attribute name), and TSKSBND (column name). Action Type attribute The type of the action. The type is integer (32-bit numeric property) with enumerated values. The following values are defined: UNKNOWN (0), AUTOMATION (1). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: ACTION_TYPE or TSKTYPE (historical name), Action Type (caption), Action_Type (attribute name), and TSKTYPE (column name). Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Timestamp attribute The time the event was generated. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). Thread Pool Status data set The Thread Pool Status data set contains information that reflects the status of the internal thread pool used to collect data asynchronously. This data set contains the following attributes: Node attribute The managed system name of the agent. This attribute is a key attribute. The type is string. The following names are defined for this attribute: NODE (historical name), Node (caption), ORIGINNODE (attribute name), and ORIGINNODE (column name). Thread Pool Active Threads attribute The number of threads in the thread pool currently active doing work. The type is integer (32-bit gauge) with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_ACTIVE_THREADS or TPACTTH (historical name), Thread Pool Active Threads (caption), Thread_Pool_Active_Threads (attribute name), and TPACTTH (column name). Thread Pool Avg Active Threads attribute The average number of threads in the thread pool simultaneously active doing work. The type is real number (32-bit gauge) with two decimal places of precision with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_AVG_ACTIVE_THREADS or TPAVGAT (historical name), Thread Pool Avg Active Threads (caption), Thread_Pool_Avg_Active_Threads (attribute name), and TPAVGAT (column name). 28 PostgreSQL agent Reference
Thread Pool Avg Job Wait attribute The average time a job spends waiting on the thread pool queue in seconds. The type is real number (32-bit gauge) with two decimal places of precision with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_AVG_JOB_WAIT or TPAVJBW (historical name), Thread Pool Avg Job Wait (caption), Thread_Pool_Avg_Job_Wait (attribute name), and TPAVJBW (column name). Thread Pool Avg Queue Length attribute The average length of the thread pool queue during this run. The type is real number (32-bit gauge) with two decimal places of precision with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_AVG_QUEUE_LENGTH or TPAVGQL (historical name), Thread Pool Avg Queue Length (caption), Thread_Pool_Avg_Queue_Length (attribute name), and TPAVGQL (column name). Thread Pool Max Active Threads attribute The peak number of threads in the thread pool that were simultaneously active doing work. The type is integer (32-bit counter) with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_MAX_ACTIVE_THREADS or TPMAXAT (historical name), Thread Pool Max Active Threads (caption), Thread_Pool_Max_Active_Threads (attribute name), and TPMAXAT (column name). Thread Pool Max Queue Length attribute The peak length the thread pool queue reached. The type is integer (32-bit counter) with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_MAX_QUEUE_LENGTH or TPMAXQL (historical name), Thread Pool Max Queue Length (caption), Thread_Pool_Max_Queue_Length (attribute name), and TPMAXQL (column name). Thread Pool Max Size attribute The maximum number of threads that are allowed to exist in the thread pool. The type is integer (32-bit numeric property) with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_MAX_SIZE or TPMAXSZ (historical name), Thread Pool Max Size (caption), Thread_Pool_Max_Size (attribute name), and TPMAXSZ (column name). Thread Pool Min Active Threads attribute The smallest number of threads in the thread pool that were simultaneously active doing work. The type is integer (32-bit counter) with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_MIN_ACTIVE_THREADS or TPMINAT (historical name), Thread Pool Min Active Threads (caption), Thread_Pool_Min_Active_Threads (attribute name), and TPMINAT (column name). Thread Pool Min Queue Length attribute The minimum length the thread pool queue reached. The type is integer (32-bit counter) with Chapter 4. Attributes 29
enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_MIN_QUEUE_LENGTH or TPMINQL (historical name), Thread Pool Min Queue Length (caption), Thread_Pool_Min_Queue_Length (attribute name), and TPMINQL (column name). Thread Pool Queue Length attribute The number of jobs currently waiting in the thread pool queue. The type is integer (32-bit gauge) with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_QUEUE_LENGTH or TPQLGTH (historical name), Thread Pool Queue Length (caption), Thread_Pool_Queue_Length (attribute name), and TPQLGTH (column name). Thread Pool Size attribute The number of threads currently existing in the thread pool. The type is integer (32-bit gauge) with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_SIZE or THPSIZE (historical name), Thread Pool Size (caption), Thread_Pool_Size (attribute name), and THPSIZE (column name). Thread Pool Total Jobs attribute The number of jobs that are completed by all threads in the pool since agent start. The type is integer (32-bit counter) with enumerated values. The following values are defined: NO DATA (-1), NO DATA (-100). Any value that does not have a definition here is displayed in the User Interface. The following names are defined for this attribute: THREAD_POOL_TOTAL_JOBS or TPTJOBS (historical name), Thread Pool Total Jobs (caption), Thread_Pool_Total_Jobs (attribute name), and TPTJOBS (column name). Timestamp attribute The local time at the agent when the data was collected. The type is string. The following names are defined for this attribute: TIMESTAMP (historical name), Timestamp (caption), Timestamp (attribute name), and TIMESTAMP (column name). 30 PostgreSQL agent Reference
Accessibility features Accessibility features assist users who have a disability, such as restricted mobility or limited vision, to use information technology content successfully. Accessibility features The web-based interface of IBM Performance Management is the Performance Management console. The console includes the following major accessibility features: v Enables users to use assistive technologies, such as screen-reader software and digital speech synthesizer, to hear what is displayed on the screen. 1 Consult the product documentation of the assistive technology for details on using those technologies with this product. v Enables users to operate specific or equivalent features using only the keyboard. v Communicates all information independently of color. 2 The Performance Management console uses the latest W3C Standard, WAI-ARIA 1.0 (http:// www.w3.org/tr/wai-aria/), to ensure compliance with US Section 508 (http://www.access-board.gov/ guidelines-and-standards/communications-and-it/about-the-section-508-standards/section-508-standards), and Web Content Accessibility Guidelines (WCAG) 2.0 (http://www.w3.org/tr/wcag20/). To take advantage of accessibility features, use the latest release of your screen reader in combination with the latest web browser that is supported by this product. The Performance Management console online product documentation in IBM Knowledge Center is enabled for accessibility. The accessibility features of IBM Knowledge Center are described at http://www.ibm.com/support/knowledgecenter/doc/kc_help.html#accessibility. Keyboard navigation This product uses standard navigation keys. Interface information The Performance Management console web user interface does not rely on cascading style sheets to render content properly and to provide a usable experience. However, the product documentation does rely on cascading style sheets. IBM Knowledge Center provides an equivalent way for low-vision users to use their custom display settings, including high-contrast mode. You can control font size by using the device or browser settings. The Performance Management console web user interface includes WAI-ARIA navigational landmarks that you can use to quickly navigate to functional areas in the application. The Performance Management console user interface does not have content that flashes 2-55 times per second. Related accessibility information In addition to standard IBM help desk and support websites, IBM has established a TTY telephone service for use by deaf or hard of hearing customers to access sales and support services: 1. Exceptions include some charts and some of the Agent Configuration pages of the Performance Management console. 2. Exceptions include some Agent Configuration pages of the Performance Management console. Copyright IBM Corp. 2014, 2016 31
TTY service 800-IBM-3383 (800-426-3383) (within North America) IBM and accessibility For more information about the commitment that IBM has to accessibility, see IBM Accessibility (www.ibm.com/able). 32 PostgreSQL agent Reference
Notices This information was developed for products and services offered in the US. This material might be available from IBM in other languages. However, you may be required to own a copy of the product or product version in that language in order to access it. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY 10504-1785 US For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you provide in any way it believes appropriate without incurring any obligation to you. Copyright IBM Corp. 2014, 2016 33
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Director of Licensing IBM Corporation North Castle Drive, MD-NC119 Armonk, NY 10504-1785 US Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. The performance data discussed herein is presented as derived under specific operating conditions. Actual results may vary. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibmproducts. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. Statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs. Each copy or any portion of these sample programs or any derivative work must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. 2015. 34 PostgreSQL agent Reference
Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Terms and conditions for product documentation Permissions for the use of these publications are granted subject to the following terms and conditions. Applicability These terms and conditions are in addition to any terms of use for the IBM website. Personal use You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative work of these publications, or any portion thereof, without the express consent of IBM. Commercial use You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM. Rights Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein. IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above instructions are not being properly followed. You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations. Notices 35
IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE. IBM Online Privacy Statement IBM Software products, including software as a service solutions, ( Software Offerings ) may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user or for other purposes. In many cases no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering's use of cookies is set forth in the following paragraphs. Depending upon the configurations deployed, this Software Offering may use session cookies that collect each user's user name for purposes of session management, authentication, and single sign-on configuration. These cookies can be disabled, but disabling them will also likely eliminate the functionality they enable. If the configurations deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users via cookies and other technologies, you should seek your own legal advice about any laws applicable to such data collection, including any requirements for notice and consent. For more information about the use of various technologies, including cookies, for these purposes, See IBM's Privacy Policy at http://www.ibm.com/privacy and IBM's Online Privacy Statement at http://www.ibm.com/privacy/details the section entitled Cookies, Web Beacons and Other Technologies and the IBM Software Products and Software-as-a-Service Privacy Statement at http://www.ibm.com/software/info/product-privacy. 36 PostgreSQL agent Reference
Index A accessibility features 31 Action App Return Code attribute 27 Action Command attribute 27 Action ID attribute 27 Action Instance attribute 27 Action Message attribute 27 Action Name attribute 27 Action Node attribute 27 Action Owner attribute 27 Action Results attribute 27 Action Status attribute 27 Action Subnode attribute 28 Action Type attribute 28 Active Db Num attribute 19 additional information attributes 11 Affect Rows attribute 26 Application Component attribute 13 attributes Action App Return Code 27 Action Command 27 Action ID 27 Action Instance 27 Action Message 27 Action Name 27 Action Node 27 Action Owner 27 Action Results 27 Action Status 27 Action Subnode 28 Action Type 28 Active Db Num 19 Affect Rows 26 Application Component 13 Availability 13 Average Collection Duration 22 Buffer Hit Percent 17 Cache Hit Percent 22 Cache Hits 22 Cache Misses 22 Command Line 13 Connection Num 16 CPU Value 18 Database Name 16, 17, 19, 20, 24, 26 Database Query Counts 16 Db Allow Conn 17 Db Buff Hit Rate 17 Db CPU 18 Db Memory 18 Db Name 25 Db Num 19 DB Size 19 Delete SQL Count 16 Error Code 22 Exec Time 26 FQDN 25 Full Name 13 Functionality Test Message 13 Functionality Test Status 14 Hold App Name 20 attributes (continued) Hold PID 20 Hold SQL 20 Hostname 25 Inactive Db Num 19 Insert SQL Count 16 Intervals Skipped 23 IP Address 25 Last Collection Duration 23 Last Collection Finished 23 Last Collection Start 23 Lock Detail 20 Lock Mode 20 Lock Sum 21 Lock Type 20 Lock Type ID 21 Locks 21 Memory 18 Name 14 Node 14, 16, 18, 19, 21, 23, 25, 26, 28 Number Active Connections 18 Number of Collections 24 Object Name 24 Object Status 24 Object Type 24 overview 11 Page Faults per Sec 14 Percent Privileged Time 14 Percent Processor Time 14 Percent User Mode Time 14 Performance Object Status 22 PID 15 Port 25 Query Info 26 Query Name 24 Refresh Interval 24 Select SQL Count 17 Server Info 24 SQL Response Time 25 SQL Statement Perf 26 SQL Text 26 Status 15 Table Space Name 19 Table Space Size MB 20 Take Action Status 26 Thread Count 15 Thread Pool Active Threads 28 Thread Pool Avg Active Threads 28 Thread Pool Avg Job Wait 29 Thread Pool Avg Queue Length 29 Thread Pool Max Active Threads 29 Thread Pool Max Queue Length 29 Thread Pool Max Size 29 Thread Pool Min Active Threads 29 Thread Pool Min Queue Length 29 Thread Pool Queue Length 30 Thread Pool Size 30 Thread Pool Status 28 Thread Pool Total Jobs 30 Timestamp 15, 16, 17, 18, 19, 20, 21, 24, 25, 26, 28, 30 Total Count 17 Copyright IBM Corp. 2014, 2016 37
attributes (continued) Type 15 Update SQL Count 17 Virtual Size 15 Wait App Name 21 Wait PID 21 Wait Time 21 Working Set Size 15 Availability data set 13 Average Collection Duration attribute 22 B Buffer Hit Percent attribute 17 C Cache Hit Percent attribute 22 Cache Hits attribute 22 Cache Misses attribute 22 Command Line attribute 13 Connection Num attribute 16 Connection Num data set 16 CPU Value attribute 18 D dashboards 3 data set attributes 13 data sets Availability 13 Connection Num 16 Database Query Counts 16 Db Buff Hit Rate 17 Db CPU 18 Db Memory 18 Db Num 19 DB Size 19 list of all 12 Lock Detail 20 Locks 21 overview 11 Performance Object Status 22 Server Info 24 SQL Response Time 25 SQL Statement Perf 26 Take Action Status 26 Thread Pool Status 28 Database Name attribute 16, 17, 19, 20, 24, 26 Database Query Counts data set 16 Db Allow Conn attribute 17 Db Buff Hit Rate data set 17 Db CPU data set 18 Db Memory data set 18 Db Name attribute 25 Db Num data set 19 DB Size data set 19 Delete SQL Count attribute 16 E Error Code attribute 22 eventing thresholds 7 eventing thresholds, using attributes 11 Exec Time attribute 26 F FQDN attribute 25 Full Name attribute 13 Functionality Test Message attribute 13 Functionality Test Status attribute 14 H Hold App Name attribute 20 Hold PID attribute 20 Hold SQL attribute 20 Hostname attribute 25 I Inactive Db Num attribute 19 Insert SQL Count attribute 16 Intervals Skipped attribute 23 Introduction 1 IP Address attribute 25 K KPIs 3 L Last Collection Duration attribute 23 Last Collection Finished attribute 23 Last Collection Start attribute 23 Lock Detail data set 20 Lock Mode attribute 20 Lock Sum attribute 21 Lock Type attribute 20 Lock Type ID attribute 21 Locks data set 21 M Memory attribute 18 N Name attribute 14 Node attribute 14, 16, 18, 19, 21, 23, 25, 26, 28 Number Active Connections attribute 18 Number of Collections attribute 24 O Object Name attribute 24 Object Status attribute 24 Object Type attribute 24 P Page Faults per Sec attribute 14 Percent Privileged Time attribute 14 Percent Processor Time attribute 14 Percent User Mode Time attribute 14 38 PostgreSQL agent Reference
Performance Object Status data set 22 PID attribute 15 Port attribute 25 Q Query Info attribute 26 Query Name attribute 24 R Refresh Interval attribute 24 S Select SQL Count attribute 17 Server Info data set 24 SQL Response Time attribute 25 SQL Response Time data set 25 SQL Statement Perf data set 26 SQL Text attribute 26 Status attribute 15 T Table Space Name attribute 19 Table Space Size MB attribute 20 Take Action Status data set 26 Thread Count attribute 15 Thread Pool Active Threads attribute 28 Thread Pool Avg Active Threads attribute 28 Thread Pool Avg Job Wait attribute 29 Thread Pool Avg Queue Length attribute 29 Thread Pool Max Active Threads attribute 29 Thread Pool Max Queue Length attribute 29 Thread Pool Max Size attribute 29 Thread Pool Min Active Threads attribute 29 Thread Pool Min Queue Length attribute 29 Thread Pool Queue Length attribute 30 Thread Pool Size attribute 30 Thread Pool Status data set 28 Thread Pool Total Jobs attribute 30 thresholds See eventing thresholds Timestamp attribute 15, 16, 17, 18, 19, 20, 21, 24, 25, 26, 28, 30 Total Count attribute 17 Type attribute 15 U Update SQL Count attribute 17 V Virtual Size attribute 15 W Wait App Name attribute 21 Wait PID attribute 21 Wait Time attribute 21 widgets 3 Working Set Size attribute 15 Index 39
40 PostgreSQL agent Reference
IBM Printed in USA