Quick Start #
How to install #
VictoriaTraces is available in the following distributions:
- Single-server-VictoriaTraces - all-in-one binary that is easy to run and maintain.
VictoriaMetrics is available as:
- docker images at Docker Hub and Quay .
- Binary releases
- Source code . See How to build from sources
Starting VictoriaTraces Single Node via Docker #
Run the newest available VictoriaTraces release from Docker Hub or Quay :
docker run --rm -it -p 10428:10428 -v ./victoria-traces-data:/victoria-traces-data \
docker.io/victoriametrics/victoria-traces:v0.1.0
This command will make VictoriaTraces run in the foreground, and store the ingested data to the victoria-traces-data directory. You should see the following logs:
2025-08-08T07:33:13.532Z info VictoriaTraces/app/victoria-traces/main.go:44 starting VictoriaTraces at "[:10428]"...
2025-08-08T07:33:13.532Z info VictoriaTraces/app/vtstorage/main.go:111 opening storage at -storageDataPath=victoria-traces-data
...
2025-08-08T07:33:13.542Z info VictoriaMetrics@v0.0.0-20250714222639-15242a70a79f/lib/httpserver/httpserver.go:145 started server at http://0.0.0.0:10428/
...
After VictoriaTraces is running, verify VMUI is working by going to http://<victoria-traces>:10428/vmui.
See how to write or read from VictoriaTraces.
Starting VictoriaTraces Single Node from a Binary #
- Download the correct binary for your OS and architecture from GitHub
. Here’s an example for
Linux/amd64:
curl -L -O https://github.com/VictoriaMetrics/VictoriaTraces/releases/download/v0.1.0/victoria-traces-linux-amd64-v0.1.0.tar.gz
- Extract the archive by running:
tar -xvf victoria-traces-linux-amd64-v0.1.0.tar.gz
- Go to the binary’s folder and start VictoriaTraces:
./victoria-traces-prod
This command will make VictoriaTraces run in the foreground, and store the ingested data to the victoria-traces-data directory by default.
After VictoriaTraces is running, verify VMUI is working by going to http://<victoria-traces>:10428/vmui.
See how to write or read from VictoriaTraces.
Write data #
VictoriaTraces can accept trace spans via the OpenTelemetry protocol (OTLP) . It provides the following API:
/insert/opentelemetry/v1/traces
To test the data ingestion, the following example application can be used:
docker run \
-p8080-8083:8080-8083 \
--rm \
--env OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://<victoria-traces>:10428/insert/opentelemetry/v1/traces \
jaegertracing/example-hotrod:latest \
all
Simply open http://127.0.0.1:8080/, click any button to generate traces, and then check the data in VMUI at http://<ip_or_hostname>:10428/vmui.
See more details about how to send data to VictoriaTraces from an instrumented application or an OpenTelemetry collector in this doc .
Read data #
VictoriaTraces
has built-in VMUI for browsing data by span at http://<victoria-traces>:10428/vmui.
VictoriaTraces also provides Jaeger Query Service JSON APIs . It allows users to visualize trace data on Grafana, by simply adding a Jaeger datasource with VictoriaTraces URL:
http://<victoria-traces>:10428/select/jaeger
See more details about the HTTP APIs and params VictoriaTraces supports and how to query data from them in this doc .