For the complete documentation index, see llms.txt. Markdown versions are available by appending .md to documentation URLs.

Querying

SigNoz Cloud - This page applies to SigNoz Cloud editions.
Self-Host - This page applies to self-hosted SigNoz editions.

Querying in SigNoz provides a unified interface for asking questions across all three telemetry signals — logs, traces, and metrics. Whether you prefer a visual builder, raw SQL, or Prometheus-style expressions, SigNoz supports all three approaches from a single UI.

Key capabilities

  • Visual Query Builder: Construct queries with point-and-click filters, aggregations, and groupings — no query language required. Autocomplete surfaces available attributes and operators as you type.
  • ClickHouse SQL: Drop into raw SQL for arbitrary analytics over the underlying ClickHouse tables. Available for metrics, logs, and traces.
  • PromQL: Write Prometheus-compatible queries for metric data. Useful when migrating from Prometheus or when existing PromQL expressions need to be reused.
  • Full-text search: Search log bodies and trace attributes with natural filter syntax.

Get started

  • Query Builder — Start building queries visually with autocomplete and expressions.
  • Search syntax — Learn the filter syntax used across Logs Explorer, Traces Explorer, and Alert rules.

Query your data

Reference

Troubleshooting

  • Troubleshooting guide — Diagnose and fix common query issues.
  • FAQs — Frequently asked questions about querying in SigNoz.

Is this page helpful

Last updated—May 18, 2026

Is this page helpful

On this page

Last updated—May 18, 2026