Changes between Version 19 and Version 20 of Documentatie/Beheerder/Installeren/Server

Timestamp:

05/09/18 23:14:29 (8 years ago)

Author:

bob

Comment:

--

Documentatie/Beheerder/Installeren/Server

@@ -182 +182 @@
 Het nummer achter "Port" moet overeenkomen met het nummer achter "!MessageQueue Poort" in de sectie "OpenAC Server" van het instellingenscherm van OpenAC 2. Door "Start" op false te zetten wordt de !MessageQueue niet gestart.
 
-== nlog.config ==
-
+
+
+== Log instellingen in nlog.config ==
+
+Indien men OpenAC3 draait in een dosbox, dan zijn hier log-regels te zien van de werking van Microsoft en andere onderdelen. Je kunt de berichten die je wilt zien instellen in appsettings.json
+sectie "Logging". Zie hier onder een voorbeeld. 
+
+- Voor appsettings de sectie "Logging" zoals hieronder weergegeven.
+Het doel hiervan is om de berichten in de console te beperken tot alleen WARN, ERROR en FATAL.
+Er zal veel minder informatie voorbij scrollen bij een instellng met ERROR, FATAL. Mocht er een error of fatal ontstaan dan kun je vervolgens in de NLog logfiles duiken.
+
+{{{
+"Logging": {
+"IncludeScopes": false,
+"LogLevel": {
+   "Default": "Warning",
+   "System": "Warning",
+   "Microsoft": "Error"
+   }
+ }
+}}}
+
+
+Als OpenAC3 als service draait heb je niets aan de logging sectie in appsettings.json. Het kan wel eens voorkomen dat je OpenAC3 tijdelijk in een dosbox wilt draaien
+bijvoorbeeld om te debuggen en dan kun je de nodige berichten beïnvloeden door deze sectie het niveau en de nodige namespace aan te passen.
+Notabene deze "Logging" instelling werken geheel los van de NLog.config instellingen en de berichten in de console worden niet gelogd in tegenstelling tot die van NLog.config 
+
+= nlog.config = 
+Het instellen van de logfile van OpenAC3 gebeurt in "%!ProgramData%\OpenACWeb\NLog.config". 
+
+Vanaf de build van 22 februari 2018 kan men het beste de volgende log instellingen gebruiken in OpenAC3:
+
+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.
+
+{{{
+ <targets>
+    <!-- write logs to file -->
+    <target xsi:type="File" name="allfile" fileName="c:\temp\openac-alles-${shortdate}.log"
+                 layout="${longdate}|${uppercase:${level}}|${event-properties:item=EventId.Id}|${logger}|${message} ${exception}" />
+
+   
+    <target xsi:type="File" name="ownFile-web" fileName="c:\temp\openac-applicatie-${shortdate}.log"
+             layout="${longdate}|${uppercase:${level}}|${event-properties:item=EventId.Id}|${aspnet-Request-IP}|${logger}|${message} ${exception}" />
+
+    <target xsi:type="Null" name="blackhole" />
+  </targets>
+
+  <rules>
+    <!--All logs, including from Microsoft-->
+    <logger name="*" minlevel="Debug" writeTo="allfile" />
+
+    <!--Skip Microsoft logs and so log only own logs-->
+    <logger name="Microsoft.*" minlevel="Debug" writeTo="blackhole" final="true" />
+    <logger name="*" minlevel="Debug" writeTo="ownFile-web" />
+  </rules>
+
+}}}
+
+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. 
+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 
+2018-02-19 13:54:31.0539|WARN||192.168.0.234|OpenACLogica.Controllers.StatusController|Here is a Warning message 
+2018-02-19 13:54:31.0769|INFO||192.168.0.234|OpenACLogica.Controllers.StatusController|Here is a Information message 
+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.