# Logging

powerVault uses [Apache log4net](<https://logging.apache.org/log4net/>) as core logging library, and additionally [PostSharp Diagnostics](<http://doc.postsharp.net/5.0/logging>) for extended Debug logging.

By default, all the logs are stored in a logfile located in *'C:\\Users\\\{USER}\\AppData\\Local\\coolOrange\\powerVault\\Logs\\powerVault.log'* and it contains only Infos, Warnings and Errors.

The log4net settings file is located in *C:\\Program Files\\coolOrange\\Modules\\powerVault\\powerVault.log4net*.\
Further information about log4Net Configurations can be found [here](<https://logging.apache.org/log4net/release/manual/configuration.html>).

## When to change the logging behavior?

When you have issues or when you want to get a more detailed knowledge about what went wrong, you can increase the [loglevel](<inv:powerjobs_processor#logging/log_level>).

:::{note}
When changing the loglevel to *DEBUG* [PostSharp Diagnostics](<http://doc.postsharp.net/5.0/logging>) will
be enabled and will log all the function calls into the log files.\
This could cause performance issues
:::

## LogFile

You can see, that there are multiple logging-Appenders used.\
If you want to change the [Logging Levels](<inv:powerjobs_processor#logging/log_level>) for the logfile, please visit following appender:

```{code-block} xml
:linenos: true

<appender name="FileAppender" type="log4net.Appender.RollingFileAppender">
```

In the lines

```{code-block} xml
:linenos: true

<root>
	<level value="INFO" />
	<appender-ref ref="FileAppender"/>
	<appender-ref ref="ColoredConsoleAppender" />
</root>
```

you can configure the logginglevel for all appenders.\
You could set the level to "DEBUG", than all the appenders will log in debug.

In the line

```{code-block} xml
:linenos: true

<param name="File" value="${LOCALAPPDATA}\\coolOrange\\powerVault\\Logs\\powerVault.log" />
```

you can configure the outputpath and name of the logfile.

## PowerShell IDE

PowerShell IDEs like PowerShell console (and PowerShell ISE) are configured to show the logging levels in a different color.

```{code-block} xml
:linenos: true

<mapping>
	<level value="DEBUG" />
	<foreColor value="Black" />
	<backColor value="White" />
</mapping>
<mapping>
	<level value="INFO" />
	<backColor value="DarkGreen" />
</mapping>
<mapping>
	<level value="WARN" />
	<backColor value="DarkYellow" />
</mapping>
<mapping>
	<level value="ERROR" />
	<backColor value="Red" />
</mapping>
<mapping>
	<level value="FATAL" />
	<backColor value="DarkRed" />
</mapping>

```

These and many other options can be configured in the appender named **ColoredConsoleAppender**.