Document toolboxDocument toolbox

LOG - Eisen (en aanbevelingen) voor logging

#EisFHIR serviceBron applicatieDomein
001Koppeltaal maakt gebruik van AuditEvents voor het vastleggen van gebeurtenissen in de vorm van een logboek.xxx
002AuditEvents zijn onveranderlijk (immutable) en mogen onder geen geding gewijzigd worden. x

003De FHIR resource service is verantwoordelijk voor het loggen van de gebeurtenissen die voortkomen uit de interactie met de FHIR resource service. De applicaties in het domein zijn verantwoordelijk voor het loggen van gebeurtenissen rondom de launch en de logging van eventuele problemen die zich voordoen met het verwerken van resources in de eigen database, zowel resources die uit eigen initiatief verwerkt worden, in de context van een launch of in de context van een notificatie van een abonnement (Subscription). xx
004Het formaat van de FHIR AuditEvent resource wordt in XML of JSON formaat aangeleverd.xx
005Koppeltaal Logging voldoet aan de wet en regelgeving zoals AVG, WGBO, WABVPZ, NEN-7510, NEN-7513 en WEGIZ.xxx
006In de interactie met de FHIR resource service dient gebruik gemaakt te worden van de tracing headers X-Request-Id, X-Correlation-Id  en X-Trace-id. De waarde van deze headers MOET gelogd worden in AuditEvents indien deze van toepassing zijn.xx
007Elk request ZOU een uniek  X-Request-Id header moeten hebben dat bestaat uit een globaal unieke waarde. Hier wordt aangeraden van een uuid v4 gebruik te maken. Indien een request wordt uitgevoerd zonder X-Request-Id header MAG de ontvangende partij een waarde voor het veld genereren.xx
008Een request MAG een X-Correlation-Id header hebben, deze moet gevuld zijn met de X-Request-Id van het bovenliggende request. Het is niet toegestaan deze te vullen met enkel nullen.xx
009Een request MAG een X-Trace-id header hebben, deze moet gevuld zijn met een gegenereerde waarde als de aanvrager de initiërende partij van het request is. Indien de header aanwezig is MOET deze ongewijzigd doorgegeven worden aan de onderliggende requests in de X-Trace-id header. Indien de  X-Trace-id header ontbreekt en er toch sprake is van onderliggende requests MAG de uitvoerder van de onderliggende requests de waardevan de  X-Request-Id header van het bovenliggende request gebruiken.