pyroscope/pyroscope-dotnet

Pyroscope .NET性能分析器原生库Docker镜像

镜像概述

Pyroscope .NET性能分析器原生库镜像（pyroscope/pyroscope-dotnet）是Grafana Pyroscope项目提供的Docker镜像，包含.NET应用集成Pyroscope性能分析工具所需的原生共享库文件。该镜像旨在简化Docker化.NET应用中Pyroscope性能分析功能的集成过程，提供预编译的原生库以支持性能数据采集。

核心功能与特性

• 提供关键原生库：包含Pyroscope.Profiler.Native.so（性能分析器核心库）和Pyroscope.Linux.ApiWrapper.x64.so（Linux系统调用包装库），为.NET应用提供性能数据采集能力。
• 多环境支持：通过镜像标签区分C标准库环境，支持glibc（适用于大多数Linux发行版，如Debian、Ubuntu）和musl（适用于Alpine Linux）。
• 版本化管理：镜像标签遵循<版本>-<libc类型>格式（如0.8.5-glibc），确保依赖版本一致性，便于版本控制和升级。

使用场景

适用于需要在Docker容器中运行的.NET应用程序，需集成Pyroscope进行性能数据采集与分析的场景，例如：

• Docker化的生产环境.NET服务性能监控
• 容器化.NET应用的性能问题诊断与优化
• 基于Pyroscope的分布式追踪与性能分析平台构建

使用方法与配置说明

基础使用步骤（glibc环境）

若应用镜像基于glibc环境（如使用mcr.microsoft.com/dotnet/aspnet等官方非Alpine基础镜像），可通过以下步骤集成：

1. 在应用Dockerfile中，使用COPY --from指令从该镜像复制原生库文件到应用镜像中：

   dockerfile
   # 适用于glibc环境的.NET应用Dockerfile
   COPY --from=pyroscope/pyroscope-dotnet:0.8.5-glibc /Pyroscope.Profiler.Native.so ./Pyroscope.Profiler.Native.so
   COPY --from=pyroscope/pyroscope-dotnet:0.8.5-glibc /Pyroscope.Linux.ApiWrapper.x64.so ./Pyroscope.Linux.ApiWrapper.x64.so
   

Alpine Linux（musl环境）适配

若应用基于Alpine Linux（使用musl libc，如mcr.microsoft.com/dotnet/aspnet:alpine），需使用musl版本镜像，将镜像标签中的glibc替换为musl：

dockerfile
# 适用于Alpine Linux（musl环境）的.NET应用Dockerfile
COPY --from=pyroscope/pyroscope-dotnet:0.8.5-musl /Pyroscope.Profiler.Native.so ./Pyroscope.Profiler.Native.so
COPY --from=pyroscope/pyroscope-dotnet:0.8.5-musl /Pyroscope.Linux.ApiWrapper.x64.so ./Pyroscope.Linux.ApiWrapper.x64.so

配置说明

• 镜像标签选择：根据基础镜像的C标准库类型选择标签，glibc对应常规Linux发行版，musl对应Alpine Linux。
• 版本兼容性：确保镜像版本与应用使用的Pyroscope .NET SDK版本兼容（建议参考https://github.com/grafana/pyroscope-dotnet%EF%BC%89%E3%80%82
• 库文件加载：复制的库文件需放置在.NET应用可访问的路径（如应用工作目录），确保运行时能正确加载。