Difference between revisions of "HowTo:Configure Logging"

Latest revision as of 11:23, 24 November 2020

Configure Logging for Version 3.5 or earlier

By default, logging is switched on using default setttings, for example for the destination path of the logging files. See Logging.config for an example of a configuration file for logging.

Switch off logging

Turning off logging can be done by setting the switchValue in the Category Source to Off in the corresponding config files:

UBIK.Studio.exe.config for UBIK^® Studio
Web.config for the webservice

Configure logging

Instead of editing the config files, it is also possible to use the graphical configuration tool from the Enterprise Library. After installing the package open the config file with the tool and switch on or off logging for each category as shown.

@@ Line 1: / Line 1: @@
-Logging in {{UBIK}} can be configured for the Web Service as well as for the UBIK.Studio. The general configuration for logging is described [http://msdn.microsoft.com/en-us/library/ms733830%28v=vs.110%29.aspx here].
+== Configure Logging for Version 3.5 or earlier ==
+By default, logging is switched on using default setttings, for example for the destination path of the logging files. See [[Configuration_Files/Logging.config|Logging.config]] for an example of a configuration file for logging.
-* The logging for the Web Service can be configured via editing the [[UBIK_Web_Service_Configuration|Web Service Configuration]] in section [[UBIK_Web_Service_Configuration_Example#loggingConfiguration|loggingConfiguration]].
+=== Switch off logging  ===
+Turning off logging can be done by setting the '''switchValue''' in the Category Source to '''Off''' in the corresponding config files:
+* '''UBIK.Studio.exe.config''' for {{UBIK Studio}}
+* '''Web.config''' for the webservice
-* The logging in UBIK.Studio can be configured by editing the file "UBIK.Studio.exe.config", which is located in the program folder of UBIK.Studio and also contains the section [[UBIK_Web_Service_Configuration_Example#loggingConfiguration|loggingConfiguration]] which can be configured in the same way like the UBIK Web Service.
+<source lang="xml">
+<loggingConfiguration name="" tracingEnabled="true" defaultCategory="ASSERTION">
-==Logging Categories==
+...
+   <categorySources>
-UBIK has different types of categories configured for the logging mechanism. The following categories can be configured in the configuration files. Categories with the remark "internal use" are available via customizing code, but are not intednded to be used for logging customizing or workflow events. Therefore, two separate categories have been defined.
+     ...
+     <add switchValue="Off" name="ASSERTION">
-{| class="wikitable" | width = "88%"
+        <listeners>
+           <add name="log.assertion"/>
-|-
+        </listeners>
-! Type!! Description
+     </add>
-|-
+   ...
-| CUSTOMIZING ||  Log for events that occured in the customizing
+   </categorySources>
-|-
+...
-| WORKFLOW || Log for events that occured when running workflows which is provided by the [[WriteLogEntry_(Activity)|WriteLogEntry Activity]]
+</loggingConfiguration>
-|-
+</source>
-| ASSERTION || Log for failed Assertions (internal)
-|-
-| WARNING || Log for events that created a warning (internal)
-|-
-| ERROR ||  Log for events that created an error (internal)
-|-
-| DEBUG ||  Log for events that have to be investigated in the development (internal)
-|-
-| SQL || Log for events related to SQL queries (internal)
-|-
-| EXCEPTION || Log for events that caused an exception (internal)
-|-
-|}
+[[File:UI_Configure _Logging_EntLibConfig.png|220px|thumb|border|alt=Configure logging|Configure logging]]
+Instead of editing the config files, it is also possible to use the graphical configuration tool from the [http://www.microsoft.com/en-us/download/details.aspx?id=15104 Enterprise Library]. After installing the package open the config file with the tool and switch on or off logging for each category as shown.
+{{Clear}}
 ==See also==
-* [[WriteLogEntry_(Activity)|WriteLogEntry (Activity)]]
+* [[Logging]]
-* [[UBIK_Web_Service_Configuration|UBIK Web Service Configuration]]
+* [[Configuration_Files]]
+* [[Web_Service_Configuration|Web service configuration]]
+* [[Activity:WriteLogEntry_(Activity)|WriteLogEntry (Activity)]]
+* [[Serilog]]
+{{Category/Version|3.5.0}}
-[[Category:How-To]]
+[[Category:3.5.0|Configure Logging]]
-[[Category:UBIK Studio]]
+[[Category:How-To|Configure Logging]]
+[[Category:Installing|Configure Logging]]
+[[Category:Server|Configure Logging]]