跳转至

MySQL


·


MySQL 指标采集,收集以下数据:

  • MySQL Global Status 基础数据采集
  • Schema 相关数据
  • InnoDB 相关指标
  • 支持自定义查询数据采集

配置

前置条件

  • MySQL 版本 5.7+
  • 创建监控账号(一般情况,需用 MySQL root 账号登陆才能创建 MySQL 用户)
CREATE USER 'datakit'@'localhost' IDENTIFIED BY '<UNIQUEPASSWORD>';

-- MySQL 8.0+ create the datakit user with the caching_sha2_password method
CREATE USER 'datakit'@'localhost' IDENTIFIED WITH caching_sha2_password by '<UNIQUEPASSWORD>';
  • 授权
GRANT PROCESS ON *.* TO 'datakit'@'localhost';
GRANT SELECT ON *.* TO 'datakit'@'localhost';
show databases like 'performance_schema';
GRANT SELECT ON performance_schema.* TO 'datakit'@'localhost';
GRANT SELECT ON mysql.user TO 'datakit'@'localhost';
GRANT replication client on *.*  to 'datakit'@'localhost';
Attention
  • 如用 localhost 时发现采集器有如下报错,需要将上述步骤的 localhost 换成 ::1
    Error 1045: Access denied for user 'datakit'@'localhost' (using password: YES)

  • 以上创建、授权操作,均限定了 datakit 这个用户,只能在 MySQL 主机上(localhost)访问 MySQL。如果需要对 MySQL 进行远程采集,建议将 localhost 替换成 %(表示 DataKit 可以在任意机器上访问 MySQL),也可用特定的 DataKit 安装机器地址。

采集器配置

进入 DataKit 安装目录下的 conf.d/db 目录,复制 mysql.conf.sample 并命名为 mysql.conf。示例如下:

[[inputs.mysql]]
  host = "localhost"
  user = "datakit"
  pass = "<PASS>"
  port = 3306
  # sock = "<SOCK>"
  # charset = "utf8"

  ## @param connect_timeout - number - optional - default: 10s
  # connect_timeout = "10s"

  ## Deprecated
  # service = "<SERVICE>"

  interval = "10s"

  ## @param inno_db
  innodb = true

  ## table_schema
  tables = []

  ## user
  users = []

  ## Set dbm to true to collect database activity 
  # dbm = false

  ## Set true to enable election
  election = true

  [inputs.mysql.log]
    # #required, glob logfiles
    # files = ["/var/log/mysql/*.log"]

    ## glob filteer
    # ignore = [""]

    ## optional encodings:
    ## "utf-8", "utf-16le", "utf-16le", "gbk", "gb18030" or ""
    # character_encoding = ""

    ## The pattern should be a regexp. Note the use of '''this regexp'''
    ## regexp link: https://golang.org/pkg/regexp/syntax/#hdr-Syntax
    multiline_match = '''^(# Time|\d{4}-\d{2}-\d{2}|\d{6}\s+\d{2}:\d{2}:\d{2}).*'''

    ## grok pipeline script path
    pipeline = "mysql.p"

  ## Run a custom SQL query and collect corresponding metrics.
  # [[inputs.mysql.custom_queries]]
  #   sql = '''
  #     select ENGINE as engine,TABLE_SCHEMA as table_schema,count(*) as table_count 
  #     from information_schema.tables 
  #     group by engine,table_schema
  #   '''
  #   metric = "mysql_custom"
  #   tags = ["engine", "table_schema"]
  #   fields = ["table_count"] 

  ## Config dbm metric 
  [inputs.mysql.dbm_metric]
    enabled = true

  ## Config dbm sample 
  [inputs.mysql.dbm_sample]
    enabled = true  

  ## Config dbm activity
  [inputs.mysql.dbm_activity]
    enabled = true  

  ## TLS Config
  [inputs.mysql.tls]
    # tls_ca = "/etc/mysql/ca.pem"
    # tls_cert = "/etc/mysql/cert.pem"
    # tls_key = "/etc/mysql/key.pem"
    ## Use TLS but skip chain & host verification
    insecure_skip_verify = true

  [inputs.mysql.tags]
    # some_tag = "some_value"
    # more_tag = "some_other_value"

配置好后,重启 DataKit 即可。

目前可以通过 ConfigMap 方式注入采集器配置来开启采集器。


Binlog 开启

默认情况下,MySQL Binlog 是不开启的。如果要统计 Binlog 大小,需要开启 MySQL 对应 Binlog 功能:

