首页 > 编程语言 >Asp .Net Core 系列：Asp .Net Core 集成 NLog

Asp .Net Core 系列：Asp .Net Core 集成 NLog

时间：2024-02-06 21:22:05浏览次数：31  
标签：comment Core Asp NET NLog Net null Data 日志

简介

NLog是一个基于.NET平台编写的日志记录类库，它可以在应用程序中添加跟踪调试代码，以便在开发、测试和生产环境中对程序进行监控和故障排除。NLog具有简单、灵活和易于配置的特点，支持在任何一种.NET语言中输出带有上下文的调试诊断信息，并能够将这些信息发送到一个或多个输出目标（target）中，如文件、数据库、控制台等。

NLog的API非常类似于log4net，但配置方式更加简单，使用路由表（routing table）进行配置，使得配置文件易于阅读和维护。此外，NLog还支持结构化日志记录，可以方便地记录复杂的数据类型，如对象、集合等。它还提供了可扩展性，允许用户编写自定义目标或传递自定义值，以满足特定的日志记录需求。

NLog支持多种平台，包括.NET Framework、.NET Core、Xamarin、ASP.NET等，可以在各种应用程序中使用。同时，NLog还遵从BSD license，允许商业应用且完全开放源代码，因此得到了广泛的应用和支持。

NLog 支持结构化日志 记录和传统日志记录。

NLog的重点是：高性能、易于使用、易于扩展和灵活配置。

官网：https://nlog-project.org/

github：https://github.com/nlog/nlog/

配置文件说明：https://github.com/NLog/NLog/wiki/Configuration-file#

NLog配置文件说明

文件位置

启动时，NLog 在各种文件中搜索其配置，如下所述。它加载找到的第一个 nlog 配置。当找到第一个 nlog 配置时，搜索结束。如果未找到配置，NLog 将不会执行任何日志记录。

对于独立的 *.exe 应用程序，按如下方式搜索文件：

  • 标准应用程序配置文件 app.config（例如 applicationname.exe.config）
  • 应用程序目录中的 applicationname.exe.nlog
  • 应用程序目录中的 NLog.config
  • NLog.dll.nlog 位于 NLog.dll 所在目录中（仅当 NLog 未安装在 GAC 中时）

对于 ASP.NET 应用程序，按如下方式搜索文件：

  • 标准 Web 应用程序配置文件 web.config
  • web.nlog 与 web.config 位于同一目录
  • 应用程序目录中的 NLog.config
  • NLog.dll.nlog 位于 NLog.dll 所在目录中（仅当 NLog 未安装在 GAC 中时）

另请参阅显式 NLog 配置加载（包括有关assetsXamarin Android 的 -folder 的详细信息）

元素说明

您可以使用以下元素作为 的子元素nlog。targets和rules在任何配置中都是必需的 其他是可选的，并且在高级场景中很有用。

  • targets– 定义日志目标/输出
  • rules– 定义日志路由规则
  • extensions– 从 *.dll 文件加载 NLog 扩展
  • include– 包括外部配置文件
  • variable– 设置配置变量的值

Targets：定义日志目标/输出

<targets>
    <target name="f"
            xsi:type="File"
            fileName="${basedir}/logs/${shortdate}.log"
            layout="${longdate} ${uppercase:${level}} ${message}" 
            maxArchiveFiles="5"
            archiveAboveSize="10240"
            archiveEvery="Day"/>
</targets>0

Nlog允许用户配置单个文件大小, 放置在内容过长效率过慢,配置了大小之后, Nlog会自动创建一个新的文件副本,插入新的日志输出。

maxArchiveFiles：允许生成的副本文件最大数量

archiveAboveSize：允许单个文件得最大容量

archiveEvery：按天生成

name：输出目标的名称，用于rules中路由规则writeTo指定

fileName：包含完整的生成文件的路径和文件名

xsi:type：输出类型如下

Chainsaw
ColoredConsole 
Console
Database
Debug
Debugger
EventLog
File
LogReceiverService
Mail
Memory
MethodCall
Network
NLogViewer
Null
OutputDebugString
PerfCounter
Trace
WebService

