配置

了解更多信息

本页介绍了向 Java 代理提供配置的多种方式。有关配置选项本身的信息，请参阅配置 SDK。

代理配置

代理可以从以下一个或多个来源（按优先级从高到低排序）获取配置：

在某些环境中，通常更喜欢通过环境变量来配置设置。任何可以使用系统属性配置的设置也可以使用环境变量进行设置。虽然下面的许多设置都提供了两种格式的示例，但对于那些没有提供的设置，请使用以下步骤来确定所需系统属性的正确名称映射：

例如，otel.instrumentation.common.default-enabled 将转换为 OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED。

你可以通过设置以下属性来提供代理配置文件的路径：

System property: otel.javaagent.configuration-file

Environment variable: OTEL_JAVAAGENT_CONFIGURATION_FILE

Description: 指向包含代理配置的有效 Java 属性文件的路径。

你可以通过设置以下属性来启用扩展：

System property: otel.javaagent.extensions

Environment variable: OTEL_JAVAAGENT_EXTENSIONS

Description: 指向扩展 jar 文件或文件夹的路径，包含 jar 文件。如果指向文件夹，则该文件夹中的每个 jar 文件都将被视为单独的、独立的扩展。

-->

可通过设置以下属性配置代理的日志输出：

System property: otel.javaagent.logging

Environment variable: OTEL_JAVAAGENT_LOGGING

Description: Java 代理日志记录模式。支持以下 3 种模式：

simple：代理将使用标准错误流打印其日志。只会打印 INFO 或更高级别的日志。这是默认的 Java 代理日志记录模式。
none：代理不会记录任何内容，甚至不会记录其自身版本。
application：代理将尝试将其自身的日志重定向到已插桩应用程序的 slf4j 记录器。这对于不使用多个类加载器的简单 one-jar 应用程序中效果最好； Spring Boot 应用程序也受支持。 Java 代理的输出日志可以使用被插桩应用程序的日志配置（例如 logback.xml 或 log4j2.xml）进一步配置。 确保在将此模式用于生产环境之前测试其是否适用于应用程序。

SDK 的自动配置模块用于代理的基本配置。阅读文档以查找诸如配置导出或采样等设置。

重要

与 SDK 自动配置不同，Java 代理和 OpenTelemetry Spring Boot 启动器的 2.0+ 版本使用 http/protobuf 作为默认协议，而不是 grpc。

除了来自 SDK 自动配置的资源配置外，您还可以启用默认处于禁用状态的额外资源提供程序：

System property: otel.resource.providers.aws.enabled

Environment variable: OTEL_RESOURCE_PROVIDERS_AWS_ENABLED

Default: false
Description: 启用 AWS 资源提供程序。

System property: otel.resource.providers.gcp.enabled

Environment variable: OTEL_RESOURCE_PROVIDERS_GCP_ENABLED

Default: false
Description: 启用 GCP 资源提供程序。

System property: otel.resource.providers.azure.enabled

Environment variable: OTEL_RESOURCE_PROVIDERS_AZURE_ENABLED

Default: false
Description: 启用 Azure 资源提供程序。

Was this page helpful?

Thank you. Your feedback is appreciated!

Please let us know how we can improve this page. Your feedback is appreciated!