În producție, stabilitatea unui flux EDI nu se măsoară doar în “merge” sau “nu merge”. Pentru lanțuri de retail, automotive sau FMCG, fiecare mesaj EDIFACT livrat la timp înseamnă comenzi onorate, facturi plătite și loc pe raft. Segmentul UNH — antetul fiecărui mesaj EDIFACT — este un punct de ancoră ideal pentru observabilitate: ne spune ce tip de mesaj este (ORDERS, DESADV, INVOIC), versiunea standardului și identificatorul unic. Instrumentarea UNH cu Prometheus și vizualizarea în Grafana oferă echipelor IT un limbaj comun pentru SRE și business în jurul unui flux EDI critic.
De ce UNH este “codul de bare” al monitorizării EDI
UNH marchează granularitatea exactă a tranzacției EDI: un mesaj, un antet, un set de atribute canonice. Asta permite metrici robuste, independente de furnizorul platformei EDI (IBM Sterling, OpenText Trading Grid, SAP Integration Suite, Boomi, Mulesoft sau soluții open-source ca OpenAS2). OpenText Trading Grid, de exemplu, procesează peste 33 de miliarde de tranzacții anual pentru peste 1 milion de parteneri comerciali — la asemenea volum, vizibilitatea bazată pe UNH devine diferența dintre un incident localizat și un efect domino.
Ce măsurăm: metrici centrate pe UNH
- Volum și rată: edifact_unh_messages_total și rate pe ferestre de timp — trafic EDI per partener, tip mesaj, direcție (in/out).
- Erori de validare/parsing: edifact_unh_errors_total — mapări ratate, versiuni EDIFACT greșite, segmente lipsă.
- Duplicate și inconsistențe: edifact_unh_duplicates_total — detectate după referința de mesaj versus UNT.
- Latență end-to-end: histograme pentru processing_duration_seconds — din momentul recepției UNH până la acknowledgements (CONTRL/APERAK) sau până la livrarea în ERP.
- Backlog și saturație: queue_depth pentru cozi de prelucrare EDI, thread pool usage, conexiuni AS2/FTP.
- Integritate: mismatch-uri UNH–UNT, versiuni de subset (ex: EANCOM D.01B) vs. mapări active.
Cheia este modelarea etichetelor (labels) fără a introduce cardinalitate explozivă. Evitați să puneți în etichete ID-uri unice de UNH; păstrați-le în loguri. Folosiți în schimb: partner_id, message_type, direction, standard_version.
Exemplu de expunere Prometheus
# HELP edifact_unh_messages_total Mesaje EDIFACT contorizate la UNH
# TYPE edifact_unh_messages_total counter
edifact_unh_messages_total{partner="retailer_ro",message_type="ORDERS",direction="in",version="D96A"} 15432
edifact_unh_messages_total{partner="retailer_ro",message_type="DESADV",direction="out",version="D96A"} 9211
edifact_unh_errors_total{partner="retailer_ro",message_type="INVOIC",direction="in",version="D01B"} 37
edifact_processing_duration_seconds_bucket{partner="retailer_ro",le="1"} 1200
edifact_processing_duration_seconds_bucket{partner="retailer_ro",le="5"} 3140
edifact_processing_duration_seconds_count{partner="retailer_ro"} 3500
edifact_processing_duration_seconds_sum{partner="retailer_ro"} 6400
Alerte care contează pentru EDI în producție
Definiți alertele în jurul semnalelor “golden” (trafic, erori, latență, saturație) traduse pentru EDI.
- Spike de erori: rate(edifact_unh_errors_total[5m]) / rate(edifact_unh_messages_total[5m]) > 2% pentru 10m.
- Tăcere suspectă pe un partener critic: absent(sum by(partner)(rate(edifact_unh_messages_total{direction=”in”}[15m])) > 0) pentru 30m.
- Depășire SLO de latență: p95(edifact_processing_duration_seconds) > 60s pentru 15m.
- Duplicate detection: increase(edifact_unh_duplicates_total[10m]) > 0 pe același partner/message_type.
- ACK lipsă: diferența dintre mesaje inbound și CONTRL/APERAK corespunzătoare depășește pragul X într-o fereastră.
În Alertmanager, rulați rutare pe severitate: critice către on-call și Slack/Teams, warning în backlog Jira. În Grafana, panouri cu serie temporală per partner și un overview “semáforo” pentru SLA EDI pe tip de mesaj.
Integrarea cu platformele EDI existente
Majoritatea gateway-urilor EDI pot fi instrumentate fără a le rescrie. IBM Sterling B2B Integrator expune evenimente detaliate ce pot fi agregate într-un exporter. OpenAS2 permite hooks pentru a incrementa metrici Prometheus când se primește un UNH. SAP Integration Suite (fost CPI) poate trimite metrici în Prometheus prin OpenTelemetry Collector. Important este să standardizați nomenclatura: edifact_* pentru EDIFACT, ansi_x12_* pentru X12, și să nu scurgeți date sensibile în etichete.
KPI de business din metrici tehnice
- Fill-rate și on-time delivery: corelați DESADV/RECADV cu comenzi pentru a măsura impactul latenței EDI în SLA-uri logistice.
- Cash acceleration: latența INVOIC–ACK vs. termen de plată; alertele EDI reduc ciclul DSO prin detectarea rapidă a respingerilor.
- Conformitate cu retaileri mari: Carrefour, Kaufland, Lidl și alți jucători cer conformitate strictă pe subseturi EDIFACT; metricile pe UNH/versiune vă arată din timp când un partener migrează seturile de reguli.
Context de piață și presiuni operaționale
Adopția EDI rămâne pe un trend ascendent, stimulată de digitalizarea lanțurilor de aprovizionare și de valul de e-facturare la nivelul UE (în România, e-Factura a devenit obligatorie B2B în 2024). Furnizori globali precum SPS Commerce raportează o rețea de peste 120.000 de clienți conectați, iar OpenText și IBM domină zona enterprise cu rețele și SLA-uri stricte. În acest context, observabilitatea bazată pe UNH oferă o modalitate standardizată, independentă de vendor, de a controla calitatea execuției EDI.
Practici recomandate pentru echipele IT
- Stabiliți SLO-uri EDI: de exemplu, 99,9% din mesaje procesate sub 60s, eroare sub 0,5% per partner.
- Evitați cardinalitatea mare: nu etichetați cu ID-uri UNH; păstrați nivel partener/tip/versiune.
- Corelați metricele EDI cu transportul: AS2 MDN round-trip și erori TLS în același dashboard.
- Completați cu loguri/tracing: Grafana Loki și Tempo pentru drill-down din panelul UNH în logul mesajului sau traseul de mapare.
- Testați alertele: rulați “fire drill” lunar simulând spike de erori EDI și întreruperea traficului de la un partener.
Ce câștigă concret organizația
Cu Prometheus/Grafana ancorate în UNH, echipa EDI vede în timp real unde apar deriva de versiune, congestia pe cozi sau “șuieratul” erorilor de mapare înainte să lovească ERP-ul. Pentru it managers, it consultants, erp providers și EDI consultants, acesta este un mod pragmatic de a traduce fluxuri EDI în metri cantariți: traficul, erorile și latența. Iar pentru business, înseamnă mai puține chargeback-uri, livrări mai stabile și cash-flow predictibil.
Concluzie: monitorizarea EDI prin prisma UNH nu este doar o idee elegantă; este o disciplină operațională care face vizibile detaliile ce contează. Cu metrici clare, alerte bine calibrate și dashboard-uri Grafana orientate pe partener și tip de mesaj, veți transforma EDI din “cutie neagră” într-un sistem guvernat de date, pregătit pentru următorul salt de volum și pentru cerințele stricte ale partenerilor globali.