How to: Write to an Application Event Log

You can use the My.Application.Log and My.Log objects to write information about events that occur in your application. This example shows how to configure an event log listener so My.Application.Log writes tracing information to the Application event log.

You cannot write to the Security log. In order to write to the System log, you must be a member of the LocalSystem or Administrator account.

To view an event log, you can use Server Explorer or Windows Event Viewer. For more information, see How to: Work with Event Logs in Server Explorer or How to: Launch Event Viewer from the Server Explorer.

Note

Event logs are not supported on Windows 95, Windows 98, or Windows Millennium Edition.

To add and configure the event log listener

1. Right-click app.config in Solution Explorer and choose Open.

   - or -

   If there is no app.config file,

   1. On the Project menu, choose Add New Item.

   2. From the Add New Item dialog box, choose Application Configuration File.

   3. Click Add.

2. Locate the <listeners> section in the application configuration file.

   You will find the <listeners> section in the <source> section with the name attribute "DefaultSource", which is nested under the <system.diagnostics> section, which is nested under the top-level <configuration> section.

3. Add this element to that <listeners> section:

   <add name="EventLog"/>
   

4. Locate the <sharedListeners> section, in the <system.diagnostics> section, in the top-level <configuration> section.

5. Add this element to that <sharedListeners> section:

   <add name="EventLog"
       type="System.Diagnostics.EventLogTraceListener, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
        initializeData="APPLICATION_NAME"/>
   

   Replace APPLICATION_NAME with the name of your application.

   Note

   Typically, an application writes only errors to the event log. For information on filtering log output, see Walkthrough: Filtering My.Application.Log Output.

To write event information to the event log

• Use the My.Application.Log.WriteEntry or My.Application.Log.WriteException method to write information to the event log. For more information, see How to: Write Log Messages and How to: Log Exceptions in Visual Basic.

  After you configure the event log listener for an assembly, it receives all messages that My.Applcation.Log writes from that assembly.

See Also

Tasks

How to: Log Exceptions in Visual Basic

Walkthrough: Determining Where My.Application.Log Writes Information

Concepts

Working with Application Logs in Visual Basic

Reference

My.Application.Log Object

My.Log Object

WriteEntry Method (My.Application.Log and My.Log)

WriteException Method (My.Application.Log and My.Log)