---
title: "Traces | wasmCloud"
description: "How to enable end-to-end visibility of messages through wasmCloud"
canonical: "https://wasmcloud.com/docs/v1/deployment/observability/tracing/"
---

This is documentation for wasmCloud **v1**, which is no longer actively maintained.

For up-to-date documentation, see the **[latest version](https://wasmcloud.com/docs/)** (v2).

Version: v1

# Traces

Traces are essential for understanding the flow of messages through a distributed system. The wasmCloud host is instrumented to record traces for all control interface and RPC messages.

The wasmCloud host can record and export distributed traces using the [OpenTelemetry](https://opentelemetry.io/) (OTEL) specification. If you haven't worked with distributed traces before, [this primer](https://opentelemetry.io/docs/concepts/observability-primer/#distributed-traces) is a great place to start.

For more information on wasmCloud's implementation of OpenTelemetry, including advanced configuration options, see [Observability with OpenTelemetry](https://wasmcloud.com/docs/v1/deployment/observability/observability-with-opentelemetry/).

### Configuration

By default, tracing is disabled in the wasmCloud host. The host can be configured using [environment variables or host config flags](https://wasmcloud.com/docs/v1/cli/wasmcloud/).

To enable all OTEL signals, including traces, use the `WASMCLOUD_OBSERVABILITY_ENABLED` environment variable:

bash

```bash
WASMCLOUD_OBSERVABILITY_ENABLED="true"
```

To enable only traces, use the `WASMCLOUD_TRACES_ENABLED` environment variable:

bash

```bash
WASMCLOUD_TRACES_ENABLED="true"
```

By default, wasmCloud hosts export traces via HTTP/OpenTelemetry Protocol (`otlp`) on port 4318.

The endpoint for trace exports may be overwritten with the `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` environment variable:

bash

```bash
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://my-custom-host:4318
```

See the [host config](https://wasmcloud.com/docs/v1/cli/wasmcloud/) options for equivalent host configuration CLI flags.

### Viewing traces with Grafana and Tempo

A set of sample configurations and Docker Compose files are available to help launch a local observability environment. After following the instructions to [**launch a wasmCloud observability ecosystem**](https://wasmcloud.com/docs/v1/deployment/observability/observability-with-opentelemetry/#launch-a-wasmcloud-observability-ecosystem), you can navigate to [http://localhost:5050/explore](http://localhost:5050/explore), click the dropdown in the upper left, and select **"Tempo"** to view traces.

There are several ways to query traces in Tempo. To see all traces from the host, change the "Query type" tab to "Search," then click the "Service Name" dropdown and select "wasmcloud-host." You can also increase the "Limit" field to something more than the default (20). To search, press Shift-Enter. You can click on any of the Trace IDs to view all the spans associated with the trace.

Refer to the `OTEL_` environment variables in the [Docker Compose file](https://github.com/wasmCloud/wasmCloud/blob/main/examples/docker/docker-compose-otel.yml) for a complete example configuration. The example uses Grafana and Tempo, but wasmCloud works with any OTEL-compatible tracing backend, such as Zipkin, Jaeger, DataDog, Honeycomb, etc.

Last updated on **Jun 10, 2026** by **Liam Randall**
