Serilog.Sinks.AzureTableStorage
9.7.1
See the version list below for details.
dotnet add package Serilog.Sinks.AzureTableStorage --version 9.7.1
NuGet\Install-Package Serilog.Sinks.AzureTableStorage -Version 9.7.1
<PackageReference Include="Serilog.Sinks.AzureTableStorage" Version="9.7.1" />
paket add Serilog.Sinks.AzureTableStorage --version 9.7.1
#r "nuget: Serilog.Sinks.AzureTableStorage, 9.7.1"
// Install Serilog.Sinks.AzureTableStorage as a Cake Addin
#addin nuget:?package=Serilog.Sinks.AzureTableStorage&version=9.7.1
// Install Serilog.Sinks.AzureTableStorage as a Cake Tool
#tool nuget:?package=Serilog.Sinks.AzureTableStorage&version=9.7.1
Serilog.Sinks.AzureTableStorage
Writes to a table in Azure Table Storage.
Package - Serilog.Sinks.AzureTableStorage | Platforms - .NET Standard 2.0
var log = new LoggerConfiguration()
.WriteTo.AzureTableStorage("<connectionString>")
.CreateLogger();
Configuration
Configuration | Description | Default |
---|---|---|
connectionString | The Cloud Storage Account connection string | |
sharedAccessSignature | The storage account/table SAS key | |
accountName | The storage account name | |
restrictedToMinimumLevel | The minimum log event level required in order to write an event to the sink. | Verbose |
formatProvider | Culture-specific formatting information | |
storageTableName | Table name that log entries will be written to | LogEvent |
writeInBatches | Use a periodic batching sink, as opposed to a synchronous one-at-a-time sink | true |
batchPostingLimit | The maximum number of events to post in a single batch | 100 |
period | The time to wait between checking for event batches | 0:0:2 |
keyGenerator | The key generator used to create the PartitionKey and the RowKey for each log entry | DefaultKeyGenerator |
propertyColumns | Specific log event properties to be written as table columns | |
bypassTableCreationValidation | Bypass the exception in case the table creation fails | false |
documentFactory | Provider to create table document from LogEvent | DefaultDocumentFactory |
tableClientFactory | Provider to create table client | DefaultTableClientFactory |
partitionKeyRounding | Partition key rounding time span | 0:5:0 |
JSON configuration
It is possible to configure the sink using Serilog.Settings.Configuration by specifying the table name and connection string in appsettings.json
:
"Serilog": {
"WriteTo": [
{"Name": "AzureTableStorage", "Args": {"storageTableName": "", "connectionString": ""}}
]
}
JSON configuration must be enabled using ReadFrom.Configuration()
; see the documentation of the JSON configuration package for details.
XML <appSettings>
configuration
To use the file sink with the Serilog.Settings.AppSettings package, first install that package if you haven't already done so:
Install-Package Serilog.Settings.AppSettings
Instead of configuring the logger in code, call ReadFrom.AppSettings()
:
var log = new LoggerConfiguration()
.ReadFrom.AppSettings()
.CreateLogger();
In your application's App.config
or Web.config
file, specify the file sink assembly and required path format under the <appSettings>
node:
<configuration>
<appSettings>
<add key="serilog:using:AzureTableStorage" value="Serilog.Sinks.AzureTableStorage" />
<add key="serilog:write-to:AzureTableStorage.connectionString" value="DefaultEndpointsProtocol=https;AccountName=ACCOUNT_NAME;AccountKey=KEY;EndpointSuffix=core.windows.net" />
<add key="serilog:write-to:AzureTableStorage.formatter" value="Serilog.Formatting.Compact.CompactJsonFormatter, Serilog.Formatting.Compact" />
</appSettings>
</configuration>
Example Configuration for ASP.NET
public static class Program
{
private const string OutputTemplate = "{Timestamp:HH:mm:ss.fff} [{Level:u1}] {Message:lj}{NewLine}{Exception}";
public static async Task<int> Main(string[] args)
{
// azure home directory
var homeDirectory = Environment.GetEnvironmentVariable("HOME") ?? ".";
var logDirectory = Path.Combine(homeDirectory, "LogFiles");
Log.Logger = new LoggerConfiguration()
.MinimumLevel.Verbose()
.MinimumLevel.Override("Microsoft", LogEventLevel.Information)
.Enrich.FromLogContext()
.WriteTo.Console(outputTemplate: OutputTemplate)
.WriteTo.File(
path: $"{logDirectory}/boot.txt",
rollingInterval: RollingInterval.Day,
shared: true,
flushToDiskInterval: TimeSpan.FromSeconds(1),
outputTemplate: OutputTemplate,
retainedFileCountLimit: 10
)
.CreateBootstrapLogger();
try
{
Log.Information("Starting web host");
var builder = Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder(args);
builder.Host
.UseSerilog((context, services, configuration) => configuration
.ReadFrom.Configuration(context.Configuration)
.ReadFrom.Services(services)
.Enrich.FromLogContext()
.Enrich.WithProperty("ApplicationName", builder.Environment.ApplicationName)
.Enrich.WithProperty("EnvironmentName", builder.Environment.EnvironmentName)
.WriteTo.Console(outputTemplate: OutputTemplate)
.WriteTo.File(
path: $"{logDirectory}/log.txt",
rollingInterval: RollingInterval.Day,
shared: true,
flushToDiskInterval: TimeSpan.FromSeconds(1),
outputTemplate: OutputTemplate,
retainedFileCountLimit: 10
)
.WriteTo.AzureTableStorage(
connectionString: context.Configuration.GetConnectionString("StorageAccount"),
propertyColumns: new[] { "SourceContext", "RequestId", "RequestPath", "ConnectionId", "ApplicationName", "EnvironmentName" }
)
);
ConfigureServices(builder);
var app = builder.Build();
ConfigureMiddleware(app);
await app.RunAsync();
return 0;
}
catch (Exception ex)
{
Log.Fatal(ex, "Host terminated unexpectedly");
return 1;
}
finally
{
await Log.CloseAndFlushAsync();
}
}
private static void ConfigureServices(WebApplicationBuilder builder)
{
}
private static void ConfigureMiddleware(Microsoft.AspNetCore.Builder.WebApplication app)
{
}
}
Change Log
9.1.0
- Add: Built-in trace and span id support
9.0.0
- Breaking: Due to issue with creating provides from configuration
IDocumentFactory.Create
add AzureTableStorageSinkOptions and IKeyGenerator argumentsIKeyGenerator.GeneratePartitionKey
add AzureTableStorageSinkOptions argumentIKeyGenerator.GenerateRowKey
add AzureTableStorageSinkOptions argument
- Fix: DefaultDocumentFactory and DefaultKeyGenerator needed paramaterless contructor for use in configuration files
- Add: ITableClientFactory to control TableClient creation
8.5.0
- Add option for partition key rounding
- Move IKeyGenertor from options
- Add DateTime extension methods for partition key and row key
- Add sample web project
8.0.0
- Breaking: major refactor to simplify code base
- Removed: AzureTableStorageWithProperties extension removed, use equivalent AzureTableStorage
- Removed: ICloudTableProvider provider removed
- Added: IDocumentFactory to allow control over table document
- Change: PartitionKey and RowKey changed to new implementation
7.0.0
- Update dependencies: repace Microsoft.Azure.Cosmos.Table with Azure.Data.Tables
6.0.0
- Updated dependencies: replace deprecated package WindowsAzure.Storage with Microsoft.Azure.Cosmos.Table 1.0.8
- Updated dependencies: Serilog 2.10.0
5.0.0
- Migrated to new CSPROJ project system
- Updated dependencies: WindowsAzure.Storage 8.6.0, Serilog 2.6.0, Serilog.Sinks.PeriodicBatching 2.1.1
- Fix #36 - Allow using SAS URI for logging.
1.5
- Moved from serilog/serilog
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Azure.Data.Tables (>= 12.8.3)
- Serilog (>= 3.1.1)
- Serilog.Sinks.PeriodicBatching (>= 4.1.1)
- ulid (>= 1.3.3)
-
.NETStandard 2.1
- Azure.Data.Tables (>= 12.8.3)
- Serilog (>= 3.1.1)
- Serilog.Sinks.PeriodicBatching (>= 4.1.1)
- ulid (>= 1.3.3)
-
net6.0
- Azure.Data.Tables (>= 12.8.3)
- Serilog (>= 3.1.1)
- Serilog.Sinks.PeriodicBatching (>= 4.1.1)
- ulid (>= 1.3.3)
-
net8.0
- Azure.Data.Tables (>= 12.8.3)
- Serilog (>= 3.1.1)
- Serilog.Sinks.PeriodicBatching (>= 4.1.1)
- ulid (>= 1.3.3)
NuGet packages (9)
Showing the top 5 NuGet packages that depend on Serilog.Sinks.AzureTableStorage:
Package | Downloads |
---|---|
TouchConvert.Tenant.Api.V1.Dtos
Data transfer objects for TouchConvert version one APIs. |
|
TouchConvert.Tenant.Api.V2.Dtos
Data transfer objects for TouchConvert version two APIs. |
|
BumperLane.Hosted.Api.V2.Application
BumperLane Core API functionality |
|
AzureWebFarm.OctopusDeploy
Scalable, OctopusDeploy-powered webfarm using Windows Azure Web Roles. |
|
MewPro.MewService
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
10.0.0-beta.1 | 191 | 6/3/2024 |
9.7.1 | 5,193 | 5/29/2024 |
9.7.0 | 4,584 | 5/10/2024 |
9.6.0 | 9,136 | 4/26/2024 |
9.5.0 | 12,270 | 4/10/2024 |
9.4.1 | 10,227 | 3/10/2024 |
9.3.0 | 1,942 | 3/6/2024 |
9.2.0 | 45,796 | 12/11/2023 |
9.1.0 | 13,015 | 11/9/2023 |
9.0.0 | 60,493 | 8/6/2023 |
9.0.0-beta.2 | 110 | 8/1/2023 |
9.0.0-beta.1.1 | 108 | 8/1/2023 |
8.5.42-alpha.0.7 | 100 | 8/1/2023 |
8.5.41 | 37,113 | 6/24/2023 |
8.5.39-beta | 553 | 6/24/2023 |
8.5.38 | 79,059 | 5/8/2023 |
8.5.36-beta | 598 | 5/2/2023 |
8.0.35 | 4,883 | 4/16/2023 |
8.0.33-beta | 526 | 4/16/2023 |
8.0.31-beta | 593 | 4/16/2023 |
8.0.30-beta | 581 | 4/11/2023 |
8.0.28-beta | 618 | 4/10/2023 |
8.0.27-beta | 637 | 3/27/2023 |
7.0.25 | 28,992 | 3/25/2023 |
7.0.22-beta | 640 | 3/25/2023 |
6.0.0-dev-00146 | 17,505 | 4/29/2021 |
5.0.0 | 1,279,226 | 7/28/2020 |
5.0.0-dev-00116 | 92,802 | 9/8/2018 |
5.0.0-dev-00111 | 2,456 | 9/4/2018 |
5.0.0-dev-00109 | 1,170 | 9/4/2018 |
5.0.0-dev-00105 | 8,015 | 5/9/2018 |
5.0.0-dev-00101 | 1,410 | 4/24/2018 |
5.0.0-dev-00093 | 6,676 | 3/20/2018 |
4.0.0 | 1,521,629 | 6/13/2017 |
4.0.0-dev-00089 | 1,555 | 5/22/2017 |
4.0.0-dev-00082 | 4,717 | 3/14/2017 |
4.0.0-dev-00079 | 1,566 | 3/4/2017 |
4.0.0-dev-00077 | 1,436 | 3/1/2017 |
4.0.0-dev-00074 | 1,350 | 2/28/2017 |
4.0.0-dev-00069 | 2,804 | 2/13/2017 |
3.0.1-dev-00067 | 2,739 | 2/3/2017 |
3.0.0 | 188,199 | 11/22/2016 |
3.0.0-dev-00055 | 1,454 | 10/14/2016 |
3.0.0-dev-00052 | 1,372 | 10/7/2016 |
3.0.0-dev-00045 | 2,324 | 10/6/2016 |
3.0.0-dev-00044 | 2,513 | 10/3/2016 |
3.0.0-dev-00039 | 1,555 | 10/3/2016 |
2.0.1-dev-00030 | 2,447 | 7/19/2016 |
2.0.0 | 56,381 | 6/29/2016 |
2.0.0-beta-20 | 2,405 | 4/26/2016 |
1.5.14 | 36,192 | 4/17/2016 |
1.5.11 | 12,727 | 12/26/2015 |
1.5.5 | 32,511 | 4/2/2015 |
1.5.4 | 3,043 | 4/2/2015 |
1.5.3 | 1,777 | 4/1/2015 |
1.5.2 | 2,547 | 3/30/2015 |
1.5.1 | 1,710 | 3/27/2015 |
1.4.196 | 2,439 | 2/22/2015 |
1.4.182 | 1,998 | 2/15/2015 |
1.4.168 | 1,939 | 2/8/2015 |
1.4.155 | 1,816 | 2/1/2015 |
1.4.139 | 1,684 | 1/23/2015 |
1.4.118 | 1,824 | 1/13/2015 |
1.4.113 | 1,988 | 1/6/2015 |
1.4.102 | 2,281 | 12/21/2014 |
1.4.99 | 2,129 | 12/18/2014 |
1.4.97 | 2,023 | 12/18/2014 |
1.4.76 | 2,024 | 12/8/2014 |
1.4.75 | 1,996 | 12/7/2014 |
1.4.39 | 1,912 | 11/26/2014 |
1.4.34 | 1,847 | 11/24/2014 |
1.4.28 | 1,852 | 11/24/2014 |
1.4.27 | 1,967 | 11/23/2014 |
1.4.23 | 2,007 | 11/21/2014 |
1.4.22 | 1,892 | 11/21/2014 |
1.4.21 | 1,869 | 11/21/2014 |
1.4.18 | 2,034 | 11/18/2014 |
1.4.15 | 2,236 | 11/4/2014 |
1.4.14 | 1,825 | 10/23/2014 |
1.4.13 | 1,786 | 10/23/2014 |
1.4.12 | 1,889 | 10/12/2014 |
1.4.11 | 1,718 | 10/8/2014 |
1.4.10 | 2,527 | 9/26/2014 |
1.4.9 | 1,852 | 9/17/2014 |
1.4.8 | 1,839 | 9/11/2014 |
1.4.7 | 2,413 | 9/1/2014 |
1.4.6 | 1,793 | 8/31/2014 |
1.4.5 | 1,695 | 8/27/2014 |
1.4.4 | 1,793 | 8/27/2014 |
1.4.3 | 2,669 | 8/25/2014 |
1.4.2 | 1,659 | 8/23/2014 |
1.4.1 | 1,687 | 8/23/2014 |
1.3.43 | 1,847 | 8/4/2014 |
1.3.42 | 1,724 | 7/30/2014 |
1.3.41 | 1,719 | 7/28/2014 |
1.3.40 | 1,723 | 7/26/2014 |
1.3.39 | 1,792 | 7/25/2014 |
1.3.37 | 1,746 | 7/25/2014 |
1.3.36 | 1,758 | 7/20/2014 |
1.3.35 | 1,729 | 7/17/2014 |
1.3.34 | 1,704 | 7/6/2014 |
1.3.33 | 1,720 | 6/30/2014 |
1.3.30 | 1,740 | 6/19/2014 |
1.3.29 | 1,731 | 6/19/2014 |
1.3.28 | 1,752 | 6/19/2014 |
1.3.27 | 1,734 | 6/18/2014 |
1.3.26 | 1,735 | 6/18/2014 |
1.3.25 | 1,768 | 6/9/2014 |
1.3.24 | 1,761 | 5/21/2014 |
1.3.23 | 1,711 | 5/20/2014 |
1.3.20 | 1,810 | 5/18/2014 |
1.3.19 | 1,757 | 5/17/2014 |
1.3.18 | 1,729 | 5/17/2014 |
1.3.17 | 1,738 | 5/17/2014 |
1.3.16 | 1,708 | 5/17/2014 |
1.3.15 | 1,738 | 5/16/2014 |
1.3.14 | 1,734 | 5/16/2014 |
1.3.13 | 1,714 | 5/16/2014 |
1.3.12 | 1,696 | 5/14/2014 |
1.3.7 | 1,732 | 5/11/2014 |
1.3.6 | 1,746 | 5/9/2014 |
1.3.5 | 1,780 | 5/6/2014 |
1.3.4 | 1,710 | 5/4/2014 |
1.3.3 | 1,845 | 4/28/2014 |
1.3.1 | 2,020 | 4/26/2014 |
1.2.53 | 1,838 | 4/26/2014 |
1.2.52 | 1,861 | 4/24/2014 |
1.2.51 | 1,947 | 4/18/2014 |
1.2.50 | 1,941 | 4/18/2014 |
1.2.49 | 1,853 | 4/17/2014 |
1.2.48 | 1,959 | 4/14/2014 |
1.2.47 | 1,929 | 4/14/2014 |
1.2.45 | 1,928 | 4/13/2014 |
1.2.44 | 1,933 | 4/9/2014 |
1.2.41 | 2,202 | 4/7/2014 |
1.2.40 | 1,819 | 4/7/2014 |
1.2.39 | 2,240 | 3/29/2014 |
1.2.38 | 1,829 | 3/29/2014 |
1.2.37 | 1,875 | 3/29/2014 |
1.2.29 | 2,099 | 3/16/2014 |
1.2.27 | 1,820 | 3/14/2014 |
1.2.26 | 1,791 | 3/12/2014 |
1.2.25 | 3,447 | 2/20/2014 |
0.9.9 | 2,534 | 11/23/2013 |
0.9.1 | 2,629 | 8/24/2013 |
0.8.6 | 1,939 | 7/29/2013 |
0.8.5 | 2,043 | 7/22/2013 |
0.8.1 | 2,070 | 7/9/2013 |
0.7.2 | 2,045 | 7/6/2013 |
0.6.1 | 1,961 | 6/13/2013 |
0.5.2 | 2,007 | 5/27/2013 |
0.5.1 | 1,897 | 5/26/2013 |
0.4.3 | 2,203 | 5/25/2013 |