Integration OpenTelemetry (OTLP)

Envoyer les metriques de test de charge via OpenTelemetry

L'integration OpenTelemetry exporte les metriques en direct de vos tests de charge via le protocole OpenTelemetry (OTLP) vers n'importe quel backend compatible OTLP, afin que vous puissiez suivre un test dans l'outil que vous utilisez deja pour l'observabilite. Elle fonctionne avec Honeycomb, Grafana Cloud, New Relic, Datadog, Dynatrace, Elastic et tout OpenTelemetry Collector auto-heberge.

Creer l'integration

1. Allez dans Account > Integration Settings.
2. Cliquez sur New Integration et choisissez OpenTelemetry.
3. Renseignez les champs ci-dessous et cliquez sur Save integration.

Champs de l'integration

• Name : Un libelle pour cette integration, par exemple Honeycomb HTTP.
• OTLP Endpoint : Ou les metriques sont envoyees.
  • Pour HTTP (protobuf), utilisez l'URL de base avec le schema, par exemple https://api.honeycomb.io. LoadFocus ajoute /v1/metrics pour vous.
  • Pour gRPC, utilisez host:port, par exemple api.honeycomb.io:443. Sans schema, https:// est suppose.
• Protocol : HTTP (protobuf) (la valeur par defaut, fonctionne partout) ou gRPC.
• Headers : Paires key=value separees par des virgules pour l'authentification, par exemple api-key=YOUR_KEY,x-tenant=team. C'est le seul champ secret et il est stocke chiffre.

Endpoints et Headers par backend

Notes sur Honeycomb

• Utilisez une Ingest Key, creee dans Environment Settings > API Keys > Ingest. Copiez le Key Secret affiche une seule fois lors de la creation de la cle, pas la Key ID plus courte de la liste. Envoyer la Key ID renvoie unknown API key (HTTP 401).
• Les metriques necessitent le header x-honeycomb-dataset pour nommer le dataset de destination.
• Donnez a la cle la permission Can create services/datasets afin que le dataset soit cree des l'arrivee des premieres metriques.

Associer l'integration a un test

1. Ouvrez un test JMeter ou k6 et allez dans sa section Integrations.
2. Selectionnez votre integration OpenTelemetry dans la liste deroulante.
3. Enregistrez le test, puis executez-le.

Chaque execution associee a une integration envoie ses metriques au backend configure.

Ce que vous verrez

Les metriques arrivent avec les attributs de ressource service.name, loadfocus.testrunname et loadfocus.testrunid, afin que vous puissiez filtrer par execution.

• Les tests JMeter envoient jmeter.samples, jmeter.response_time_ms et jmeter.errors, avec les tags sampler et response_code. JMeter regroupe et vide a la fin de l'execution, donc ses metriques apparaissent une fois l'execution terminee.
• Les tests k6 envoient les metriques standard de k6 comme http_req_duration, http_reqs, vus et iterations, transmises pendant que le test s'execute.

Depannage

• unknown API key ou HTTP 401 : l'identifiant est incorrect ou absent. Pour Honeycomb, verifiez que vous avez utilise le Key Secret et non la Key ID.
• Aucune donnee dans le backend : verifiez le nom de destination (dataset Honeycomb, compte New Relic, etc.), verifiez le header d'authentification et rappelez-vous que les metriques JMeter n'apparaissent qu'une fois l'execution terminee.
• Endpoint rejete : les endpoints HTTP doivent inclure le schema https:// ; les endpoints gRPC utilisent host:port.
• L'execution n'est pas affectee : si une integration est mal configuree, le test s'execute quand meme, il n'exporte simplement aucune metrique.

Modifier ou supprimer l'integration

• Modifier : dans Integration Settings, cliquez sur l'icone de modification de l'integration pour changer le nom, l'endpoint, le protocole ou les headers. Laissez le champ Headers vide pour conserver l'identifiant existant ; saisissez une valeur uniquement lorsque vous souhaitez le remplacer.
• Supprimer : cliquez sur l'icone de suppression de l'integration pour la retirer de vos services de reporting externes.