Skip to content

Latest commit

 

History

History
61 lines (49 loc) · 3 KB

README.md

File metadata and controls

61 lines (49 loc) · 3 KB
Raw

NLog.AzureAppendBlob.Standard

Version Downloads
An NLog target using Microsoft Azure Storage Append Blobs in .Net Core App(1.x ~ 2.x), reference this NLog.AzureAppendBlob.

How To Use

Install the NLog.AzureAppendBlob.Standard package from NuGet. If you use NLog 4.x or higher, it will automatically load the extension assembly. In further, put the following in your NLog configuration(.Net Core must 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 type name of target is AzureAppendBlob.

  • layout - (layout) Content text to write.
  • connectionString - (layout) The connection string of the storage account. Consult the Azure Portal to retrieve this.
  • container - (layout) The name of the blob container where logs will be placed. It will be created automatically when it does not exist.
  • blobName - (layout) The name of the blob to write to. It will be created automatically when it does not exist(only once, unless you set forceCheck to true).
  • forceCheck - (bool) Check if the target blob exists for each write. Optional.

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