Monitoring Agent for MySQL Version Reference

Transcription

1 Monitoring Agent for MySQL Version Reference

2

3 Monitoring Agent for MySQL Version Reference

4 Note Before using this information and the product it supports, read the information in Notices on page 49. This edition applies to version of Monitoring Agent for MySQL and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2013, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Figures v Tables vii Chapter 1. Attributes Data sets for the monitoring agent Attribute descriptions Agent Config data set Availability data set EVENTS data set FILES data set GLOBAL STATUS data set GLOBAL VARIABLES data set INNODB LOCK WAITS data set PARTITIONS data set Performance Object Status data set PLUGINS data set PROCESSLIST data set SCHEMATA data set SESSION STATUS data set STATISTICS data set Status data set TABLES data set Take Action Status data set Thread Pool Status data set USER PRIVILEGES data set Chapter 2. Dashboards MySQL summary MySQL details Bytes Received vs Sent InnoDB Buffer Pool Pages Historical Performance Chapter 3. Eventing thresholds Predefined eventing thresholds Customized eventing thresholds Chapter 4. Historical data configurations Notices Trademarks Privacy policy considerations Index Copyright IBM Corp. 2013, 2014 iii

6 iv MySQL agent Reference

7 Figures Copyright IBM Corp. 2013, 2014 v

8 vi MySQL agent Reference

9 Tables 1. KPIs in the MYSQL group widget KPIs in the Bytes Received vs Sent group widget KPIs in the MySQL InnoDB Buffer Pool Pages group widget KPIs in the Historical Performance group widget Copyright IBM Corp. 2013, 2014 vii

10 viii MySQL agent Reference

11 Chapter 1. Attributes Attributes are the application properties that are being measured and reported by the Monitoring Agent for MySQL. 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 open the dashboard and start the eventing threshold or historical data collection, data samples of the attributes in the data set are taken. Dashboards Attributes are displayed in the dashboards. The group widgets use queries to the dashboard data provider to 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 widget thresholds. After selecting an application to display in the dashboard, select the group named Components, and click Actions > Edit to open the editor. Eventing thresholds In addition to the widget thresholds that are reported in the dashboards, you can also 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 you want to test. After the eventing threshold is started, the values that are assigned to the attributes in the threshold definition are compared with the values that are collected by the MySQL agent. After the condition is met, an event is registered. You are alerted to events by indicator icons that are displayed in the Application Performance Dashboard navigator and in the Events tab. Historical data configurations The MySQL agent collects historical data for key data sets that are shown in the dashboards. You can add more historical data configurations for any other data sets that are applicable for historical data collection. When the sampled values for the attributes described in a threshold meet the condition (such as attribute A is greater than 80%), an event is opened. Note the following conditions: v When no data can be collected for a data set, an empty result is returned (no rows of data) v When a specific attribute cannot be collected, the value 0 or is returned unless otherwise specified in a particular attribute (for example, N/A ) v 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 defined by the data set, such as Value Exceeds Maximum or Value Exceeds Minimum. 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 MySQL agent, see Data sets for the monitoring agent on page 2 and Attribute descriptions on page 3. Copyright IBM Corp. 2013,

