配置
编辑配置编辑
要使 Elastic APM Java 代理适应您的需求，您可以使用以下方法之一进行配置，这些方法按优先级降序排列
|
1) 集中配置 |
在 Kibana APM 应用中配置代理。 |
|
2) 属性文件 |
|
|
3) Java 系统属性 |
所有配置键均以 |
|
4) 环境变量 |
所有配置键均为大写，并以 |
|
5) 运行时附加参数 |
|
|
6) 默认值 |
为每个配置定义。 |
动态配置 
编辑
当从支持的源设置时，标记为“动态”为“真”的配置选项可以在运行时更改
- 集中配置
-
elasticapm.properties文件 - Java 系统属性，但仅限从应用程序内部设置时
使用 elasticapm.properties 有两种不同的方式：作为外部配置文件和作为类路径资源。
只有外部文件可用于动态配置。
最小配置编辑
为了开始使用 Elastic APM，最重要的配置选项是 service_name、server_url 和 application_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
选项参考编辑
这是按类别分组的所有配置选项的列表。单击某个键以获取更多信息。
-
-
circuit_breaker_enabled( [1.14.0] 在 1.14.0 中添加。 性能) -
stress_monitoring_interval(性能) -
stress_monitor_gc_stress_threshold(性能) -
stress_monitor_gc_relief_threshold(性能) -
stress_monitor_cpu_duration_threshold(性能) -
stress_monitor_system_cpu_stress_threshold(性能) -
stress_monitor_system_cpu_relief_threshold(性能)
-
-
-
recording( [1.15.0] 在 1.15.0 中添加。 ) -
enabled( [1.18.0] 在 1.18.0 中添加。 ) -
instrument( [1.0.0] 在 1.0.0 中添加。自 1.15.0 版起，可以在运行时更改此值 ) -
service_name -
service_node_name( [1.11.0] 在 1.11.0 中添加。 ) -
service_version -
hostname( [1.10.0] 在 1.10.0 中添加。 ) -
environment -
transaction_sample_rate(性能) -
transaction_max_spans(性能) -
long_field_max_length(性能 [1.37.0] 在 1.37.0 中添加。 ) -
sanitize_field_names(安全) -
enable_instrumentations( [1.28.0] 在 1.28.0 中添加。 ) -
disable_instrumentations( [1.0.0] 在 1.0.0 中添加。自 1.15.0 版起，可以在运行时更改此值 ) -
enable_experimental_instrumentations( [1.25.0] 在 1.25.0 中添加。 ) -
unnest_exceptions -
ignore_exceptions( [1.11.0] 在 1.11.0 中添加。 ) -
capture_body(性能) -
capture_headers(性能) -
global_labels( [1.7.0] 在 1.7.0 中添加。需要 APM 服务器 7.2+ ) -
instrument_ancient_bytecode( [1.35.0] 在 1.35.0 中添加。 ) -
context_propagation_only( [1.44.0] 在 1.44.0 中添加。 ) -
classes_excluded_from_instrumentation -
trace_methods( [1.0.0] 在 1.0.0 中添加。自 1.15.0 版起，可以在运行时更改此值 ) -
trace_methods_duration_threshold( [1.7.0] 在 1.7.0 中添加。 ) -
central_config( [1.8.0] 在 1.8.0 中添加。 ) -
breakdown_metrics( [1.8.0] 在 1.8.0 中添加。 ) -
config_file( [1.8.0] 在 1.8.0 中添加。 ) -
plugins_dir(实验性) -
use_elastic_traceparent_header( [1.14.0] 在 1.14.0 中添加。 ) -
disable_outgoing_tracecontext_headers( [1.37.0] 在 1.37.0 中添加。 ) -
span_min_duration( [1.16.0] 在 1.16.0 中添加。 ) -
cloud_provider( [1.21.0] 在 1.21.0 中添加。 ) -
enable_public_api_annotation_inheritance(性能) -
transaction_name_groups( [1.33.0] 在 1.33.0 中添加。 ) -
trace_continuation_strategy( [1.34.0] 在 1.34.0 中添加。 ) -
baggage_to_attach( [1.43.0] 在 1.43.0 中添加。 )
-
-
-
log_level -
log_file -
log_ecs_reformatting( [1.22.0] 于 1.22.0 版本中添加。（实验性功能） ) -
log_ecs_reformatting_additional_fields( [1.26.0] 于 1.26.0 版本中添加。 ) -
log_ecs_formatter_allow_list -
log_ecs_reformatting_dir -
log_file_size( [1.17.0] 于 1.17.0 版本中添加。 ) -
log_format_sout( [1.17.0] 于 1.17.0 版本中添加。 ) -
log_format_file( [1.17.0] 于 1.17.0 版本中添加。 ) -
log_sending( [1.36.0] 于 1.36.0 版本中添加。（实验性功能） )
-
-
-
dedot_custom_metrics( [1.22.0] 于 1.22.0 版本中添加。 ) -
custom_metrics_histogram_boundaries( [1.37.0] 于 1.37.0 版本中添加。（实验性功能） ) -
metric_set_limit( [1.33.0] 于 1.33.0 版本中添加。 ) -
agent_reporter_health_metrics( [1.35.0] 于 1.35.0 版本中添加。（实验性功能） ) -
agent_background_overhead_metrics( [1.35.0] 于 1.35.0 版本中添加。（实验性功能） )
-
-
-
universal_profiling_integration_enabled( [1.50.0] 于 1.50.0 版本中添加。 ) -
universal_profiling_integration_buffer_size( [1.50.0] 于 1.50.0 版本中添加。 ) -
universal_profiling_integration_socket_dir( [1.50.0] 于 1.50.0 版本中添加。 ) -
profiling_inferred_spans_enabled( [1.15.0] 于 1.15.0 版本中添加。（实验性功能） ) -
profiling_inferred_spans_logging_enabled( [1.37.0] 于 1.37.0 版本中添加。 ) -
profiling_inferred_spans_sampling_interval( [1.15.0] 于 1.15.0 版本中添加。 ) -
profiling_inferred_spans_min_duration( [1.15.0] 于 1.15.0 版本中添加。 ) -
profiling_inferred_spans_included_classes( [1.15.0] 于 1.15.0 版本中添加。 ) -
profiling_inferred_spans_excluded_classes( [1.15.0] 于 1.15.0 版本中添加。 ) -
profiling_inferred_spans_lib_directory( [1.18.0] 于 1.18.0 版本中添加。 )
-