知识条目 / InfluxDB

InfluxDB 报 max-series-per-database 或基数爆炸如何处理?

高基数通常来自标签取值失控,先定位高基数 measurement 与标签,再调整模型与保留策略。

InfluxDB 的 series 由 measurement 与 tag 组合决定。把用户 ID、请求 ID 等高基数字段作为 tag 会迅速耗尽内存与索引。

处理步骤

  1. 确认基数上限检查 max-series-per-database 与当前 series 数量,确认是否触顶。
  2. 定位高基数来源使用 SHOW SERIES CARDINALITY 按 measurement 与 tag 统计,找出增长最快的维度。
  3. 修正数据模型把高基数字段改为 field 或写入日志系统,减少 tag 维度并统一标签命名。
  4. 清理与防护按保留策略删除过期数据,设置基数监控与写入校验,避免再次爆炸。

示例

SHOW SERIES CARDINALITY
SHOW SERIES CARDINALITY FROM "cpu"
SHOW TAG KEYS FROM "cpu"
SHOW RETENTION POLICIES ON "db_name"

调整 max-series-per-database 只是提高上限,不能解决高基数带来的内存与查询问题。

关键词

influxdb · cardinality · 基数 · series · max-series-per-database · 标签 · tag

官方文档

同库知识