12 Data sets for the monitoring agent The MySQL agent contains the following data sets. v Data set name: Agent Config Table name: KSEAGNTCFG Historical table name: KSE_AGENT_CONFIG or KSEAGNTCFG v Data set name: Availability Table name: KSEAVAIL Historical table name: KSE_AVAILABILITY or KSEAVAIL v Data set name: EVENTS Table name: KSEEVENTS0 Historical table name: KSE_EVENTS or KSEEVENTS0 v Data set name: FILES Table name: KSEFILES0 Historical table name: KSE_FILES or KSEFILES0 v Data set name: GLOBAL STATUS Table name: KSEGLOBAL2 Historical table name: KSE_GLOBAL_STATUS or KSEGLOBAL2 v Data set name: GLOBAL VARIABLES Table name: KSEGLOBAL0 Historical table name: KSE_GLOBAL_VARIABLES or KSEGLOBAL0 v Data set name: INNODB LOCK WAITS Table name: KSEINNODB0 Historical table name: KSE_INNODB_LOCK_WAITS or KSEINNODB0 v Data set name: PARTITIONS Table name: KSEPARTIT0 Historical table name: KSE_PARTITIONS or KSEPARTIT0 v Data set name: Performance Object Status Table name: KSEPOBJST Historical table name: KSE_PERFORMANCE_OBJECT_STATUS or KSEPOBJST v Data set name: PLUGINS Table name: KSEPLUGIN0 Historical table name: KSE_PLUGINS or KSEPLUGIN0 v Data set name: PROCESSLIST Table name: KSEPROCES0 Historical table name: KSE_PROCESSLIST or KSEPROCES0 v Data set name: SCHEMATA Table name: KSESCHEMA0 Historical table name: KSE_SCHEMATA or KSESCHEMA0 v Data set name: SESSION STATUS Table name: KSESESSIO0 Historical table name: KSE_SESSION_STATUS or KSESESSIO0 v Data set name: STATISTICS Table name: KSESTATIS0 Historical table name: KSE_STATISTICS or KSESTATIS0 2 MySQL agent Reference

13 v Data set name: Status Table name: KSESTATUS Historical table name: KSE_STATUS v Data set name: TABLES Table name: KSETABLES0 Historical table name: KSE_TABLES or KSETABLES0 v Data set name: Take Action Status Table name: KSETACTST Historical table name: KSE_TAKE_ACTION_STATUS or KSETACTST v Data set name: Thread Pool Status Table name: KSETHPLST Historical table name: KSE_THREAD_POOL_STATUS or KSETHPLST v Data set name: USER PRIVILEGES Table name: KSEUSERPR0 Historical table name: KSE_USER_PRIVILEGES or KSEUSERPR0 Attribute descriptions Attributes in each MySQL 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. Agent Config data set Contains information on the configuration of the agent.. 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). 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). Port attribute The configured MySQL port. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: PORT (historical name), Port (caption), Port (attribute name), and PORT (column name). Chapter 1. Attributes 3

14 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: 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). 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). 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: v N/A (N/A) The following names are defined for this attribute: NAME (historical name), Name (caption), Name (attribute name), and NAME (column name). Status attribute The status of the application component. 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. v For services 'UP', 'DOWN', or 'UNKNOWN': 'UNKNOWN' is displayed when the service is not installed. v For functionality tests: 'PASSED' or 'FAILED' is displayed. The type is Integer with enumerated values. The following values are defined: v DOWN (0) v UP (1) v WARNING (2) v UNKNOWN (3) v PASSED (4) v FAILED (5) v PROCESS DATA NOT AVAILABLE (6) The following names are defined for this attribute: STATUS (historical name), Status (caption), Status (attribute name), and STATUS (column name). 4 MySQL agent Reference

15 Full Name attribute The full name of the process including the path. The type is String with enumerated values. The following values are defined: v N/A (N/A) 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). 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: v PROCESS (0) v SERVICE (1) v FUNCTIONALITY TEST (2) 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). Page Faults per Sec attribute The rate of page faults for the process measured in faults per second. This attribute only contains 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). Working Set Size attribute The working set size of the process in MB. This attribute only contains 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). Thread Count attribute The number of threads currently allocated by this process. This attribute only contains 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). PID attribute The process ID associated with the process. This attribute only contains 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). Percent Privileged Time attribute The percentage of the available CPU time that is being used by this process for privileged operation. The type is Integer (32-bit gauge). Chapter 1. Attributes 5

16 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 User Mode Time attribute The percentage of the available CPU time that is being used by this process for user mode operation. The type is Integer (32-bit gauge). 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). 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). Command Line attribute The program name and any arguments specified on the command line when the process was started. This has the value N/A if this is a Service, or Functionality test. The type is String with enumerated values. The following values are defined: v N/A (N/A) 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). 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: v SUCCESS (0) v N/A (1) v GENERAL ERROR (2) v WARNING (3) v NOT RUNNING (4) v DEPENDENT NOT RUNNING (5) v ALREADY RUNNING (6) v PREREQ NOT RUNNING (7) v TIMED OUT (8) v DOESNT EXIST (9) v UNKNOWN (10) v DEPENDENT STILL RUNNING (11) v INSUFFICIENT USER AUTHORITY (12) 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). 6 MySQL agent Reference

