ProNotes

Ниже — минимальный «must have» набор метрик для Galera/MariaDB через mysqld_exporter, чтобы дашборды типа Galera Cluster Perf/Workload Overview были реально полезными. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)

## 1. Галерные wsrep-метрики (кластер и репликация)

Следи за всеми wsrep_* из global status, основные:

- `mysql_global_status_wsrep_cluster_status` – статус кластера (Primary/Non-Primary). [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- `mysql_global_status_wsrep_cluster_size` – размер кластера (кол-во нод). [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- `mysql_global_status_wsrep_local_state` и `mysql_global_status_wsrep_local_state_comment` – состояние ноды (Synced, Donor, Joined). [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- `mysql_global_status_wsrep_ready` – готова ли нода обслуживать запросы. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- `mysql_global_status_wsrep_connected` – есть ли связь с кластером. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- `mysql_global_status_wsrep_flow_control_paused` – доля времени в flow control (узкое место). [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- `mysql_global_status_wsrep_flow_control_sent`, `mysql_global_status_wsrep_flow_control_recv` – сколько раз включался FC. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- `mysql_global_status_wsrep_replicated`, `mysql_global_status_wsrep_received` – реплицированные/полученные write-sets (через rate() — TPS по репликации). [docs.percona](https://docs.percona.com/percona-monitoring-and-management/3/reference/dashboards/dashboard-pxc-galera-node-summary.html)
- `mysql_global_status_wsrep_replicated_bytes`, `mysql_global_status_wsrep_received_bytes` – трафик Galera (через rate() — сеть между нодами). [docs.percona](https://docs.percona.com/percona-monitoring-and-management/3/reference/dashboards/dashboard-pxc-galera-node-summary.html)
- `mysql_global_status_wsrep_cert_deps_distance` – «глубина» параллелизма репликации. [docs.percona](https://docs.percona.com/percona-monitoring-and-management/3/reference/dashboards/dashboard-pxc-galera-node-summary.html)
- `mysql_global_status_wsrep_local_recv_queue`, `mysql_global_status_wsrep_local_send_queue` – длина очередей, симптом лагов. [docs.percona](https://docs.percona.com/percona-monitoring-and-management/3/reference/dashboards/dashboard-pxc-galera-node-summary.html)

## 2. Общие метрики MariaDB/MySQL

База без этого — слепая, даже при живой репликации. [github](https://github.com/prometheus/mysqld_exporter/)

- QPS/команды: `mysql_global_status_queries`, `mysql_global_status_questions`, `mysql_global_status_commands_*` (через rate()). [github](https://github.com/prometheus/mysqld_exporter/)
- Соединения: `mysql_global_status_threads_connected`, `mysql_global_status_threads_running`. [github](https://github.com/prometheus/mysqld_exporter/)
- Ошибки/блокировки: `mysql_global_status_innodb_row_lock_time`, `mysql_global_status_innodb_row_lock_waits`, `mysql_global_status_table_locks_waited`. [github](https://github.com/prometheus/mysqld_exporter/)
- Логи: `mysql_global_status_slow_queries`, `mysql_global_status_connections`, `mysql_global_status_aborted_clients`, `mysql_global_status_aborted_connects`. [github](https://github.com/prometheus/mysqld_exporter/)

## 3. InnoDB / буфер, диск, I/O

Для понимания, упрётся ли кластер в диск или RAM. [docs.percona](https://docs.percona.com/percona-monitoring-and-management/3/reference/dashboards/dashboard-pxc-galera-node-summary.html)

- Буфер-пул: `mysql_global_status_innodb_buffer_pool_reads`, `mysql_global_status_innodb_buffer_pool_read_requests` (hit ratio), `mysql_global_status_innodb_buffer_pool_pages_dirty`. [github](https://github.com/prometheus/mysqld_exporter/)
- I/O: `mysql_global_status_innodb_data_reads`, `mysql_global_status_innodb_data_writes`, `mysql_global_status_innodb_log_writes` (все через rate()). [github](https://github.com/prometheus/mysqld_exporter/)
- Флаш/чекпоинт: `mysql_global_status_innodb_checkpoint_age`, `mysql_global_status_innodb_checkpoint_max_age`. [docs.percona](https://docs.percona.com/percona-monitoring-and-management/3/reference/dashboards/dashboard-pxc-galera-node-summary.html)

## 4. Хостовые метрики (не из mysqld_exporter, а node_exporter)

Очень желательно добавить node_exporter для корреляции с железом. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)

- CPU load: `node_load1`, `node_load5`, `node_load15`. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- Память: `node_memory_MemAvailable_bytes`, `node_memory_MemFree_bytes`. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- Диск: `node_disk_read_bytes_total`, `node_disk_written_bytes_total`, latency метрики, `node_filesystem_avail_bytes`. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)
- Сеть: `node_network_receive_bytes_total`, `node_network_transmit_bytes_total`. [galeracluster](https://galeracluster.com/documentation/html_docs_20210213-1355-master/documentation/galera-manager-monitoring-clusters.html)

## 5. Как это привязать к дашбордам Galera

Готовые Galera Cluster Perf/Workload Overview и PXC/Galera-доки используют именно wsrep_* как ключевые индикаторы здоровья кластера плюс стандартный набор InnoDB/общих метрик. [grafana](https://grafana.com/grafana/dashboards/14619-galera-workload-overview/)
mysqld_exporter уже умеет вытаскивать wsrep и стандартные статусы, главное — не резать их в `--collect.*` и проверить, что endpoint `/metrics` содержит `mysql_global_status_wsrep_*`. [dev](https://dev.to/alighaemia/how-to-set-up-mariadbmysql-exporter-on-galera-cluster-nodes-for-prometheus-monitoring-4b3l)

Если хочешь, могу набросать готовые PromQL-выражения для панелей «здоровье кластера» (status, size, FC), «репликация» (received/replicated, очереди) и «нагрузка» (QPS, InnoDB I/O).