如何在Serilog+ElasticSearch中将StopWatch的ElapsedTime转为可统计字段

核心问题 #

你当前通过格式化字符串输出的ElapsedTime被Serilog序列化为文本类型存入ElasticSearch，导致无法在Kibana中进行平均值、总和等统计操作。解决思路是让ElasticSearch将该字段识别为数值类型（如毫秒数）或时间间隔（duration）类型。

具体解决方案 #

方案1：直接记录毫秒数（最推荐，统计最便捷）

将StopWatch的耗时转换为毫秒数值作为单独字段存入，同时保留格式化后的友好文本显示：

var elapsedMs = sw.ElapsedMilliseconds;
Log.Information(
    "Component {ComponentName} ran tests successfully in {ElapsedTime:mm\\:ss\\.fff} ({ElapsedMs}ms)",
    component.Name,
    sw.Elapsed,
    elapsedMs
);

这样ElasticSearch会将ElapsedMs识别为long类型，直接支持Kibana的统计计算，同时日志消息仍保持原有可读性。

方案2：存储原始TimeSpan类型，映射为ElasticSearch的duration类型

不通过格式化字符串将TimeSpan转为文本，而是直接传入原始TimeSpan对象作为日志属性，让ElasticSearch识别为时间间隔类型：

// 直接传入TimeSpan，Serilog会保留其原始类型
Log.Information(
    "Component {ComponentName} ran tests successfully in {ElapsedTime:mm\\:ss\\.fff}",
    component.Name,
    sw.Elapsed
);

// 若需明确指定属性名称，可使用ForContext
Log.ForContext("ElapsedDuration", sw.Elapsed, destructureObjects: true)
   .Information(
        "Component {ComponentName} ran tests successfully in {ElapsedTime:mm\\:ss\\.fff}",
        component.Name,
        sw.Elapsed
    );

注意：需要确保ElasticSearch的索引模板将对应字段（如ElapsedDuration）映射为duration类型。若未自动识别，可通过Kibana Dev Tools手动更新映射：

PUT /your-index-pattern/_mapping
{
  "properties": {
    "ElapsedDuration": { "type": "duration" }
  }
}

方案3：分离消息格式化与属性存储

将友好显示的格式化文本与原始TimeSpan属性分开，确保属性存储原始类型：

Log.Information(
    "Component {ComponentName} ran tests successfully in {ElapsedTimeFormatted}",
    component.Name,
    sw.Elapsed.ToString("mm\\:ss\\.fff"),
    new { ElapsedTime = sw.Elapsed }
);

此方式会让ElapsedTime字段以TimeSpan类型存入ElasticSearch，后续可映射为duration类型进行统计。

后续注意事项 #

• 若已有历史数据，旧的ElapsedTime文本字段无法直接转换类型，需重新索引或新增字段统计。
• 建议提前配置ElasticSearch索引模板，指定数值或duration类型字段的映射规则，避免后续字段类型不匹配问题。

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