-- ON: 开启/OFF: 关闭
SHOW VARIABLES LIKE 'log_bin';

Binlog 开启,参见这个问答,或者这个问答

数据库性能指标采集

数据库性能指标主要来源于 MySQL 的内置数据库 performance_schema, 该数据库提供了一个能够在运行时获取服务器内部执行情况的方法。通过该数据库,DataKit 能够采集历史查询语句的各种指标统计和查询语句的执行计划,以及其他相关性能指标。采集的性能指标数据保存为日志,source 分别为 mysql_dbm_metric, mysql_dbm_samplemysql_dbm_activity

如需开启,需要执行以下步骤。

  • 修改配置文件,开启监控采集
[[inputs.mysql]]

# 开启数据库性能指标采集
dbm = true

...

# 监控指标配置
[inputs.mysql.dbm_metric]
  enabled = true

# 监控采样配置
[inputs.mysql.dbm_sample]
  enabled = true

# 等待事件采集
[inputs.mysql.dbm_activity]
  enabled = true   
...
  • MySQL 配置

修改配置文件(如 mysql.conf),开启 MySQL Performance Schema, 并配置相关参数:

[mysqld]
performance_schema = on
max_digest_length = 4096
performance_schema_max_digest_length = 4096
performance_schema_max_sql_text_length = 4096
performance-schema-consumer-events-statements-current = on
performance-schema-consumer-events-waits-current = on
performance-schema-consumer-events-statements-history-long = on
performance-schema-consumer-events-statements-history = on
  • 账号配置

账号授权

-- MySQL 5.6 & 5.7
GRANT REPLICATION CLIENT ON *.* TO datakit@'%' WITH MAX_USER_CONNECTIONS 5;
GRANT PROCESS ON *.* TO datakit@'%';

-- MySQL >= 8.0
ALTER USER datakit@'%' WITH MAX_USER_CONNECTIONS 5;
GRANT REPLICATION CLIENT ON *.* TO datakit@'%';
GRANT PROCESS ON *.* TO datakit@'%';

创建数据库

CREATE SCHEMA IF NOT EXISTS datakit;
GRANT EXECUTE ON datakit.* to datakit@'%';
GRANT CREATE TEMPORARY TABLES ON datakit.* TO datakit@'%';

创建存储过程 explain_statement,用于获取 SQL 执行计划

DELIMITER $$
CREATE PROCEDURE datakit.explain_statement(IN query TEXT)
    SQL SECURITY DEFINER
BEGIN
    SET @explain := CONCAT('EXPLAIN FORMAT=json ', query);
    PREPARE stmt FROM @explain;
    EXECUTE stmt;
    DEALLOCATE PREPARE stmt;
END $$
DELIMITER ;

为需要采集执行计划的数据库单独创建存储过程(可选)

DELIMITER $$
CREATE PROCEDURE <数据库名称>.explain_statement(IN query TEXT)
    SQL SECURITY DEFINER
BEGIN
    SET @explain := CONCAT('EXPLAIN FORMAT=json ', query);
    PREPARE stmt FROM @explain;
    EXECUTE stmt;
    DEALLOCATE PREPARE stmt;
END $$
DELIMITER ;
GRANT EXECUTE ON PROCEDURE <数据库名称>.explain_statement TO datakit@'%';
  • consumers 配置

方法一(推荐):通过 DataKit 动态配置 performance_schema.events_*,需要创建以下存储过程:

DELIMITER $$
CREATE PROCEDURE datakit.enable_events_statements_consumers()
    SQL SECURITY DEFINER
BEGIN
    UPDATE performance_schema.setup_consumers SET enabled='YES' WHERE name LIKE 'events_statements_%';
    UPDATE performance_schema.setup_consumers SET enabled='YES' WHERE name = 'events_waits_current';
END $$
DELIMITER ;

GRANT EXECUTE ON PROCEDURE datakit.enable_events_statements_consumers TO datakit@'%';

方法二:手动配置 consumers

UPDATE performance_schema.setup_consumers SET enabled='YES' WHERE name LIKE 'events_statements_%';
UPDATE performance_schema.setup_consumers SET enabled='YES' WHERE name = 'events_waits_current';

指标

以下所有数据采集,默认会追加名为 host 的全局 tag(tag 值为 DataKit 所在主机名),也可以在配置中通过 [inputs.mysql.tags] 指定其它标签:

 [inputs.mysql.tags]
  # some_tag = "some_value"
  # more_tag = "some_other_value"
  # ...

