Log instellingen

Het instellen van de logfile van OpenAC3 gebeurt in "%ProgramData%\OpenACWeb\NLog.config". Indien men OpenAC3 draait in een dosbox, dan zijn hier log-regels in te zien. De log-regels die te zijn in de console worden ingesteld in appsettings.json sectie "Logging". Deze worden niet gelogged. Deze instelling werkt los van de NLog.config instellingen. Deze instellingen gelden dus niet voor OpenAC3 die als service draait.

Voor OpenAC2, zover ik weet is het log-formaat niet instelbaar. De log-file staat in "%AppData%\OpenAC\sessie.log". Zodra je OpenAC2 sluit, worden de laatste log-regels uit geheugen weggeschreven naar de log-file. Elke keer als je OpenAC2 start wordt de vorige logfile overschreven!! Maak even een kopie als je denkt dat er iets belangrijk in staat.

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 is het advies om het formaat ${longdate}|${uppercase:${level}}| aan het begin van een regel te zetten. 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. 

Logregels kunnen uitgevoerd worden naar aparte bestanden. Om bijvoorbeeld alle fouten in een los bestand te verzamelen kan een nieuw target met rule gedefinieerd worden. Match de waarde van het "writeTo" attribuut met de naam van het target.

 <targets>
    ...
    <target xsi:type="File" name="errorfile" fileName="c:\temp\openac-errors-${shortdate}.log"
                 layout="${longdate}|${uppercase:${level}}|${event-properties:item=EventId.Id}|${logger}|${message} ${exception}" />


  <rules>
     ...
	<logger name="*" minlevel="Error" writeTo="errorfile" />

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.