Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Navitabs
rootAntigen Indlæser - Leverancebeskrivelse
firsttabYder Indlæser - Leverancebeskrivelse
includeroottrue


Table of Contents

Indledning

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

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

Hvordan agerer Antigentest indlæseren

...

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.

...

  • Afhængighedsproblemer (fx. ingen forbindelse til kilden)
  • Hvis håndteringen af et modtaget batch ikke er færdiggjort efter X timer pga. manglende kvittering fra Synlab, hvor X er konfigurerbart.

...

  • 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

Image Added

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

Image Added

Fejl ved adgang til data kilden

Image Added

Fejl ved indlæsning af data

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

Image Added

Data overholder ikke overordnet struktur - hele datasættet afvises

Image Added

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

Image Added

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

Code Block
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

Code Block
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

Code Block
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

Code Block
{"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"}