layout：用来规定输出内容格式，语法“${属性}”，可以把上下文信息插入到日志中。

系统变量参考：https://nlog-project.org/config/?tab=layout-renderers

Rules– 定义日志路由规则

路由顺序会对日志打印产生影响。路由匹配逻辑为顺序匹配。

日志可以分不同级别进行输出，日志规则rules里面可以控制输出的日志级别。不同级别的日志代表日志的重要程度，比如一些debug级别的日志在生产环境就会被控制不输出，以减少日志文件的大小。

<rules>
    <logger name="*" minlevel="Debug" writeTo="file" />
</rules>name：记录者的名字。
  • ame– 匹配记录器对象的记录器名称 - 可能包含通配符（* 和 ?）
  • minlevel– 记录的最低级别（与指定级别和上面的级别匹配）
  • maxlevel– 记录的最大级别（与指定级别和下面的级别匹配）
  • level– 单级记录
  • levels- 以逗号分隔的要记录的级别列表
  • writeTo– 以逗号分隔的要写入的目标列表
  • final– 最终规则匹配后不处理任何规则
  • enabled- 设置为false禁用规则而不删除它
  • ruleName- 允许使用 Configuration.FindRuleByName和进行规则查找的规则标识符Configuration.RemoveRuleByName。NLog 4.6.4 中引入
  • FinalMinLevel - 记录器匹配将被限制为以下规则的指定最低级别。NLog 5.0中引入

日志级别有如下，自上而下，等级递增。

  • Trace - 最常见的记录信息，一般用于普通输出
  • Debug - 同样是记录信息，不过出现的频率要比Trace少一些，一般用来调试程序
  • Info - 信息类型的消息
  • Warn - 警告信息，一般用于比较重要的场合
  • Error - 错误信息
  • Fatal - 致命异常信息。一般来讲，发生致命异常之后程序将无法继续执行。

日志过滤器：可以在路由当中, 为每个路由配置自定义得日志过滤器fliter，如下所示

<rules>
    <logger name="*" writeTo="file">
        <filters>
            <when condition="length('${message}') > 100" action="Ignore" />
            <when condition="equals('${logger}','MyApps.SomeClass')" action="Ignore" />
            <when condition="(level >= LogLevel.Debug and contains('${message}','PleaseDontLogThis'))" action="Ignore" />
            <when condition="not starts-with('${message}','PleaseLogThis')" action="Ignore" />
        </filters>
    </logger>
</rules>

Asp .Net Core 集成 NLog

参考：https://github.com/NLog/NLog/wiki/Getting-started-with-ASP.NET-Core-6

  1. 安装 NLog.Web.AspNetCore 包

    在您的项目中，通过 NuGet 包管理器安装 NLog.Web.AspNetCore 包。在 Visual Studio 中，您可以右键点击项目 -> 选择 "Manage NuGet Packages" -> 搜索 NLog.Web.AspNetCore -> 点击 "Install"。

    或者通过命令行安装：

    dotnet add package NLog.Web.AspNetCore

  2. 配置 NLog

    创建一个 nlog.config 文件在项目的根目录下，并添加您的 NLog 配置。例如：

<?xml version="1.0" encoding="utf-8" ?>  
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"  
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
      autoReload="true"  
      throwExceptions="false"  
      internalLogLevel="Info" internalLogFile="internal-nlog.txt">  

    <!-- 定义日志输出目标 -->  
    <targets>  
      <target xsi:type="File" name="file" fileName="${basedir}/logs/nlog.txt"  
              layout="${longdate} ${level:uppercase=true} ${message} ${exception}" />  
    </targets>  

    <!-- 定义日志规则 -->  
    <rules>  
      <logger name="*" minlevel="Debug" writeTo="file" />  
    </rules>  
</nlog>

  1. 在 Program.cs 中配置 NLog

    // 添加 NLog  
