前言
开发人员的.NET Core项目上线后,经常会出现各种问题,内存泄漏,CPU 100%,处理时间长等, 这个时候就需要快速并准确的发现问题,并解决问题, 除了项目本身的日志记录外,NET Core 为我们开发人员提供了一系列功能强大并且无侵入的诊断工具,本文主要介绍的是 .NET Core dotnet 诊断全局工具
先决条件
支持.NET Core 3.0 SDK 及更高版本, .NET Core 命令行接口 (CLI) 工具
dotnet-counters
dotnet-counters 是一个性能监视工具,用于临时运行状况监视和初级性能调查, 你可以通过命令查看和存储,当前程序的运行时信息,它可以收集 CPU,内存,GC,线程,异常 等信息
安装 dotnet-counters
dotnet tool install --global dotnet-counters
主要命令
- dotnet-counters collect
- dotnet-counters list
- dotnet-counters monitor
- dotnet-counters ps
dotnet-counters ps
显示可监视的 dotnet 进程的列表, 我本地显示有两个.Net Core的程序在运行,前面的数字是进程ID
dotnet-counters list
这个命令我们可以看到程序的运行时信息,和Web主机运行信息
- 运行时:CPU 内存 GC 异常 线程数 异常信息...
- Web主机: QPS 每秒请求数量, 当前请求数量和失败请求数量
dotnet-counters monitor
这个命令可以实时监控程序的运行信息
//以 3 秒的刷新间隔监视 System.Runtime 运行时信息
dotnet-counters monitor --process-id 19072 --refresh-interval 3 System.Runtime
//以 3 秒的刷新间隔监视 Web主机 运行信息
dotnet-counters monitor --process-id 19072 --refresh-interval 3 Microsoft.AspNetCore.Hosting
dotnet-counters collect
定期收集所选计数器的值,并将它们导出为指定的文件格式以进行后续处理。
// 以 3 秒的刷新间隔时间收集所有计数器的值,并生成 json 输出文件:
dotnet-counters collect --process-id 19072 --refresh-interval 3 --format json
dotnet-dump
dotnet-dump是性能收集和分析实用工具,流程是先用 dotnet-dump collect
命令 收集当前程序的运行时信息,然后通过 dotnet-dump analyze
命令启动交互式 shell命令,来分析程序。
安装 dotnet-dump
dotnet tool install -g dotnet-dump
主要命令
- dotnet-dump collect
- dotnet-dump analyze
dotnet-dump collect
// 捕获并写入
dotnet-dump collect --process-id 19072
运行完成后,可以在当前命令行目录中,找到保存的文件,复制文件名,然后使用 dotnet-dump analyze
命令开始分析
dotnet-dump analyze
// 读取文件,并启动交互式shell开始分析
dotnet-dump collect --process-id 19072
输入 help 可以查看所有的命令,这里我想获取托管代码的堆栈信息,输入 clrstack
dotnet-trace
dotnet-trace 是一个跨平台的 .NET Core 工具,在不使用本机探查器的情况下启用正在运行的进程的 .NET Core 跟踪集合,
它是围绕 .NET Core 运行时的跨平台 EventPipe 技术而构建的,在 Windows、Linux 或 macOS 上提供相同体验。
安装 dotnet-trace
dotnet tool install --global dotnet-trace
主要命令
- dotnet-trace collect
- dotnet-trace convert
- dotnet-trace ps
- dotnet-trace list-profiles
dotnet-trace ps
此命令,列出可附加到的 dotnet 进程,我们一般需要拿到进程Id
dotnet-trace collect
dotnet-trace collect --process-id 20196
开始实时获取信息
运行后,数据收集到 trace.nettrace 文件, 按 键停止收集, 可以用 PerfView 打开,我是直接用 VS 打开的,可以看到收集到的数据还是比较全面的。
总结
微软提供了一套强大的诊断工具,熟练的使用这些工具,可以更快更有效的发现程序的运行问题,解决程序的性能问题。
参考文档:https://docs.microsoft.com/zh-cn/dotnet/core/diagnostics/dotnet-counters
dotnet-trace: https://github.com/dotnet/diagnostics.git
打个广告
HttpReports 是针对.Net Core 开发的轻量级APM系统, 基于MIT开源协议,主要支持了统计,分析,告警,链路监控,请求日志等, 文档齐全,前段时间也是很荣幸的加入到了 .NET Core Community 组织,目前在准备V2.0版本的发布计划, 开源不易,还希望感兴趣的同学可以点个 Star 关注下,谢谢
Github地址:https://github.com/dotnetcore/HttpReports
在线预览: https://moa.hengyinfs.com
账号: admin 密码 123456
在线文档:https://www.yuque.com/httpreports/docs