mirror of
https://github.com/ipfs/kubo.git
synced 2025-05-17 23:16:11 +08:00
69 lines
2.4 KiB
Go
69 lines
2.4 KiB
Go
// Package tracing contains the tracing logic for go-ipfs, including configuring the tracer and
|
|
// helping keep consistent naming conventions across the stack.
|
|
//
|
|
// NOTE: Tracing is currently experimental. Span names may change unexpectedly, spans may be removed,
|
|
// and backwards-incompatible changes may be made to tracing configuration, options, and defaults.
|
|
//
|
|
// Tracing is configured through environment variables, as consistent with the OpenTelemetry spec as possible:
|
|
//
|
|
// https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/configuration/sdk-environment-variables.md
|
|
//
|
|
// OTEL_TRACES_EXPORTER: a comma-separated list of exporters:
|
|
// - otlp
|
|
// - zipkin
|
|
// - file
|
|
//
|
|
// Different exporters have their own set of environment variables, depending on the exporter. These are typically
|
|
// standard environment variables. Some common ones:
|
|
//
|
|
// OTLP HTTP/gRPC:
|
|
//
|
|
// - OTEL_EXPORTER_OTLP_PROTOCOL
|
|
// one of [grpc, http/protobuf]
|
|
// default: grpc
|
|
// - OTEL_EXPORTER_OTLP_ENDPOINT
|
|
// - OTEL_EXPORTER_OTLP_CERTIFICATE
|
|
// - OTEL_EXPORTER_OTLP_HEADERS
|
|
// - OTEL_EXPORTER_OTLP_COMPRESSION
|
|
// - OTEL_EXPORTER_OTLP_TIMEOUT
|
|
//
|
|
// Zipkin:
|
|
//
|
|
// - OTEL_EXPORTER_ZIPKIN_ENDPOINT
|
|
//
|
|
// File:
|
|
//
|
|
// - OTEL_EXPORTER_FILE_PATH
|
|
// file path to write JSON traces
|
|
// default: `$PWD/traces.json`
|
|
//
|
|
// For example, if you run a local IPFS daemon, you can use the jaegertracing/all-in-one Docker image to run
|
|
// a full Jaeger stack and configure Kubo to publish traces to it:
|
|
//
|
|
// docker run -d --rm --name jaeger \
|
|
// -e COLLECTOR_OTLP_ENABLED=true \
|
|
// -e COLLECTOR_ZIPKIN_HOST_PORT=:9411 \
|
|
// -p 5775:5775/udp \
|
|
// -p 6831:6831/udp \
|
|
// -p 6832:6832/udp \
|
|
// -p 5778:5778 \
|
|
// -p 16686:16686 \
|
|
// -p 14250:14250 \
|
|
// -p 14268:14268 \
|
|
// -p 14269:14269 \
|
|
// -p 4317:4317 \
|
|
// -p 4318:4318 \
|
|
// -p 9411:9411 \
|
|
// jaegertracing/all-in-one
|
|
// OTEL_EXPORTER_OTLP_INSECURE=true OTEL_TRACES_EXPORTER=otlp ipfs daemon --init
|
|
//
|
|
// # In this example the Jaeger UI is available at http://localhost:16686.
|
|
//
|
|
// Span names follow a convention of <Component>.<Span>, some examples:
|
|
//
|
|
// - component=Gateway + span=Request -> Gateway.Request
|
|
// - component=CoreAPI.PinAPI + span=Verify.CheckPin -> CoreAPI.PinAPI.Verify.CheckPin
|
|
//
|
|
// We follow the OpenTelemetry convention of using whatever TracerProvider is registered globally.
|
|
package tracing
|