Indledning

Nærværende dokument udgør driftsvejledningen for Antigentest indlæseren.

Antigentest indlæsen har til opgave at indlæse en JSON fil med EU godkendte Covid-19 Antigentest devices og gemme data om hvert device i en database. JSON filen kommer fra et kald til en https URL udstillet af NSP Proxy.

Hvordan agerer Antigentest indlæseren

Antigentest indlæseren anvendes til at hente og vedligeholde data om Antigentest enheder der er godkendte i Europa.

Denne information bliver f.eks. anvendt til Corona-passet for at afgøre om en given test er udført med en godkendt enhed.

Monitoreringssnitflader

Alle indlæsere overvåges via en simpel statusservice. (Se evt. https://www.nspop.dk/display/public/web/Husregler+for+udvikling+til+NSP#HusreglerforudviklingtilNSP-Snitfladetilmonitorering(gl4.4)).

Statusservicen kan tilgås på URL http://<host>:<port>/antigentestindlaeser/status hvor <host> og <port> peger på den aktuelle installation.

Denne statusservice bliver overvåget ved at den bliver kaldt hver 10. sekund. Denne returnerer en HTTP status kode, som enten er 200 (ok) eller 500 (internal server error). Ved 500 er det tegn på, at en NSP driftleverandøren skal i gang med at undersøge problemet.

Statusservicen giver udslag i følgende situationer, som vil sætte support i gang:

  • Afhængighedsproblemer (fx. ingen forbindelse til kilden)
  • Værdier i de hentede date overholder ikke formatet eller værdier overstiger den allokerede længde i databasen

De mulige svar fra statusservicen er:

OK status

Ved normal drift vil statusservicen returnere http 200 med denne information

Ikke Ok status

Opstår som følge af HTTP 500 status kode og kræver NSP driftleverandørens umiddelbare opmærksomhed. De mulige situationer, hvor HTTP 500 status kode leveres er beskrevet herunder.

Fejl ved adgang til databasen

Fejl ved adgang til data kilden

Fejl ved indlæsning af data

Værdi i data overstiger allokeret felt I databasen - enkelte elementer indlæses ikke

Data overholder ikke overordnet struktur - hele datasættet afvises

Elementer i data overholder ikke strukturen - enkelte elementer indlæses ikke

Generelle overvågningssnitflader

Ingen - ud over den beskrevne statusservice.


Service snitflader

Ingen.


Fejlhåndtering

Ingen - ud over hvad der rapporteres gennem statusservicen.


Logning

Under håndtering af en fil logges der til nsputil-sla.log, antigentestAudit.log, antigentestApplication.log og antigentestStat.log:

nsputil-sla.log

09-06-2021 10:56:30,355 [default task-1] INFO  dk.sdsd.nsp.slalogdata - LogPoint="LoggerBean" LogPointUniqId="LoggerBean" StartTime="2021-06-09 10:56:30.354" EndTime="2021-06-09 10:56:30.354" Duration="245 microseconds" MessageId="8024d49a-af89-45f9-ae8f-45baa8eec79a" RequestSize=0 ReplySize=0 Result=OK ClientIP="<empty>" SOAPOperation="DataSet received" SOAPEndpoint="<empty>" SOAPAction="<empty>" TargetSOAPOperation="<empty>" TargetSOAPEndpoint="<empty>" GenericCallParms(1)= { ("Input","<empty>") }
09-06-2021 10:56:40,053 [Camel (camel-1) thread #1 - AggregateTimeoutChecker] INFO  dk.sdsd.nsp.slalogdata - LogPoint="LoggerBean" LogPointUniqId="LoggerBean" StartTime="2021-06-09 10:56:30.354" EndTime="2021-06-09 10:56:40.051" Duration="9697149 microseconds" MessageId="8024d49a-af89-45f9-ae8f-45baa8eec79a" RequestSize=0 ReplySize=0 Result=OK ClientIP="<empty>" SOAPOperation="DataSet completed" SOAPEndpoint="<empty>" SOAPAction="<empty>" TargetSOAPOperation="<empty>" TargetSOAPEndpoint="<empty>" GenericCallParms(1)= { ("Input","<empty>") }

antigentestAudit.log

timestamp="2021-06-09 10:56:24,036" priority="WARN" class="dk.nsi.sdm.antigentest.monitoring.StatusService" message="Fetching data"
timestamp="2021-06-09 10:56:30,557" priority="INFO" class="dk.nsi.sdm.antigentest.bean.LoggerBean" message="The dataset 8024d49a-af89-45f9-ae8f-45baa8eec79a has been preparsed"
timestamp="2021-06-09 10:56:39,073" priority="INFO" class="dk.nsi.sdm.antigentest.bean.LoggerBean" message="The dataset 8024d49a-af89-45f9-ae8f-45baa8eec79a has been parsed and splitted"
timestamp="2021-06-09 10:56:40,056" priority="INFO" class="dk.nsi.sdm.antigentest.bean.LoggerBean" message="The dataset 96f510a5-9ebb-4413-8d08-50dee7467e9e has been completed with status Completed"

antigentestApplication.log

timestamp="2021-06-09 10:56:30,557" priority="INFO" class="dk.nsi.sdm.antigentest.bean.LoggerBean" message="The dataset 8024d49a-af89-45f9-ae8f-45baa8eec79a has been preparsed"
timestamp="2021-06-09 10:56:39,073" priority="INFO" class="dk.nsi.sdm.antigentest.bean.LoggerBean" message="The dataset 8024d49a-af89-45f9-ae8f-45baa8eec79a has been parsed and splitted"
timestamp="2021-06-09 10:56:39,075" priority="DEBUG" class="dk.nsi.sdm.antigentest.parser.AntigentestParser" message="Parsed 315 Antigettestdevices"
timestamp="2021-06-09 10:56:40,056" priority="INFO" class="dk.nsi.sdm.antigentest.bean.LoggerBean" message="The dataset 96f510a5-9ebb-4413-8d08-50dee7467e9e has been completed with status Co
mpleted"

antigentestStat.log

{"Time to preparse":"PT0.059S","Persisted records":"Written Antigentests: 479, Updated Antigentests: 0, Deleted Antigentests: 0","Parsed records":"Parsed 481 Antigettestdevices","Application":"AntigentestIndlæser","Timestamp":"2021-11-22 22:32:50,592","Processing Time":"PT18.591S","ExchangeId":"d6ce28cc-398f-41fb-969c-550a028d2923","Time to parse and split":"PT11.61S"}
  • No labels