builder.Logging.ClearProviders();  
//builder.Logging.SetMinimumLevel(LogLevel.Debug);  
//NLogBuilder.ConfigureNLog("nlog.config");  
builder.Host.UseNLog();

  2. 使用 NLog

    现在您可以在控制器、服务等中注入 ILogger 并使用它记录日志。NLog 将处理这些日志并记录到配置的目标中。

    using Microsoft.AspNetCore.Mvc;

namespace NLogTest.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private readonly ILogger<WeatherForecastController> _logger;

        public WeatherForecastController(ILogger<WeatherForecastController> logger)
        {
            _logger = logger;
        }

        [HttpGet(Name = "GetWeatherForecast")]
        public IEnumerable<WeatherForecast> Get()
        {
            try
            {           
                int a = 1 / int.Parse("0");
                return null;
            }
            catch (Exception ex)
            {
                _logger.LogDebug(ex, ex.Message);
                _logger.LogTrace(ex, ex.Message);
                _logger.LogInformation(ex, ex.Message);
                _logger.LogWarning(ex, ex.Message);
                _logger.LogError(ex, ex.Message);
                return Enumerable.Empty<WeatherForecast>();
            }
        }
    }
}

NLog 自定义全局变量

            app.Use(async (context, next) =>
            {
                GlobalDiagnosticsContext.Set("TenantId", 1);
                GlobalDiagnosticsContext.Set("CreateUserId", 111);
                await next();
            });

// 使用
${gdc:TenantId}

将日志消息写入MySQL数据库

https://github.com/NLog/NLog/wiki/Database-target

安装Nuget包

dotnet add package NLog.Database
dotnet add package MySql.Data

数据库准备(MySQL)

create database mcode_log;
use mcode_log;
create table if not exists erp_log
(
    Id              bigint auto_increment comment '主键'
        primary key,
    TenantId        bigint       null comment '租户Id',
    ApplicationName varchar(100) null comment '程序名称',
    HostName        varchar(100) null comment '主机',
    Ip              varchar(100) null comment 'Ip地址',
    Message         text         null comment '信息',
    Level           varchar(50)  null comment '级别',
    ExceptionInfo   text         null comment '异常信息',
    CallInfo        text         null comment '调用信息',
    RequestMethod   varchar(20)  null comment '请求方法',
    RequestUrl      varchar(512) null comment '请求地址',
    RequestBody     text         null comment '请求主体',
    CreateTime      datetime     null comment '创建时间',
    CreateUserId    bigint       null comment '创建用户',
    CreateUserName  varchar(50)  null comment '创建用户名称'
);

配置NLog