17 Functionality Test Message attribute The text message that corresponds to the Functionality Test Status. This is only valid for functionality tests. The type is String with enumerated values. The following values are defined: v N/A (N/A) 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). EVENTS data set Events generated by MySQL, from the table EVENTS. 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). 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). EVENT CATALOG attribute The catalog for this event. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: EVENT_CATALOG or EVENT_CATA (historical name), EVENT CATALOG (caption), EVENT_CATALOG (attribute name), and EVENT_CATA (column name). EVENT SCHEMA attribute The schema for this event. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: EVENT_SCHEMA or EVENT_SCHE (historical name), EVENT SCHEMA (caption), EVENT_SCHEMA (attribute name), and EVENT_SCHE (column name). EVENT NAME attribute The name of this event. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: EVENT_NAME (historical name), EVENT NAME (caption), EVENT_NAME (attribute name), and EVENT_NAME (column name). DEFINER attribute The account of the user who defined this event. The type is String. The following names are defined for this attribute: DEFINER (historical name), DEFINER (caption), DEFINER (attribute name), and DEFINER (column name). TIME ZONE attribute The time zone for this event. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: TIME_ZONE (historical name), TIME ZONE (caption), TIME_ZONE (attribute name), and TIME_ZONE (column name). EVENT BODY attribute The language of 'DO' text for this event. The type is String. Chapter 1. Attributes 7

18 The following names are defined for this attribute: EVENT_BODY (historical name), EVENT BODY (caption), EVENT_BODY (attribute name), and EVENT_BODY (column name). EVENT DEFINITION attribute The statement triggered by this event. The type is String. The following names are defined for this attribute: EVENT_DEFINITION or EVENT_DEFI (historical name), EVENT DEFINITION (caption), EVENT_DEFINITION (attribute name), and EVENT_DEFI (column name). EVENT TYPE attribute The repetition type of this event. The type is String. The following names are defined for this attribute: EVENT_TYPE (historical name), EVENT TYPE (caption), EVENT_TYPE (attribute name), and EVENT_TYPE (column name). EXECUTE AT attribute The time specified for a one time event. The type is Timestamp. The following names are defined for this attribute: EXECUTE_AT (historical name), EXECUTE AT (caption), EXECUTE_AT (attribute name), and EXECUTE_AT (column name). INTERVAL VALUE attribute The interval specified for a repeating event. The type is String. The following names are defined for this attribute: INTERVAL_VALUE or INTERVAL_V (historical name), INTERVAL VALUE (caption), INTERVAL_VALUE (attribute name), and INTERVAL_V (column name). INTERVAL FIELD attribute The interval's units specified for a repeating event. The type is String. The following names are defined for this attribute: INTERVAL_FIELD or INTERVAL_F (historical name), INTERVAL FIELD (caption), INTERVAL_FIELD (attribute name), and INTERVAL_F (column name). SQL MODE attribute The server's SQL mode when this event was created. The type is String. The following names are defined for this attribute: SQL_MODE (historical name), SQL MODE (caption), SQL_MODE (attribute name), and SQL_MODE (column name). STARTS attribute The start time for a repeated event (if defined). The type is Timestamp. The following names are defined for this attribute: STARTS (historical name), STARTS (caption), STARTS (attribute name), and STARTS (column name). ENDS attribute The end time for a repeated event (if defined). The type is Timestamp. The following names are defined for this attribute: ENDS (historical name), ENDS (caption), ENDS (attribute name), and ENDS (column name). STATUS attribute Whether this event is enabled, disabled, or enabled on a slave server. The type is String. The following names are defined for this attribute: STATUS (historical name), STATUS (caption), STATUS (attribute name), and STATUS (column name). ON COMPLETION attribute Whether to preserve this event upon completion. The type is String. The following names are defined for this attribute: ON_COMPLETION or ON_COMPLET (historical name), ON COMPLETION (caption), ON_COMPLETION (attribute name), and ON_COMPLET (column name). 8 MySQL agent Reference

19 CREATED attribute When this event was created. The type is Timestamp. The following names are defined for this attribute: CREATED (historical name), CREATED (caption), CREATED (attribute name), and CREATED (column name). LAST ALTERED attribute When this event was last altered. The type is Timestamp. The following names are defined for this attribute: LAST_ALTERED or LAST_ALTER (historical name), LAST ALTERED (caption), LAST_ALTERED (attribute name), and LAST_ALTER (column name). LAST EXECUTED attribute When this event was last executed. The type is Timestamp. The following names are defined for this attribute: LAST_EXECUTED or LAST_EXECU (historical name), LAST EXECUTED (caption), LAST_EXECUTED (attribute name), and LAST_EXECU (column name). EVENT COMMENT attribute User comment for this event. The type is String. The following names are defined for this attribute: EVENT_COMMENT or EVENT_COMM (historical name), EVENT COMMENT (caption), EVENT_COMMENT (attribute name), and EVENT_COMM (column name). ORIGINATOR attribute The server ID of the originating server for this event (or 0 if not replicated). The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: ORIGINATOR (historical name), ORIGINATOR (caption), ORIGINATOR (attribute name), and ORIGINATOR (column name). CHARACTER SET CLIENT attribute The session client character set in use when the event was created. The type is String. The following names are defined for this attribute: CHARACTER_SET_CLIENT or CHARACTER_ (historical name), CHARACTER SET CLIENT (caption), CHARACTER_SET_CLIENT (attribute name), and CHARACTER_ (column name). COLLATION CONNECTION attribute The session collation connection in set when the event was created. The type is String. The following names are defined for this attribute: COLLATION_CONNECTION or COLLATION_ (historical name), COLLATION CONNECTION (caption), COLLATION_CONNECTION (attribute name), and COLLATION_ (column name). DATABASE COLLATION attribute The collation of the database for this event. The type is String. The following names are defined for this attribute: DATABASE_COLLATION or DATABASE_C (historical name), DATABASE COLLATION (caption), DATABASE_COLLATION (attribute name), and DATABASE_C (column name). FILES data set Information regarding files associated with MySQL tablespaces, from the table FILES. This data set contains the following attributes: Chapter 1. Attributes 9

20 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). TABLESPACE NAME attribute The name of the tablespace this file is associated with. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: TABLESPACE_NAME or TABLESPACE (historical name), TABLESPACE NAME (caption), TABLESPACE_NAME (attribute name), and TABLESPACE (column name). FILE NAME attribute The name of the file. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: FILE_NAME (historical name), FILE NAME (caption), FILE_NAME (attribute name), and FILE_NAME (column name). GLOBAL STATUS data set All global status variables and their values, from the table GLOBAL_STATUS. 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). 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). VARIABLE NAME attribute The global status variable name. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: VARIABLE_NAME or VARIABLE_N (historical name), VARIABLE NAME (caption), VARIABLE_NAME (attribute name), and VARIABLE_N (column name). VARIABLE VALUE attribute The global status variable value. The type is String. The following names are defined for this attribute: VARIABLE_VALUE or VARIABLE_V (historical name), VARIABLE VALUE (caption), VARIABLE_VALUE (attribute name), and VARIABLE_V (column name). VARIABLE VALUE AS INTEGER attribute The global status variable value as an integer. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: 10 MySQL agent Reference

