Serilog.Sinks.AzureTableStorage 10.0.1

Serilog.Sinks.AzureTableStorage

写入到 Azure 表存储 的表中。

包 - Serilog.Sinks.AzureTableStorage | 平台 - .NET Standard 2.0

var log = new LoggerConfiguration()
    .WriteTo.AzureTableStorage("<connectionString>")
    .CreateLogger();

配置

JSON配置

可以使用Serilog.Settings.Configuration配置接收器，通过指定appsettings.json中的表名和连接字符串来进行配置

"Serilog": {
  "WriteTo": [
    {"Name": "AzureTableStorage", "Args": {"storageTableName": "", "connectionString": ""}}
  ]
}

必须使用ReadFrom.Configuration()启用JSON配置；有关详细信息，请参阅JSON配置包的文档。

XML <appSettings>配置

要使用Serilog.Settings.AppSettings包与文件接收器，如果尚未安装，请首先安装该包

Install-Package Serilog.Settings.AppSettings

而不是在代码中配置记录器，请调用ReadFrom.AppSettings()

var log = new LoggerConfiguration()
    .ReadFrom.AppSettings()
    .CreateLogger();

在您的应用程序的App.config或Web.config文件中，在<appSettings>节点下指定文件接收器程序集和所需路径格式

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

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)
    {
    }
}

更改日志

10.0.0

• 破坏性更改：移除writeInBatches，所有写入现在都是分批进行的
• 更新：更新到serilog 4.0
• 移除：已从Serilog.Sinks.PeriodicBatching中删除依赖项，使用serilog 4.0的IBatchedLogEventSink

9.6.0

• 修复：改进时区支持

9.5.0

• 添加：使用ULID作为rowkey以提高速度和效率

9.4.0

• 修复：防止重复rowkey

9.1.0

• 添加：内置跟踪和span id支持

9.0.0

• 破坏性更改：由于从配置创建提供程序的问题
  • IDocumentFactory.Create添加AzureTableStorageSinkOptions和IKeyGenerator参数
  • IKeyGenerator.GeneratePartitionKey添加AzureTableStorageSinkOptions参数
  • IKeyGenerator.GenerateRowKey添加AzureTableStorageSinkOptions参数
• 修复：默认文档工厂和默认密钥生成器需要参数无构造函数，用于在配置文件中使用
• 添加：ITableClientFactory以控制TableClient创建

8.5.0

• 添加分区密钥舍入选项
• 移动IKeyGenertor从选项
• 添加分区密钥和row key的DateTime扩展方法
• 添加示例Web项目

8.0.0

• 破坏性更改：对代码库进行大量的重构以简化
  • 移除：已移除AzureTableStorageWithProperties扩展，使用等效的AzureTableStorage
  • 移除：已移除ICloudTableProvider提供程序
  • 添加：IDocumentFactory以允许控制表文档
  • 更改：PartitionKey和RowKey更改为新实现

7.0.0

• 更新依赖关系：用Azure.Data.Tables替换Microsoft.Azure.Cosmos.Table

6.0.0

• 更新依赖项：用1.0.8替换已弃用的包WindowsAzure.Storage Microsoft.Azure.Cosmos.Table
• 更新依赖项：Serilog 2.10.0

5.0.0

• 迁移到新的CSPROJ项目系统
• 更新依赖项：WindowsAzure.Storage 8.6.0，Serilog 2.6.0，Serilog.Sinks.PeriodicBatching 2.1.1
• 修复#36 - 允许使用SAS URI进行日志记录。

1.5

• 从serilog/serilog迁移