<?xml version="1.0" encoding="utf-8"?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      autoReload="true"
      throwExceptions="false" 
      throwConfigExceptions="true"
      internalLogLevel="warn"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<!--生产环境 throwExceptions 建议为false -->
	<extensions>
		<add assembly="NLog.Web.AspNetCore"/>
		<add assembly="NLog.Database"/>
	</extensions>
	<!--internalLogFile="logfiles"-->
	<targets async="true">
		<!--屏幕打印消息-->
		<target name="console" xsi:type="ColoredConsole"
						layout="${newline}=======================================================================
                            ${newline} 【当前时间】: [${date:format=yyyy-MM-dd HH\:mm\:ss}]                           
                            ${newline} 【 级 别 】：[${level}]                            
                            ${newline} 【 调 用 】：[${callsite}] [${callsite-linenumber}] [${callsite-filename}] [${stacktrace}]                                                            
                            ${newline} 【 消 息 】：[${message}]   
                            ${newline} 【 异 常 】：[${exception:format=ToString}] [${threadname}] [${threadid}]
                            " />

		<!--VS输出窗口-->
		<target name="debugger" xsi:type="Debugger"
						 layout="${newline}=======================================================================
                            ${newline} 【当前时间】: [${date:format=yyyy-MM-dd HH\:mm\:ss}]                           
                            ${newline} 【 级 别 】：[${level}]                            
                            ${newline} 【 调 用 】：[${callsite}] [${callsite-linenumber}] [${callsite-filename}] [${stacktrace}]                                                            
                            ${newline} 【 消 息 】：[${message}]   
                            ${newline} 【 异 常 】：[${exception:format=ToString}] [${threadname}] [${threadid}]
                            " />

		<!--保存至文件-->
		<target name="info" xsi:type="File" maxArchiveFiles="30"
						fileName="${basedir}/Logs/Info/${shortdate}.txt"
						 layout="${newline}=======================================================================
                             ${newline} 【当前时间】: [${date:format=yyyy-MM-dd HH\:mm\:ss}]                           
                            ${newline} 【 级 别 】：[${level}]                            
                            ${newline} 【 调 用 】：[${callsite}] [${callsite-linenumber}] [${callsite-filename}] [${stacktrace}]                                                            
                            ${newline} 【 消 息 】：[${message}]   
                            ${newline} 【 异 常 】：[${exception:format=ToString}] [${threadname}] [${threadid}]
                            " />

		<!--保存至文件-->
		<target name="error" xsi:type="File" maxArchiveFiles="30"
						fileName="${basedir}/Logs/Error/${shortdate}.txt"
						layout="${newline}=======================================================================
                            ${newline} 【当前时间】: [${date:format=yyyy-MM-dd HH\:mm\:ss}]                           
                            ${newline} 【 级 别 】：[${level}]                            
                            ${newline} 【 调 用 】：[${callsite}] [${callsite-linenumber}] [${callsite-filename}] [${stacktrace}]                                                            
                            ${newline} 【 消 息 】：[${message}]   
                            ${newline} 【 异 常 】：[${exception:format=ToString}] [${threadname}] [${threadid}]
                            " />
		<!--写入数据库-->
		<target xsi:type="Null" name="blackhole"/>
		<target name="database" xsi:type="Database"
			   dbProvider="MySql.Data.MySqlClient.MySqlConnection, MySql.Data"
			  connectionString="server=110.41.14.13;Database=mcode_log;user id=root;password=123456;SslMode=none">
		<!--<target name="database" xsi:type="Database"
			  dbProvider="MySqlConnector.MySqlConnection, MySqlConnector"
			  connectionString="server=127.0.0.1;Database=mcode_log;user id=root;password=123456;SslMode=none">-->
			<commandText>
				insert into erp_log (TenantId, ApplicationName, HostName, Ip, Message, Level, ExceptionInfo, CallInfo,
				RequestMethod, RequestUrl, RequestBody, CreateTime, CreateUserId, CreateUserName)
				values (@TenantId,@ApplicationName,@HostName,@Ip,@Message,@Level,@ExceptionInfo,@CallInfo,@RequestMethod,@RequestUrl,@RequestBody,@CreateTime,@CreateUserId,@CreateUserName);
			</commandText>
			<!--注意：对于非字符串，要指定dbType"-->
			<parameter name="@TenantId" layout="${gdc:TenantId}"  dbType="DbType.Int64" />
			<parameter name="@ApplicationName" layout="${gdc:ApplicationName}"   />
			<parameter name="@HostName" layout="${hostname}" />
			<parameter name="@Ip" layout="${gdc:Ip}" />
			<parameter name="@Message" layout="${message}" />
			<parameter name="@Level" layout="${level}" />
			<parameter name="@ExceptionInfo" layout="[${exception:format=ToString}] [${threadname}] [${threadid}]" />
			<parameter name="@CallInfo" layout="[${callsite}] [${callsite-linenumber}] [${callsite-filename}] [${stacktrace}]" />
			<parameter name="@RequestMethod" layout="${gdc:RequestMethod}" />
			<parameter name="@RequestUrl" layout="${gdc:RequestUrl}" />
			<parameter name="@RequestBody" layout="${gdc:RequestBody}" />
			<parameter name="@CreateTime" layout="${date}"  dbType="DbType.DateTime" />
			<parameter name="@CreateUserId" layout="${gdc:CreateUserId}" dbType="DbType.Int64" />
			<parameter name="@CreateUserName" layout="${gdc:CreateUserName}" />
		</target>
	</targets>

	<!--规则-->
	<rules>
		<logger name="*" minlevel="Warn" writeTo="console" />
		<logger name="NLogTest.*" minlevel="Debug"  writeTo="debugger" />
		<logger name="NLogTest.*" minlevel="Info" maxlevel="Info"  writeTo="info" />
		<logger name="*" minlevel="Warn" writeTo="error" />
		<logger name="NLogTest.*" minlevel="Warn" writeTo="database" />
	</rules>
