Business events Dynatrace : suivre un KPI métier sans code

Business events Dynatrace : capturer une commande avec OneAgent sans code, la requêter en DQL, en faire un SLI métier et alerter sur sa chute de volume.
Business events Dynatrace : suivre un KPI métier sans code

Le directeur produit demande combien de commandes ont échoué pendant l’incident d’hier soir. Les traces montrent des erreurs 500, les logs des exceptions, mais personne ne sait traduire cela en paniers perdus. Les business events Dynatrace comblent ce trou : ils capturent un fait métier (une commande, un paiement, une inscription) avec ses attributs, au moment où il se produit. Ce guide crée un premier business event Dynatrace et l’exploite de bout en bout.

Pour un SRE, c’est un SLI de premier ordre. Le taux de commandes réussies parle mieux à tout le monde que la latence du p95, et il mesure directement ce que l’error budget protège. Mieux : avec OneAgent, on peut capturer ces événements sans modifier une ligne du code applicatif.

Objectif : créer une règle de capture OneAgent qui transforme une requête HTTP en événement métier, l’interroger en DQL, en tirer un KPI et une alerte. Le contenu vise Dynatrace SaaS (stockage dans Grail). Pour Dynatrace Managed, vérifiez la disponibilité de Business Analytics dans votre version avant de démarrer.

Ce que sont les business events Dynatrace

Un business event est un enregistrement stocké dans la table bizevents de Grail. Il porte au minimum un fournisseur (event.provider), un type (event.type) et un horodatage, puis les attributs que vous choisissez : montant, devise, identifiant client, moyen de paiement.

Trois sources principales :

  • OneAgent : une règle de capture lit la requête ou la réponse HTTP d’un service surveillé. Aucun code.
  • RUM : des événements envoyés depuis le navigateur ou l’application mobile.
  • API : un POST au format CloudEvents sur /api/v2/bizevents/ingest, utile pour un système externe (ERP, batch).

À ne pas confondre avec les logs : un business event est structuré dès la capture, avec un schéma que vous contrôlez. Pas de parsing, pas de regex fragile.

Prérequis

  • Un environnement SaaS avec OneAgent en Full-Stack sur le service qui reçoit les requêtes métier (Java, .NET, Node.js, Go, PHP ou autre technologie supportée par la capture).
  • Le droit de modifier les réglages Business Observability.
  • Pour l’API : un token avec le scope bizevents.ingest, ou un token de plateforme avec openpipeline:bizevents:ingest.
  • Connaître la forme de la requête à capturer : chemin, méthode, champs du corps JSON.

Étape 1 : choisir le KPI et la requête porteuse

Partez d’une question précise : « combien de commandes validées par minute, et pour quel montant ? ». Identifiez l’appel qui la matérialise, par exemple :

POST /api/checkout
Content-Type: application/json

{ "orderId": "A-1029", "amount": 84.90, "currency": "EUR", "paymentMethod": "card" }

Notez aussi ce qui signale l’échec : un code de statut HTTP différent de 200, ou un champ status dans la réponse.

Étape 2 : créer la règle de capture OneAgent

  1. Ouvrez Settings > Business Observability > OneAgent business event sources (le libellé peut varier ; cherchez « business event » dans les réglages).
  2. Ajoutez une règle et nommez-la, par exemple checkout-order.
  3. Triggers : request.path égal à /api/checkout et request.method égal à POST. Les déclencheurs sont combinés en ET : tous doivent être vrais.
  4. Event provider : une constante, par exemple shop.checkout.
  5. Event type : une constante, par exemple com.shop.order.submitted.
  6. Data fields : ajoutez amount (source request.body, chemin amount), currency, paymentMethod, et status (source response.statusCode).
  7. Enregistrez. La règle s’applique sans redémarrage dans la plupart des cas ; vérifiez la documentation pour votre technologie.

Point critique : ne capturez jamais de donnée personnelle inutile (nom, adresse, numéro de carte). Si un champ sensible doit transiter, masquez-le dans le pipeline : voir le masquage des données sensibles avec OpenPipeline.

Étape 3 (option) : envoyer un événement par l’API

Pour une source qui n’est pas surveillée par OneAgent, l’API suffit :