mysql

  • 标签
Tag Description
host The server host address
server Server addr
  • 字段列表
Metric Description Type Unit
Aborted_clients The number of connections that were aborted because the client died without closing the connection properly. int count
Aborted_connects The number of failed attempts to connect to the MySQL server. int count
Binlog_cache_disk_use The number of transactions that used the temporary binary log cache but that exceeded the value of binlog_cache_size and used a temporary file to store statements from the transaction. int B
Binlog_cache_use The number of transactions that used the binary log cache. int B
Binlog_space_usage_bytes Total binary log file size. int B
Bytes_received The number of bytes received from all clients. int B
Bytes_sent The number of bytes sent to all clients. int B
Com_commit The number of times of commit statement has been executed. int count
Com_delete The number of times of delete statement has been executed. int count
Com_delete_multi The number of times of delete-multi statement has been executed. int count
Com_insert The number of times of insert statement has been executed. int count
Com_insert_select The number of times of insert-select statement has been executed. int count
Com_load The number of times of load statement has been executed. int count
Com_replace The number of times of replace statement has been executed. int count
Com_replace_select The number of times of replace-select statement has been executed. int count
Com_rollback The number of times of rollback statement has been executed. int count
Com_select The number of times of select statement has been executed. int count
Com_update The number of times of update statement has been executed. int count
Com_update_multi The number of times of update-mult has been executed. int count
Connections The rate of connections to the server. int count
Created_tmp_disk_tables The rate of internal on-disk temporary tables created by second by the server while executing statements. int count
Created_tmp_files The rate of temporary files created by second. int count
Created_tmp_tables The rate of internal temporary tables created by second by the server while executing statements. int count
Handler_commit The number of internal COMMIT statements. int count
Handler_delete The number of internal DELETE statements. int count
Handler_prepare The number of internal PREPARE statements. int count
Handler_read_first The number of internal READ_FIRST statements. int count
Handler_read_key The number of internal READ_KEY statements. int count
Handler_read_next The number of internal READ_NEXT statements. int count
Handler_read_prev The number of internal READ_PREV statements. int count
Handler_read_rnd The number of internal READ_RND statements. int count
Handler_read_rnd_next The number of internal READ_RND_NEXT statements. int count
Handler_rollback The number of internal ROLLBACK statements. int count
Handler_update The number of internal UPDATE statements. int count
Handler_write The number of internal WRITE statements. int count
Key_buffer_bytes_unflushed MyISAM key buffer bytes unflushed. int count
Key_buffer_bytes_used MyISAM key buffer bytes used. int count
Key_buffer_size Size of the buffer used for index blocks. int B
Key_cache_utilization The key cache utilization ratio. int percent
Key_read_requests The number of requests to read a key block from the MyISAM key cache. int count
Key_reads The number of physical reads of a key block from disk into the MyISAM key cache. If Key_reads is large, then your key_buffer_size value is probably too small. The cache miss rate can be calculated as Key_reads/Key_read_requests. int count
Key_write_requests The number of requests to write a key block to the MyISAM key cache. int count
Key_writes The number of physical writes of a key block from the MyISAM key cache to disk. int count
Max_used_connections The maximum number of connections that have been in use simultaneously since the server started. int count
Open_files The number of open files. int count
Open_tables The number of of tables that are open. int count
Opened_tables The number of tables that have been opened. If Opened_tables is big, your table_open_cache value is probably too small. int count
Qcache_free_blocks The number of free memory blocks in the query cache. int B
Qcache_free_memory The amount of free memory for the query cache. int B
Qcache_hits The rate of query cache hits. int count
Qcache_inserts The number of queries added to the query cache. int count
Qcache_lowmem_prunes The number of queries that were deleted from the query cache because of low memory. int count
Qcache_not_cached The number of noncached queries (not cacheable, or not cached due to the query_cache_type setting). int count
Qcache_queries_in_cache The number of queries registered in the query cache. int count
Qcache_total_blocks The total number of blocks in the query cache. int count
Queries The rate of queries. int count
Questions The rate of statements executed by the server. int count
Select_full_join The number of joins that perform table scans because they do not use indexes. If this value is not 0, you should carefully check the indexes of your tables. int count
Select_full_range_join The number of joins that used a range search on a reference table. int count
Select_range The number of joins that used ranges on the first table. This is normally not a critical issue even if the value is quite large. int count
Select_range_check The number of joins without keys that check for key usage after each row. If this is not 0, you should carefully check the indexes of your tables. int count
Select_scan The number of joins that did a full scan of the first table. int count
Slow_queries The rate of slow queries. int count
Sort_merge_passes The number of merge passes that the sort algorithm has had to do. If this value is large, you should consider increasing the value of the sort_buffer_size system variable. int count
Sort_range The number of sorts that were done using ranges. int count
Sort_rows The number of sorted rows. int count
Sort_scan The number of sorts that were done by scanning the table. int count
Table_locks_immediate The number of times that a request for a table lock could be granted immediately. int count
Table_locks_waited The total number of times that a request for a table lock could not be granted immediately and a wait was needed. int count
Threads_cached The number of threads in the thread cache. int count
Threads_connected The number of currently open connections. int count
Threads_created The number of threads created to handle connections. If Threads_created is big, you may want to increase the thread_cache_size value. int count
Threads_running The number of threads that are not sleeping. int count
max_connections The maximum number of connections that have been in use simultaneously since the server started. int count
query_cache_size The amount of memory allocated for caching query results. int B
table_open_cache The number of open tables for all threads. Increasing this value increases the number of file descriptors that mysqld requires. int count
thread_cache_size How many threads the server should cache for reuse. When a client disconnects, the client's threads are put in the cache if there are fewer than thread_cache_size threads there. int B