</nlog>

在这里插入图片描述
在这里插入图片描述

其它数据库

MySql and .NET Core

Install package: https://www.nuget.org/packages/MySql.Data/

dbProvider="MySql.Data.MySqlClient.MySqlConnection, MySql.Data"

or if using packages: https://www.nuget.org/packages/MySqlConnector/ and https://www.nuget.org/packages/MySqlConnector.Logging.NLog/

dbProvider="MySqlConnector.MySqlConnection, MySqlConnector"

System.Data.SQLite and .NET Core

Install package: https://www.nuget.org/packages/System.Data.SQLite

dbProvider="System.Data.SQLite.SQLiteConnection, System.Data.SQLite"

Microsoft.Data.SqlClient and .NET Core

Install package: https://www.nuget.org/packages/Microsoft.Data.SqlClient/

dbProvider="Microsoft.Data.SqlClient.SqlConnection, Microsoft.Data.SqlClient"

Microsoft.Data.Sqlite and .NET Core

Install package: https://www.nuget.org/packages/Microsoft.Data.SQLite/

dbProvider="Microsoft.Data.Sqlite.SqliteConnection, Microsoft.Data.Sqlite"

Npgsql and .NET core

Install package: https://www.nuget.org/packages/Npgsql/

dbProvider="Npgsql.NpgsqlConnection, Npgsql"

Oracle.ManagedDataAccess and .NET

dbProvider="Oracle.ManagedDataAccess.Client.OracleConnection, Oracle.ManagedDataAccess"

Mono.Data.Sqlite and .NET

dbProvider="Mono.Data.Sqlite.SqliteConnection, Mono.Data.Sqlite"

记录故障排除

有时我们的应用程序不会向日志文件写入任何内容，即使我们应该正确配置了日志记录。日志未写入的原因可能有很多。最常见的问题是权限问题，通常在 ASP.NET 进程中，其中aspnet_wp.exe或w3wp.exe进程可能没有对我们要存储日志的目录的写访问权限。

NLog 旨在吞掉日志记录可能导致的运行时异常。以下设置可以更改此行为和/或重定向这些消息。

  • <nlog throwExceptions="true" />-throwExceptions在配置文件中添加该属性会导致 NLog 停止屏蔽异常并将其传递给调用应用程序。该属性在部署时非常有用，可以快速定位任何问题。至关重要的是，一旦应用程序正确配置throwExceptions为"false"运行，就应立即进行配置，这样意外的日志记录问题就不会导致应用程序挂起或崩溃。
  • <nlog throwConfigExceptions="true" /> - 类似于throwExceptions但仅与配置异常隔离。与此不同的是throwExceptions，启用它并不危险，建议在生产环境中启用，因为在生产环境中，日志记录配置的初始设置成功至关重要。NLog 4.3 中引入。默认null（表示未配置，而是使用 的值throwExceptions）
  • <nlog internalLogLevel="Trace|Debug|Info|Warn|Error|Fatal" />– 确定内部日志级别。级别越高，内部日志输出越不详细。当需要诊断日志记录问题时，输出通常非常有帮助。有关设置输出到文件或控制台的选项，请参阅内部日志记录。

标签：comment,Core,Asp,NET,NLog,Net,null,Data,日志
From： https://www.cnblogs.com/vic-tory/p/18010317

