I have downloaded and installed LOG4VIEW. How can I start?

First, make sure that your logging application is configured to write log messages using log4net. If you just want to test LOG4VIEW, you can use the application LogEmiter.exe which is installed together with LOG4VIEW. Then, just drag your application exe file from the file explorer to LOG4VIEW. Confirm the settings in the receiver configuration form and press OK. Now, LOG4VIEW is configured to receive messages from your application.

I have created a receiver in LOG4VIEW but I don't get any messages

Make sure, that your application is configured to write log messages. Examine the settings of the log4net root logger. Make sure, that no Log4Net filter prevents the reception or display of log messages.

Which appender/receiver should I use for LOG4VIEW?

LOG4VIEW works with the standard UDP appender, with file and rolling file appenders and with a special LOG4VIEW TCP appender. If the log messages shouldn't be persisted, use the TCP appender. It works on the local machine as well as with remote applications. All you need is an open TCP port. If you need to store your logging information, use the RollingFileAppender. LOG4VIEW can read consecutive rolled files at once and reads the current log file as it is written without locking the file so that it can be rolled over by log4net.

How do I use the network receiver?

Log4View can receive network messages via TCP or UDP. For TCP, just start your logging application/appender and add a new network receiver in Log4View. Select the TCP protocol radio button, enter the server's hostname or IP adress as hostname and make sure you use the same port as the appender.

For UDP, select the UDP protocol. Again use the server's hostname or IP as hostname and the same port as the appender. Be aware that you have to set the receiver's IP or the network's broadcast IP in the appender's remote adress configuration, else you will not receive any messages.

I have configured my application to send messages with the TCP appender but I don't get any messages. When I use the file appender, everything works fine.

Make sure, that the file prosa.LogAppender.dll is in the same directory as your logging application.

I am using Windows 7 and am trying to receive Messages using the UDP appender. But I don't get any messages

Log4net has a bug in the UDP appender so that you can't send messages to the local IP address 127.0.0.1 in Windows 7. A workaround is to use the local address "127.0.0.2".

Which message layout should I use?

Use XML layout whenever possible. It is best suited to be read by LOG4VIEW. LOG4VIEW can also read pattern formatted log files but it can't be ensured that LOG4VIEW can read every log pattern, because some patterns are ambiguous.

I selected "Save Settings for Files" when adding a log file, now Log4View shows strange behaivor.

 

You created a File Extension Schema for log files with a specific extension. For further information on how to use and deactivate this feature, please refer to the corresponding chapter in our documentation.

How do I create and include a plugin?

Log4View is capable of including user generated plugins. There are visual plugins you may add to the GUI of Log4View and receiver plugins that allow you to receive messages from your own appenders. When installing Log4View, include the Sample Receiver and Sample Dashboard to install code examples of plugins in your Log4View main directory. Your plugins will have access to our powerful API documented at “<Log4ViewDirectory >\Help\Log4ViewAPI.chm”.

Your plugins must follow the name pattern Log4View.*.dll and have to be copied in Log4View’s main directory to be included.

How do I debug a plugin?

There are two ways for debugging your own plugins. The first one is to debug via Visual Studio. Go to “Debug” -> “Attach to Process…” and select Log4View. You should now be able to use the Visual Studio Debugger within the code of your own plugin.

Another way is to send log messages at critical sections of your plugin's code. Log4View already features an integrated a status logger you may call via

LogManager.GetCurrentClassLogger().Info("Example");

This way a message “Example“ with the Loglevel Info will be logged via TCP-, file- or Traceappender, depending on your entries in the Log4View.exe.config (in the main directory of Log4View) in the section of log4net.

To supervise these messages in real time, you can use Log4View again. The easiest way is to copy the whole directory of Log4View and to change the file path of its log file in its Log4View.exe.config (else you would receive the status messages of both the logging and the receiving instance of Log4View). Start the copied Log4View and attach the logging one’s file via a file receiver.

Do I have to activate Log4View?

You do not need to activate Log4View via internet, email, telephone codes or similar. Adding your license file is enough to activate Log4View and all of its features.

What's the difference between a machine-bound and a person-bound license?

Technically, there is no difference. You register the same license file in both cases.

  • The default case is the machine-bound license: Every installation of Log4View needs its own license. Typical cases are Servers, Control-PCs, Test-Machines and other computers, which are not assigned to a special person.
  • Developers and technicians often use multiple Computers, e.g. a work desktop, an additional notebook and the PC at home. In our oppinion, it wouldn't be fair to require a user purchasing three licenses if he wants to install Log4View on all of his three computers. Therefore, a user who owns a Log4View license has the right to install Log4View on up to three of his PCs. We call this a person-bound license. Yet he may only run Log4View on one of his devices at a time.

You decide on your own if you assigns a Log4View license to a machine or to a person. You can even change this assignment once a quarter. For this purpose you do not need to get a new license or inform us. We trust in your own responsibility to comply with the License Agreement. Log4View only checks if the license count is met.

Example:

You want to equip 5 developers and 3 technicians with Log4View. Additionaly you want to install Log4View on two servers and 4 PCs in the test lab which are used by five testers. This scenario requires 14 licenses. You assign eight of them to the five developers and three technicians. Each of them can install Log4View on up to three of his machines. These eight licenses are person-bound. The other six licenses are used for the two servers and four test machines. These computers can be used by many different persons who don't need an own Log4View license. These six licenses are machine-bound.

I encounter problems installing Log4View

If you get an error when installing the latest version of Log4View because the old version can not be removed, please extract Log4ViewSetup_12.5.X.0.exe to a folder (e.g. using 7zip) and run Setup.exe from there.