.NET 6中的dotnet monitor讲解

 更新时间:2021年12月24日 16:55:05   作者:晓晨Master  
dotnet monitor为Azure App Service(Linux)提供.NET 应用程序的诊断工具提供支持。这篇文章讲解了.NET 6中的dotnet monitor,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

一.什么是 dotnet monitor

在不同的环境中运行 .NET 应用程序可能会使收集诊断信息(例如日志、跟踪、dump)变得困难。dotnet monitor 是一种工具,它提供了一种统一的方法来收集这些诊断信息,而不管您是在桌面计算机(desktop machine 可理解为我们日常使用的电脑)还是在 kubernetes 集群中运行。

收集这些诊断信息有两种不同的机制:

  • 按需收集诊断信息的 HTTP API。当您的应用程序遇到问题并且想收集更多信息时,可以调用这些 HTTP API。
  • 基于规则配置的触发器。您可以配置规则,以便在满足所需条件时收集诊断信息,例如在 CPU 持续一段时间保持较高的指标时收集进程转储(process dump)。

二.入门

dotnet monitor 可以通过两种不同的分发机制获得:

  • .NET CLI 工具
  • 通过 Microsoft Container Registry (MCR) 获得的容器镜像

.NET CLI 工具

dotnet monitor CLI 工具首先需要安装 .NET 6 SDK,如果你没有足够新的 SDK,可以通过 .NET 下载网页获取安装包进行安装。

你可以使用一下命令获取最新版的 dotnet monitor:

dotnet tool install -g dotnet-monitor --version 6.0.0

如果你已经安装但是想更新到最新,可以运行以下命令:

dotnet tool update -g dotnet-monitor --version 6.0.0

容器镜像

dotnet monitor 容器镜像在 MCR 上可用,你可以通过以下命令获取最新的镜像:

docker pull mcr.microsoft.com/dotnet/monitor:6.0.0

三.HTTP API

dotnet monitor 公开了一个 HTTP API 来查询可用进程、收集诊断信息并检查请求信息的状态。

暴露了以下 HTTP API:

  • /processes- 获取可被发现的进程的详细信息
  • /dump- 在不使用调试器的情况下捕获进程的 dump
  • /gcdump- 捕获进程的 GC dump
  • /trace- 不使用 profiler 来追踪进程
  • /metrics- 以 Prometheus exposition 格式捕获默认进程的指标快照
  • /livemetrics- 捕获进程的实时指标流
  • /logs- 捕获进程的日志
  • /info- 获取有关 dotnet monitor 的信息
  • /operations- 获取操作状态和取消操作

下面的示例演示如何使用 dotnet monitor 从目标进程开始,在60秒的时间内从Microsoft.AspNetCore.Server.Kestrel.Connections 日志级别为 Debug 的日志流数据。

PS> curl.exe -X POST "https://localhost:52323/logs?name=myWebApp&durationSeconds=60" `
    -H "Accept: application/x-ndjson" `
    -H "Content-Type: application/json" `
    --negotiate -u $(whoami)`
    -d '{"filterSpecs": {"Microsoft.AspNetCore.Server.Kestrel.Connections": "Debug"}}' 

{"Timestamp":"2021-11-05 08:12:54Z","LogLevel":"Debug","EventId":39,"EventName":"ConnectionAccepted","Category":"Microsoft.AspNetCore.Server.Kestrel.Connections","Message":"Connection id u00220HMD06BUKL2CUu0022 accepted.","State":{"Message":"Connection id u00220HMD06BUKL2CUu0022 accepted.","ConnectionId":"0HMD06BUKL2CU","{OriginalFormat}":"Connection id u0022{ConnectionId}u0022 accepted."}}
{"Timestamp":"2021-11-05 08:12:54Z","LogLevel":"Debug","EventId":1,"EventName":"ConnectionStart","Category":"Microsoft.AspNetCore.Server.Kestrel.Connections","Message":"Connection id u00220HMD06BUKL2CUu0022 started.","State":{"Message":"Connection id u00220HMD06BUKL2CUu0022 started.","ConnectionId":"0HMD06BUKL2CU","{OriginalFormat}":"Connection id u0022{ConnectionId}u0022 started."}}
{"Timestamp":"2021-11-05 08:12:54Z","LogLevel":"Debug","EventId":9,"EventName":"ConnectionKeepAlive","Category":"Microsoft.AspNetCore.Server.Kestrel.Connections","Message":"Connection id u00220HMD06BUKL2CUu0022 completed keep alive response.","State":{"Message":"Connection id u00220HMD06BUKL2CUu0022 completed keep alive response.","ConnectionId":"0HMD06BUKL2CU","{OriginalFormat}":"Connection id u0022{ConnectionId}u0022 completed keep alive response."},"Scopes":[{"ConnectionId":"0HMD06BUKL2CU"},{"RequestId":"0HMD06BUKL2CU:00000002","RequestPath":"/"}]}