21 The following names are defined for this attribute: VARIABLE_VALUE_AS_INTEGER or VARIABLE_I (historical name), VARIABLE VALUE AS INTEGER (caption), VARIABLE_VALUE_AS_INTEGER (attribute name), and VARIABLE_I (column name). GLOBAL VARIABLES data set All global variables and their values, from the table GLOBAL_VARIABLES. 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). 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). VARIABLE NAME attribute The global variable name. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: VARIABLE_NAME or VARIABLE_N (historical name), VARIABLE NAME (caption), VARIABLE_NAME (attribute name), and VARIABLE_N (column name). VARIABLE VALUE attribute The global variable value. The type is String. The following names are defined for this attribute: VARIABLE_VALUE or VARIABLE_V (historical name), VARIABLE VALUE (caption), VARIABLE_VALUE (attribute name), and VARIABLE_V (column name). VARIABLE VALUE AS INTEGER attribute The global variable value as an integer. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: VARIABLE_VALUE_AS_INTEGER or VARIABLE_I (historical name), VARIABLE VALUE AS INTEGER (caption), VARIABLE_VALUE_AS_INTEGER (attribute name), and VARIABLE_I (column name). INNODB LOCK WAITS data set InnoDB transactions which are currently blocked and their causes, from the table INNODB_LOCK_WAITS. 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). Chapter 1. Attributes 11

22 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). requesting trx id attribute The ID of the requesting transaction which is currently blocked. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: REQUESTING_TRX_ID or REQUESTING (historical name), requesting trx id (caption), requesting_trx_id (attribute name), and REQUESTING (column name). requested lock id attribute The ID of the lock the requesting transaction is currently blocking on. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: REQUESTED_LOCK_ID or REQUESTED_ (historical name), requested lock id (caption), requested_lock_id (attribute name), and REQUESTED_ (column name). blocking trx id attribute The ID of the blocking transaction which currently holds the contested lock. The type is String. The following names are defined for this attribute: BLOCKING_TRX_ID or BLOCKING_T (historical name), blocking trx id (caption), blocking_trx_id (attribute name), and BLOCKING_T (column name). blocking lock id attribute The ID of a lock the blocking transaction is currently holding which is blocking another transaction from proceeding. The type is String. The following names are defined for this attribute: BLOCKING_LOCK_ID or BLOCKING_L (historical name), blocking lock id (caption), blocking_lock_id (attribute name), and BLOCKING_L (column name). PARTITIONS data set Information regarding table partitioning, from the table PARTITIONS. 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). 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). TABLE CATALOG attribute The catalog for this partition. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: TABLE_CATALOG or TABLE_CATA (historical name), TABLE CATALOG (caption), TABLE_CATALOG (attribute name), and TABLE_CATA (column name). TABLE SCHEMA attribute The schema of the table for this partition. : This attribute is a key attribute. The type is String. 12 MySQL agent Reference

23 The following names are defined for this attribute: TABLE_SCHEMA or TABLE_SCHE (historical name), TABLE SCHEMA (caption), TABLE_SCHEMA (attribute name), and TABLE_SCHE (column name). TABLE NAME attribute The table name for this partition. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: TABLE_NAME (historical name), TABLE NAME (caption), TABLE_NAME (attribute name), and TABLE_NAME (column name). PARTITION NAME attribute The name of this partition. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PARTITION_NAME or PARTITION_ (historical name), PARTITION NAME (caption), PARTITION_NAME (attribute name), and PARTITION_ (column name). SUBPARTITION NAME attribute The subpartition name if this partition is a subpartition. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: SUBPARTITION_NAME or SUBPARTITI (historical name), SUBPARTITION NAME (caption), SUBPARTITION_NAME (attribute name), and SUBPARTITI (column name). PARTITION ORDINAL POSITION attribute The current position in the ordering of partitions for this partition's table. : This attribute is a key attribute. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: PARTITION_ORDINAL_POSITION or PARTITION0 (historical name), PARTITION ORDINAL POSITION (caption), PARTITION_ORDINAL_POSITION (attribute name), and PARTITION0 (column name). SUBPARTITION ORDINAL POSITION attribute The current position in the ordering of subpartitions for this partition (if subpartitioned). : This attribute is a key attribute. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: SUBPARTITION_ORDINAL_POSITION or SUBPARTIT0 (historical name), SUBPARTITION ORDINAL POSITION (caption), SUBPARTITION_ORDINAL_POSITION (attribute name), and SUBPARTIT0 (column name). PARTITION METHOD attribute The type of partitioning enabled for this partition's table. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PARTITION_METHOD or PARTITION1 (historical name), PARTITION METHOD (caption), PARTITION_METHOD (attribute name), and PARTITION1 (column name). SUBPARTITION METHOD attribute The type of subpartitioning enabled for this partition. : This attribute is a key attribute. The type is String. Chapter 1. Attributes 13