mysql_schema

MySQL schema information

  • 标签
Tag Description
host The server host address
schema_name Schema name
server Server addr
  • 字段列表
Metric Description Type Unit
query_run_time_avg Avg query response time per schema. float ns
schema_size Size of schemas(MiB) float MB

mysql_innodb

  • 标签
Tag Description
host The server host address
server Server addr
  • 字段列表
Metric Description Type Unit
active_transactions The number of active transactions on InnoDB tables int count
adaptive_hash_searches Number of successful searches using Adaptive Hash Index int count
adaptive_hash_searches_btree Number of searches using B-tree on an index search int count
buffer_data_reads Amount of data read in bytes (innodb_data_reads) int count
buffer_data_written Amount of data written in bytes (innodb_data_written) int count
buffer_pages_created Number of pages created (innodb_pages_created) int count
buffer_pages_read Number of pages read (innodb_pages_read) int count
buffer_pages_written Number of pages written (innodb_pages_written) int count
buffer_pool_bytes_data The total number of bytes in the InnoDB buffer pool containing data. The number includes both dirty and clean pages. int B
buffer_pool_bytes_dirty Buffer bytes containing data (innodb_buffer_pool_bytes_data) int count
buffer_pool_pages_data Buffer pages containing data (innodb_buffer_pool_pages_data) int count
buffer_pool_pages_dirty Buffer pages currently dirty (innodb_buffer_pool_pages_dirty) int count
buffer_pool_pages_flushed The number of requests to flush pages from the InnoDB buffer pool int count
buffer_pool_pages_free Buffer pages currently free (innodb_buffer_pool_pages_free) int count
buffer_pool_pages_misc Buffer pages for misc use such as row locks or the adaptive hash index (innodb_buffer_pool_pages_misc) int count
buffer_pool_pages_total Total buffer pool size in pages (innodb_buffer_pool_pages_total) int count
buffer_pool_read_ahead Number of pages read as read ahead (innodb_buffer_pool_read_ahead) int count
buffer_pool_read_ahead_evicted Read-ahead pages evicted without being accessed (innodb_buffer_pool_read_ahead_evicted) int count
buffer_pool_read_ahead_rnd The number of random read-aheads initiated by InnoDB. This happens when a query scans a large portion of a table but in random order. int count
buffer_pool_read_requests Number of logical read requests (innodb_buffer_pool_read_requests) int count
buffer_pool_reads Number of reads directly from disk (innodb_buffer_pool_reads) int count
buffer_pool_size Server buffer pool size (all buffer pools) in bytes int count
buffer_pool_wait_free Number of times waited for free buffer (innodb_buffer_pool_wait_free) int count
buffer_pool_write_requests Number of write requests (innodb_buffer_pool_write_requests) int count
checkpoint_age Checkpoint age as shown in the LOG section of the SHOW ENGINE INNODB STATUS output int count
current_transactions Current InnoDB transactions int count
data_fsyncs The number of fsync() operations per second. int count
data_pending_fsyncs The current number of pending fsync() operations. int count
data_pending_reads The current number of pending reads. int count
data_pending_writes The current number of pending writes. int count
data_read The amount of data read per second. int B
data_written The amount of data written per second. int B
dblwr_pages_written The number of pages written per second to the doublewrite buffer. int count
dblwr_writes The number of doublewrite operations performed per second. int B
dml_deletes Number of rows deleted int count
dml_inserts Number of rows inserted int count
dml_updates Number of rows updated int count
file_num_open_files Number of files currently open (innodb_num_open_files) int count
hash_index_cells_total Total number of cells of the adaptive hash index int count
hash_index_cells_used Number of used cells of the adaptive hash index int count
history_list_length History list length as shown in the TRANSACTIONS section of the SHOW ENGINE INNODB STATUS output. int count
ibuf_free_list Insert buffer free list, as shown in the INSERT BUFFER AND ADAPTIVE HASH INDEX section of the SHOW ENGINE INNODB STATUS output. int count
ibuf_merged Insert buffer and adaptative hash index merged int count
ibuf_merged_delete_marks Insert buffer and adaptative hash index merged delete marks int count
ibuf_merged_deletes Insert buffer and adaptative hash index merged delete int count
ibuf_merged_inserts Insert buffer and adaptative hash index merged inserts int count
ibuf_merges Number of change buffer merges int count
ibuf_merges_delete Number of purge records merged by change buffering int count
ibuf_merges_delete_mark Number of deleted records merged by change buffering int count
ibuf_merges_discard_delete Number of purge merged operations discarded int count
ibuf_merges_discard_delete_mark Number of deleted merged operations discarded int count
ibuf_merges_discard_insert Number of insert merged operations discarded int count
ibuf_merges_insert Number of inserted records merged by change buffering int count
ibuf_size Change buffer size in pages int count
innodb_activity_count Current server activity count int count
innodb_dblwr_pages_written Number of pages that have been written for doublewrite operations (innodb_dblwr_pages_written) int count
innodb_dblwr_writes Number of doublewrite operations that have been performed (innodb_dblwr_writes) int count
innodb_page_size InnoDB page size in bytes (innodb_page_size) int count
innodb_rwlock_s_os_waits Number of OS waits due to shared latch request int count
innodb_rwlock_s_spin_rounds Number of rwlock spin loop rounds due to shared latch request int count
innodb_rwlock_s_spin_waits Number of rwlock spin waits due to shared latch request int count
innodb_rwlock_sx_os_waits Number of OS waits due to sx latch request int count
innodb_rwlock_sx_spin_rounds Number of rwlock spin loop rounds due to sx latch request int count
innodb_rwlock_sx_spin_waits Number of rwlock spin waits due to sx latch request int count
innodb_rwlock_x_os_waits Number of OS waits due to exclusive latch request int count
innodb_rwlock_x_spin_rounds Number of rwlock spin loop rounds due to exclusive latch request int count
innodb_rwlock_x_spin_waits Number of rwlock spin waits due to exclusive latch request int count
lock_deadlocks Number of deadlocks int count
lock_row_lock_current_waits Number of row locks currently being waited for (innodb_row_lock_current_waits) int count
lock_row_lock_time Time spent in acquiring row locks, in milliseconds (innodb_row_lock_time) int ms
lock_row_lock_time_avg The average time to acquire a row lock, in milliseconds (innodb_row_lock_time_avg) int ms
lock_row_lock_time_max The maximum time to acquire a row lock, in milliseconds (innodb_row_lock_time_max) int ms
lock_row_lock_waits Number of times a row lock had to be waited for (innodb_row_lock_waits) int count
lock_structs Lock structs int count
lock_timeouts Number of lock timeouts int count
locked_tables Locked tables int count
locked_transactions Locked transactions int count
log_padded Bytes of log padded for log write ahead int count
log_waits Number of log waits due to small log buffer (innodb_log_waits) int count
log_write_requests Number of log write requests (innodb_log_write_requests) int count
log_writes Number of log writes (innodb_log_writes) int count
lsn_current Log sequence number as shown in the LOG section of the SHOW ENGINE INNODB STATUS output. int count
lsn_flushed Flushed up to log sequence number as shown in the LOG section of the SHOW ENGINE INNODB STATUS output. int count
lsn_last_checkpoint Log sequence number last checkpoint as shown in the LOG section of the SHOW ENGINE INNODB STATUS output. int count
mem_adaptive_hash As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int B
mem_additional_pool As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int B
mem_dictionary As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int B
mem_file_system As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int B
mem_lock_system As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int count
mem_page_hash As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int count
mem_recovery_system As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int count
mem_thread_hash As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int count
mem_total As shown in the BUFFER POOL AND MEMORY section of the SHOW ENGINE INNODB STATUS output. int count
os_data_fsyncs Number of fsync() calls (innodb_data_fsyncs) int count
os_data_reads Number of reads initiated (innodb_data_reads) int count
os_data_writes Number of writes initiated (innodb_data_writes) int count
os_file_fsyncs (Delta) The total number of fsync() operations performed by InnoDB. int count
os_file_reads (Delta) The total number of files reads performed by read threads within InnoDB. int count
os_file_writes (Delta) The total number of file writes performed by write threads within InnoDB. int count
os_log_bytes_written Bytes of log written (innodb_os_log_written) int count
os_log_fsyncs Number of fsync log writes (innodb_os_log_fsyncs) int count
os_log_pending_fsyncs Number of pending fsync write (innodb_os_log_pending_fsyncs) int count
os_log_pending_writes Number of pending log file writes (innodb_os_log_pending_writes) int count
os_log_written Number of bytes written to the InnoDB log. int B
pages_created Number of InnoDB pages created. int count
pages_read Number of InnoDB pages read. int count
pages_written Number of InnoDB pages written. int count
pending_aio_log_ios As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
pending_aio_sync_ios As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
pending_buffer_pool_flushes As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
pending_checkpoint_writes As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
pending_ibuf_aio_reads As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
pending_log_flushes As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
pending_log_writes As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
pending_normal_aio_reads As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
pending_normal_aio_writes As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
queries_inside As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
queries_queued As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
read_views As shown in the FILE I/O section of the SHOW ENGINE INNODB STATUS output. int count
rows_deleted Number of rows deleted from InnoDB tables. int count
rows_inserted Number of rows inserted into InnoDB tables. int count
rows_read Number of rows read from InnoDB tables. int count
rows_updated Number of rows updated in InnoDB tables. int count
s_lock_os_waits As shown in the SEMAPHORES section of the SHOW ENGINE INNODB STATUS output int count
s_lock_spin_rounds As shown in the SEMAPHORES section of the SHOW ENGINE INNODB STATUS output. int count
s_lock_spin_waits As shown in the SEMAPHORES section of the SHOW ENGINE INNODB STATUS output. int count
semaphore_wait_time Semaphore wait time int count
semaphore_waits The number semaphore currently being waited for by operations on InnoDB tables. int count
tables_in_use Tables in use int count
trx_rseg_history_len Length of the TRX_RSEG_HISTORY list int count
x_lock_os_waits As shown in the SEMAPHORES section of the SHOW ENGINE INNODB STATUS output. int count
x_lock_spin_rounds As shown in the SEMAPHORES section of the SHOW ENGINE INNODB STATUS output. int count
x_lock_spin_waits As shown in the SEMAPHORES section of the SHOW ENGINE INNODB STATUS output. int count

