Indholdfortegnelse:

1. Introduktion og overblik

Driftsvejledningen indeholder information, som er relevant i forhold til drift af Nationalt eCPR (Herefter eCPR). Der gives en grundig introduktion til konfiguration, herunder hvilke properties der eksisterer, samt deres standard konfiguration. Dertil kommer information om hvordan systemet overvåges i form af HTTP-endpoints samt Auditlog, SLA-logning samt øvrig logning.

eCPR består af én javabaseret web-service, nemlig eCPR-service. Servicen har følgende afhængigheder: 

1. Der kræves adgang til en MariaDB datasource
2. National adviserings service 2.0 (NAS)
3. Kald til (læsning fra) CPR-Enkeltopslag (SCES)
4. Læsning fra krs-stamdata gennem 3 views

2. Konfiguration

Konfigurationen af eCPR sker i filerne i "compose/configuration" mappen som beskrevet i eCPR - Installationsvejledning. I det følgende gennemgås servicens konfigurationsfiler i detaljer:

2.1. Konfiguration af eCPR-servicen

eCPR-servicen konfigureres overordnet i ecpr2.properties filen. Nedenfor er filens properties gennemgået i detaljer:

2.2. Konfiguration af log4j-ecpr2

Log4j-eCPR2 konfigurations filen indeholder en Log4J opsætning, der følger gængs standard på NSP. Denne fil findes også i "compose/configuration", hvor eCPR generelt konfigureres.

3. Overvågning

Systemet kan overvåges via 2 http-endpoints, der viser hhv. healthstatus samt status på export history jobbet. samt forskellige logningsmetoder Disseer beskrevet nedenfor:

3.1. Http Endpoints 

I det følgende beskrives hvordan http-endpoints bruges til overvågning af eCPR:

3.1.1. Health status side (isAlive)

Servicen udstiller en Health-statusside (også typisk kendt som isAlive), der viser om servicen er sund, eller om noget kræver en indgriben. Health-statussiden returnerer en body med en tekstrække, der beskriver sundhedsstatus for forskellig funktionalitet i eCPR-applikationen. IsAlive-overvågningen udstedes på <url>/ecpr2/isAlive

Et eksempel på en sund service ses nedenfor:

Database Respond: 200 OK OK
Data Indexed: 200 OK OK

Title: ecpr2-service
Deployed: Mon Oct 23 12:35:45 CEST 2023
Build-Date: 2023-10-18T13:50:46Z
Build-Version: 1.28.18
Builder: trifork2
Display time: Mon Oct 23 16:10:27 CEST 2023
Lucene indexer job: Enabled, Last successful indexing: 2023-10-23T14:00:41.745Z, Error count: 0
Delete Reserved Person Ids job: Enabled, Last Exceeded Reserved Ids delete: Never, Error count: 0

Health Status siden returnerer HTTP statuskoden "200 OK" hvis både databasen responderer og hvis data i databasen succesfuldt er blevet indexeret af lucene. Hvis en af mulighederne ikke er sande returneres HTTP statuskoden "500 Internal Server Error".

De forskellige linjers betydning er forklaret nedenfor:

3.1.2. exportHistory

ExportHistory-endpoint bruges til overvågning af, om HistoryExport-jobbet er blevet udført succesfuldt. Hvis export-jobbet er gennemført uden fejl returneres "200 OK", mens der ved fejl returneres "500 Internal Server Error".

Export History:

Http status: 			200 OK
Error message: 			no error
Export number: 			2
Export time of last export: 	12/20/2022 19:45:05

De forskellige linjers betydning er forklaret nedenfor:

Export time of last export

3.2. Logning

eCPR-servicen logger på tre forskellige måder, som alle er uddybet nedenfor:

• Auditlog
• SLA logning
• Intern logning

3.2.1. Auditlog

Der auditlogges ved alle api requests til /pack/wildfly/standalone/log/audit.log.
Audit logning sker i filen Auditlogger.java, hvor hvert request logges med relevante informationer i sæt af (key, type, value)

Eksempelvis:

{
    "key": "context-system-id",
    "type": "NPI",
    "value": "Service Consumer Test"
}

3.2.2. SLA logning

Der SLA-logges ved kald til Lucene og til SCES.

3.2.3. Intern logning

Til intern logning bruges Log4J, hvor logningsniveauet er specificeret i log4J konfigurationsfilen. Logningen kan bruges til debugging, forudsat at logningsniveauet er sat lavt nok. Der logges "INFO" for, om ting er kørt, og "WARN" og "ERROR" bruges til logning af fejl.  

3.3. Fejlfinding

Servicens logfiler kan med fordel løbende tjekkes for Error-logninger. Derudover kan de ovenstående endpoints bruges til hhv. at se den generelle status for servicen (isAlive) samt at overvåge om export af ændringer foreløber fejlfrit.

Ændringslog