Reporter 配置选项

secret_token编辑

此字符串用于确保只有您的代理可以将数据发送到您的 APM 服务器。

代理和 APM 服务器都必须配置相同的密钥。

api_key编辑

此字符串用于确保只有您的代理可以将数据发送到您的 APM 服务器。

代理可以使用 API 密钥来代替密钥，APM 服务器可以有多个 API 密钥。当同时使用密钥和 API 密钥时，API 密钥优先级更高，密钥将被忽略。

server_url编辑

URL 必须是完整的，包括协议（http 或 https）和端口。

如果在 APM 服务器上启用了 SSL，请使用 https 协议。有关更多信息，请参阅 与 APM 服务器进行 SSL/TLS 通信。

如果出站 HTTP 流量必须通过代理，则可以使用 Java 系统属性 http.proxyHost 和 http.proxyPort 进行设置。有关更多信息，另请参阅 Java 的代理文档。

server_urls编辑

URL 必须是完整的，包括协议（http 或 https）和端口。

如果连接出错，则故障转移到列表中的下一个 APM 服务器 URL。通过随机排列已配置 URL 的列表来实现负载均衡。当多个代理处于活动状态时，由于随机化，它们往往会均匀分布在服务器集中。

如果在 APM 服务器上启用了 SSL，请使用 https 协议。有关更多信息，请参阅 与 APM 服务器进行 SSL/TLS 通信。

如果出站 HTTP 流量必须通过代理，则可以使用 Java 系统属性 http.proxyHost 和 http.proxyPort 进行设置。有关更多信息，另请参阅 Java 的代理文档。

disable_send编辑

如果设置为 true，则代理将照常工作，但不需要与 APM 服务器进行通信的任何任务除外。事件将被丢弃，并且代理将无法接收中央配置，这意味着在这种状态下，如果不重新启动服务，则无法更改任何其他配置。此功能的一个示例用例是保持通过日志关联功能创建跟踪和记录跟踪/事务/跨度 ID 的能力，而无需设置 APM 服务器。

server_timeout编辑

如果对 APM 服务器的请求花费的时间超过配置的超时时间，则该请求将被取消，并且该事件（异常或事务）将被丢弃。设置为 0 可禁用超时。

支持持续时间后缀 ms、s 和 m。例如：5s。

verify_server_cert编辑

默认情况下，如果您使用 HTTPS 连接到 APM 服务器，则代理会验证 SSL 证书。

可以通过将此设置更改为 false 来禁用验证。

max_queue_size编辑

缓冲事件的最大大小。

当代理无法跟上将事务和跨度等事件发送到 APM 服务器的速度或 APM 服务器关闭时，会对这些事件进行缓冲。

如果队列已满，则事件将被拒绝，这意味着在这种情况下您将丢失事务和跨度。这可以防止应用程序在 APM 服务器长时间不可用的情况下崩溃。

较低的值将减少代理的堆开销，而较高的值则可以降低在吞吐量暂时激增的情况下丢失事件的可能性。

include_process_args编辑

是否应将每个事务附加进程参数。默认情况下禁用以节省磁盘空间。

api_request_time编辑

保持对 APM 服务器的 HTTP 请求打开的最长时间。

支持持续时间后缀 ms、s 和 m。例如：10s。

api_request_size编辑

通过分块编码（HTTP 流式传输）发送到 APM 服务器接收 API 的请求正文的最大总压缩大小。请注意，可能会出现少量超调。

允许的字节单位为 b、kb 和 mb。 1kb 等于 1024b。

metrics_interval ( [1.3.0] 在 1.3.0 中添加。 )编辑

代理将指标发送到 APM 服务器的时间间隔，向下舍入到最接近的秒数（即 3783 毫秒将应用为 3000 毫秒）。如果在 Meter 中定义了间隔（步长），则将改为使用该间隔（最接近的秒数）。如果 Meter 步长时间隔小于 1 秒，则不会报告该 Meter。必须至少为 1s。设置为 0s 可停用。

支持持续时间后缀 ms、s 和 m。例如：30s。

disable_metrics ( [1.3.0] 在 1.3.0 中添加。 )编辑

禁用某些指标的收集。如果指标的名称与任何通配符表达式匹配，则不会收集该指标。例如：foo.*,bar.*

此选项支持通配符 *，它匹配零个或多个字符。例如：/foo/*/bar/*/baz*、*foo*。默认情况下，匹配不区分大小写。在元素前面加上 (?-i) 会使匹配区分大小写。