NLog.AzureAppendBlob.Standard 1.0.1

NLog.AzureAppendBlob.Standard

An NLog target using Microsoft Azure Storage Append Blobs With .NET Standard 2.0, reference of NLog.AzureAppendBlob.

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:

<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.

• 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.
• layout - (layout) Content text to write.

Sample

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

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

Building

The project is a .NET Standard 2.0 project. If you wish to build it yourself, you'll need install Visual Studio 2017 or Visual Studio Code.

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.