[[TOC(heading=Loggen)]]
[[TOC(heading=Moduleconfiguratie, sectionindex, compact, depth=3, allactive, Documentatie/Beheerder/Modules/)]]
[[TOC(heading=Beheerder, sectionindex, compact, depth=2, allactive, indirect=Documentatie/Beheerder/TOC)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

= Log instellingen =

Het instellen van de logfile voor OpenAC3 gebeurt in %programdata%\OpenACWeb\NLog.config 
De log-regels in de console worden ingesteld in appsettings.json sectie "Logging". Deze worden niet gelogged. Deze instelling werkt los van de NLog.config instellingen.

Voor OpenAC2, zover ik weet is dit niet instelbaar. De log-file staat in %AppData%\OpenAC\sessie.log Zodra je OpenAC2 sluit wordt het laatste gedeelte dat in de geheugen buffer staat naar de log-file geschreven.
Elke keer als je OpenAC2 opnieuw opstart wordt de vorige OpenAC2 logfile overschreven.

== OpenAC3 Log instelling ==
Vanaf de build van 22 februari 2018 kan men het beste de volgende log instellingen gebruiken in OpenAC3:

- 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 en bij een ERROR, FATAL kan men de logfiles in duiken.
Deze instellingen zijn NIET verplicht maar wel handig om eventuele fouten of warnings te zien als je zo nu en dan naar de console kijkt.

{{{
"Logging": {
"IncludeScopes": false,
"LogLevel": {
   "Default": "Warning",
   "System": "Warning",
   "Microsoft": "Error"
   }
 }
}}}

Voor NLog.config het advies om het formaat {{{ ${longdate}|${uppercase:${level}}|  }}} aan het begin van een regel te zetten.
Wat wel ten strengste aangeraden wordt is 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.

== OpenAC2 Log instelling ==

Gebruik de instellingen zoals je ze nu in gebruik hebt voor OpenAC2 en anders kijk deze af van de Starterkit instellingen.