otel/autoinstrumentation-java

OpenTelemetry Operator Java自动插桩代理镜像

镜像概述和主要用途

该镜像是OpenTelemetry Operator使用的Java自动插桩代理，主要用于为Java应用提供无侵入式的可观测性数据收集能力。作为OpenTelemetry可观测性生态的关键组件，它能够自动实现Java应用的追踪、指标等数据采集，简化与OpenTelemetry Operator的集成流程。

核心功能和特性

• Java自动插桩：支持主流Java框架和库的自动 instrumentation，无需手动修改应用代码
• Operator集成：专为OpenTelemetry Operator设计，可通过Operator实现配置管理和自动注入
• 标准兼容：遵循OpenTelemetry规范，确保生成的可观测性数据与OpenTelemetry后端无缝对接

使用场景和适用范围

• Kubernetes环境：适用于部署在Kubernetes集群中，由OpenTelemetry Operator管理的Java应用
• 微服务架构：特别适合微服务环境下的Java服务，需实现分布式追踪、性能监控等可观测性功能
• 无侵入集成需求：适用于希望通过自动插桩而非代码改造实现OpenTelemetry集成的场景

使用方法和配置说明

前提条件

• 已部署OpenTelemetry Operator（参考https://github.com/open-telemetry/opentelemetry-operator#installation%EF%BC%89
• Kubernetes集群环境（1.21+推荐）

基本使用流程

1. 通过OpenTelemetry Operator创建Instrumentation自定义资源
2. 在Instrumentation资源中配置Java代理相关参数
3. 为目标Java应用添加注解，使Operator自动注入该代理

配置示例

Instrumentation资源配置示例：

yaml
apiVersion: opentelemetry.io/v1alpha1
kind: Instrumentation
metadata:
  name: java-instrumentation
spec:
  java:
    image: <该代理镜像地址>
    env:
      - name: OTEL_TRACES_EXPORTER
        value: otlp
      - name: OTEL_METRICS_EXPORTER
        value: otlp

应用注解示例：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: java-app
spec:
  template:
    metadata:
      annotations:
        instrumentation.opentelemetry.io/inject-java: "true"
    spec:
      containers:
        - name: java-app
          image: your-java-app-image:latest

详细配置参数

完整配置参数请参考https://github.com/open-telemetry/opentelemetry-operator/blob/main/docs/configuration.md#java-instrumentation

相关资源

• 代码仓库：https://github.com/open-telemetry/opentelemetry-operator
• 贡献指南：https://github.com/open-telemetry/opentelemetry-operator/blob/main/CONTRIBUTING.md
• 官方文档：opentelemetry.io