OpenTelemetry (OTLP) Integration

Lasttest-Metriken per OpenTelemetry streamen

Die OpenTelemetry-Integration exportiert Ihre Live-Lasttest-Metriken uber das OpenTelemetry-Protokoll (OTLP) an jedes OTLP-kompatible Backend, sodass Sie einen Test in dem Tool verfolgen konnen, das Sie bereits fur Observability nutzen. Sie funktioniert mit Honeycomb, Grafana Cloud, New Relic, Datadog, Dynatrace, Elastic und jedem selbst gehosteten OpenTelemetry Collector.

Integration erstellen

1. Gehen Sie zu Account > Integration Settings.
2. Klicken Sie auf New Integration und wahlen Sie OpenTelemetry.
3. Fullen Sie die folgenden Felder aus und klicken Sie auf Save integration.

Integrationsfelder

• Name: Ein Label fur diese Integration, zum Beispiel Honeycomb HTTP.
• OTLP Endpoint: Wohin die Metriken gesendet werden.
  • Fur HTTP (protobuf) verwenden Sie die Basis-URL inklusive Schema, zum Beispiel https://api.honeycomb.io. LoadFocus hangt /v1/metrics automatisch an.
  • Fur gRPC verwenden Sie host:port, zum Beispiel api.honeycomb.io:443. Ohne Schema wird https:// angenommen.
• Protocol: HTTP (protobuf) (Standard, funktioniert uberall) oder gRPC.
• Headers: Kommagetrennte key=value-Paare fur die Authentifizierung, zum Beispiel api-key=YOUR_KEY,x-tenant=team. Dies ist das einzige Geheimfeld und wird verschlusselt gespeichert.

Endpoints und Headers je Backend

Hinweise zu Honeycomb

• Verwenden Sie einen Ingest Key, erstellt unter Environment Settings > API Keys > Ingest. Kopieren Sie das Key Secret, das beim Erstellen des Schlussels einmalig angezeigt wird, nicht die kurzere Key ID aus der Liste. Die Key ID fuhrt zu unknown API key (HTTP 401).
• Metriken benotigen den Header x-honeycomb-dataset, um das Ziel-Dataset zu benennen.
• Geben Sie dem Schlussel die Berechtigung Can create services/datasets, damit das Dataset bei den ersten eintreffenden Metriken erstellt wird.

Integration einem Test zuweisen

1. Offnen Sie einen JMeter- oder k6-Test und gehen Sie zum Abschnitt Integrations.
2. Wahlen Sie Ihre OpenTelemetry-Integration aus dem Dropdown.
3. Speichern Sie den Test und starten Sie ihn.

Jeder Lauf mit zugewiesener Integration streamt seine Metriken an das konfigurierte Backend.

Was Sie sehen werden

Die Metriken kommen mit den Resource-Attributen service.name, loadfocus.testrunname und loadfocus.testrunid an, sodass Sie nach Testlauf filtern konnen.

• JMeter-Tests senden jmeter.samples, jmeter.response_time_ms und jmeter.errors, versehen mit sampler und response_code. JMeter sammelt und flusht am Ende des Laufs, daher erscheinen die Metriken, sobald der Lauf abgeschlossen ist.
• k6-Tests senden die Standardmetriken von k6 wie http_req_duration, http_reqs, vus und iterations, gestreamt wahrend der Test lauft.

Fehlerbehebung

• unknown API key oder HTTP 401: die Anmeldedaten sind falsch oder fehlen. Prufen Sie bei Honeycomb, ob Sie das Key Secret und nicht die Key ID verwendet haben.
• Keine Daten im Backend: prufen Sie den Zielnamen (Honeycomb-Dataset, New-Relic-Konto usw.), prufen Sie den Auth-Header und beachten Sie, dass JMeter-Metriken erst nach Abschluss des Laufs erscheinen.
• Endpoint abgelehnt: HTTP-Endpoints benotigen das https://-Schema; gRPC-Endpoints verwenden host:port.
• Der Lauf selbst bleibt unberuhrt: ist eine Integration falsch konfiguriert, lauft der Test trotzdem, er exportiert lediglich keine Metriken.

Integration bearbeiten oder entfernen

• Bearbeiten: klicken Sie in Integration Settings auf das Bearbeiten-Symbol der Integration, um Name, Endpoint, Protokoll oder Headers zu andern. Lassen Sie das Feld Headers leer, um die vorhandenen Anmeldedaten zu behalten; geben Sie nur dann einen Wert ein, wenn Sie ihn ersetzen mochten.
• Entfernen: klicken Sie auf das Loschen-Symbol der Integration, um sie aus Ihren externen Berichtsdiensten zu entfernen.