编辑“︁Graphite”︁

'''石墨烯（Graphite）'''是一个开源的分布式时间序列数据库，专为监控系统设计，能够高效地存储和检索数值型时间序列数据。它最初由[[Chris Davis]]于2006年开发，现已成为监控领域广泛使用的基础设施组件之一。

== 概述 ==
Graphite 由三个主要组件构成：
* '''Carbon''' - 守护进程，负责接收时间序列数据
* '''Whisper''' - 固定大小的时间序列数据库格式
* '''Graphite Web''' - 基于[[Django]]的Web界面，用于数据可视化和查询

== 主要特性 ==
* '''高性能写入''': 支持每秒数十万数据点的写入
* '''灵活的数据保留策略''': 可配置不同时间分辨率的数据保留时长
* '''丰富的函数库''': 提供多种数据处理和聚合函数
* '''可扩展架构''': 支持水平扩展处理更大规模数据
* '''与多种监控工具集成''': 如[[Grafana]]、[[Prometheus]]等

== 架构 ==
Graphite 采用分层架构设计：

<mermaid>
graph TD
    A[客户端] --> B[Carbon]
    B --> C[Whisper DB]
    C --> D[Graphite Web]
    D --> E[用户]
</mermaid>

== 数据模型 ==
Graphite 使用点分隔的指标路径来组织数据，例如：
```
servers.webserver01.cpu.loadavg.1min
environments.production.webservers.cpu.utilization
```

== 安装与配置 ==
=== 使用Docker安装 ===
<syntaxhighlight lang="bash">
docker run -d \
  --name graphite \
  -p 80:80 \
  -p 2003-2004:2003-2004 \
  -p 2023-2024:2023-2024 \
  -p 8125:8125/udp \
  -p 8126:8126 \
  graphiteapp/graphite-statsd
</syntaxhighlight>

=== 基本配置 ===
Carbon配置文件示例（/opt/graphite/conf/carbon.conf）：
<syntaxhighlight lang="ini">
[cache]
STORAGE_DIR = /opt/graphite/storage
LOCAL_DATA_DIR = /opt/graphite/storage/whisper
</syntaxhighlight>

== 数据写入 ==
Graphite 支持多种协议写入数据：
=== 纯文本协议 ===
<syntaxhighlight lang="bash">
echo "test.metric 42 $(date +%s)" | nc -q0 graphite.server 2003
</syntaxhighlight>

=== Python客户端示例 ===
<syntaxhighlight lang="python">
from graphite_api.client import Client

client = Client('graphite.server')
client.send('test.metric', 42)
</syntaxhighlight>

== 数据查询 ==
Graphite 提供功能强大的查询语言：
=== 基本查询 ===
```
http://graphite.server/render?target=servers.*.cpu.loadavg.1min&format=json
```

=== 使用聚合函数 ===
```
http://graphite.server/render?target=sumSeries(servers.*.cpu.loadavg.1min)&from=-24h
```

== 与Grafana集成 ==
Graphite 是[[Grafana]]支持的核心数据源之一。在Grafana中添加Graphite数据源：
1. 进入Grafana配置界面
2. 选择"Add data source"
3. 选择Graphite类型
4. 配置Graphite服务器URL
5. 保存并测试连接

== 实际应用案例 ==
* '''基础设施监控''': 收集服务器CPU、内存、磁盘等指标
* '''应用性能监控''': 跟踪应用响应时间、错误率等
* '''业务指标监控''': 监控用户活跃度、交易量等业务指标

== 性能优化 ==
* 使用'''carbon-c-relay'''替代原生Carbon提高转发性能
* 配置合理的存储策略，平衡数据精度和存储成本
* 使用'''grafana-carbonapi'''作为查询缓存层

== 替代方案 ==
* [[Prometheus]]
* [[InfluxDB]]
* [[TimescaleDB]]

== 参见 ==
* [[时间序列数据库]]
* [[监控系统]]
* [[数据可视化]]

[[Category:时间序列数据库]]
[[Category:监控系统]]
[[Category:开源软件]]