Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Digital Post Adapter
    • Type: Webservice
    • Filnavn: digital-post-adapter.war
    • Statusurl: <serverurl>/digitalpost/status
    • Alarmurl: <serverurl>/digitalpost/alarm
    • Joburl: <serverurl>/digitalpost/sendDigitalPost
    • Endpoint for SendDigitalPost:
      • Url: <serverurl>/digitalpost/2024/05/29/send

...

  • STS
  • PersonInformationService
  • DigitalPostKomponent
    • Her vil fejl i servicen ikke resultere i fejl i DPA, men vil blot resultere i genudsendelse af kald på et senere tidspunkt

Aktivering af job

DPA forventer at modtage et kald til <serverurl>/digitalpost/sendDigitalPost med jævne mellemrum, f.eks. hvert 5. minut.

Dette kald vil føre til afsendelse af de breve der ved kald til SOAP-endpointed er skrevet i databasen, og de breve der ved tidligere aktiveringer af dette job er fejlet.

Konfiguration

Komponenterne afvikles i et docker-compo3 setup, som ligger under https://git.nspop.dk/projects/COM/repos/digital-post-adapter/browse/compose.

...

Konfiguration af SLA-log findes i filen: compose/configuration/nspslalog-dpa.properties filen

...

Code Block
INSERT INTO whitelisting (persistent_unique_key, it_system_name, template_id)
VALUES ('some-key-here', 'some-it-system-name-here', 'fgvhr/20241218/BekraeftelseRegistreringFravalg');


Service konfiguration

Konfigurationen af servicen findes i: compose/configuration/dpa.properties filen

PropertyBeskrivelsePåkrævet
dpk.urlURL til Digital Post KomponentJa
person_information.urlURL til Person InformationJa
datasource.jndiNavn på jboss datasource (defineret i dpa-ds.xml)Ja

Monitorering

Til statuscheck af DPA udstilles <serverurl>/digitalpost/status som returnerer HTTP 200 hvis servicen i øjeblikket kører fint og HTTP 503 hvis der er opstået en fejl der kræver indgriben.

Overvågning

DPA overvåges ...

Placering af HTML overvågningsside

..på <serverurl>/digitalpost/alarm.

Fortolkning af HTML overvågningsside

Alle overvågningssider Overvågningssiden returnerer enten status 200 hvis de i øjeblikket kører fint, status 404 hvis servicen ikke er deployeret , .... og status 500, hvis der er opstået en fejl, og komponenten derfor ikke virker korrekt.

Derudover returneres evt. følgende fejlbeskeder hvis de er opfyldt:

  • "Database tabellen digitalpost har flere records med error_counter højere end tilladt. Det nuværende antal er: %d."
  • "Database tabellen digitalpost har breve som er usendte i en længere periode en tilladt. Perioden er: %s.

...

  • Det nuværende antal er: %d."
  • "Følgende fejl er forekommet for letter %s og %d andre: %s"
  • "Følgende fejl er forekommet for letter %s: %s"

Fejlbeskederne med fejl angiver altid den seneste fejl for et givet brev.

Overvågningstype

Som udgangspunkt overvåges følgende:

Audit log

Auditlogning foretages med ...

De forskellige ITI-håndtag logges på følgende måde:

Standard fejlsøgning

  • Ved problemer med indlæsning af servicens konfigurationsfiler (...) bør man verificere at ...alle påkrævede properties er sat
  • Ved manglende logning hvor der forventes fejlbeskeder bør konfigurationsfilen (log4j...) properties checkes, da logindstillingerne sættes herigennem.
  • En service eller et job kan stoppes og startes gennem docker.

...

Dokument Historik

3/4 2025Martin Henriksen/SDSEtablering af dokumentation
4/6 2025Markus Andreassen/TriforkUdfyldelse af dokumentation