Versions Compared

Key

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

...

LogningspunktKomponent

Eksempel på message fra applikationsloggen

(formatteret så det er lettere at læse i denne vejledning)

Der logges når der oprettes et PullPoint. Hertil medtages yderligere information, så som ejeren, evt. abonnement og URL, der er tilknyttet.

PullPointFactory

Service

STATISTIK: {
"action":"createPullPoint",
"info":{
"pullPointId":"98a3f337-4a65-45db-9001-2c9f0b69ff05",
"ownerItSystem":"NAS2UnitTests",
"ownerCvr":"46837428"}}

Logning af alle forespørgsler til Pull Point service herunder antal af adviseringer, der medtages i svaret.

Der logges også om der var tale om replay (DGWS).

PullPoint

Service

STATISTIK: {
"action":"getmessages",
"info":{
"pullPointId":"2acedce5-c00a-40bc-8ddf-fe6de2a596a3",
"subscriptionIds":["a34c720f-9c26-4832-83d1-8671d4b6f7f3"],
"quota":2,
"replay":false}}

Alle kald til Notification Broker skal ligeledes logges sådan at antal af adviseringer modtaget kan uddrages. Her vil topic også medtages.

NotificationBroker

Service

STATISTIK: {
"action":"notify",
"info":{
"quota":1,
"topic":"TESTNAS-TOPIC1"}}
Offsets statistik log logger information omkring subscription og offsets på subscription og offsets i Kafka.PullPoint service
STATISTIK: {
"action":"offsets",
"owner":["46837428NAS2UnitTests"],
"e
ndOffsets":["146","72","72"],
"maxOffsetDelta":["17"],
"pullPointId":["d43c793f-b29a-4d61-b9db-5970e2fc65f0"],
"deltaOffsets":["17","16","17"],
"topic":["topic"],
"subscriptionId":["d8274761-4c27-40d4-bef3-31cec848f5a6"]
}

For alle kald til Notifikation Broker logges det om et request indeholder DGWS headers.
Dermed er muligt at overvåge dette i forbindelse med udfasningen af muligheden for at kalde uden.

NotificationBroker

Service

STATISTIK: {
     "action":"notify",
     "info":{"No security headers found. Notification request is without DGWS protection"}
}

Oprydning

Der kan foretages oprydning af abonnementer og nasconsumers i databasen.
Der konfigureres hvor gamle abonnementer må være – se tidligere – og så sker oprydningen når oprydningsservicen kaldes.
Nasconsumers fjernes i batches af 20. 

Kald laves på følgende URL: http://NAS/cleanup/start (et simpelt GET request er tilstrækkeligt). Svaret for kaldet vil være 200 medmindre der er gået noget galt. Derudover svares der med hvor mange henholdsvis abonnementer og nasconsumers, der er blevet fjernet.

Statussiden for cleanup servicen: http://NAS/cleanup/status viser status for seneste oprydningsjob på instansten, og her bemærkes at status gemmes i memory og ikke representere status på tværs af instanser. 

Persistere offsets for tilbagespoling af subscription

Subscriptionmanager servicen udstiller en service til at persistere offsets for alle topics. Disse data kan bruges til at spole en subscription tilbage til et givent tidspunkt. Servicen skal kaldes med regulære mellemrum. og kan tilgås på føglende URL: http://nas/subscriptionmanager/saveOffsets. Hvis kaldet går godt returneres der HTTP 200 med nedenstående body.

Code Block
languagejs
{"rowsDeleted":0,"rowsInserted":6}

Databasen

Database modellen er beskrevet i NAS2 - Design og arktitekturbeskrivelse.

DKS-snitflader

Relevante services udstiller deres DKS-snitflade på endpointet "/dks".  I skrivende stund findes følgende:

  • <serverurl>/idlist/service/dks
  • <serverurl>/subscriptionmanager/service/dks
  • <serverurl>/pullpointfactory/service/dks
  • <serverurl>/pullpoint/service/dks

Test af DKS

Efter konfiguration og deployment af NAS2, kan en given DKS-snitfladen testes i stil med følgende:

Code Block
languagebash
curl -i http://localhost:8080/pullpointfactory/service/dks

Eksempel på output:

...

languagexml

...

DKS-snitflader

Relevante services udstiller deres DKS-snitflade på endpointet "/dks".  I skrivende stund findes følgende:

  • <serverurl>/idlist/service/dks
  • <serverurl>/subscriptionmanager/service/dks
  • <serverurl>/pullpointfactory/service/dks
  • <serverurl>/pullpoint/service/dks

Test af DKS

Efter konfiguration og deployment af NAS2, kan en given DKS-snitfladen testes i stil med følgende:

Code Block
languagebash
curl -i http://localhost:8080/pullpointfactory/service/dks

Eksempel på output:

Code Block
languagexml
HTTP/1.1 200 OK
Connection: keep-alive
Transfer-Encoding: chunked
Content-Type: text/xml;charset=UTF-8
Date: Thu, 18 Jan 2024 09:28:28 GMT

<?xml version="1.0"?><root xmlns="http://nspop.dk/2014/04" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://nspop.dk/2014/04 dks.xsd">    <dksVersion>1</dksVersion>    <timestamp>2024-01-18T09:25:06+01:00</timestamp>    <name>pullpointfactory</name>    <endpoint>http://localhost:8080/pullpointfactory/service</endpoint>    <operations>    <action name="http://docs.oasis-open.org/wsn/bw-2/CreatePullPoint/CreatePullPointRequest"><model>synchronous_timeout</model><timeoutMillis>120000</timeoutMillis><idCardLevel>VOCES</idCardLevel></action>    </operations></root>

Oprydning

Der kan foretages oprydning af abonnementer og nasconsumers i databasen.
Der konfigureres hvor gamle abonnementer må være – se tidligere – og så sker oprydningen når oprydningsservicen kaldes.
Nasconsumers fjernes i batches af 20. 

Kald laves på følgende URL: http://NAS/cleanup/start (et simpelt GET request er tilstrækkeligt). Svaret for kaldet vil være 200 medmindre der er gået noget galt. Derudover svares der med hvor mange henholdsvis abonnementer og nasconsumers, der er blevet fjernet.

Statussiden for cleanup servicen: http://NAS/cleanup/status viser status for seneste oprydningsjob på instansten, og her bemærkes at status gemmes i memory og ikke representere status på tværs af instanser. 

Persistere offsets for tilbagespoling af subscription

Subscriptionmanager servicen udstiller en service til at persistere offsets for alle topics. Disse data kan bruges til at spole en subscription tilbage til et givent tidspunkt. Servicen skal kaldes med regulære mellemrum. og kan tilgås på føglende URL: http://nas/subscriptionmanager/saveOffsets. Hvis kaldet går godt returneres der HTTP 200 med nedenstående body.

Code Block
languagejs
{"rowsDeleted":0,"rowsInserted":6}

Databasen

Database modellen er beskrevet i NAS2 - Design og arktitekturbeskrivelse.