v2.11.0-guance

重大改变

版本2.x开头的版本与1.x版本有这很多破坏性的改动，同时也是两个分支。

版本v1 不做功能的开发，仅仅维护和修复一些bug。

---

V2 版本相对于 V1 版本做了哪些破坏性的改动：

• The default OTLP protocol has been changed from grpc to http/protobuf in order to align with
  the specification.
  You can switch to the grpc protocol using OTEL_EXPORTER_OTLP_PROTOCOL=grpc
  or -Dotel.exporter.otlp.protocol=grpc.
• Micrometer metric bridge has been disabled by default. You can enable it using
  OTEL_INSTRUMENTATION_MICROMETER_ENABLED=true
  or -Dotel.instrumentation.micrometer.enabled=true.
• The OTLP logs exporter is now enabled by default. You can disable it using
  OTEL_LOGS_EXPORTER=none or -Dotel.logs.exporter=none.
• Controller spans are now disabled by default. You can enable them using
  OTEL_INSTRUMENTATION_COMMON_EXPERIMENTAL_CONTROLLER_TELEMETRY_ENABLED=true
  or -Dotel.instrumentation.common.experimental.controller-telemetry.enabled=true.
• View spans are now disabled by default. You can enable them using
  OTEL_INSTRUMENTATION_COMMON_EXPERIMENTAL_VIEW_TELEMETRY_ENABLED=true
  or -Dotel.instrumentation.common.experimental.view-telemetry.enabled=true.
• ⚠️⚠️ Stable HTTP semantic conventions are now emitted ⚠️⚠️
  • TOO MANY CHANGES TO LIST HERE, be sure to review the full
    list of changes. 见下文 HTTP 改动
• Stable JVM semantic conventions are now emitted.

  • Memory metrics

    • process.runtime.jvm.memory.usage renamed to jvm.memory.used
    • process.runtime.jvm.memory.committed renamed to jvm.memory.committed
    • process.runtime.jvm.memory.limit renamed to jvm.memory.limit
    • process.runtime.jvm.memory.usage_after_last_gc renamed to jvm.memory.used_after_last_gc
    • process.runtime.jvm.memory.init renamed to jvm.memory.init (still experimental)
    • Metric attributes
      • type renamed to jvm.memory.type
      • pool renamed to jvm.memory.pool.name

  • Garbage collection metrics

    • process.runtime.jvm.gc.duration renamed to jvm.gc.duration
    • Metric attributes
      • name renamed to jvm.gc.name
      • action renamed to jvm.gc.action

  • Thread metrics

    • process.runtime.jvm.threads.count renamed to jvm.threads.count
    • Metric attributes
      • daemon renamed to jvm.thread.daemon

  • Classes metrics

    • process.runtime.jvm.classes.loaded renamed to jvm.classes.loaded
    • process.runtime.jvm.classes.unloaded renamed to jvm.classes.unloaded
    • process.runtime.jvm.classes.current_loaded renamed to jvm.classes.count

  • CPU metrics

    • process.runtime.jvm.cpu.utilization renamed to jvm.cpu.recent_utilization
    • process.runtime.jvm.system.cpu.load_1m renamed to jvm.system.cpu.load_1m (still experimental)
    • process.runtime.jvm.system.cpu.utilization renamed to jvm.system.cpu.utilization (still experimental)

  • Buffer metrics

    • process.runtime.jvm.buffer.limit renamed to jvm.buffer.memory.limit (still experimental)
    • process.runtime.jvm.buffer.count renamed to jvm.buffer.count (still experimental)
    • process.runtime.jvm.buffer.usage renamed to jvm.buffer.memory.usage (still experimental)
    • Metric attributes
      • pool renamed to jvm.buffer.pool.name

  • HTTP 的改动在open-telemetry-docs

原文地址：https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/CHANGELOG.md#version-200-2024-01-12

---

使用 http/protobuf

使用 http 的话，每个exporter路径需要显性配置 如：

java -javaagent:/usr/local/ddtrace/opentelemetry-javaagent-2.11.0.jar \
  -Dotel.exporter=otlp \
  -Dotel.exporter.otlp.protocol=http/protobuf \
  -Dotel.exporter.otlp.logs.endpoint=http://localhost:9529/otel/v1/logs \
  -Dotel.exporter.otlp.traces.endpoint=http://localhost:9529/otel/v1/trace \
  -Dotel.exporter.otlp.metrics.endpoint=http://localhost:9529/otel/v1/metric \
  -Dotel.service.name=client \
  -jar tmall.jar

使用 grpc 协议的话，grpc必须是显式配置，否则就是默认的http协议：

java -javaagent:/usr/local/ddtrace/opentelemetry-javaagent-2.5.0.jar \
  -Dotel.exporter=otlp \
  -Dotel.exporter.otlp.protocol=grpc \
  -Dotel.exporter.otlp.endpoint=http://localhost:4317
  -Dotel.service.name=client \
  -jar tmall.jar

开启debug：

-Dotel.javaagent.debug=true

日志

默认日志是开启的，要关闭日志采集的话，exporter 配置为空即可：-Dotel.logs.exporter=none

指标

指标变化大,很多的指标都重命名了。

仪表板需要重新做

V1.31.0-guance

合并v1.30.0tag

v1.28.1-guance

脱敏参数聚合到一个tag中origin_sql_args

V1.28.0

Merge open-telemetry v1.28.0

V1.26.3-guance

add:

#17

V1.26.2-guance

增加功能

• DB语句清理（sql 脱敏处理） #16

v1.26.1-guance

新增 2 个 instrumentation

• 非侵入方式支持获取特定方法的入参信息 #12
• 阿里 HSF 框架集成 #14

v1.26.0-guance

更新日志

新增

支持达梦国产数据库 #5

其他

merge v1.26.0 #6

v1.25.0-guance

新增三个 instrumentation

• xxl-job2.3(支持 xxl-job #1)
• alibaba-dubbo(dubbox)(#2 )
• Thrift(#3 )

merge v1.25.0