Graphite项目中的标签系统详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00857/article/details/148488316

Graphite项目中的标签系统详解

什么是Graphite标签系统

Graphite从1.1.x版本开始引入了标签(tag)支持，这是一种比传统层级命名结构更灵活的数据标识方式。通过标签系统，每个时间序列数据可以通过名称和一组标签/值对来唯一标识。

标签系统的基本概念

标签格式规范

标签名称长度必须≥1，可以包含除;!^=和空格外的任何ASCII字符
标签值长度必须≥1，可以包含除;和空格外的任何ASCII字符，且首字符不能是~
虽然UTF-8字符可能有效，但不建议在指标名称或标签中使用非ASCII字符
指标名称会被索引到特殊的name标签下

标签的特殊处理

如果指标名称以~开头，这些字符会被移除
如果指标名称只包含~字符，则会被视为无效并可能被丢弃

如何使用标签系统

数据输入方式

要将带标签的数据输入Graphite，可以通过Carbon以特定格式传递：

my.series;tag1=value1;tag2=value2

Carbon会自动解码标签、规范化标签顺序，并在标签数据库中注册该系列。

查询带标签的数据

查询标签数据的基础是使用seriesByTag函数：

# 查找所有tag1=value1的系列
seriesByTag('tag1=value1')

返回的结果可以与其他Graphite函数一起使用：

# 查找所有tag1=value1的系列并按总数排序
seriesByTag('tag1=value1') | sortByTotal()

标签表达式语法

seriesByTag函数支持多种标签表达式格式：

tag=spec    标签值完全匹配spec
tag!=spec   标签值不完全匹配spec
tag=~value  标签值匹配正则表达式spec
tag!=~spec  标签值不匹配正则表达式spec

复杂查询示例：

# 查找名称匹配cpu.*且tag1不等于value1的所有系列
seriesByTag('name=~cpu\..*', 'tag1!=value1')

高级标签操作

分组操作

使用groupByTags函数可以基于标签对系列进行分组：

# 获取所有web服务器按数据中心分组的磁盘使用情况
seriesByTag('name=disk.used', 'server=~web.*') | groupByTags('sumSeries', 'datacenter')

别名格式化

使用aliasByTags函数可以格式化系列名称显示：

# 使用server和name标签格式化系列名称
seriesByTag('name=disk.used','datacenter=dc1') | aliasByTags('server', 'name')

标签数据库存储

Graphite将标签信息存储在单独的标签数据库(TagDB)中，支持多种后端：

本地数据库TagDB

默认使用Graphite的SQLite、MySQL或PostgreSQL数据库存储标签信息。

Redis TagDB

通过配置可改用Redis服务器存储标签信息，需要设置：

TAGDB='graphite.tags.redis.RedisTagDB'

并配置相关Redis连接参数。

HTTP(S) TagDB

可以将标签操作委托给外部服务器实现，需要设置：

TAGDB='graphite.tags.http.HttpTagDB'

并配置相关HTTP连接参数。

标签系统管理

添加系列到TagDB

通常由Carbon自动处理，也可以通过HTTP API手动添加：

curl -X POST "http://graphite/tags/tagSeries" \
  --data-urlencode 'path=disk.used;rack=a1;datacenter=dc1;server=web01'

探索标签

可以通过HTTP API获取标签列表、标签值和匹配系列：

# 获取所有标签列表
curl -s "http://graphite/tags?pretty=1"

# 获取特定标签的值
curl -s "http://graphite/tags/datacenter?pretty=1"

# 搜索匹配系列
curl -s "http://graphite/tags/findSeries?pretty=1&expr=datacenter=dc1"

自动补全支持

提供两个端点支持标签和值的自动补全：

# 标签自动补全
curl -s "http://graphite/tags/autoComplete/tags?pretty=1"

# 值自动补全
curl -s "http://graphite/tags/autoComplete/values?pretty=1&tag=rack"

删除系列

当从数据存储中删除系列时，也应从TagDB中删除：

curl -X POST "http://graphite/tags/delSeries" \
  --data-urlencode 'path=disk.used;datacenter=dc1;rack=a1;server=web01'