简介

编辑

ECS 日志记录是您最喜欢的 .NET 日志记录库的集成。它们使您可以轻松地将日志格式化为与 ECS 兼容的 JSON。

想要了解有关 ECS、ECS 日志记录和其他可用语言插件的更多信息?请参阅ECS 日志记录概述

.NET ECS 库分为几个类别

模型

编辑

核心所有 .NET ECS 库都由Elastic.CommonSchema提供支持,它将 ECS 规范强类型化为 .NET 类。

此库可用于以类型安全的方式将您的事件映射到 ECS。

var doc = EcsDocument.CreateNewWithDefaults<EcsDocument>();
doc = new EcsDocument();

详细了解 Elastic.CommonSchema.

日志格式化程序

编辑

我们的日志格式化程序允许您更改各种日志记录框架记录到 IO(文件/控制台)的方式以使用 ECS json。

数据发送器

编辑

我们的数据发送器与日志记录框架集成,以方便将事件(日志)发送到各种 Elastic 接收器。

目前,这些发送器支持 Elastic Cloud 和 Elasticsearch,但其他输出正在开发中。

所有数据发送器都利用Elastic.Ingest.Elasticsearch.CommonSchema 将事件发送到 Elasticsearch。

增强器

编辑

增强器可以与日志格式化程序数据发送器一起安装,以自动增强生成的 ECS json。

架构

编辑

这些库重用了为 Elastic 的其他 .NET 库提供支持的相同组件,从而确保了一种通用方法来配置和监视 Elastic 的 .NET 库。

ECS.NET Artichtecture overview

核心所有数据发送器都依赖于Elastic.Transport 来协调 HttpRequests。此库也是 Elastic 客户端的核心,并确保我们共享最佳实践和配置选项。

所有数据发送器库都依赖于来自Elastic.Ingest.* 的基于推送的摄取抽象,该抽象提供了一种易于使用的System.Threading.Channels支持的方法,以可变速率批量推送事件到外部数据源。

详细了解 Elastic.Ingest.Elasticsearch.CommonSchema.