mysql_table_schema

MySQL table information

  • 标签
Tag Description
engine The storage engine for the table. See The InnoDB Storage Engine, and Alternative Storage Engines.
host The server host address
server Server addr
table_name The name of the table.
table_schema The name of the schema (database) to which the table belongs.
table_type BASE TABLE for a table, VIEW for a view, or SYSTEM VIEW for an INFORMATION_SCHEMA table.
version The version number of the table's .frm file.
  • 字段列表
Metric Description Type Unit
data_free The number of rows. Some storage engines, such as MyISAM, store the exact count. For other storage engines, such as InnoDB, this value is an approximation, and may vary from the actual value by as much as 40% to 50%. In such cases, use SELECT COUNT(*) to obtain an accurate count. int count
data_length For InnoDB, DATA_LENGTH is the approximate amount of space allocated for the clustered index, in bytes. Specifically, it is the clustered index size, in pages, multiplied by the InnoDB page size int count
index_length For InnoDB, INDEX_LENGTH is the approximate amount of space allocated for non-clustered indexes, in bytes. Specifically, it is the sum of non-clustered index sizes, in pages, multiplied by the InnoDB page size int count
table_rows The number of rows. Some storage engines, such as MyISAM, store the exact count. For other storage engines, such as InnoDB, this value is an approximation, and may vary from the actual value by as much as 40% to 50%. In such cases, use SELECT COUNT(*) to obtain an accurate count. int count

