跳到主要内容
版本:1.2

GreptimeDB 文档

GreptimeDB 是一个开源可观测性数据库,用一个引擎存储指标、日志和链路追踪。它可以作为唯一的 OpenTelemetry 后端,替代 Prometheus、Loki 和 Elasticsearch,数据放在对象存储上,用 SQLPromQL 查询。

  • 立即开始

    安装 GreptimeDB,写入第一批数据,执行第一个查询。

  • 用户指南

    写入协议、查询、Pipeline、Flow,以及生产环境的部署与运维。

  • For AI Agents

    从 coding agent 使用 GreptimeDB,不需要自建集成。

  • 参考手册

    SQL 语法、函数和数据类型。

向 AI 提问

安装、写入、查询、配置——基于本站文档作答。

为什么选择 GreptimeDB

用一个系统替代三个。 指标、日志和链路追踪写进同一个列式引擎,原生支持 OpenTelemetry,不用再为每种信号分别维护存储、查询语言和运维体系。

成本按对象存储计价。 S3、Azure Blob、GCS 是主存储,计算独立扩展。列式存储加上针对可观测性负载调优的压缩,成本最高可降 50 倍——OceanBase Cloud 在 GreptimeDB 上存放 300 TB 日志和审计数据,公开的数据显示从 Loki 迁移后存储成本下降 60%+。

采集器和仪表盘不用换。 写入侧支持 Prometheus remote writeOTLP,查询侧支持 PromQLJaeger 接口,两者各有独立的 HTTP 端点;SQL 则通过 MySQLPostgreSQL 线协议访问,Grafana 仪表盘可以继续使用。各协议的覆盖范围和限制见协议

给 agent 一个统一的查询接口。Agent RCA Bench 中,6 个模型分别在 GreptimeDB 和 Prometheus + Loki + Tempo 上排查同样的 14 个故障:错误诊断少 40%,读取的输入 token 少 48%,整体成本低约 45%。

详见为什么选择 GreptimeDBObservability 2.0 与宽事件

与 AI agent 集成

入门指南以可直接抓取的 Markdown 文件托管,coding agent 在运行时读取即可,无需安装。

  • MCP Server —— agent 可调用的查询工具:SQL、TQL 和范围查询,默认只读;此外还能管理 Pipeline 和仪表盘,这部分会写入。
  • Skills —— 覆盖 Pipeline、Flow、Trigger、表设计和性能诊断,遵循 Agent Skills 标准。
  • 语义层 —— greptime.semantic.* 表元数据,记录每张表的信号类型、写入来源和单位。
  • llms.txt —— 全站的结构化索引;在任意文档 URL 后加 .md 可取得该页的原始 Markdown。

继续了解

  • 教程:端到端的完整示例,例如监控一个 Kubernetes 集群。
  • GreptimeDB 企业版:读副本、负载隔离、RBAC、审计日志和容灾方案。
  • 贡献者指南:面向参与 GreptimeDB 开发的读者,介绍内部实现。
  • Roadmap:项目的发展方向。
  • 发布说明:所有历史版本的发布说明。
  • FAQ:部署、写入和查询中的常见问题。