Traces

1. Ingestion des Traces #

Ingestion via OTLP ou protocoles tiers (Jaeger, Zipkin).

Recevoir les traces #

Les applications instrumentées envoient leurs traces à Alloy, qui les traite puis les transmet à Tempo ou à un autre backend. Les ports standard de l'OTLP sont 4317 (gRPC) et 4318 (HTTP).

otelcol.receiver.otlp "default" {
  grpc {
    endpoint = "0.0.0.0:4317"
  }
  http {
    endpoint = "0.0.0.0:4318"
  }
  output {
    traces = [otelcol.processor.memory_limiter.default.input]
  }
}

otelcol.processor.memory_limiter "default" {
  check_interval         = "1s"
  limit_percentage       = 80
  spike_limit_percentage = 20
  output {
    traces = [otelcol.processor.batch.default.input]
  }
}

otelcol.processor.batch "default" {
  output {
    traces = [otelcol.exporter.otlp.tempo.input]
  }
}

otelcol.exporter.otlp "tempo" {
  client {
    endpoint = "tempo:4317"
    tls {
      insecure = true
    }
  }
}

L'ordre recommandé #

Erreur rencontrée : limit_percentage seul est refusé au démarrage (« limit_percentage and spike_limit_percentage must be greater than 0 »). Indiquez les deux : c'est pourquoi l'exemple précise aussi spike_limit_percentage.

Accepter les anciens formats #

Pendant une migration, Alloy reçoit aussi Jaeger et Zipkin, puis convertit tout vers le même pipeline. Les applications existantes n'ont donc rien à changer.

otelcol.receiver.jaeger "historique" {
  protocols {
    grpc {}
  }
  output {
    traces = [otelcol.processor.batch.default.input]
  }
}

otelcol.receiver.zipkin "historique" {
  output {
    traces = [otelcol.processor.batch.default.input]
  }
}

otelcol.processor.batch "default" {
  output {
    traces = []
  }
}

Vérifier #

Branchez temporairement otelcol.exporter.debug en sortie : il affiche chaque span dans les journaux d'Alloy. Ce composant est expérimental : lancez Alloy avec --stability.level=experimental. Les métriques otelcol_receiver_accepted_spans_total et otelcol_exporter_sent_spans_total permettent ensuite de comparer l'entrée et la sortie.

0.0.0.0:4318 rend le récepteur accessible aux autres machines. Sur un hôte partagé, limitez l'accès, ou ajoutez l'authentification avec otelcol.auth.*.