mysql_user_status

MySQL user information

  • 标签
Tag Description
host The server host address
server The server address containing both host and port
user user
  • 字段列表
Metric Description Type Unit
bytes_received The number of bytes received this user int count
bytes_sent The number of bytes sent this user int count
current_connect The number of current connect int count
max_execution_time_exceeded The number of SELECT statements for which the execution timeout was exceeded. int count
max_execution_time_set The number of SELECT statements for which a nonzero execution timeout was set. This includes statements that include a nonzero MAX_EXECUTION_TIME optimizer hint, and statements that include no such hint but execute while the timeout indicated by the max_execution_time system variable is nonzero. int count
max_execution_time_set_failed The number of SELECT statements for which the attempt to set an execution timeout failed. int count
slow_queries The number of queries that have taken more than long_query_time seconds. This counter increments regardless of whether the slow query log is enabled int count
sort_rows The number of sorted rows. int count
sort_scan The number of sorts that were done by scanning the table. int count
table_open_cache_hits The number of hits for open tables cache lookups. int count
table_open_cache_misses The number of misses for open tables cache lookups. int count
table_open_cache_overflows The number of overflows for the open tables cache. This is the number of times, after a table is opened or closed, a cache instance has an unused entry and the size of the instance is larger than table_open_cache / table_open_cache_instances. int count
total_connect The number of total connect int count