24 The following names are defined for this attribute: SUBPARTITION_METHOD or SUBPARTIT1 (historical name), SUBPARTITION METHOD (caption), SUBPARTITION_METHOD (attribute name), and SUBPARTIT1 (column name). PARTITION EXPRESSION attribute The expression used to partition this partition's table. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PARTITION_EXPRESSION or PARTITION2 (historical name), PARTITION EXPRESSION (caption), PARTITION_EXPRESSION (attribute name), and PARTITION2 (column name). SUBPARTITION EXPRESSION attribute The expression used to subpartition this partition (if subpartitioned). : This attribute is a key attribute. The type is String. The following names are defined for this attribute: SUBPARTITION_EXPRESSION or SUBPARTIT2 (historical name), SUBPARTITION EXPRESSION (caption), SUBPARTITION_EXPRESSION (attribute name), and SUBPARTIT2 (column name). PARTITION DESCRIPTION attribute The description of partitioning for this partition's table. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PARTITION_DESCRIPTION or PARTITION3 (historical name), PARTITION DESCRIPTION (caption), PARTITION_DESCRIPTION (attribute name), and PARTITION3 (column name). TABLE ROWS attribute The number of table rows stored in this partition. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: TABLE_ROWS (historical name), TABLE ROWS (caption), TABLE_ROWS (attribute name), and TABLE_ROWS (column name). AVG ROW LENGTH attribute The average row length (in bytes) of the rows stored in this partition. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: AVG_ROW_LENGTH or AVG_ROW_LE (historical name), AVG ROW LENGTH (caption), AVG_ROW_LENGTH (attribute name), and AVG_ROW_LE (column name). DATA LENGTH attribute The total amount of row data (in bytes) stored in this partition. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: DATA_LENGTH or DATA_LENGT (historical name), DATA LENGTH (caption), DATA_LENGTH (attribute name), and DATA_LENGT (column name). 14 MySQL agent Reference

25 MAX DATA LENGTH attribute The maximum amount of data (in bytes) that can be stored in this partition. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: MAX_DATA_LENGTH or MAX_DATA_L (historical name), MAX DATA LENGTH (caption), MAX_DATA_LENGTH (attribute name), and MAX_DATA_L (column name). INDEX LENGTH attribute The length (in bytes) of the index file for this partition. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: INDEX_LENGTH or INDEX_LENG (historical name), INDEX LENGTH (caption), INDEX_LENGTH (attribute name), and INDEX_LENG (column name). DATA FREE attribute The size (in bytes) of allocated but unused storage for the partition. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: The following names are defined for this attribute: DATA_FREE (historical name), DATA FREE (caption), DATA_FREE (attribute name), and DATA_FREE (column name). CREATE TIME attribute The time this partition was created. The type is Timestamp. The following names are defined for this attribute: CREATE_TIME or CREATE_TIM (historical name), CREATE TIME (caption), CREATE_TIME (attribute name), and CREATE_TIM (column name). UPDATE TIME attribute The time this partition was last updated. The type is Timestamp. The following names are defined for this attribute: UPDATE_TIME or UPDATE_TIM (historical name), UPDATE TIME (caption), UPDATE_TIME (attribute name), and UPDATE_TIM (column name). CHECK TIME attribute The time this partition was most recently checked. The type is Timestamp. The following names are defined for this attribute: CHECK_TIME (historical name), CHECK TIME (caption), CHECK_TIME (attribute name), and CHECK_TIME (column name). CHECKSUM attribute The checksum for this partition. The type is Integer (64-bit gauge) with enumerated values. The following values are defined: Chapter 1. Attributes 15

