# 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](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](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" />
	<backColor value="White" />
</mapping>
<mapping>
	<level value="INFO" />
	<backColor value="Green" />
</mapping>
<mapping>
	<level value="WARN" />
	<backColor value="Yellow" />
</mapping>
<mapping>
	<level value="ERROR" />
	<backColor value="Red" />
</mapping>
<mapping>
	<level value="FATAL" />
	<backColor value="Red, HighIntensity" />
</mapping>
```

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