qryn 开源项目教程

qryn 开源项目教程

qryn All-in-one Polyglot Observability stack with ClickHouse storage. Lightweight & Drop-in API compatible with Loki, Prometheus, Tempo, Opentelemetry, Elastic, InfluxDB and more! wasm powered ⭐️ Star to support ⭐️ 项目地址: https://gitcode.com/gh_mirrors/qr/qryn

1. 项目介绍

qryn 是一个轻量级、多标准的多元观测性堆栈，专为日志、指标、追踪和分析而设计。它是一个开源项目，旨在提供一个统一的观测性解决方案，兼容多种流行的观测性标准和协议，如 Loki、Prometheus、Tempo、Pyroscope 和 Opentelemetry。qryn 的核心优势在于其轻量级的设计和强大的兼容性，使其成为 Grafana Cloud 的理想替代品。

2. 项目快速启动

2.1 安装 qryn

首先，确保你已经安装了 Node.js 和 Bun。然后，通过以下命令克隆 qryn 仓库并安装依赖：

git clone https://github.com/metrico/qryn.git
cd qryn
bun install

2.2 启动 qryn

安装完成后，使用以下命令启动 qryn：

bun run qryn

2.3 配置 Grafana

为了在 Grafana 中使用 qryn，你需要配置 Grafana 的数据源。打开 Grafana 的配置文件 grafana.ini，添加以下配置：

[datasources]
[datasources.qryn]
type = loki
url = http://localhost:3100
access = proxy
isDefault = true

重启 Grafana 后，你就可以在 Grafana 中使用 qryn 进行日志、指标和追踪的查询了。

3. 应用案例和最佳实践

3.1 日志管理

qryn 可以与 Loki 兼容，因此你可以使用 LogQL 查询语言来查询和管理日志。例如，以下查询可以检索特定时间范围内的所有错误日志：

{job="my-service"} |= "error"

3.2 指标监控

qryn 支持 Prometheus 的 PromQL 查询语言，可以用于监控系统的各种指标。例如，以下查询可以检索 CPU 使用率：

rate(node_cpu_seconds_total{mode="system"}[5m])

3.3 追踪分析

qryn 支持 Tempo 的 TraceQL 查询语言，可以用于分析分布式系统的追踪数据。例如，以下查询可以检索特定服务的所有追踪：

service.name = "my-service"

4. 典型生态项目

4.1 Grafana

Grafana 是一个开源的监控和可视化平台，qryn 可以作为其数据源，提供日志、指标和追踪的可视化。

4.2 Prometheus

Prometheus 是一个开源的监控和报警工具，qryn 可以作为其数据源，提供指标的存储和查询。

4.3 Loki

Loki 是一个开源的日志聚合系统，qryn 可以作为其替代品，提供日志的存储和查询。

4.4 Tempo

Tempo 是一个开源的分布式追踪系统，qryn 可以作为其替代品，提供追踪数据的存储和查询。

通过以上模块的介绍和实践，你可以快速上手并深入了解 qryn 开源项目，并将其应用于实际的观测性需求中。

qryn All-in-one Polyglot Observability stack with ClickHouse storage. Lightweight & Drop-in API compatible with Loki, Prometheus, Tempo, Opentelemetry, Elastic, InfluxDB and more! wasm powered ⭐️ Star to support ⭐️ 项目地址: https://gitcode.com/gh_mirrors/qr/qryn