NLog.AzureAppendBlob.Standard 1.0.3

NLog.AzureAppendBlob.Standard

An NLog target using Microsoft Azure Storage Append Blobs With .NET Standard 2.0.

How To Use

Install the NLog.AzureAppendBlob.Standard package from NuGet. If you use NLog 4.x or higher, NLog will automatically load the extension assembly. Otherwise, put the following in your NLog configuration(.NET Core has to do):

<nlog>
    <extensions>
        <add assembly="NLog.AzureAppendBlob.Standard" />
    </extensions>
</nlog>

If still not work, you can try to Register manually (choose one) in your application start. e.g. main(), app_start().

1. Target.Register<NLog.AzureAppendBlob.Standard.AzureAppendBlobTarget>("AzureAppendBlob"); //generic

2. ConfigurationItemFactory.Default.Targets.RegisterDefinition("AzureAppendBlob", typeof(NLog.AzureAppendBlob.Standard.AzureAppendBlobTarget)); //old syntax

Target configuration

The target's type name is AzureAppendBlob.

• layout - (layout) Content text to write.
• connectionString - (layout) The connection string for the storage account to use. Consult the Azure Portal to retrieve this.
• container - (layout) The name of the blob container where logs will be placed. Will be created when it does not exist.
• blobName - (layout) Name of the blob to write to. Will be created when it does not exist(only once).
• forceCheck(Optional) - (bool) Check target blob does existing or not when write to at any time.

Sample

<targets async="true">
    <target xsi:type="AzureAppendBlob" 
            name="Azure" 
            layout="${longdate} ${uppercase:${level}} - ${message}" 
            connectionString="YourConnectionString" 
            container="YourContainer" 
            blobName="logs/${shortdate}.log" 
            forceCheck= "false" />
</targets>
<rules>
    <logger name="*" minlevel="Trace" writeTo="Azure"/>
</rules>

You can see NLog Wiki for more information about configuring NLog.

Test App

NLog.AzureAppendBlob.Standard.Test is a console program that is preconfigured to use the AzureAppendBlob target. To test it, you'll have to create an Azure storage account and a blob account.

Note

If you need other NLog extensions(Target or Layout Renderer) that built by me or prefer all in one like me. You can visit this.

Reference

NLog.AzureAppendBlob by Erik Heemskerk