26 The following names are defined for this attribute: CHECKSUM (historical name), CHECKSUM (caption), CHECKSUM (attribute name), and CHECKSUM (column name). PARTITION COMMENT attribute The user comment for this partition. The type is String. The following names are defined for this attribute: PARTITION_COMMENT or PARTITION4 (historical name), PARTITION COMMENT (caption), PARTITION_COMMENT (attribute name), and PARTITION4 (column name). NODEGROUP attribute The nodegroup for this partition. The type is String. The following names are defined for this attribute: NODEGROUP (historical name), NODEGROUP (caption), NODEGROUP (attribute name), and NODEGROUP (column name). TABLESPACE NAME attribute The name of the tablespace for this partition. The type is String. The following names are defined for this attribute: TABLESPACE_NAME or TABLESPACE (historical name), TABLESPACE NAME (caption), TABLESPACE_NAME (attribute name), and TABLESPACE (column name). 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: 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). Query Name attribute The name of the data set. : 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). 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 Type attribute The type of the performance object. The type is Integer with enumerated values. The following values are defined: v WMI (0) 16 MySQL agent Reference

27 v PERFMON (1) v WMI ASSOCIATION GROUP (2) v JMX (3) v SNMP (4) v SHELL COMMAND (5) v JOINED GROUPS (6) v CIMOM (7) v CUSTOM (8) v ROLLUP DATA (9) v WMI REMOTE DATA (10) v LOG FILE (11) v JDBC (12) v CONFIG DISCOVERY (13) v NT EVENT LOG (14) v FILTER (15) v SNMP EVENT (16) v PING (17) v DIRECTOR DATA (18) v DIRECTOR EVENT (19) v SSH REMOTE SHELL COMMAND (20) 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). Object Status attribute The status of the performance object. The type is Integer with enumerated values. The following values are defined: v ACTIVE (0) v INACTIVE (1) 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). Error Code attribute The error code that is associated with the query. The type is Integer with enumerated values. The following values are defined: v NO ERROR (0) v GENERAL ERROR (1) v OBJECT NOT FOUND (2) v COUNTER NOT FOUND (3) v NAMESPACE ERROR (4) v OBJECT CURRENTLY UNAVAILABLE (5) v COM LIBRARY INIT FAILURE (6) v SECURITY INIT FAILURE (7) v PROXY SECURITY FAILURE (9) v NO INSTANCES RETURNED (10) v ASSOCIATOR QUERY FAILED (11) Chapter 1. Attributes 17

28 v REFERENCE QUERY FAILED (12) v NO RESPONSE RECEIVED (13) v CANNOT FIND JOINED QUERY (14) v CANNOT FIND JOIN ATTRIBUTE IN QUERY 1 RESULTS (15) v CANNOT FIND JOIN ATTRIBUTE IN QUERY 2 RESULTS (16) v QUERY 1 NOT A SINGLETON (17) v QUERY 2 NOT A SINGLETON (18) v NO INSTANCES RETURNED IN QUERY 1 (19) v NO INSTANCES RETURNED IN QUERY 2 (20) v CANNOT FIND ROLLUP QUERY (21) v CANNOT FIND ROLLUP ATTRIBUTE (22) v FILE OFFLINE (23) v NO HOSTNAME (24) v MISSING LIBRARY (25) v ATTRIBUTE COUNT MISMATCH (26) v ATTRIBUTE NAME MISMATCH (27) v COMMON DATA PROVIDER NOT STARTED (28) v CALLBACK REGISTRATION ERROR (29) v MDL LOAD ERROR (30) v AUTHENTICATION FAILED (31) v CANNOT RESOLVE HOST NAME (32) v SUBNODE UNAVAILABLE (33) v SUBNODE NOT FOUND IN CONFIG (34) v ATTRIBUTE ERROR (35) v CLASSPATH ERROR (36) v CONNECTION FAILURE (37) v FILTER SYNTAX ERROR (38) v FILE NAME MISSING (39) v SQL QUERY ERROR (40) v SQL FILTER QUERY ERROR (41) v SQL DB QUERY ERROR (42) v SQL DB FILTER QUERY ERROR (43) v PORT OPEN FAILED (44) v ACCESS DENIED (45) v TIMEOUT (46) v NOT IMPLEMENTED (47) v REQUESTED A BAD VALUE (48) v RESPONSE TOO BIG (49) v GENERAL RESPONSE ERROR (50) v SCRIPT NONZERO RETURN (51) v SCRIPT NOT FOUND (52) v SCRIPT LAUNCH ERROR (53) v CONF FILE DOES NOT EXIST (54) v CONF FILE ACCESS DENIED (55) v INVALID CONF FILE (56) 18 MySQL agent Reference

