Polyglot Observability Stack with ClickHouse storage


Keywords
logs, opentelemetry, logql, promql, grafana, clickhouse, clickhouse-server, tempoql, tempo, tail, prometheus, apm, ebpf, lgtm, loki, metrics, monitoring, observability, pyroscope, timeseries, tracing, wasm
License
AGPL-3.0
Install
npm install qryn@3.2.20-beta.3

Documentation

CI+CD CodeQL GitHub Repo stars

 

🚀 lighweight, multi-standard, polyglot observability stack for Logs, Metrics, Traces and Profiling

... it's pronounced /ˈkwÉŠr..ÉŠÅ‹/ or just querying

  • Polyglot: All-in-one, Drop-in compatible with Loki, Prometheus, Tempo, Pyroscope
  • Lightweight: Powered by Bun - the fast, all-in-one JavaScript runtime + ClickHouse OLAP Engine
  • Familiar: Use stable & popular LogQL, PromQL, TempoQL languages to query and visualize data
  • Voracious: Ingest using Opentelemetry, Loki, Prometheus, Tempo, Influx, Datadog, Elastic + more
  • Versatile: Explore data with qryn's built-in Explorer and CLI or native Grafana datasource compatibility
  • Secure: Retain total control of data, using ClickHouse, DuckDB or InfluxDB IOx with S3 object storage
  • Indepentent: Opensource, Community powered, Anti lock-in alternative to Vendor controlled stacks

lgtm_vs_qryn


🚀 Get Started



Features

ðŸ’Ą qryn independently implements popular observability standards, protocols and query languages


👁ïļ Built-In Explorer

qryn ships with view - our zero dependency, lightweight data explorer for Logs, Metrics and Traces


➡ïļ Ingest

📚 OpenTelemetry

⚡ qryn is officially integrated with opentelemetry supports any log, trace or metric format
Ingested data can be queried using any of the avialable qryn APIs (LogQL, PromQL, TraceQL)

ðŸ’Ą No modifications required to your opentelemetry instrumentation!

📚 Native

qryn supports native ingestion for Loki, Prometheus, Tempo/Zipkin and many other protocols
With qryn users can push data using any combination of supported APIs and formats

ðŸ’Ą No opentelemetry or any other middlewayre/proxy required!


⮅ïļ Query

📚 Loki + LogQL

Any Loki compatible client or application can be used with qryn out of the box

⚡ qryn implements the Loki API for transparent compatibility with LogQL clients

The Grafana Loki datasource can be used to natively browse and query logs and display extracted timeseries

🎉 No plugins needed
👁ïļ No Grafana? No problem! Use View


📈 Prometheus + PromQL

Any Prometheus compatible client or application can be used with qryn out of the box

⚡ qryn implements the Prometheus API for transparent PromQL compatibility using WASM 🏆

The Grafana Prometheus datasource can be used to natively to query metrics and display timeseries

🎉 No plugins needed
👁ïļ No Grafana? No problem! Use View


🕛 Tempo + TraceQL

⚡ qryn implements the Tempo API for transparent compatibility with TraceQL clients.

Any Tempo/Opentelemetry compatible client or application can be used with qryn out of the box

The Tempo datasource can be used to natively query traces including TraceQL and supporting service graphs

🎉 No plugins needed
👁ïļ No Grafana? No problem! Use View


ðŸ”Ĩ Pyroscope + Phlare

⚡ qryn implements the Pyroscope/Phlare API for transparent compatibility with Pyroscope SDK clients.

Any Pyroscope SDK client or Pyroscope compatible agent can be used with qryn out of the box for continuous profiling



📚 Vendors Compatibility

qryn can ingest data using formats from Grafana, InfluxDB, DataDog, Elastic and other vendors.


With qryn and grafana everything just works right out of the box:

  • Native datasource support without any plugin or extension
  • Advanced Correlation between Logs, Metrics and Traces
  • Service Graphs and Service Status Panels, and all the cool features




📚 Follow our team behind the scenes on the qryn blog


Contributions

Whether it's code, documentation or grammar, we âĪïļ all contributions. Not sure where to get started?

  • Join our Matrix Channel, and ask us any questions.
  • Have a PR or idea? Request a session / code walkthrough with our team for guidance.

Contributors

    Contributors for @metrico/qryn

Stargazers repo roster for @metrico/qryn

Forkers repo roster for @metrico/qryn

License

ÂĐïļ QXIP BV, released under the GNU Affero General Public License v3.0. See LICENSE for details.