ASP.NET Core 9 Debian服务：实现Linux日志多行条目输出

我将ASP.NET Core 9 MVC应用以服务形式部署在Debian系统，日志输出到journal中，但遇到了多行日志被合并为单行的问题，希望实现类似PostgreSQL的多行日志格式。

现有代码 #

Program.cs #

using Microsoft.Extensions.Hosting.Systemd;

var builder = WebApplication.CreateBuilder(args);

// 注册MVC服务
builder.Services.AddControllersWithViews();

// 启用Systemd服务集成
builder.Host.UseSystemd();

var app = builder.Build();
...

控制器日志记录代码 #

public class ContextLessLogger(ILogger<ContextLessLogger> syslog)
{
    public void Log() 
    {
        StringBuilder viga = new();
        viga.AppendLine("Line 1");
        viga.AppendLine("Line 2");
        syslog.Log(LogLevel.Warning, viga.ToString());
    }
}

当前问题 #

当前journalctl的输出会把多行日志合并成单行显示：

veebr 12 22:33:52 myhost MyService[268922]: Eeva.Service.ContextLessLogger[0] Line 1  Line 2

根据微软官方文档说明，Systemd控制台日志格式化器默认会将所有日志消息转为单行输出。

期望效果 #

希望单个日志条目能分多行展示，格式类似PostgreSQL的多行日志：

veebr 12 22:33:52 myhost MyService[268922]: Eeva.Service.ContextLessLogger[0] Line 1  
                                                                              Line 2

解决方法 #

由于Systemd原生格式化器不支持保留多行格式，可通过以下两种方式实现：

方式一：自定义Systemd日志格式化器 #

创建自定义格式化器，重写消息处理逻辑，保留换行并为后续行添加对应缩进：

public class MultilineSystemdFormatter : SystemdConsoleFormatter
{
    public MultilineSystemdFormatter() : base() { }

    protected override void WriteMessage(
        in LogEntry entry,
        IExternalScopeProvider scopeProvider,
        TextWriter textWriter)
    {
        // 先写入日志前缀（如类别、日志级别标识）
        base.WriteMessage(entry, scopeProvider, textWriter);
        // 处理日志内容，替换换行符为带缩进的换行
        var message = entry.Message;
        if (!string.IsNullOrEmpty(message))
        {
            // 缩进长度根据实际日志前缀的长度调整，示例中为57个空格
            var indent = new string(' ', 57);
            var multilineMessage = message.Replace(Environment.NewLine, $"{Environment.NewLine}{indent}");
            textWriter.Write(multilineMessage);
        }
    }
}

然后在Program.cs中注册这个自定义格式化器：

builder.Host.ConfigureLogging(logging =>
{
    logging.ClearProviders();
    logging.AddSystemd(options =>
    {
        options.FormatterName = nameof(MultilineSystemdFormatter);
    });
    logging.AddFormatter<MultilineSystemdFormatter, SystemdConsoleFormatterOptions>();
});

方式二：手动添加缩进写入日志 #

如果不想自定义格式化器，也可以在日志写入时直接为每行添加缩进：

public void Log() 
{
    // 缩进长度匹配期望的对齐位置
    var indent = new string(' ', 57);
    syslog.LogWarning("Line 1");
    syslog.LogWarning($"{indent}Line 2");
}

这种方式更直接，但需要手动控制缩进长度，适合日志格式固定的简单场景。

内容的提问来源于stack exchange，提问作者Andrus