proxysql/doc/tsdb/embedded_tsdb_quickstart.md

TSDB Quickstart Guide

1. Enable TSDB

SET tsdb-enabled=1;
LOAD TSDB VARIABLES TO RUNTIME;
SAVE TSDB VARIABLES TO DISK;

Optional backend probe collection:

SET tsdb-monitor_enabled=1;
LOAD TSDB VARIABLES TO RUNTIME;
SAVE TSDB VARIABLES TO DISK;

2. Verify Status

SHOW TSDB STATUS;

3. Verify Tables

SELECT name
FROM stats_history.sqlite_master
WHERE type='table' AND name LIKE 'tsdb_%';

4. Query Raw Samples

SELECT datetime(timestamp,'unixepoch') AS ts, metric_name, labels, value
FROM stats_history.tsdb_metrics
WHERE timestamp > unixepoch() - 300
ORDER BY timestamp DESC
LIMIT 50;

5. Query Hourly Rollups

SELECT datetime(bucket,'unixepoch') AS hour, metric_name, avg_value, max_value, min_value, count
FROM stats_history.tsdb_metrics_hour
WHERE bucket > unixepoch() - 86400
ORDER BY bucket;

6. Query Backend Probe Health

SELECT datetime(timestamp,'unixepoch') AS ts, hostgroup, hostname, port, probe_up, connect_ms
FROM stats_history.tsdb_backend_health
WHERE timestamp > unixepoch() - 3600
ORDER BY timestamp DESC;

Notes

• TSDB settings are global variables prefixed with tsdb-.