lomik/graphite-clickhouse

graphite-clickhouse

支持ClickHouse的Graphite集群后端

工作原理

灰色组件为可选或替代组件

快速入门

https://github.com/lomik/graphite-clickhouse-tldr

兼容性

• ✓ https://github.com/graphite-project/graphite-web
• ✓ https://github.com/graphite-project/graphite-web/tree/0.9.15
• ✓ https://github.com/graphite-project/graphite-web
• ✓ https://github.com/go-graphite/carbonapi
• ✓ https://github.com/go-graphite/carbonzipper（已弃用，当前已集成到carbonapi中）

构建

需Golang 1.13+

sh
# 构建二进制文件
git clone https://github.com/lomik/graphite-clickhouse.git
cd graphite-clickhouse
make

安装

1. 设置https://github.com/yandex/ClickHouse和https://github.com/lomik/carbon-clickhouse
2. 设置并配置graphite-clickhouse
3. 将graphite-clickhouse的host:port添加到graphite-web的http://graphite.readthedocs.io/en/latest/config-local-settings.html#cluster-configuration

配置

参见配置文档。

特殊头处理

服务会对部分HTTP头进行特殊处理

请求头

Grafana头：X-Dashboard-Id、X-Grafana-Org-Id和X-Panel-Id会被记录并传递给ClickHouse。

调试头（详见debugging.md）：

• X-Gch-Debug-External-Data - 当此头被设置为任意值，且[debug]中的directory、directory-perm和external-data-perm参数均已设置且有效时，服务会将外部数据表的转储保存到目录中用于调试输出。
• X-Gch-Debug-Output - 用于启用对format=carbonapi_v3_pb和format=json渲染输出的特殊处理的头。
• X-Gch-Debug-Protobuf - 启用protobuf和carbonapi_v3_pb的原始编组器以检查二进制数据完整性的头。

响应头

• X-Gch-Request-Id - 当前请求ID。

在同一主机运行旧版graphite-web 0.9.x

默认情况下，graphite-web不会连接到本地主机的CLUSTER_SERVER。解决方法：

python
class ForceLocal(str):
    def split(self, *args, **kwargs):
        return ["8.8.8.8", "8080"]

CLUSTER_SERVERS = [ForceLocal("127.0.0.1:9090")]