What's new from Grafana Labsbreadcrumb arrow Grafana database metrics deprecation
What's new from Grafana Labs
What's new from Grafana Labs
Open source Enterprise Generally Available
Release date: 2026-04-14

Grafana database metrics deprecation

The following Prometheus metrics are now deprecated in Grafana v13, and will be removed in a future release:

  • go_sql_stats_connections_max_open
  • go_sql_stats_connections_open
  • go_sql_stats_connections_in_use
  • go_sql_stats_connections_idle
  • go_sql_stats_connections_waited_for
  • go_sql_stats_connections_blocked_seconds
  • go_sql_stats_connections_closed_max_idle
  • go_sql_stats_connections_closed_max_lifetime
  • go_sql_stats_connections_closed_max_idle_time
  • grafana_database_conn_max_open
  • grafana_database_conn_open
  • grafana_database_conn_in_use
  • grafana_database_conn_idle
  • grafana_database_conn_wait_count_total
  • grafana_database_conn_wait_duration_seconds
  • grafana_database_conn_max_idle_closed_total
  • grafana_database_conn_max_idle_closed_seconds
  • grafana_database_conn_max_lifetime_closed_total

They are replaced by the following metrics, which provide the exact same data:

  • go_sql_max_open_connections
  • go_sql_open_connections
  • go_sql_in_use_connections
  • go_sql_idle_connections
  • go_sql_wait_count_total
  • go_sql_wait_duration_seconds_total
  • go_sql_max_idle_closed_total
  • go_sql_max_idle_time_closed_total
  • go_sql_max_lifetime_closed_total

Mitigation

If you were using the grafana_database_conn_* metrics, use the following mapping to replace them:

  • grafana_database_conn_max_open => go_sql_max_open_connections
  • grafana_database_conn_open => go_sql_open_connections
  • grafana_database_conn_in_use => go_sql_in_use_connections
  • grafana_database_conn_idle => go_sql_idle_connections
  • grafana_database_conn_wait_count_total => go_sql_wait_count_total
  • grafana_database_conn_wait_duration_seconds => go_sql_wait_duration_seconds_total
  • grafana_database_conn_max_idle_closed_total => go_sql_max_idle_closed_total
  • grafana_database_conn_max_idle_closed_seconds => go_sql_max_idle_time_closed_total
  • grafana_database_conn_max_lifetime_closed_total => go_sql_max_lifetime_closed_total

If you were using the go_sql_stats_connections_* metrics, use the following mapping to replace them:

  • go_sql_stats_connections_max_open => go_sql_max_open_connections
  • go_sql_stats_connections_open => go_sql_open_connections
  • go_sql_stats_connections_in_use => go_sql_in_use_connections
  • go_sql_stats_connections_idle => go_sql_idle_connections
  • go_sql_stats_connections_waited_for => go_sql_wait_count_total
  • go_sql_stats_connections_blocked_seconds => go_sql_wait_duration_seconds_total
  • go_sql_stats_connections_closed_max_idle => go_sql_max_idle_closed_total
  • go_sql_stats_connections_closed_max_lifetime => go_sql_max_idle_time_closed_total
  • go_sql_stats_connections_closed_max_idle_time => go_sql_max_lifetime_closed_total