正确使用dotnet-*工具的方法

安装

• 因为我们现在都是容器化时代了，所以我们可以把这类工具全部制作成基础镜像
• 准备Dockerfile

FROM mcr.microsoft.com/dotnet/sdk:3.1 AS sdk
RUN dotnet tool install --tool-path /tools dotnet-trace
RUN dotnet tool install --tool-path /tools dotnet-counters
RUN dotnet tool install --tool-path /tools dotnet-dump
RUN dotnet tool install --tool-path /tools dotnet-gcdump

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 AS runtime
WORKDIR /tools
COPY --from=sdk /tools .

basedockerfile.yaml

验证

基础镜像做好了，查看下镜像的大小应该就比runtime的大小多几十兆，相比为了使用dotnet-* tool而直接采用sdk的话，体积小了很多很多

用我们刚才制作的基础镜像随便起个demo程序验证下

• 已经包含了tools文件夹了，里面存放了我们的tools工具

• 以dotnet-trace为例，测试下是否可用（ps：注意使用方式）

至此包含tools的runtime基础镜像制作完毕。

dotnet-dump

它只能收集托管内存，不能用于条是本地代码的问题，而且分析它所创建的dump文件，必须和当前环境保持一致

createdump

它既可以收集本地信息又可以收集托管信息，是一种比较全面而且推荐的方法

虽然gdb、gcore也能起到同样的作用，但是他们可能会在收集的时候错过一些托管状态，导致最后你分析dump文件的时候有”UNKNOWN“的错误

这个工具是伴随着.net core runtime安装的，目录一般在”/usr/share/dotnet/shared/Microsoft.NETCore.App/[version]“下

开始使用：

• /usr/share/dotnet/shared/Microsoft.NETCore.App/3.1.10/createdump -u 1 （1是我容器中程序的进程id）

• 他会将coredump文件生成到容器的tmp目录下，至此没报错的话，说明成功
• 如果报权限相关错误，可以在你的yaml文件里加上：

分析coredump文件

先将上面生成在tmp下的coredump文件copy到可以调试的地方

kubectl cp  bookstore/demo-7b6d9f6d4f-2t8hl:/tmp/coredump.1 /root/mydump/coredump.1 -c app-k8s

然后为我们的coredump.1文件下载关联的symbol：

如果你准备分析dump的机器没有dotnet sdk的话，先装一个把

• sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
• sudo yum install dotnet-sdk-3.1

如果dotnet-symbol没有安装的话，安装一个

• dotnet tool install --global dotnet-symbol
• 然后关闭当前终端，再打开一个新的

然后执行dotnet-symbol --host-only --debugging coredump.1

• 看到dac，dbi文件写入就代表成功了，这时候你的文件夹应该长这样

然后我们使用lldb进行调试

• 如果你机器里没装的话，先装一个吧
• 安装sos插件：
  • dotnet tool install --global dotnet-sos
  • dotnet-sos install
• lldb-8 --core coredump.1
• 然后就可以用lldb来分析dump文件了

相关资料：

1. https://docs.microsoft.com/en-us/dotnet/core/diagnostics/dotnet-symbol
2. https://github.com/dotnet/diagnostics/blob/master/documentation/debugging-coredump.md
3. https://devblogs.microsoft.com/devops/understanding-symbol-files-and-visual-studios-symbol-settings/
4. https://github.com/dotnet/diagnostics/blob/master/documentation/FAQ.md
5. https://github.com/dotnet/runtime/issues/11012
6. 关于大对象使用的注意点以及官方blob gc的实现描述