Ketenmonitoring logging

Wat is ketenmonitoring binnen MedMij (via de logging interface)

• Ketenmonitoring is in dit kader een extra laag bovenop de reguliere logging die deelnemers (zoals DVP’s, DVA’s) al uitvoeren binnen het MedMij-ketenverkeer.

• Concreet betekent dit dat gebeurtenissen in de communicatie tussen verschillende schakels (“in de keten”) expliciet worden vastgelegd volgens een afgesproken format (logregels).

• Deze loggegevens worden vervolgens aangeboden aan Stichting MedMij — in de vorm van verzamelingen logregels.

• De logregels bevatten gestandaardiseerde informatie zoals:

  1. event — welk type gebeurtenis (bijv. “send_authorization_request”, “receive_token_response”)

  2. location, datetime, session_id, trace_id — metadata om het moment, de bron/locatie en de context van de gebeurtenis te identificeren

  3. request object — met gegevens over het verzoek (method, client_id, server_id, URI, en soms extra attributen zoals provider_id, service_id)

  4. response object — met informatie over het antwoord (zoals naar welk request het hoort, HTTP status)

  5. error object — wanneer een fout optreedt: foutcode, omschrijving etc.

  6. Bij specifieke gebeurtenissen kan additionele data worden gelogd (bijv. welke gegevens succesvol zijn opgehaald, welke niet)

• Deelnemers zijn verplicht bepaalde gebeurtenissen te loggen — niet alleen interne acties, maar ook interacties tussen schakels (zoals “send_resource_request”, “receive_resource_response”, fouten, beschikbaarheidstoetsen, etc.).

• De logregels moeten voldoen aan bepaalde eisen (zoals JSON-format, juiste attributen, consistente identificatoren) en moeten op een afgesproken manier aangeleverd worden aan MedMij.

Zie https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/logging-interface van het Medmij Afsprakenstelsel voor meer informatie.

Wat is het doel van ketenmonitoring in MedMij

1. Sneller verstoringen signaleren en herstellen
   Door centrale inzage in de loggegevens van alle schakels kan Stichting MedMij eerder en beter problemen of storingen in de keten oppakken. Dit leidt ertoe dat de duur van storingen vermindert en dat gebruikers van PGO’s (personen) minder hinder ondervinden.

2. Inzicht in kwaliteit en volledigheid van uitwisseling
   Met de verzamelde loggegevens kan MedMij analyses uitvoeren: bijvoorbeeld hoe vaak een verzoek succesvol is, hoeveel data-elementen ontbreken, waar in de keten fouten optreden, of de uitwisseling op tijd gebeurt, etc. Dit biedt zicht op zwakke punten in de keten.

3. Verbetering van de gegevensuitwisseling
   Door gebruik te maken van de inzichten uit de ketenmonitoring kunnen partijen verbeteringen doorvoeren: robuustere interfaces, minder foutgevoeligheid, optimalisatie van performance, etc. Zo draagt het bij aan een betrouwbaardere en efficiëntere keten.

4. Ondersteunen van vertrouwen en toezicht
   Omdat MedMij een centrale rol heeft in het afsprakenstelsel en toezicht op naleving, geeft de ketenmonitoring middelen om te controleren of de deelnemers zich houden aan de afspraken, de kwaliteit van dienstverlening, en of de technische interfaces correct functioneren.

5. Bevorderen van adoptie
   Wanneer uitwisseling betrouwbaarder wordt en storingen minder voorkomen, zal het vertrouwen in het systeem toenemen — dit kan een stimulans zijn dat meer partijen daadwerkelijk gaan aansluiten en gebruiken.

TODO: dashboard gemaakt door Medmij beheer en beschikbaar voor DVA/DVP, wat willen zij hierin zien en wat moet er voor aangeleverd worden.