Documentazione di Mtracer

Benvenuti nella documentazione di Mtracer, uno strumento CLI progettato per creare ed eseguire test di sistema all’interno di un sistema distribuito, raccogliendo le trace generate in formato OpenTelemetry. Questa documentazione fornisce tutto il necessario per comprendere l’utilizzo, i concetti principali e l’architettura di Mtracer.

Cos’è Mtracer?

Mtracer è uno strumento da riga di comando che consente agli sviluppatori di creare test di sistema per sistemi distribuiti, raccogliendo e analizzando le trace generate dalle applicazioni.

Mtracer ha lo scopo di avviare la trace attraverso un trigger (come HTTP o gRPC) e di raccoglierla tramite un observability backend (come Jaeger, OpenObserve, ecc.).
È quindi compito dello sviluppatore assicurarsi che tutte le trace vengano inviate all’observability backend e configurare Mtracer affinché possa raccoglierle correttamente.

Una volta definito come avviare e raccogliere le trace, lo sviluppatore può eseguire diversi controlli per verificare che le trace rispettino le aspettative.

Inoltre, prima di ogni test è possibile definire dei comandi per preparare l’ambiente e pulirlo al termine.

Infine, è fondamentale specificare che Mtracer supporta l’analisi delle trace solamente in formato OTel; pertanto, qualora si desideri utilizzare un observability backend che non supporta nativamente questo formato, o se le trace vengono pubblicate in un formato diverso, è necessario prima convertirle in formato OTel.