Page History
...
Til monitorering af Min Spærring services findes to servicespecifikke sniflader: servicecheck og status, beskrevet en servicespecifik status-sniflade. Med servicespecifik menes, at der findes en udgave for hhv. administration- og verification-servicen. Snitfladen beskrives i det følgende.
...
Status-snitfladen
Servicecheck-snitflade for Min Spærring servicen, der Status-snitfladen kaldes under opstart af servicen, kontrollerer tilgængelighed (og i et vist omfang indhold) af property-filer og afprøver aktivt forbindelsen til databaser.
Specielt vedrørende testConnection på JBoss
På grund af en kendt fejl i JBoss 6, logges en række exceptions i server loggen, hvis følgende filer ikke findes (de må gerne være tomme):
Code Block |
---|
/pack/jboss/server/default/conf/props/roles.properties
/pack/jboss/server/default/conf/props/users.properties |
Konfiguration af databasemonitorering
Snitfladen laver endvidere passiv opsamling af resultater ved kald af database. Status-snitfladen opsamler data på hvor mange kald til database, der er fejlet, og melder fejl hvis det overstiger de threshold-værdier, der er defineret i property-filen for hhv. Min Spærring administrationsservicen og Min Spærring verifikationsservicen.
Konfiguration af databasemonitorering
Databasemonitoreringen fungerer ved at lave Databasemonitoreringen fungerer ved at lave en simpel query mod Min Spærring databasens tabeller. Der laves en query mod hver tabel. Disse queries er justerbare og kan ændres i hhv. ConsentAdministration.properties og ConsentVerification.properties.
Code Block |
---|
databasecheck.statement.consent=SELECT * FROM consent.consentitem LIMIT 1; databasecheck.statement.what=SELECT * FROM consent.whatitem LIMIT 1; databasecheck.statement.who=SELECT * FROM consent.whoitem LIMIT 1; whitelistds.statement=SELECT * FROM whitelist.whitelist_config LIMIT 1; |
Test af
...
monitorering af status
Til Servicecheck-snitfladen findes en servlet i Min Spærring services.
Efter konfiguration og deploy af Min Spærring servicenservices, kan den testes med:
Code Block |
---|
curl –i localhost:8081/consent-administration/info/servicecheckstatus curl –i localhost:8080/consent-verification/info/servicecheckstatus |
Servicen returnerer følgende http koder:
Der returneres http kode 200 ved normal situation.
http fejlkode 404 returneres hvis servicen ikke er deployeret
Hvis databasen ikke er tilgængelig eller ved en eller flere af afhængighederne mangler eller ved intern fejl i WildFly returneres kode 500. Fejlbeskeden vil kunne ses i consentadministration-servicecheck.log eller consentverification-servicecheck.log alt efter hvilken service der er kaldt. Såfremt der ikke er nogen fejlbeskeder i loggen bør property-filen undersøges som det første, da det er herigennem logindstillingerne bestemmes.
Status-snitfladen
Status-snitfladen laver passiv opsamling af resultater ved kald af database. Status-snitfladen opsamler data på hvor mange kald til database, der er fejlet, og melder fejl hvis det overstiger de threshold-værdier, der er defineret i property-filen for hhv. Min Spærring administrationsservicen og Min Spærring verifikationsservicen.
Test af monitorering af status
Efter konfiguration og deploy af Min Spærring services, kan den testes med:
Code Block |
---|
curl –i localhost:8081/consent-administration/info/status
curl –i localhost:8080/consent-verification/info/status |
Servicen returnerer følgende http koder:
...
Der returneres http kode 200 ved normal situation.
...
http fejlkode 404 returneres hvis servicen ikke er deployeret
...
Svaret indeholder information om, hvilke tjek der er udført, og om de gik godt eller dårligt. Nedenfor vises et eksempel på et sådan svar, ved kørsel af curl -i http://localhost:8080/consent-verification/info/status:
Code Block |
---|
HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Transfer-Encoding: chunked
Content-Type: text/plain;charset=ISO-8859-1
Date: Mon, 13 Sep 2021 12:57:35 GMT
200 OK
Component: consent-verification-service
Test run: Mon Sep 13 14:57:35 CEST 2021
Deployed: Mon Sep 13 14:22:01 CEST 2021
Properties check: All expected properties located in property file.
Datasource health check: All expected datasources available.
Datasource stability check: OK
SOR liveness check: OK. |
Resultatet af de udførte tjek bliver også skrevet til en af filerne consentadministration-status.log og consentverification-status.log. Såfremt der ikke er
...
nogle fejlbeskeder i loggen bør property-filen undersøges som det første, da det er herigennem logindstillingerne bestemmes.
Overvågning
Min Spærring verifikations- og administrationsservices overvåges af en servicespecifik servicechecksnitflade samt en statussnitflade. Disse snitfladers url’er kan aflæses i afsnit 2.
...
Auditlogning is done using the official NSP Audit Log modul.
De forskellige håndtag logges på følgende måde.
Min Spærring verificering Audit data
...
...