日志

Version-1.4.6

mysql_dbm_metric

Record the number of executions of the query statement, wait time, lock time, and the number of rows queried.

  • 标签
Tag Description
digest The digest hash value computed from the original normalized statement.
host The server host address
query_signature The hash value computed from digest_text
schema_name The schema name
server The server address containing both host and port
service The service name and the value is 'mysql'
  • 字段列表
Metric Description Type Unit
count_star The total count of executed queries per normalized query and schema. int count
message The text of the normalized statement digest. string -
sum_errors The total count of queries run with an error per normalized query and schema. int count
sum_lock_time The total time(nanosecond) spent waiting on locks per normalized query and schema. int count
sum_no_good_index_used The total count of queries which used a sub-optimal index per normalized query and schema. int count
sum_no_index_used The total count of queries which do not use an index per normalized query and schema. int count
sum_rows_affected The number of rows mutated per normalized query and schema. int count
sum_rows_examined The number of rows examined per normalized query and schema. int count
sum_rows_sent The number of rows sent per normalized query and schema. int count
sum_select_full_join The total count of full table scans on a joined table per normalized query and schema. int count
sum_select_scan The total count of full table scans on the first table per normalized query and schema. int count
sum_timer_wait The total query execution time(nanosecond) per normalized query and schema. int count

mysql_dbm_sample

Select some of the SQL statements with high execution time, collect their execution plans, and collect various performance indicators during the actual execution process.

  • 标签
Tag Description
current_schema The name of the current schema.
digest The digest hash value computed from the original normalized statement.
digest_text The digest_text of the statement.
host The server host address
network_client_ip The ip address of the client
plan_definition The plan definition of JSON format.
plan_signature The hash value computed from plan definition.
processlist_db The name of the database.
processlist_user The user name of the client.
query_signature The hash value computed from digest_text.
query_truncated It indicates whether the query is truncated.
resource_hash The hash value computed from SQL text.
server The server address containing both host and port
service The service name and the value is 'mysql'
  • 字段列表
Metric Description Type Unit
duration Value in nanoseconds of the event's duration. float count
lock_time_ns Time in nanoseconds spent waiting for locks. int count
message The text of the normalized statement digest. string -
no_good_index_used 0 if a good index was found for the statement, 1 if no good index was found. int -
no_index_used 0 if the statement performed a table scan with an index, 1 if without an index. int -
rows_affected Number of rows the statement affected. int count
rows_examined Number of rows read during the statement's execution. int count
rows_sent Number of rows returned. int count
select_full_join Number of joins performed by the statement which did not use an index. int count
select_full_range_join Number of joins performed by the statement which used a range search of the int first table. int count
select_range Number of joins performed by the statement which used a range of the first table. int count
select_range_check Number of joins without keys performed by the statement that check for key usage after int each row. int count
select_scan Number of joins performed by the statement which used a full scan of the first table. int count
sort_merge_passes Number of merge passes by the sort algorithm performed by the statement. int count
sort_range Number of sorts performed by the statement which used a range. int count
sort_rows Number of rows sorted by the statement. int count
sort_scan Number of sorts performed by the statement which used a full table scan. int count
timer_wait_ns Value in nanoseconds of the event's duration float ns
timestamp The timestamp(millisecond) when then the event ends. float msec

