如何在 Docker 环境下自动给 .NET 程序生成 Dump

Published on2021-06-02
-Views
1Minutes Read

前言

之前“一线码农”大佬有写文章介绍了如何在 windows 下自动 dump,正好手里有个在 docker 环境下 dump 的需求,所以在参考大佬文章的基础上,有了本篇。 ​

工具

dotnet-dump

dotnet-dump是微软官方推出的一个.NET全局工具,安装和使用都非常简单。 安装:
使用:
但是它不能够自动dump(也可能是我不知道),所以本文主要讨论下面这个工具

ProcDump for linux

本工具是 ProcDump 的社区 linux 移植版,不过主要开发人员也是微软的员工。 它可以实现根据 CPU 占用 、内存占用、线程数等情况进行自动 dump,我们以此来应对程序出现异常时需要dump文件进行分析的场景。 ​
安装 在 Dockerfile中添加以下命令: 注意我们要在运行时的镜像中添加,并且最好是自行构建一个基础镜像,而不是每次都进行安装。
本文基于 aspnet:5.0 镜像,即 debian 10,如果基于其他镜像,可去下面目录中寻找对应的包 https://packages.microsoft.com/repos/ 也可参考作者提供的安装说明
运行 因为 docker 容器并不能很方便的在启动时同时执行多个进程,所以我们需要一个sh文件以便在启动时同时执行dotnet和procdump。 因为我个人不喜欢在 Dockerfile 之外还要依赖其他文件,所以我直接在 Dockerfile 里进行了sh文件的创建
如果有需要的话,也可以自行创建一个start.sh,内容为
Dockerfile 改为
这样就可以了,在docker run的时候会同时启动dotnet和procdump,并且当内存大于200M的时候会自动dump。 还有一点要注意,docker run的时候需要添加--privileged 以提高权限。例如docker run --privileged -it xx ​
其中 procdump 的各个参数为
举例来说,以下命令表示当 CPU 使用率为>= 65%或内存为>= 100 MB 时创建一个 dump 文件

其他

dump 文件的持久化 大家都知道 docker 容器消失的话,那么其中的 dump 文件也会消失。 所以需要输出 dump 文件到一个指定的、进行过持久化挂载的卷中,不过可惜的是,当前procdump for linux还没有一个输出参数来控制输出目录,只会在应用程序的同级目录生成,所以现在需要手动移动一下。 我看已经有人提了 PR,未来会增加一个 -o 参数以控制输出。

参考

Tags:
#Blog