NLog.AzureAppendBlob.Standard 2.0.1

An NLog target using Microsoft Azure Storage Append Blobs in .NET Core App(1.x ~ 2.x).

Supported platforms:

- .NET Standard 1.6
- .NET Standard 2.0
- .NET Core 1.0 ~ .NET Core 1.1
- .NET Core 2.0 ~ .NET Core 2.2

Install-Package NLog.AzureAppendBlob.Standard -Version 2.0.1
dotnet add package NLog.AzureAppendBlob.Standard --version 2.0.1
<PackageReference Include="NLog.AzureAppendBlob.Standard" Version="2.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NLog.AzureAppendBlob.Standard --version 2.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

NLog.AzureAppendBlob.Standard

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 target's type name 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(Optional) - (bool) Check if the target blob exists for each write.

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.

NLog.AzureAppendBlob.Standard

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 target's type name 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(Optional) - (bool) Check if the target blob exists for each write.

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.

Release Notes

1. Upgrade dependencies.
2. Support .NET Core App 1.x now.

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
2.0.1 126 6/16/2019
1.0.3 1,403 5/31/2018
1.0.2 1,567 4/13/2018
1.0.1 349 4/13/2018