About

This is a OpenTelemetry .NET playground.

The following components are used:

Usage (Ubuntu 22.04)

# create the environment defined in docker-compose.yml
# and leave it running in the background.
docker compose up --detach --build --wait

# show running containers.
docker compose ps

# show logs.
docker compose logs

# show the quotes container health check output log.
docker inspect --format '{{json .State.Health }}' \
  "$(docker compose ps quotes --format '{{.Name}}')" \
  | jq -r '.Log[].Output'

# open a container network interface in wireshark.
./wireshark.sh quotes

# open the quotes service swagger.
xdg-open http://localhost:8000/swagger

# make a request.
http \
  --verbose \
  http://localhost:8000/quote

# make a failing request.
http \
  --verbose \
  http://localhost:8000/quote?opsi=opsi

# make a request that includes a parent trace.
# NB the dotnet trace id will be set to the traceparent trace id.
# NB the tracestate does not seem to be stored or propagated anywhere.
# NB traceparent syntax: <version>-<trace-id>-<parent-id-aka-span-id>-<trace-flags>
http \
  --verbose \
  http://localhost:8000/quote \
  traceparent:00-10000000000000000000000000000000-1000000000000000-01 \
  tracestate:x.client.state=example

# make a request to quotetext, which in turn, makes a nested request to quote.
http \
  --verbose \
  http://localhost:8000/quotetext

# make a failing request to quotetext, which in turn, makes a nested failing
# request to quote.
http \
  --verbose \
  http://localhost:8000/quotetext?opsi=opsi

# make a request that includes a parent trace.
# NB the dotnet trace id will be set to the traceparent trace id.
# NB the tracestate does not seem to be stored or propagated anywhere.
# NB traceparent syntax: <version>-<trace-id>-<parent-id-aka-span-id>-<trace-flags>
http \
  --verbose \
  http://localhost:8000/quotetext \
  traceparent:00-20000000000000000000000000000000-1000000000000000-01 \
  tracestate:x.client.state=example

# open aspire dashboard (metrics/traces/logs).
xdg-open http://localhost:18888

# destroy the environment.
docker compose down --remove-orphans --volumes --timeout=0

List this repository dependencies (and which have newer versions):

GITHUB_COM_TOKEN='YOUR_GITHUB_PERSONAL_TOKEN' ./renovate.sh

Notes

• .NET uses the Activity class to encapsulate the W3C Trace Context.
  • The Activity Id property contains to the W3C traceparent header value.
    • It looks alike 00-98d483b6d0e3a6d012b11e23737faa50-6ac18089ab13c12e-01.
    • It has four fields: version, trace-id, parent-id (aka span-id), and trace-flags.

Reference

• W3C Trace Context.
• OpenTelemetry Concepts.
• OpenTelemetry Semantic Conventions Specification.
• OpenTelemetry Specifications.
• opentelemetry-dotnet repository.
• OpenTelemetry in .NET documentation.
• OpenTelemetry.Exporter.OpenTelemetryProtocol Environment Variables.