前言

所谓日志（Log）是指系统所指定对象的某些操作和其操作结果按时间有序的集合。每个日志文件由日志记录组成，每条日志记录描述了一次单独的系统事件。通常情况下，系统日志是用户可以直接阅读的文本文件，其中包含了一个时间戳和一个信息或者子系统所特有的其他信息。

日志文件为服务器、工作站、防火墙和应用软件等IT资源相关活动记录必要的、有价值的信息，这对系统监控、查询、报表和安全审计是十分重要的。日志文件中的记录可提供以下用途：监控系统资源；审计用户行为；对可疑行为进行告警；确定入侵行为的范围；为恢复系统提供帮助；生成调查报告；为打击计算机犯罪提供证据来源。

WatchDog 是一个使用 C# 开发的开源的轻量监控工具，它可以记录和查看 ASP.NET Core Web 和 WebApi 的实时消息、事件、异常、 Http 请求响应等。

WatchDog功能特性主要有：

• 实时 HTTP 请求和响应记录
• 实时异常记录
• 代码内消息和事件记录
• 用户友好的查询页面
• 身份验证
• 数据定期清除

相关网址：https://github.com/IzyPro/WatchDog

一、性能监控工具WatchDog的使用

1.安装包

通过 .NET CLI 安装 WatchDog.NET

dotnet addpackage WatchDog.NET --version 1.3.2

或者使用包管理器安装

Install-Package WatchDog.NET --version 1.3.2

2.添加引用

默认使用本地文件数据库

builder.Services.AddWatchDogServices();

也可以选择外部的 MSSQL, MySQL & PostgreSQL 数据库

services.AddWatchDogServices(opt =>
{
	opt.SetExternalDbConnString = "DbConnString";
	opt.SqlDriverOption = WatchDogSqlDriverEnum.PostgreSql;
});

3.配置 WatchDog 中间件

//配置中间件
app.UseWatchDog(opt =>
{
    opt.WatchPageUsername = "admin";
    opt.WatchPagePassword = "123456";
});

4.运行程序

4.1 登录页面

访问 /watchdog 路径，账号密码就是中间件配置的

4.2 查看 Http 请求和响应

访问https://localhost:7018/WeatherForecast/

4.3 查看异常信息

4.4 记录日志信息

using Microsoft.AspNetCore.Mvc;
using WatchDog;

namespace WebApiTest.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private static readonly string[] Summaries = new[]
        {
        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
    };

        private readonly ILogger<WeatherForecastController> _logger;

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

        [HttpGet(Name = "GetWeatherForecast")]
        public IEnumerable<WeatherForecast> Get()
        {
            try
            {
                throw new Exception("User is already registered!");
            }
            catch (Exception e)
            {
                WatchLogger.Log(@$"我是看门狗日志:{e.Message}-{e.Data}");
            }
            
            return Enumerable.Range(1, 5).Select(index => new WeatherForecast
            {
                Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
                TemperatureC = Random.Shared.Next(-20, 55),
                Summary = Summaries[Random.Shared.Next(Summaries.Length)]
            })
            .ToArray();
        }

    }
}