如上面的示例所示,您可以使用 dotnet monitor 按需从目标进程中捕获诊断信息。除了日志,您还可以从目标进程收集跟踪、内存转储、GC转储和 metrics。

四.触发器

dotnet monitor 可以配置为根据发现的进程中的条件自动收集诊断信息。 发现新进程时,如果该进程数据与规则匹配,则 dotnet monitor 将尝试应用配置的规则。 应用的规则将开始监视触发器描述的条件的过程。 如果满足该条件,则假定尚未达到指定的限制来执行操作列表。

示例:如果 dotnet monitor 检测到持续超过一分钟的CPU使用率在80%以上,则它将收集进程 dump,限制每小时不超过1个。

{
  "CollectionRules": {
    "HighCpuRule": {
      "Filters": [
        {
          "Key": "ProcessName",
          "Value": "MyApp",
          "MatchType": "Exact"
        }
      ],
      "Trigger": {
        "Type": "EventCounter",
        "Settings": {
          "ProviderName": "System.Runtime",
          "CounterName": "cpu-usage",
          "GreaterThan": 80,
          "SlidingWindowDuration": "00:01:00"
        }
      },
      "Limits": {
        "ActionCount": 1,
        "ActionCountSlidingWindowDuration": "1:00:00"
      },
      "Actions": [
        {
          "Type": "CollectDump",
          "Settings": {
            "Type": "Triage",
            "Egress": "myBlobStorageAccount"
          }
        }
      ]
    }
  }
}

规则文档:https://github.com/dotnet/dotnet-monitor/blob/main/documentation/collectionrules.md

五.反馈

github issue: https://github.com/dotnet/dotnet-monitor/issues/new/choose

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。

相关文章

  • .net core 中 WebApiClientCore的使用示例代码

    .net core 中 WebApiClientCore的使用示例代码

    这篇文章主要介绍了.net core 中 WebApiClientCore的使用示例代码,代码简单易懂,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-12-12
  • .Net Core部署IIS的最细步骤

    .Net Core部署IIS的最细步骤

    本文来介绍一下.Net Core部署IIS,首先需要安装.NET Core和IIS,并创建Web应用程序项目,然后,将项目文件夹拷贝到IIS服务器上,并使用IIS管理器配置Web应用程序,感兴趣的可以了解一下
    2023-11-11
  • 更改.NET中的默认时区的操作方法

    更改.NET中的默认时区的操作方法

    除了"在操作系统中修改时区信息,然后重启.NET应用程序,使其生效"之外,如何在不修改操作系统时区的前提下,修改.NET中的默认时区呢,下面小编给大家分享更改.NET中的默认时区的操作方法,感兴趣的朋友一起看看吧
    2024-06-06
  • asp.net(vb)实现金额转换成大写的函数

    asp.net(vb)实现金额转换成大写的函数

    asp.net(vb)实现金额转换成大写的函数代码,需要的朋友可以参考下。
    2011-10-10
  • asp.net MVC使用PagedList.MVC实现分页效果

    asp.net MVC使用PagedList.MVC实现分页效果

    这篇文章主要为大家详细介绍了asp.net MVC使用PagedList.MVC实现分页效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-07-07
  • asp.net 大文件上传控件

    asp.net 大文件上传控件

    这段时间写了个asp.net 上传大文件控件。经过测试,在ie中可显示进度条。特此共享,望广大网友多提意见。
    2008-12-12
  • 详解如何在ASP.NET Core中使用Route特性

    详解如何在ASP.NET Core中使用Route特性

    这篇文章主要介绍了如何在ASP.NET Core中使用Route特性,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-01-01
  • ASP.NET设计网络硬盘之查看文件夹实现代码

    ASP.NET设计网络硬盘之查看文件夹实现代码

    下面要介绍的实例包括网上硬盘的许多功能,将一步步为大家进行介绍。首先创建工程实例,然后进行主界面的设计,最后对各个功能的实现分别进行介绍
    2012-10-10
  • Asp.Net设计模式之单例模式详解

    Asp.Net设计模式之单例模式详解

    这篇文章主要为大家详细介绍了Asp.Net设计模式之单例模式的相关资料,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-11-11
  • asp.net 判断数组是否存在某个值的方法

    asp.net 判断数组是否存在某个值的方法

    asp.net 判断数组是否存在某个值的两种方法, 需要的朋友可以参考下。
    2010-07-07

最新评论