如何在 Docker 环境下自动给 .NET 程序生成 Dump
<h3 id="前言">前言</h3><p>之前“一线码农”大佬有写文章介绍了如何在 windows 下自动 dump，正好手里有个在 docker 环境下 dump 的需求，所以在参考大佬文章的基础上，有了本篇。<br>
</p>
<h3 id="工具">工具</h3>
<p>dotnet-dump (https://docs.microsoft.com/en-us/dotnet/core/diagnostics/dotnet-dump)<br>
ProcDump for linux (https://github.com/Sysinternals/ProcDump-for-Linux)<br>
</p>
<h4 id="dotnet-dump">dotnet-dump</h4>
<p>dotnet-dump是微软官方推出的一个.NET全局工具，安装和使用都非常简单。<br>
安装:</p>
<pre><code class="language-bash">dotnet tool install --global dotnet-dump
</code></pre>
<p>使用:</p>
<pre><code class="language-bash">dotnet-dump collect --process-id 1902 # pid
</code></pre>
<p>但是它不能够自动dump(也可能是我不知道)，所以本文主要讨论下面这个工具</p>
<h4 id="procdump-for-linux">ProcDump for linux</h4>
<p>本工具是 ProcDump 的社区 linux 移植版，不过主要开发人员也是微软的员工。<br>
它可以实现根据 CPU 占用 、内存占用、线程数等情况进行自动 dump，我们以此来应对程序出现异常时需要dump文件进行分析的场景。<br>
</p>
<p><strong>安装</strong><br>
在 Dockerfile中添加以下命令：<br>
注意我们要在运行时的镜像中添加，并且最好是自行构建一个基础镜像，而不是每次都进行安装。</p>
<pre><code class="language-dockerfile"># final stage/image
FROM mcr.microsoft.com/dotnet/aspnet:5.0
# 安装所需依赖
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
wget \
gdb \
lldb
# 安装 procdump
RUN wget https://packages.microsoft.com/repos/microsoft-debian-buster-prod/pool/main/p/procdump/procdump_1.1.1-220_amd64.deb -O procdump.deb \
&& dpkg -i procdump.deb \
&& rm procdump.deb
</code></pre>
<p>本文基于 aspnet:5.0 镜像，即 debian 10，如果基于其他镜像，可去下面目录中寻找对应的包<br>
https://packages.microsoft.com/repos/<br>
也可参考作者提供的安装说明</p>
<p><strong>运行</strong><br>
因为 docker 容器并不能很方便的在启动时同时执行多个进程，所以我们需要一个sh文件以便在启动时同时执行dotnet和procdump。<br>
因为我个人不喜欢在 Dockerfile 之外还要依赖其他文件，所以我直接在 Dockerfile 里进行了sh文件的创建</p>
<pre><code class="language-dockerfile">RUN echo "#!/bin/bash \n\
procdump -M 200 -w dotnet & \n\
dotnet \$1 \n\
" > ./start.sh
RUN chmod +x ./start.sh
ENTRYPOINT ["./start.sh", "<YourApp>.dll"]
</code></pre>
<p>如果有需要的话，也可以自行创建一个start.sh，内容为</p>
<pre><code class="language-dockerfile">#!/bin/bash
procdump -M 200 -w dotnet &
dotnet $1
</code></pre>
<p>Dockerfile 改为</p>
<pre><code class="language-dockerfile">COPY start.sh ./start.sh
RUN chmod +x ./start.sh
ENTRYPOINT ["./start.sh", "<YourApp>.dll"]
</code></pre>
<p>这样就可以了，在docker run的时候会同时启动dotnet和procdump，并且当内存大于200M的时候会自动dump。<br>
还有一点要注意，docker run的时候需要添加--privileged 以提高权限。例如docker run --privileged -it xx<br>
</p>
<p>其中 procdump 的各个参数为</p>
<pre><code class="language-bash">Usage: procdump TARGET
OPTIONS
-h Prints this help screen
-C 当CPU超过或等于指定值（0到100 * nCPU）时，触发核心转储生成。
-c 当CPU小于指定值（0到100 * nCPU）时触发核心转储生成。
-M 当内存提交超过或等于指定值(MB)时，触发核心转储生成
-m 当内存提交小于指定值（MB）时，触发核心转储生成。
-T 当线程数超过或等于指定值时触发。
-F 当文件描述符计数超过或等于指定值时触发。
-I Polling frequency in milliseconds (default is 1000)
-n Number of core dumps to write before exiting (default is 1)
-s Consecutive seconds before dump is written (default is 10)
-d Writes diagnostic logs to syslog
TARGET 以下二选一:
-p 进程的 pid
-w 进程的名字
</code></pre>
<p>举例来说，以下命令表示当 CPU 使用率为>= 65%或内存为>= 100 MB 时创建一个 dump 文件</p>
<pre><code class="language-bash">procdump -C 65 -M 100 -p 1234
</code></pre>
<h4 id="其他">其他</h4>
<p>dump 文件的持久化<br>
大家都知道 docker 容器消失的话，那么其中的 dump 文件也会消失。<br>
所以需要输出 dump 文件到一个指定的、进行过持久化挂载的卷中，不过可惜的是，当前procdump for linux还没有一个输出参数来控制输出目录，只会在应用程序的同级目录生成，所以现在需要手动移动一下。<br>
我看已经有人提了 PR，未来会增加一个 -o 参数以控制输出。</p>
<h3 id="参考">参考</h3>
<p>https://www.cnblogs.com/huangxincheng/p/14661031.html<br>
https://docs.docker.com/config/containers/multi-service_container/<br>
https://github.com/msbrz/procdump-docker</p><br><br>
来源：https://www.cnblogs.com/Rwing/p/docker-net-auto-dump.html
頁:
[1]