mysql_dbm_activity

Collect the waiting event of the current thread

  • 标签
Tag Description
host The server host address
server The server address
service The service name and the value is 'mysql'
  • 字段列表
Metric Description Type Unit
connections The total number of the connection int count
current_schema The default database for the statement, NULL if there is none string -
end_event_id The thread current event number when the event ends string -
event_id The event id string -
event_name The name of the instrument that produced the event string -
event_source The name of the source file string -
event_timer_end The time when event timing ended int ns
event_timer_start The time when event timing started int ns
event_timer_wait The time the event has elapsed so far int ns
index_name The name of the index used string -
ip The client IP address string -
lock_time The time spent waiting for table locks int ns
message The text of the normalized SQL text string -
object_name The name of the object being acted on string -
object_schema The schema of th object being acted on string -
object_type The type of the object being acted on string -
port The TCP/IP port number, in the range from 0 to 65535 string -
processlist_command The command of the thread string -
processlist_db The default database for the thread, or NULL if none has been selected string -
processlist_host The host name of the client with a thread string -
processlist_id The process list ID string -
processlist_state The state of the thread string -
processlist_user The user associated with a thread string -
query_signature The hash value computed from SQL text string -
socket_event_name The name of the wait/io/socket/* instrument that produced the event string -
sql_text The statement the thread is executing string -
thread_id The thread ID string -
wait_event The name of the wait event string -
wait_timer_end The time when the waiting event timing ended int ns
wait_timer_start The time when the waiting event timing started int ns

MySQL 运行日志

如需采集 MySQL 的日志,将配置中 log 相关的配置打开,如需要开启 MySQL 慢查询日志,需要开启慢查询日志,在 MySQL 中执行以下语句

SET GLOBAL slow_query_log = 'ON';

-- 未使用索引的查询也认为是一个可能的慢查询
set global log_queries_not_using_indexes = 'ON';
[inputs.mysql.log]
    # 填入绝对路径
    files = ["/var/log/mysql/*.log"]

注意:在使用日志采集时,需要将 DataKit 安装在 MySQL 服务同一台主机中,或使用其它方式将日志挂载到 DataKit 所在机器

MySQL 日志分为普通日志和慢日志两种。

MySQL 普通日志

日志原文:

2017-12-29T12:33:33.095243Z         2 Query     SELECT TABLE_SCHEMA, TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE CREATE_OPTIONS LIKE '%partitioned%';

切割后的字段列表如下:

字段名 字段值 说明
status Warning 日志级别
msg System table 'plugin' is expected to be transactional. 日志内容
time 1514520249954078000 纳秒时间戳(作为行协议时间)

MySQL 慢查询日志

日志原文:

# Time: 2019-11-27T10:43:13.460744Z
# User@Host: root[root] @ localhost [1.2.3.4]  Id:    35
# Query_time: 0.214922  Lock_time: 0.000184 Rows_sent: 248832  Rows_examined: 72
# Thread_id: 55   Killed: 0  Errno: 0
# Bytes_sent: 123456   Bytes_received: 0
SET timestamp=1574851393;
SELECT * FROM fruit f1, fruit f2, fruit f3, fruit f4, fruit f5

切割后的字段列表如下:

字段名 字段值 说明
bytes_sent 123456 发送字节数
db_host localhost hostname
db_ip 1.2.3.4 IP
db_slow_statement SET timestamp=1574851393;\nSELECT * FROM fruit f1, fruit f2, fruit f3, fruit f4, fruit f5 慢查询 SQL
db_user root[root] 用户
lock_time 0.000184 锁时间
query_id 35 查询 ID
query_time 0.2l4922 SQL 执行所消耗的时间
rows_examined 72 为了返回查询的数据所读取的行数
rows_sent 248832 查询返回的行数
thread_id 55 线程 ID
time 1514520249954078000 纳秒时间戳(作为行协议时间)

FAQ

阿里云 RDS 采集时,指标 mysql_user_status 没有上报数据?

该指标需要开启 performance_schema,可以通过以下 SQL 查询:

show variables like "performance_schema";

+--------------------+-------+
| Variable_name      | Value |
+--------------------+-------+
| performance_schema | ON    |
+--------------------+-------+

如果值是 OFF,请参考阿里云相关 文档 进行开启。

文档评价

文档内容是否对您有帮助? ×