curl -s -X POST "$DT_ENV/api/v2/bizevents/ingest" \
  -H "Authorization: Api-Token $DT_TOKEN" \
  -H "Content-Type: application/cloudevent+json" \
  -d '{
    "specversion": "1.0",
    "id": "erp-55102",
    "source": "erp.invoicing",
    "type": "com.shop.invoice.created",
    "data": { "orderId": "A-1029", "amount": 84.90, "currency": "EUR" }
  }'

Les champs specversion, id, source et type sont obligatoires. source devient le fournisseur de l’événement et type son type.

Étape 4 : interroger chaque business event Dynatrace en DQL

Vérifiez d’abord que les événements arrivent :

fetch bizevents, from:now()-1h
| filter event.provider == "shop.checkout"
| filter event.type == "com.shop.order.submitted"
| sort timestamp desc
| limit 20

Puis construisez le KPI : volume, chiffre d’affaires et taux de succès par tranche de cinq minutes.

fetch bizevents, from:now()-24h
| filter event.type == "com.shop.order.submitted"
| fieldsAdd ok = if(toLong(status) == 200, 1, else: 0)
| makeTimeseries orders = count(),
                 revenue = sum(toDouble(amount)),
                 succeeded = sum(ok),
                 interval:5m

Le taux de succès (succeeded / orders) est un SLI métier prêt à l’emploi. D’autres modèles de requêtes figurent dans les requêtes DQL d’exploitation.

Étape 5 : alerter sur le KPI

Deux approches :

  • SLO : définissez un objectif sur le taux de succès des commandes et alertez sur sa consommation d’error budget, comme expliqué dans les alertes burn rate.
  • Détecteur d’anomalie : sur la série orders, un seuil bas ou une détection adaptative attrape la chute brutale de volume, symptôme typique d’un paiement en panne sans erreur visible.

Pour ouvrir un ticket automatiquement, réutilisez le workflow vers Jira et ServiceNow.

Comment vérifier que ça fonctionne

  1. Passez une commande de test sur l’environnement de préproduction.
  2. Lancez la première requête DQL de l’étape 4 : l’événement doit apparaître avec amount, currency et status renseignés.
  3. Si l’événement existe mais qu’un champ est vide, le chemin du data field est faux (casse, imbrication). Corrigez-le dans la règle.
  4. Si rien n’arrive : le service n’est pas en Full-Stack, la requête ne correspond pas aux déclencheurs (chemin avec préfixe, méthode), ou la technologie ne permet pas la lecture du corps.

Bonnes pratiques

  • Nommer les types comme une API : com.entreprise.domaine.action, stable dans le temps.
  • Peu de champs, bien choisis : chaque attribut a un coût de stockage et un risque de confidentialité.
  • Un KPI par parcours critique : panier, paiement, inscription. Pas davantage au départ.
  • Relier au technique : les événements capturés par OneAgent gardent le contexte de trace, ce qui permet de passer d’une commande échouée à la requête lente qui l’explique.
  • Référence : documentation Business Observability.

Questions fréquentes

Les business events Dynatrace remplacent-ils un outil d’analytique web ?

Non. Ils servent à relier des faits métier à la santé technique, pas à analyser des entonnoirs marketing. Les deux outils répondent à des questions différentes.

Que coûtent les business events ?

Ils sont facturés à l’ingestion, à la rétention et à la requête selon votre contrat. Estimez le volume (événements par jour multipliés par la taille) avant d’activer une règle sur une route très sollicitée.

Peut-on capturer la réponse plutôt que la requête ?

Oui : les sources de données incluent response.body, response.headers et response.statusCode. C’est souvent là que se trouve le résultat réel de l’opération.

Conclusion

Une règle de capture, deux requêtes DQL et un SLO : en une heure, le taux de commandes réussies devient un indicateur partagé entre produit et exploitation. Au prochain incident, la question « combien de clients touchés ? » aura une réponse chiffrée.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Dynatrace est une marque de son propriétaire. Les noms d’écrans et d’options évoluent : vérifiez-les dans la documentation officielle de votre version.

Total
0
Shares
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Alertes Kubernetes : nœuds, pods et quotas qui comptent vraiment

Alertes Kubernetes : nœuds, pods et quotas qui comptent vraiment

Next Post
Davis CoPilot : interroger ses données en langage naturel, limites comprises

Davis CoPilot : interroger ses données en langage naturel, limites comprises

Related Posts