sumologic/autoinstrumentation-dotnet

Sumo Logic Kubernetes Collection Dotnet 自动 Instrumentation 镜像

镜像概述和主要用途

该镜像为 Sumo Logic Kubernetes Collection 提供 Dotnet 应用程序的自动 instrumentation 功能，基于 OpenTelemetry Operator 的 autoinstrumentation-dotnet 镜像构建。主要用于在 Kubernetes 环境中为 Dotnet 应用程序自动注入遥测代码，实现无需手动修改应用即可收集分布式追踪、指标和日志数据，并集成到 Sumo Logic 平台进行分析。

核心功能和特性

• 自动注入：无需手动修改 Dotnet 应用代码，即可自动注入 OpenTelemetry instrumentation 逻辑
• 遥测数据收集：支持收集分布式追踪、性能指标和应用日志
• 与 Sumo Logic 集成：适配 Sumo Logic Kubernetes Collection，确保遥测数据正确发送至 Sumo Logic 平台
• 基于 OpenTelemetry：遵循 OpenTelemetry 标准，兼容主流的可观测性工具链

使用场景和适用范围

• Kubernetes 集群中运行的 Dotnet 微服务应用
• 需要实现零代码侵入式遥测数据收集的场景
• 基于 Sumo Logic 平台进行应用可观测性分析的环境
• 希望通过 OpenTelemetry 标准统一收集遥测数据的 Dotnet 应用

使用方法和配置说明

前提条件

• 已部署 Sumo Logic Kubernetes Collection（参考 https://github.com/SumoLogic/sumologic-kubernetes-collection%EF%BC%89
• 已部署 OpenTelemetry Operator（参考 https://github.com/open-telemetry/opentelemetry-operator%EF%BC%89

基本使用

该镜像通常作为 Sumo Logic Kubernetes Collection 的一部分自动部署和配置。具体配置需参考 Sumo Logic Kubernetes Collection 的官方文档，主要涉及：

1. 配置自动 instrumentation 规则，指定需要注入的 Dotnet 应用
2. 设置遥测数据导出器，指向 Sumo Logic 收集端点
3. 配置相关环境变量以调整 instrumentation 行为（如采样率、服务名称等）

配置示例

以下为典型的 Kubernetes 部署配置片段（具体参数需根据实际环境调整）：

yaml
apiVersion: opentelemetry.io/v1alpha1
kind: Instrumentation
metadata:
  name: sumologic-dotnet-instrumentation
spec:
  exporter:
    endpoint: http://sumologic-otel-collector:4317
  dotnet:
    image: sumologic/kubernetes-collection-dotnet-autoinstrumentation:latest
    env:
      - name: OTEL_SERVICE_NAME
        value: "my-dotnet-service"
      - name: OTEL_TRACES_SAMPLER
        value: "parentbased_always_on"

参考文档

• https://github.com/SumoLogic/sumologic-kubernetes-collection
• https://github.com/open-telemetry/opentelemetry-operator/pkgs/container/opentelemetry-operator%2Fautoinstrumentation-dotnet