29 v EIF INITIALIZATION FAILED (57) v CANNOT OPEN FORMAT FILE (58) v FORMAT FILE SYNTAX ERROR (59) v REMOTE HOST UNAVAILABLE (60) v EVENT LOG DOES NOT EXIST (61) v PING FILE DOES NOT EXIST (62) v NO PING DEVICE FILES (63) v PING DEVICE LIST FILE MISSING (64) v SNMP MISSING PASSWORD (65) v DISABLED (66) v URLS FILE NOT FOUND (67) v XML PARSE ERROR (68) v NOT INITIALIZED (69) v ICMP SOCKETS FAILED (70) v DUPLICATE CONF FILE (71) 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). 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: v NOT COLLECTED ( ) v NOT COLLECTED ( ) 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). 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: v NOT COLLECTED ( ) v NOT COLLECTED ( ) 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 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). 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: Chapter 1. Attributes 19

30 v NO DATA (-100) 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). 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). Number of Collections attribute The number of times this group has been collected since agent start. 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). 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). 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). 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). PLUGINS data set Information regarding the MySQL server's plugins, from the table PLUGINS. 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. 20 MySQL agent Reference

31 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). PLUGIN NAME attribute The name of this plugin. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PLUGIN_NAME or PLUGIN_NAM (historical name), PLUGIN NAME (caption), PLUGIN_NAME (attribute name), and PLUGIN_NAM (column name). PLUGIN VERSION attribute The version of this plugin. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PLUGIN_VERSION or PLUGIN_VER (historical name), PLUGIN VERSION (caption), PLUGIN_VERSION (attribute name), and PLUGIN_VER (column name). PLUGIN STATUS attribute The status of this plugin. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PLUGIN_STATUS or PLUGIN_STA (historical name), PLUGIN STATUS (caption), PLUGIN_STATUS (attribute name), and PLUGIN_STA (column name). PLUGIN TYPE attribute The type of this plugin. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PLUGIN_TYPE or PLUGIN_TYP (historical name), PLUGIN TYPE (caption), PLUGIN_TYPE (attribute name), and PLUGIN_TYP (column name). PLUGIN TYPE VERSION attribute The version of this plugin's type. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PLUGIN_TYPE_VERSION or PLUGIN_TY0 (historical name), PLUGIN TYPE VERSION (caption), PLUGIN_TYPE_VERSION (attribute name), and PLUGIN_TY0 (column name). PLUGIN LIBRARY attribute The shared object which supplies this plugin. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PLUGIN_LIBRARY or PLUGIN_LIB (historical name), PLUGIN LIBRARY (caption), PLUGIN_LIBRARY (attribute name), and PLUGIN_LIB (column name). PLUGIN LIBRARY VERSION attribute The version of the shared object which supplies this plugin. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PLUGIN_LIBRARY_VERSION or PLUGIN_LI0 (historical name), PLUGIN LIBRARY VERSION (caption), PLUGIN_LIBRARY_VERSION (attribute name), and PLUGIN_LI0 (column name). PLUGIN AUTHOR attribute The author of this plugin. : This attribute is a key attribute. The type is String. The following names are defined for this attribute: PLUGIN_AUTHOR or PLUGIN_AUT (historical name), PLUGIN AUTHOR (caption), PLUGIN_AUTHOR (attribute name), and PLUGIN_AUT (column name). Chapter 1. Attributes 21