llms.txt
Compare with other sites' llms.txt files →# Uptrace
> Open-source observability platform built on OpenTelemetry for distributed tracing, metrics, and logs.
## Features
Uptrace features including distributed tracing, metrics monitoring, log management, alerting, and SSO.
- [Grouping similar spans and events together](https://uptrace.dev/raw/features/traces/grouping.md): Optimize grouping by choosing stable span names, leveraging display.name, and providing custom fingerprints when needed.
- [Querying spans](https://uptrace.dev/raw/features/traces/querying-spans.md): Master the Uptrace span query language including identifiers, filters, grouping, and aggregates for traces, logs, and events.
- [Querying traces](https://uptrace.dev/raw/features/traces/querying-traces.md): Query distributed traces by filtering spans, logs, and events across services, and enrich root results with cross-join expressions that aggregate child spans within the same trace.
- [Span query language reference](https://uptrace.dev/raw/features/traces/reference.md): Complete reference for the Uptrace span query language: built-in fields, data types, clauses, every aggregate and transform function, the JSON functions, and the search syntax.
- [Traces](https://uptrace.dev/raw/features/traces.md): Explore spans and traces in Uptrace using filters, aggregations, operation detail panels, and the full trace waterfall to find and diagnose errors.
- [Grouping rules](https://uptrace.dev/raw/features/logs/grouping.md): Create Grok-style log grouping rules that normalize noisy messages and generate consistent fingerprints for recurring issues.
- [Logs and Errors](https://uptrace.dev/raw/features/logs.md): Browse grouped logs and errors in Uptrace, filter by service or severity, search by text or attribute, and inspect individual records with aggregated stats and per-entry details.
- [Querying Metrics](https://uptrace.dev/raw/features/metrics/querying.md): Write PromQL inspired metric queries with aliases, joins, and expressions that feed dashboards built in the UI or YAML.
- [PromQL compatibility](https://uptrace.dev/raw/features/metrics/promql-compat.md): See how Uptrace extends PromQL, which functions are supported, and how to adapt Prometheus queries or Grafana dashboards.
- [Metrics query language reference](https://uptrace.dev/raw/features/metrics/reference.md): Complete reference for the Uptrace metrics query language: selectors, the instrument and aggregation matrix, and every aggregate, rollup, transform, and timeseries function.
- [Metrics](https://uptrace.dev/raw/features/metrics.md): Monitor infrastructure and application metrics in Uptrace using pre-built dashboards with table and grid views, or explore any metric interactively with aggregations, grouping, and filters.
- [Error monitors](https://uptrace.dev/raw/features/alerting/error-monitors.md): Set up error monitors in Uptrace to receive alerts for specific log patterns, exception types, and severity levels. Customize alert names with Go templates.
- [Alerting](https://uptrace.dev/raw/features/alerting.md): Configure threshold, anomaly, outlier, forecast, error, and SLO monitors. Group related alerts into incidents and route notifications.
- [Metric monitors](https://uptrace.dev/raw/features/alerting/metric-monitors.md): Create metric monitors in Uptrace to alert on CPU, disk, network, span latency, error rates, and log volume using YAML-defined thresholds and rolling evaluation windows.
- [Notifications](https://uptrace.dev/raw/features/alerting/notifications.md): Configure Uptrace notification channels to receive alerts via Slack, PagerDuty, Microsoft Teams, Telegram, email, webhooks, and more. Control routing with Expr conditions.
- [Searching Spans and Logs](https://uptrace.dev/raw/features/searching.md): Search spans and logs using natural syntax with word filters, AND/OR logic, quoted phrases, negative filters, and scoped attribute queries.
- [Chart Annotations](https://uptrace.dev/raw/features/annotations.md): Mark deployments, incidents, and config changes on Uptrace charts via API so your team can correlate timeline events with metric and trace changes.
- [Dashboards](https://uptrace.dev/raw/features/dashboards.md): Build custom dashboards from spans, events, logs, and metrics using a graphical UI or YAML. Table and grid layouts, PromQL-style expressions, and auto-activating templates.
- [Dashboard YAML Templates](https://uptrace.dev/raw/features/dashboards/yaml.md): Complete reference for the Uptrace dashboard template YAML format, covering metadata, tables, grids, grid items, monitors, and composition.
- [Transformations](https://uptrace.dev/raw/features/transformations.md): Use YAML-based transformations and Expr filters to rename attributes, parse payloads, sample or drop telemetry, and build full-text indexes before data reaches Uptrace.
- [Operations & Functions Reference](https://uptrace.dev/raw/features/transformations/reference.md): Complete reference for all Uptrace transformation operation types and built-in Expr functions for spans, logs, events, and metric datapoints.
- [Service Graph](https://uptrace.dev/raw/features/service-graph.md): Visualize service dependencies, request flows, error rates, and latency across your infrastructure with Uptrace service graphs built from OpenTelemetry span relationships.
- [Using Uptrace and Grafana Together](https://uptrace.dev/raw/features/grafana.md): Use Uptrace as a Prometheus and Tempo data source in Grafana to query metrics with PromQL and browse traces — reuse existing dashboards without changing metric names.
- [Using Fixtures to Seed Uptrace Data](https://uptrace.dev/raw/features/fixtures.md): Define users, organizations, projects, and tokens in the seed_data section of the Uptrace config, and apply them with uptrace db seed so every self-hosted environment starts from the same state.
- [JavaScript Source Maps](https://uptrace.dev/raw/features/sourcemaps.md): Automatically unminify JavaScript stack traces using source maps. Upload source maps via API or let Uptrace fetch them from URLs in error spans.
- [MCP Server](https://uptrace.dev/raw/features/mcp.md): Built-in Model Context Protocol server that lets AI assistants query spans, traces, logs, metrics, alerts, incidents, and dashboards in Uptrace using natural language.
- [Observability as Code](https://uptrace.dev/raw/features/observability-as-code.md): Manage Uptrace organizations, projects, monitors, and notification channels with the Uptrace Terraform provider — version-controlled and reproducible across environments.
- [Uptrace Features](https://uptrace.dev/raw/features.md): Explore Uptrace features: alerting, dashboards, querying, service graphs, SSO, Grafana integration, and more.
- [Google Cloud Single Sign-On](https://uptrace.dev/raw/features/sso/google.md): Configure Google Cloud OpenID Connect SSO with Uptrace using OAuth clients, redirect URIs, and client credentials.
- [Okta Single Sign-On](https://uptrace.dev/raw/features/sso/okta.md): Configure Okta as a SAML 2.0 identity provider for Uptrace SSO using app integrations, attribute statements, and metadata URLs.
- [Keycloak Single Sign-On](https://uptrace.dev/raw/features/sso/keycloak.md): Deploy Keycloak and configure OpenID Connect SSO with Uptrace using realms, clients, redirect URIs, and client credentials.
## Getting Started
Language-specific guides for instrumenting your applications with OpenTelemetry and sending data to Uptrace.
- [Getting started with Uptrace](https://uptrace.dev/raw/get.md): Learn how to connect OpenTelemetry signals to Uptrace, read your DSN, and monitor infrastructure, Kubernetes, and logs from one place.
- [Monitoring logs with Uptrace](https://uptrace.dev/raw/get/logs.md): Collect infrastructure and application logs with Vector, Fluent Bit, or OpenTelemetry events, enrich them with attributes, and group records inside Uptrace.
- [Monitoring errors and exceptions with OpenTelemetry](https://uptrace.dev/raw/get/exceptions.md): Record exceptions with OpenTelemetry spans, capture stack traces in multiple languages, and track grouped errors inside Uptrace.
- [Monitor K8s with OpenTelemetry Collector](https://uptrace.dev/raw/get/kubernetes.md): Complete Kubernetes application monitoring and cluster observability using OpenTelemetry Collector receivers. Step-by-step setup guide for Kubernetes tracing.
- [Migrating from Datadog to Uptrace](https://uptrace.dev/raw/get/datadog-migration.md): Learn how to successfully migrate your monitoring infrastructure from Datadog to Uptrace with this step-by-step guide covering infrastructure setup, application instrumentation, dashboard conversion, and validation.
- [Migrating from New Relic to Uptrace](https://uptrace.dev/raw/get/newrelic-migration.md): Learn how to successfully migrate your monitoring infrastructure from New Relic to Uptrace with this step-by-step guide covering infrastructure setup, application instrumentation, dashboard conversion, and validation.
- [Monitor HTTP endpoints with Uptrace](https://uptrace.dev/raw/get/synthetic-monitoring.md): Add synthetic HTTP endpoint monitoring to Uptrace using the OpenTelemetry httpcheckreceiver — uptime checks, response validation, and TLS certificate expiry tracking.
- [Uptrace: Open Source APM [Forever Free]](https://uptrace.dev/raw/get/hosted/open-source-apm.md): Uptrace is an open source application performance monitoring tool that can help you monitor and analyze performance of your applications.
- [Installing Uptrace](https://uptrace.dev/raw/get/hosted/install.md): Install self hosted Uptrace by provisioning ClickHouse, PostgreSQL, and Redis, generating config files, and wiring telemetry sources.
- [Deploying Uptrace with Ansible](https://uptrace.dev/raw/get/hosted/ansible.md): Automate Uptrace deployments on bare metal with the official Ansible playbooks, inventories, and role based setup.
- [Deploying Uptrace on Kubernetes](https://uptrace.dev/raw/get/hosted/k8s.md): Deploy Uptrace on Kubernetes via the Helm chart, provision dependencies, and manage namespaces plus upgrades with kubectl.
- [Deploying Uptrace with Docker](https://uptrace.dev/raw/get/hosted/docker.md): Quick deployment of Uptrace using Docker Compose with pre-configured services including ClickHouse, PostgreSQL, and Redis.
- [Uptrace Configuration Reference](https://uptrace.dev/raw/get/hosted/config.md): Reference guide for the main Uptrace configuration options, including databases, authentication, MCP, and ClickHouse tuning.
- [Upgrading Uptrace](https://uptrace.dev/raw/get/hosted/upgrade.md): Upgrade self-hosted Uptrace with the migrate command: preview the plan, apply migrations with zero-downtime restarts, recover from a failed step, and roll back.
- [Troubleshooting](https://uptrace.dev/raw/get/hosted/debug.md): Troubleshoot self-hosted Uptrace by checking versions, reading service logs, and enabling verbose ClickHouse or PostgreSQL diagnostics.
- [Scaling Uptrace](https://uptrace.dev/raw/get/hosted/scale.md): Tune Uptrace processing pipelines, ClickHouse inserts, and optionally add Kafka for high-volume ingestion.
- [Self-hosting Uptrace](https://uptrace.dev/raw/get/hosted.md): Deploy self-hosted Uptrace on your own infrastructure — choose Docker, Kubernetes, Ansible, or a manual install, then configure, scale, and troubleshoot.
- [OpenTelemetry C++ SDK for Uptrace](https://uptrace.dev/raw/get/opentelemetry-cpp.md): Step-by-step guide to install and configure OpenTelemetry C++ SDK, export telemetry to Uptrace via OTLP.
- [OTLP Configuration for OpenTelemetry C++](https://uptrace.dev/raw/get/opentelemetry-cpp/otlp.md): Configure OpenTelemetry C++ to export traces, metrics, and logs to Uptrace using the OTLP exporter.
- [OpenTelemetry C++ Tracing](https://uptrace.dev/raw/get/opentelemetry-cpp/tracing.md): Instrument C++ services with the OpenTelemetry Tracing API, create spans, record errors, and send distributed traces to Uptrace.
- [OpenTelemetry Metrics for C++](https://uptrace.dev/raw/get/opentelemetry-cpp/metrics.md): Collect C++ application metrics with the OpenTelemetry Meter API, configure instruments, and forward data to Uptrace dashboards.
- [OpenTelemetry Logs for C++](https://uptrace.dev/raw/get/opentelemetry-cpp/logs.md): Collect C++ application logs with OpenTelemetry and send structured logs to Uptrace.
- [Resource Attributes in OpenTelemetry C++](https://uptrace.dev/raw/get/opentelemetry-cpp/resources.md): Add resource attributes in C++ to describe service name, environment, and deployment metadata so Uptrace can group telemetry correctly.
- [OpenTelemetry Context Propagation [C++]](https://uptrace.dev/raw/get/opentelemetry-cpp/propagation.md): Propagate trace context in C++ using W3C TraceContext, inject and extract traceparent headers.
- [OpenTelemetry C++ Sampling](https://uptrace.dev/raw/get/opentelemetry-cpp/sampling.md): Configure OpenTelemetry sampling in C++ with parent-based, trace ID ratio, or always-on strategies.
- [OpenTelemetry .NET distro for Uptrace](https://uptrace.dev/raw/get/opentelemetry-dotnet.md): Step-by-step guide to install and configure OpenTelemetry .NET SDKs, export telemetry to Uptrace, and verify that traces, metrics, and logs arrive via OTLP.
- [Direct OTLP Configuration for OpenTelemetry .NET](https://uptrace.dev/raw/get/opentelemetry-dotnet/otlp.md): Configure OpenTelemetry .NET to export traces, metrics, and logs to Uptrace using the OTLP exporter directly.
- [OpenTelemetry Tracing API for .NET](https://uptrace.dev/raw/get/opentelemetry-dotnet/tracing.md): Instrument .NET services with the OpenTelemetry Tracing API, create spans, record errors, and send distributed traces to Uptrace.
- [OpenTelemetry Metrics API for .NET](https://uptrace.dev/raw/get/opentelemetry-dotnet/metrics.md): Collect .NET application metrics with the OpenTelemetry Meter API, configure instruments, and forward data to Uptrace dashboards.
- [OpenTelemetry Logs for .NET](https://uptrace.dev/raw/get/opentelemetry-dotnet/logs.md): Collect .NET application logs with OpenTelemetry and send structured logs to Uptrace using the OTLP exporter.
- [Resource Detectors in OpenTelemetry .NET](https://uptrace.dev/raw/get/opentelemetry-dotnet/resources.md): Add resource attributes in .NET to describe service name, environment, and deployment metadata so Uptrace can group telemetry correctly.
- [OpenTelemetry Context Propagation [.NET]](https://uptrace.dev/raw/get/opentelemetry-dotnet/propagation.md): Configure context propagation for .NET apps using W3C TraceContext, baggage, and custom propagators to keep traces connected end to end.
- [OpenTelemetry Sampling [.NET]](https://uptrace.dev/raw/get/opentelemetry-dotnet/sampling.md): Tune OpenTelemetry sampling in .NET with parent-based, trace ID ratio, or tail sampling strategies to balance observability cost and fidelity in Uptrace.
- [.NET Zero-Code Instrumentation with Uptrace](https://uptrace.dev/raw/get/opentelemetry-dotnet/zero-code.md): Automatically instrument .NET applications without code changes using OpenTelemetry .NET auto-instrumentation. Export traces, metrics, and logs to Uptrace via OTLP.
- [OpenTelemetry Erlang/Elixir for Uptrace](https://uptrace.dev/raw/get/opentelemetry-erlang.md): Step-by-step guide to install and configure OpenTelemetry Erlang/Elixir SDKs, export telemetry to Uptrace, and verify that traces and metrics arrive via OTLP.
- [OTLP Exporter Configuration for OpenTelemetry Erlang/Elixir](https://uptrace.dev/raw/get/opentelemetry-erlang/otlp.md): Configure OpenTelemetry Erlang/Elixir to export traces and metrics to Uptrace using the OTLP exporter.
- [OpenTelemetry Erlang/Elixir Tracing API](https://uptrace.dev/raw/get/opentelemetry-erlang/tracing.md): Learn how to use manual instrumentation for custom tracing in Erlang/Elixir applications.
- [OpenTelemetry Erlang/Elixir Metrics API](https://uptrace.dev/raw/get/opentelemetry-erlang/metrics.md): Learn how to use the OpenTelemetry Metrics API to collect and export performance metrics from Erlang/Elixir applications.
- [OpenTelemetry Logs for Erlang/Elixir](https://uptrace.dev/raw/get/opentelemetry-erlang/logs.md): Collect Erlang/Elixir application logs with OpenTelemetry and send structured logs to Uptrace.
- [Resource Detectors in OpenTelemetry Elixir/Erlang](https://uptrace.dev/raw/get/opentelemetry-erlang/resources.md): Add resource attributes in Erlang to describe service name, environment, and deployment metadata so Uptrace can group telemetry correctly.
- [OpenTelemetry Context Propagation in Erlang/Elixir](https://uptrace.dev/raw/get/opentelemetry-erlang/propagation.md): Learn how to implement context propagation for distributed tracing in Erlang/Elixir OpenTelemetry applications.
- [OpenTelemetry Sampling [Erlang/Elixir]](https://uptrace.dev/raw/get/opentelemetry-erlang/sampling.md): Tune OpenTelemetry sampling in Erlang with parent-based, trace ID ratio, or tail sampling strategies to balance observability cost and fidelity in Uptrace.
- [OpenTelemetry Go distro for Uptrace](https://uptrace.dev/raw/get/opentelemetry-go.md): Step-by-step guide to install and configure OpenTelemetry Go SDKs, export telemetry to Uptrace, and verify that traces, metrics, and logs arrive via OTLP.
- [Direct OTLP Configuration for OpenTelemetry Go](https://uptrace.dev/raw/get/opentelemetry-go/otlp.md): Configure OpenTelemetry Go to export traces, metrics, and logs to Uptrace using the OTLP exporter directly.
- [OpenTelemetry Go Tracing](https://uptrace.dev/raw/get/opentelemetry-go/tracing.md): Instrument Go services with the OpenTelemetry Tracing API, create spans, record errors, and send distributed traces to Uptrace.
- [OpenTelemetry Metrics for Go](https://uptrace.dev/raw/get/opentelemetry-go/metrics.md): Collect Go application metrics with the OpenTelemetry Meter API, configure instruments, and forward data to Uptrace dashboards.
- [OpenTelemetry Logs for Go](https://uptrace.dev/raw/get/opentelemetry-go/logs.md): Collect Go application logs with OpenTelemetry using slog and send structured logs to Uptrace.
- [Resource Detectors in OpenTelemetry Go](https://uptrace.dev/raw/get/opentelemetry-go/resources.md): Add resource attributes in Go to describe service name, environment, and deployment metadata so Uptrace can group telemetry correctly.
- [OpenTelemetry Context Propagation [Go]](https://uptrace.dev/raw/get/opentelemetry-go/propagation.md): Propagate trace context in Go using W3C TraceContext, inject and extract traceparent headers automatically or manually.
- [OpenTelemetry Go Sampling](https://uptrace.dev/raw/get/opentelemetry-go/sampling.md): Tune OpenTelemetry sampling in Go with parent-based, trace ID ratio, or consistent probability strategies to balance observability cost and fidelity in Uptrace.
- [OpenTelemetry Go for Serverless](https://uptrace.dev/raw/get/opentelemetry-go/serverless.md): Configure OpenTelemetry Go for serverless environments like AWS Lambda and Vercel, with proper initialization and flushing patterns.
- [Go Zero-Code Instrumentation with Uptrace (eBPF)](https://uptrace.dev/raw/get/opentelemetry-go/zero-code.md): Automatically instrument Go applications using eBPF-based OpenTelemetry instrumentation. Export traces and metrics to Uptrace without code changes or recompilation.
- [OpenTelemetry Java for Uptrace](https://uptrace.dev/raw/get/opentelemetry-java.md): Step-by-step guide to install and configure OpenTelemetry Java SDKs, export telemetry to Uptrace, and verify that traces, metrics, and logs arrive via OTLP.
- [OpenTelemetry Java Tracing API](https://uptrace.dev/raw/get/opentelemetry-java/tracing.md): Instrument Java services with the OpenTelemetry Tracing API, create spans, record errors, and send distributed traces to Uptrace.
- [OpenTelemetry Metrics API for Java](https://uptrace.dev/raw/get/opentelemetry-java/metrics.md): Collect Java application metrics with the OpenTelemetry Meter API, configure instruments, and forward data to Uptrace dashboards.
- [OpenTelemetry Logs for Java](https://upt