配置

编辑

为了使 Elastic APM Java 代理适应您的需求,您可以使用以下方法之一进行配置,这些方法按优先级降序排列

1) 中央配置

在 Kibana APM 应用中配置代理。 动态配置

2) 属性文件

elasticapm.properties 文件位于代理 jar 的同一文件夹中,或者通过 config_file 选项提供。 动态配置

3) Java 系统属性

所有配置键都以 elastic.apm. 为前缀。
dynamic config

4) 环境变量

所有配置键都以大写字母表示,并以 ELASTIC_APM_ 为前缀。

5) 运行时附加参数

  1. --config 参数。
    请参阅 使用 apm-agent-attach-cli.jar 自动设置
  2. ElasticApmAttacher.attach(...) 的参数。
    请参阅 使用编程 API 自行附加的设置
  3. 在类路径根目录中使用 elasticapm.properties 以及 ElasticApmAttacher.attach()
    请参阅 使用编程 API 自行附加的设置

6) 默认值

为每个配置定义。

动态配置 动态配置

编辑

当从支持的源设置时,标记为“动态”为 true 的配置选项可以在运行时更改

  • 中央配置
  • elasticapm.properties 文件
  • Java 系统属性,但仅当从应用程序内部设置时

使用 elasticapm.properties 有两种不同的方式:作为外部配置文件和作为类路径资源。
只有外部文件才能用于动态配置。

最小配置

编辑

为了开始使用 Elastic APM,最重要的配置选项是 service_nameserver_urlapplication_packages。请注意,即使这些设置也是可选的。单击它们的名称可查看如何确定默认值。

配置示例如下

系统属性。

-Delastic.apm.service_name=my-cool-service
-Delastic.apm.application_packages=org.example,org.another.example
-Delastic.apm.server_url=http://127.0.0.1:8200

elasticapm.properties。

service_name=my-cool-service
application_packages=org.example,org.another.example
server_url=http://127.0.0.1:8200

环境变量。

ELASTIC_APM_SERVICE_NAME=my-cool-service
ELASTIC_APM_APPLICATION_PACKAGES=org.example,org.another.example
ELASTIC_APM_SERVER_URL=http://127.0.0.1:8200

选项参考

编辑

这是按类别分组的所有配置选项的列表。单击某个键可获取更多信息。