 Pages 153

Clone this wiki locally

Use

Targets are used to display, store, or pass log messages to another destination. There are two kinds of target; those that receive and handle the messages, and those that buffer or route the messages to another target. The second group are called 'wrapper' targets.

NLog supports creating custom targets. For more information, see: Extending NLog

Targets

NLog package 68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4e4c6f672e737667.bin

• AspResponse - Outputs log messages through the ASP Response object.
• Chainsaw - Sends log messages to the remote instance of Chainsaw application from log4j.
• ColoredConsole - Writes log messages to the console with customizable coloring.
• Console - Writes log messages to the console.
• Database - Writes log messages to the database using an ADO.NET provider.
• Debug - Mock target - useful for testing.
• Debugger - Writes log messages to the attached managed debugger.
• EventLog - Writes log message to the Event Log.
• File - Writes log messages to one or more files.
• LogReceiverService - Sends log messages to a NLog Receiver Service (using WCF or Web Services).
• Mail - Sends log messages by email using SMTP protocol.
• Memory - Writes log messages to an ArrayList in memory for programmatic retrieval.
• MethodCall - Calls the specified static method on each log message and passes contextual parameters to it.
• Network - Sends log messages over the network.
• NLogViewer - Sends log messages to the remote instance of NLog Viewer.
• Null - Discards log messages. Used mainly for debugging and benchmarking.
• OutputDebugString - Outputs log messages through the OutputDebugString() Win32 API.
• PerfCounter - Increments specified performance counter on each write.
• Trace - Sends log messages through System.Diagnostics.Trace.
• WebService - Calls the specified web service on each log message.

Wrappers

• AsyncWrapper - Provides asynchronous, buffered execution of target writes.
• AutoFlushWrapper - Causes a flush after each write on a wrapped target.
• BufferingWrapper - A target that buffers log events and sends them in batches to the wrapped target. Useful in combination with Mail target.
• FallbackGroup - Provides fallback-on-error.
• FilteringWrapper - Filters log entries based on a condition.
• ImpersonatingWrapper - Impersonates another user for the duration of the write.
• PostFilteringWrapper - Filters buffered log entries based on a set of conditions that are evaluated on a group of events.
• RandomizeGroup - Sends log messages to a randomly selected target.
• RepeatingWrapper - Repeats each log event the specified number of times.
• RetryingWrapper - Retries in case of write error.
• RoundRobinGroup - Distributes log events to targets in a round-robin fashion.
• SplitGroup - Writes log events to all targets.

NLog.Extended package 68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4e4c6f672e457874656e6465642e737667.bin

• MSMQ - Writes log message to the specified message queue handled by MSMQ.

NLog.Web package 68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4e4c6f672e5765622e737667.bin

• AspNetTrace - Writes log messages to the ASP.NET trace.

Wrappers

• AspNetBufferingWrapper - Buffers log events for the duration of ASP.NET request and sends them down to the wrapped target at the end of a request.

NLog.Windows.Forms package 68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4e4c6f672e5765622e737667.bin

• FormControl - Logs text to Windows.Forms.Control.Text property control of specified Name.
• MessageBox - Pops up log messages as message boxes.
• RichTextBox - Log text a Rich Text Box control in an existing or new form.

NLog.Elmah package 68747470733a2f2f696d672e736869656c64732e696f2f6e756765742f762f4e4c6f672e5369676e616c522e737667.bin

• Elmah - Logs to Elmah

External packages

External packages, not maintained by the NLog team.

Writing your own target

NLog supports custom target. For more information, see: Extending NLog