qryn

module
v4.2.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 8, 2026 License: AGPL-3.0

README ยถ

Gigapipe: All-In-One Polyglot Observability

formerly known as qryn

ย 

CodeQL GitHub Repo stars

๐Ÿš€ Gigapipe is a lighweight, multi-standard, polyglot observability stack for Logs, Metrics, Traces and Profiling

  • Polyglot: All-in-one, drop-in compatible with Loki, Prometheus, Tempo, Pyroscope
  • 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 GigAPI with S3 object storage
  • Independent: Open source, community powered, anti lock-in alternative to vendor controlled stacks

๐Ÿš€ Get Started

Features

๐Ÿ’ก gigapipe independently implements popular observability standards, protocols and query languages

โžก๏ธ Ingestion

๐Ÿ“š OpenTelemetry

โšก gigapipe is officially integrated with OpenTelemetry supports any log, trace or metric format
Ingested data can be queried using any of the available gigapipe APIs (LogQL, PromQL, TraceQL)

๐Ÿ’ก No modifications required to your OpenTelemetry instrumentation!

๐Ÿ“š Native APIs

gigapipe supports native ingestion for Loki, Prometheus, Tempo/Zipkin, Pyroscope and many other protocols
With gigapipe integrators can push and read data using any desired combination of APIs and formats

๐Ÿ’ก No opentelemetry or any other middlewayre/proxy required!


โฌ…๏ธ Query

๐Ÿ“š Loki + LogQL

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

โšก gigapipe 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

Index Stats & Enhanced Tail

Index statistics: Query stream metadata using /loki/api/v1/index/stats to retrieve stream count, entry count, byte volume, and chunk count. Supports LogQL stream selectors for filtering:

GET /loki/api/v1/index/stats?query={job="app"}&start=<ns>&end=<ns>

Enhanced live-tail: The Tail service now supports limit and start query parameters for controlling tail behavior. The limit parameter caps the number of entries returned, and start sets the starting timestamp (in nanoseconds). WebSocket responses include a dropped_entries field indicating when entries were dropped due to backpressure:

{
  "streams": [...],
  "dropped_entries": []
}

๐Ÿ“ˆ Prometheus + PromQL

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

โšก gigapipe 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

โšก gigapipe implements the Tempo API for transparent compatibility with TraceQL clients.

Any Tempo/OpenTelemetry compatible client or application can be used with gigapipe 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

TraceQL Metrics

gigapipe supports TraceQL metrics endpoints for calculating metrics from trace data. Calculate error rates, latency distributions, and throughput directly from traces using TraceQL queries.

Metrics endpoints:

  • /api/metrics/query_range - range queries over a time window
  • /api/metrics/query - instant queries at a specific time

Parameters:

  • q or query - TraceQL query string (required)
  • start - start timestamp (unix seconds, nanoseconds, or RFC3339)
  • end - end timestamp (same format as start)
  • since - relative time duration (e.g., "1h", "30m") - alternative to start/end
  • step - query resolution (e.g., "15s", "1m") - auto-calculated if not specified

Example:

GET /api/metrics/query_range?q={span.http.status_code=200}&since=1h&step=1m

This query calculates span counts for successful HTTP requests over the last hour with 1-minute resolution.


๐Ÿ”ฅ Pyroscope + Phlare

โšก gigapipe implements the Pyroscope API for transparent compatibility with Pyroscope SDK clients.

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

DOT Graph Rendering

The Render endpoint (/render?format=dot) generates Graphviz DOT format graphs for profiling visualization with enhanced readability:

Features:

  • maxNodes parameter: Limit the number of nodes displayed in DOT graphs (0 = unlimited). Use this to control graph complexity for large profiles.
    GET /render?query=...&from=...&until=...&format=dot&maxNodes=50
    
  • Human-readable values: Automatically formats values based on unit type (e.g., "1.23s" for durations, "1.23 MB" for memory)
  • Variable font sizes: Node font size scales from 8pt to 24pt based on self-sample percentage, creating visual hierarchy where hotter code paths are more prominent


๐Ÿ‘ Built-In Explorer

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


๐Ÿ“š Vendors Compatibility

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


With gigapipe 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 gigapipe blog


Got Questions?

Ask DeepWiki

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

ย ย ย ย 

License

ยฉ๏ธ HEPVEST BV, All Rights Reserves. Released under the GNU Affero General Public License v3.0

[^1]: Gigapipe is a 100% clear-room api implementation and does not fork, use or derivate from Grafana code or design concepts.[^1]

[^2]: Gigapipe is not affiliated or endorsed by Grafana Labs or ClickHouse Inc. All rights belong to their respective owners.[^2]

[^3]: Grafanaยฎ, Lokiโ„ข and Tempoยฎ are a Trademark of Raintank, Grafana Labs. ClickHouseยฎ is a trademark of ClickHouse Inc.[^3]

[^4]: Prometheus is a trademark of The Linux Foundation.[^4]

Directories ยถ

Path Synopsis
cmd
gigapipe command
shared
pattern/clustering
Code generated by re2go 4.1 on Wed Jun 25 12:35:44 2025, DO NOT EDIT.
Code generated by re2go 4.1 on Wed Jun 25 12:35:44 2025, DO NOT EDIT.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL