Elastic Common Schema .NET 项目教程

最新推荐文章于 2024-10-10 08:52:53 发布

石乾银

最新推荐文章于 2024-10-10 08:52:53 发布

阅读量385

点赞数 5

本文链接：https://blog.csdn.net/gitblog_00891/article/details/142806919

版权

Elastic Common Schema .NET 项目教程

ecs-dotnet .NET integrations that use the Elastic Common Schema (ECS) 项目地址: https://gitcode.com/gh_mirrors/ec/ecs-dotnet

1. 项目介绍

Elastic Common Schema (ECS) .NET 项目是一个用于将 .NET 应用程序的日志数据格式化为 Elastic Common Schema (ECS) 的集成库。ECS 是一个定义了通用字段的规范，用于将数据导入 Elasticsearch。通过使用 ECS，您可以轻松地将来自不同来源（如日志和指标）的数据关联起来，从而实现 IT 运营分析和安全分析。

该项目包含多个 .NET 日志框架的集成，包括 Serilog、NLog 和 log4net。通过这些集成，您可以将日志数据格式化为符合 ECS 标准的 JSON 格式，并将其直接发送到 Elasticsearch。

2. 项目快速启动

2.1 安装依赖

首先，您需要通过 NuGet 安装所需的包。以下是一些常用的包：

dotnet add package Elastic.CommonSchema
dotnet add package Elastic.CommonSchema.Serilog
dotnet add package Elastic.CommonSchema.NLog
dotnet add package Elastic.CommonSchema.Log4net

2.2 配置 Serilog

以下是一个使用 Serilog 的示例配置：

using Serilog;
using Serilog.Formatting.Elasticsearch;

var logger = new LoggerConfiguration()
    .WriteTo.Console(new EcsTextFormatter())
    .CreateLogger();

logger.Information("Hello, Elastic Common Schema!");

2.3 配置 NLog

以下是一个使用 NLog 的示例配置：

using NLog;
using NLog.Config;
using NLog.Targets;
using Elastic.CommonSchema.NLog;

var config = new LoggingConfiguration();
var consoleTarget = new ConsoleTarget("console")
{
    Layout = new EcsLayout()
};

config.AddRule(LogLevel.Debug, LogLevel.Fatal, consoleTarget);
LogManager.Configuration = config;

var logger = LogManager.GetCurrentClassLogger();
logger.Info("Hello, Elastic Common Schema!");

2.4 配置 log4net

以下是一个使用 log4net 的示例配置：

using log4net;
using log4net.Appender;
using log4net.Config;
using log4net.Layout;
using Elastic.CommonSchema.Log4net;

var hierarchy = (Hierarchy)LogManager.CreateRepository(Guid.NewGuid().ToString());
var appender = new ConsoleAppender
{
    Layout = new EcsLayout()
};

hierarchy.Root.AddAppender(appender);
hierarchy.Root.Level = Level.All;
hierarchy.Configured = true;

BasicConfigurator.Configure(hierarchy);

var logger = LogManager.GetLogger(hierarchy.Name, "DefaultLogger");
logger.Info("Hello, Elastic Common Schema!");