# kubeshop/tracetest

🔭 Tracetest - Build integration and end-to-end tests in minutes, instead of days, using OpenTelemetry and trace-based testing.

Repository: https://github.com/kubeshop/tracetest
Canonical: https://ross.abutalabs.com/products/tracetest
Homepage: https://docs.tracetest.io/
Language: Go
License: NOASSERTION
License Family: other
Topics: integration-testing, microservices, opentelemetry, testing, tracing, tracetest
Last push: 2025-06-03T15:24:46+00:00

## Health v2 (maintenance only)
Score: 45/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 24, release rhythm 40, longevity 100
- inputs: {"age_days": 1674, "days_push": 456, "days_rel": 692, "gap_med": 5.5, "n_releases_24m": 7}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1328, forks 95 (observed 2026-08-28T04:04:23.669925+00:00)

## What it is
Tracetest is an open-source trace-based testing tool that builds integration and end-to-end tests on top of OpenTelemetry distributed traces. It lets you assert against both API responses and trace span data across microservices, with a web UI, YAML test specs, a CLI, and CI/CD integrations.

## Use cases
- write end-to-end tests for microservices using OpenTelemetry traces
- assert on trace span timing like database queries under 100ms
- test side-effects in distributed systems such as message queues and async calls
- run trace-based tests in CI pipelines
- verify quality of OpenTelemetry instrumentation
- run trace-based tests as synthetic monitors in production
- integrate trace assertions with existing Cypress, Playwright, k6, or Postman tests

## When to choose
- you have a microservices or event-driven architecture already instrumented with OpenTelemetry
- traditional input/output tests miss race conditions, bottlenecks, or inter-service failures
- you want to assert on internal behavior of a transaction, not just the final response
- you want to build E2E tests quickly via a visual UI or YAML and run them in CI

## When to avoid
- your application is not instrumented with OpenTelemetry and you cannot add tracing
- you only need simple unit or isolated component tests without distributed tracing
- you need a fully open-source production-grade self-hosted deployment - the open-source core is hobby-grade and managed/enterprise features are commercial

## Facets
- artifact type: application
- maturity: active
- function: testing, e2e-testing, tracing, monitoring, ci-cd
- domain: testing, microservices, monitoring, developer-tools
- platform: cli, self-hosted, cloud, cross-platform
- tags: trace-based-testing, opentelemetry, distributed-tracing, integration-testing, synthetic-monitoring, observability, devops, docker, kubernetes

## Member repositories
- kubeshop/tracetest (main) score 45

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:23.669925+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:45:58.408335+00:00, confidence not recorded.
  - readme: https://github.com/kubeshop/tracetest (fetched 2026-08-28T04:04:23.669925+00:00, sha 0f12b5f7e05c)
  - homepage: https://docs.tracetest.io/ (fetched 2026-08-29T12:05:05.681534+00:00, sha 6926cb2bbcfc)
  - site_page: https://docs.tracetest.io/getting-started/overview (fetched 2026-08-29T12:05:05.692886+00:00, sha 48ccf9ed5ad5)
  - site_page: https://docs.tracetest.io/install/overview (fetched 2026-08-29T12:05:05.694679+00:00, sha a08bb9aeecae)
  - site_page: https://docs.tracetest.io/tools-and-integrations/overview (fetched 2026-08-29T12:05:05.696292+00:00, sha deaa9add7781)
  - site_page: https://docs.tracetest.io/core/getting-started/overview (fetched 2026-08-29T12:05:05.697947+00:00, sha 57cdffa29863)
  - site_page: https://docs.tracetest.io/concepts/what-is-trace-based-testing (fetched 2026-08-29T12:05:05.699610+00:00, sha 8a7502c00a33)
  - site_page: https://docs.tracetest.io/getting-started/install-agent (fetched 2026-08-29T12:05:05.701282+00:00, sha 59ace0c63b6d)
  - site_page: https://tracetest.io/on-prem-installation (fetched 2026-08-29T12:05:05.703296+00:00, sha e07007fff2ae)
  - site_page: https://tracetest.io/pricing (fetched 2026-08-29T12:05:05.690868+00:00, sha ed870942aee1)
- Data as of 2026-08-30T08:39:29.467469+00:00.