相关文章

  • （五）ADO.NET用窗体应用程序写增删查改（1.1升级版）
    在上一节我们写了一个简单的窗体应用程序增删查改，但只是限制于只能单条增加、修改、删除、查询，今天继续修改代码，让增加这个环节由用户自行输入然后增加。首先新增一个窗体，把数据库表中所需要的字段排版好。一、原“增加”按钮修改紧接着上一节项目，我们只需要把修改按钮事件修......
  • ASP 与iis基础漏洞
    1ASP安全在早期我们在windows上搭建服务器使用的是windows，iis，asp,access（sqlserver），他们几个分别是操作系统，中间件，编程语言，数据库，类比我们先前学习的NAMP,是同一类事物，本篇来学习ASP安全。1.1access脱库由于access数据库文件格式一般有.mdb.asp.asa该文件放在网站目......
  • 家用电脑装esxi使用尝试和解决no network Adapters和VMware PowerCLI安装
    因为电脑换了新配置，老的电脑目前就没在用，想着闲置再利用一下的原则，想给他安装一下esxi，正好也可以折腾一下系统。我的主板是技嘉B85M-HD3-A的，查一下 VMwareCompatibilityGuide-I/ODeviceSearch 这个选择对应网卡型号，就能看到他支持的版本。很可惜，我的这个主板上带的这个网......
  • ROS问题: libQt5Core. so.5:无法打开共享对象文件:没有那个文件或目录
    当运行下面命令报错时ros2runturtlesimturtlesim_node错误信息：/opt/ros/foxy/lib/turtlesim/turtlesim_node:errorwhileloadingsharedlibraries:libQt5Core.so.5:cannotopensharedobjectfile:Nosuchfileordirectory最佳答案 我用这个方法，来自h......
  • .NET中使用BootstrapBlazor组件库Table实操篇
    前言Table表格在后台管理应用中使用的是相当频繁的，因此找一个功能齐全的前端框架对于我们而言是非常必要的，因为封装完善的前端框架能够大大提升我们的工作对接效率。今天我们主要来讲解一下在.NET中使用BootstrapBlazor组件库的Table表格组件（本章使用的数据都是程序自动生成的模......
  • Profinet转CANopen主站网关与堡盟编码器通讯案例
    Profinet转CANopen主站网关与堡盟编码器通讯案例Profinet转CANopen主站网关(XD-COPNm20)为CPU与堡盟编码器的通讯提供了CANopen协议向Profinet协议转换互通的桥梁。CANopen是一种基于CAN总线的通讯协议，它被广泛应用于工业自动化领域，而Profinet是一种以太网协议，其优点是高速传输和......
  • neteq的peak detector解析
    neteq中的峰值检测原理如下:a)当interval_arrival_iat_packet超过target_level+2||interval_arrival_iat_packet>2*target_level的时候，认为这是一个峰值点b)记录该峰值点的高度(iat_packet)和该峰值点离上一个峰值点的间隔(period),然后放入记录数组boolDelayPe......
  • neteq的RELATIVE_ARRIVAL_DELAY，INTER_ARRIVAL_TIME的抖动计算区别
    正文neteq两种模式:RELATIVE_ARRIVAL_DELAY，INTER_ARRIVAL_TIME，两者计算抖动方式的存在区别如上图所示:RELATIVE_ARRIVAL_DELAY(简称relative_delay)的计算相邻两个点的iat_ms，然后从区间头进行累加到当前(数学展开的话，可以发现是每个包和第一个包求传输延时different)INTER_A......
  • docker 部署 asp.net8 项目
    1、需要编写dockerfile文件#基础镜像FROMmcr.microsoft.com/dotnet/aspnet:8.0ASbase#工作目录WORKDIR/app#开放访问端口EXPOSE8080#复制内容到镜像COPY./app#指定默认入口ENTRYPOINT["dotnet","Web.Admin.dll"]2、编写docker-compose.yaml文件version:'3's......
  • FlubuCore 用C#写cmd/shell脚本
    1.在解决方案下新建项目BuildScript2.在BuildScript项目下新建BuildScript.cs文件 3.Nuget安装FlubuCore包 4.BuildScript.cs内容usingSystem;usingSystem.IO;usingSystem.Linq;usingSystem.Collections.Generic;usingFlubuCore.Context;usingFlubuCore.Conte......

赞助商

阅读排行

网站主页关于我们联系我们网站地图

本网站内容转载自其他媒体，侵权联系[admin##ips99.com]。

Copyright © 2020-2023 IPS99 版权所有 IPS99