OpenTelemetry Getting Started Guide

from opentelemetry import trace

tracer = trace.get_tracer("order-service")

def process_order(order_id: str):
    with tracer.start_as_current_span("process_order") as span:
        span.set_attribute("order.id", order_id)

        with tracer.start_as_current_span("validate_payment"):
            validate_payment(order_id)

        with tracer.start_as_current_span("update_inventory"):
            update_inventory(order_id)

from opentelemetry import metrics

meter = metrics.get_meter("order-service")

order_counter = meter.create_counter(
    "orders.processed",
    description="Number of orders processed"
)

order_duration = meter.create_histogram(
    "orders.duration",
    unit="ms",
    description="Order processing duration"
)

def process_order(order_id: str):
    start = time.time()
    # ... process ...
    duration = (time.time() - start) * 1000
    order_counter.add(1, {"status": "success"})
    order_duration.record(duration)

import logging
from opentelemetry._logs import set_logger_provider

logger = logging.getLogger("order-service")

def process_order(order_id: str):
    with tracer.start_as_current_span("process_order"):
        logger.info(f"Processing order {order_id}")
        # This log is automatically correlated with the trace

# otel-collector-config.yaml
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

processors:
  batch:
    timeout: 5s
    send_batch_size: 1000

exporters:
  otlp/jaeger:
    endpoint: jaeger:4317
    tls:
      insecure: true
  prometheus:
    endpoint: 0.0.0.0:8889

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlp/jaeger]
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [prometheus]

# Python auto-instrumentation
pip install opentelemetry-distro opentelemetry-exporter-otlp
opentelemetry-bootstrap -a install

# Run your app with auto-instrumentation
opentelemetry-instrument \
  --service_name order-service \
  --exporter_otlp_endpoint http://collector:4317 \
  python app.py

apiVersion: apps/v1
kind: Deployment
metadata:
  name: otel-collector
spec:
  replicas: 1
  template:
    spec:
      containers:
        - name: collector
          image: otel/opentelemetry-collector-contrib:latest
          ports:
            - containerPort: 4317  # gRPC
            - containerPort: 4318  # HTTP
          volumeMounts:
            - name: config
              mountPath: /etc/otelcol-contrib
      volumes:
        - name: config
          configMap:
            name: otel-collector-config