指标定义
MySQL 模块的标签模型、衍生指标字典与原始指标族。
MYSQL 模块的指标来自 mysqld_exporter（原始指标，mysql_ 前缀）与 vmalert 衍生规则（mysql:ins:* / mysql:cls:*）。Dashboard 与告警优先建立在衍生指标之上，本页是衍生指标的完整字典。
公共标签
所有指标携带 job=mysql 与身份标签 cls / ins / ip / topology（取值 standalone 或 innodb_cluster）。实例级衍生指标保留全部身份标签，集群级指标聚合到 cls + topology。
可用性
| 指标 | 含义 |
|---|---|
mysql:ins:exporter_up | Exporter 抓取是否成功（传输层健康） |
mysql:ins:up | MySQL 连接探测是否成功（数据库健康） |
mysql:ins:uptime | 实例运行时长（秒） |
mysql:cls:instances | 集群声明实例数 |
mysql:cls:up | 集群在线实例数 |
mysql:cls:health | 集群健康度：2 健康 / 1 降级可写 / 0 危险 |
mysql:cls:health 对 HA 集群综合仲裁、单主与全员在线状态；对单机取 2 × mysql:cls:up。
工作负载
| 指标 | 含义 |
|---|---|
mysql:ins:qps | 每秒问询数（Questions） |
mysql:ins:tps | 每秒事务数（Commit + Rollback） |
mysql:ins:read_qps / mysql:ins:write_qps | 读类 / 写类命令速率 |
mysql:ins:row_ops | InnoDB 行操作速率（读/插/改/删分维度） |
mysql:ins:statement_rate | 性能模式语句执行速率 |
mysql:ins:statement_latency | 语句平均时延（秒） |
mysql:ins:rows_examined_per_query | 平均每查询扫描行数 |
mysql:ins:statement_errors | 语句错误率 |
mysql:ins:slow_queries / mysql:ins:slow_query_ratio | 慢查询速率与占比 |
mysql:ins:no_index_queries | 未走索引查询速率 |
连接与会话
| 指标 | 含义 |
|---|---|
mysql:ins:connections | 当前连接数（Threads_connected） |
mysql:ins:connection_usage | 连接数 / max_connections 使用率 |
mysql:ins:connection_rate | 新建连接速率 |
mysql:ins:threads_running / mysql:ins:threads_cached | 活跃 / 缓存线程数 |
mysql:ins:aborted_connects / mysql:ins:aborted_clients | 失败握手 / 异常断开速率 |
mysql:ins:connection_errors | 连接错误总速率 |
mysql:ins:rx_bytes / mysql:ins:tx_bytes | 网络收 / 发字节率 |
临时表、扫描与缓存
| 指标 | 含义 |
|---|---|
mysql:ins:tmp_tables / mysql:ins:tmp_disk_tables | 内存 / 磁盘临时表创建速率 |
mysql:ins:tmp_disk_ratio | 磁盘临时表占比 |
mysql:ins:full_joins / mysql:ins:full_scans | 无索引连接 / 全表扫描速率 |
mysql:ins:sort_merge_passes | 排序归并趟数（sort_buffer 不足信号） |
mysql:ins:table_open_cache_hit_ratio | 表缓存命中率 |
mysql:ins:open_files_usage | 打开文件数使用率 |
InnoDB
| 指标 | 含义 |
|---|---|
mysql:ins:buffer_pool_hit_ratio | 缓冲池命中率 |
mysql:ins:buffer_pool_usage / mysql:ins:buffer_pool_dirty_ratio | 缓冲池使用率 / 脏页占比 |
mysql:ins:buffer_pool_waits | 缓冲池空闲页等待速率（内存压力信号） |
mysql:ins:data_read_bytes / mysql:ins:data_write_bytes | 数据文件读 / 写字节率 |
mysql:ins:data_reads / mysql:ins:data_writes / mysql:ins:data_fsyncs | 数据文件 IO 与 fsync 速率 |
mysql:ins:redo_bytes | Redo 写入字节率 |
mysql:ins:redo_utilization | Redo 容量使用率（检查点落后度） |
mysql:ins:log_waits | Redo 缓冲等待速率 |
mysql:ins:row_lock_waits / mysql:ins:row_lock_time | 行锁等待速率 / 耗时 |
mysql:ins:deadlocks | 死锁速率 |
mysql:ins:history_list_length | Purge 滞后（历史链表长度） |
mysql:ins:binlog_bytes | Binlog 当前磁盘占用总量（字节） |
Group Replication
实例级成员状态（取值为 1 或缺失——不满足条件时序列不存在，告警据此用 unless 判断）：
| 指标 | 含义 |
|---|---|
mysql:ins:gr_member | 本实例处于任意 MGR 成员状态 |
mysql:ins:gr_online | 本实例 ONLINE |
mysql:ins:gr_primary / mysql:ins:gr_secondary | 本实例为 ONLINE 主库 / 从库 |
集群级仲裁与拓扑：
| 指标 | 含义 |
|---|---|
mysql:cls:gr_online_members | ONLINE 成员数 |
mysql:cls:gr_primary_members | ONLINE 主库数 |
mysql:cls:gr_quorum | 是否保有多数派（0/1） |
mysql:cls:gr_single_primary | 是否恰好单主（0/1） |
复制管道（认证与应用）：
| 指标 | 含义 |
|---|---|
mysql:ins:gr_certifier_queue / mysql:ins:gr_applier_queue | 认证 / 应用队列积压事务数 |
mysql:ins:gr_certifier_queue_ratio / mysql:ins:gr_applier_queue_ratio | 队列积压相对流控阈值的占比 |
mysql:ins:gr_checked_rate / mysql:ins:gr_applied_rate | 事务认证 / 应用速率 |
mysql:ins:gr_conflict_rate | 认证冲突速率（多写冲突信号，单主下应为 0） |
原始指标族
衍生指标未覆盖的细节可直接查询 Exporter 原始指标，常用族：
| 前缀 | 内容 |
|---|---|
mysql_up / up | 数据库连接探测 / 抓取状态 |
mysql_global_status_* | SHOW GLOBAL STATUS 全量计数器 |
mysql_global_variables_* | 关键系统变量（如 max_connections） |
mysql_perf_schema_events_statements_* | 语句摘要（按 digest Top 50） |
mysql_perf_schema_table_io_waits_* / ..._index_io_waits_* | 表 / 索引 IO 等待 |
mysql_perf_schema_replication_group_member_info | MGR 成员状态（member_state / member_role 维度） |
mysql_perf_schema_transactions_* / mysql_perf_schema_conflicts_detected_total | MGR 认证队列、应用队列与冲突统计 |
mysql_binlog_* | Binlog 文件数与尺寸 |
mysql_info_schema_processlist_* | 会话按状态分布 |
在 VictoriaMetrics 的 vmui（/select/vmui）中以 mysql_ 前缀浏览即可获得完整清单。