Changes between Version 30 and Version 31 of Documentatie/Beheerder/Installeren/Server

Timestamp:

May 11, 2018 8:57:43 AM (8 years ago)

Author:

henk

Comment:

--

Documentatie/Beheerder/Installeren/Server

@@ -188 +188 @@
 Configuratie van de logbestanden.
 
-Voor NLog.config is het advies om het formaat {{{ ${longdate}|${uppercase:${level}}|  }}} aan het begin van een regel te zetten. Aangeraden wordt door ons om beide rules, minLevel op "Debug" of "Trace" te zetten.
-Hierdoor krijgt Fenac uitgebreide berichten van de werking van OpenAC3. Dit helpt uiteraard bij het uitzoeken van een functionaliteit bugs waarbij er geen ERROR optreedt.
+Voor het aanmaken van logbestanden gebruikt OpenAC de logmodule NLog. NLog moet worden geconfigureerd met het configuratiebestand nlog.config waarvan hieronder een voorbeeld te zien is:
 
 {{{
@@ -215 +214 @@
 }}}
 
-Let op!! neem ook de instelling {{{ ${aspnet-Request-IP} }}} mee in het log-formaat zodat Fenac en beheerders het IP-adres zien van de cliënt-stations (waar de webrowser op draait).
-Verder heeft de AC beheerder de url {{{ http://openac3-server:poort/logleveltest }}} ter beschikking om de gewenste log werking te toetsen nadat je de log settings hebt aangepast.
-
-Fragment van een log met boven beschreven setting:
-
-{{{
-
-2018-02-19 13:53:54.2743|INFO|||CsMq.MQServer|MessageQueue started at 0.0.0.0:3800  
-2018-02-19 13:53:54.2743|INFO|||OpenACCommon.SSL.Client|Using non-SSL client. 
-2018-02-19 13:53:54.3063|DEBUG|||OpenACLogica.ZorgdomeinVerwijzingen.VerwijzingenCheck|Ophalen verwijzingen voor AGB-locatie Gestel. 
-2018-02-19 13:53:54.3214|DEBUG|||OpenACLogica.ZorgdomeinVerwijzingen.VerwijzingenCheck|Ophalen http://zd.fenac.nl:5000/api/verwijzingen/19009349 
-2018-02-19 13:53:54.5335|ERROR|||OpenACLogica.ZorgdomeinVerwijzingen.VerwijzingenCheck|Check verwijzingen: kan url http://zd.fenac.nl:5000/api/verwijzingen/19009349 niet bereiken. Foutmelding: An error occurred while sending the request. 
+Begin met het instellen van de gewenste logdirectory. Standaard staat deze ingesteld op c:\temp. Vergeet niet dat de logdirectory moet bestaan en dat OpenAC moet kunnen schrijven naar deze directory.
+
+De volgende stap is het instellen van het minimum loglevel. NLog kent een aantal loglevels en alles wat OpenAC logt met het minimum level **en hoger** komt in de logbestanden terecht. Dus hoe hoger het minimum loglevel, hoe minder er in de logbestanden komt.
+
+De loglevels zijn in aflopende volgorde:
+
+||**Fatal**||Alleen fatale fouten||
+||**Error**||Fouten en hoger||
+||**Warn**||Waarschuwingen en hoger||
+||**Info**||Meldingen en hoger||
+||**Debug**||Debug-meldingen en hoger. Bedoeld om fouten op te sporen||
+||**Trace**||Trace-meldingen en hoger. Logt het begin en einde van elke functie-aanroep. Genereert extreem veel logmeldingen||
+
+We adviseren om minlevel in te stellen op "Info". Bij het oplossen van problemen zal de FENAC soms vragen om minlevel tijdelijk op "Debug" of "Trace" te zetten.
+
+Ook het formaat van elke logregel kan worden geconfigureerd met nlog.config. Hiervoor kun je een regel-template opgeven achter het keyword "layout". De variabelen die je in de regel-template kunt gebruiken kun je terugvinden in de NLog-documentatie op https://github.com/nlog/nlog/wiki/Layout-Renderers. Let wel dat het mogelijk is dat de versie van NLog die OpenAC gebruikt niet alle variabelen ondersteunt die in de documentatie zijn terug te vinden.
+
+We adviseren om {{{ ${longdate}|${uppercase:${level}}|  }}} aan het begin van elke logregel te zetten. Ook kan het handig zijn om {{{ ${aspnet-Request-IP} }}} op te nemen zodat het IP-adres van elke client wordt gelogd.
+
+Met de url {{{ http://<openac3-server>:<poort>/logleveltest }}} kan de logconfiguratie worden getest. Dit genereert entries in het log die er afhankelijk van de configuratie ongeveer als volgt uitzien: 
+
+{{{
 2018-02-19 13:54:31.0369|FATAL||192.168.0.234|OpenACLogica.Controllers.StatusController|Here is a Fatal message. 
 2018-02-19 13:54:31.0539|ERROR||192.168.0.234|OpenACLogica.Controllers.StatusController|Here is a Error message 
@@ -233 +242 @@
 2018-02-19 13:54:31.0879|DEBUG||192.168.0.234|OpenACLogica.Controllers.StatusController|Here is a Debug message. 
 2018-02-19 13:54:31.1013|DEBUG||192.168.0.234|OpenACLogica.Controllers.StatusController|Here is a DebugInfo message. 
-
-}}}
-
-setting {{{ ${event-properties:item=EventId.Id} }}} wordt nog nader uitgezocht hoe dit te activeren. Voorlopig resulteert dit een lege veld.
+}}}
+