配置 APM Agent 中央配置

Elastic Stack

APM Agent 中央配置允许您从应用程序 UI 中微调您的 APM Agent。 更改会自动传播到您的 APM Agent，因此无需重新部署您的应用程序。

要了解有关此功能的更多信息，请参阅 APM Agent 中央配置。

以下选项仅支持 APM Server 二进制文件用户.

您可以在 apm-server.yml 配置文件的 apm-server.agent.config 部分中指定 APM Agent 配置选项。 这是一个示例配置

apm-server.agent.config.cache.expiration: 45s
apm-server.agent.config.elasticsearch.api_key: TiNAGG4BaaMdaH1tRfuU:KnR6yE41RrSowb0kQ0HWoA

1. 您必须将要配置的 API 密钥设置为 Beats。 此配置目前不支持 Base64 编码的 API 密钥。 有关如何创建和配置兼容 API 密钥的详细信息，请参阅 创建用于写入事件的 API 密钥。

使用 APM Agent 中央配置时，从 Elasticsearch 获取的信息将在内存中缓存一段时间。 通过此设置指定缓存过期时间。 默认为 30s（30 秒）。

采用与 output.elasticsearch 相同的选项。

对于 APM Server 二进制文件用户和 Elastic Agent 独立管理的 APM Server，APM Agent 中央配置会自动从 Elasticsearch 中提取，使用 output.elasticsearch 配置。 如果 output.elasticsearch 未设置或没有足够的权限，请使用这些 Elasticsearch 选项来提供 Elasticsearch 访问。

当 APM Server 尝试获取 APM Agent 中央配置时，您可能会看到来自 APM Server 的以下任一 HTTP 403 错误

APM Agent 日志

"Your Elasticsearch configuration does not support agent config queries. Check your configurations at `output.elasticsearch` or `apm-server.agent.config.elasticsearch`."

APM Server 日志

rejecting fetch request: no valid elasticsearch config

发生此问题的原因是，在 apm-server.agent.config.elasticsearch 或 output.elasticsearch（如果未设置 apm-server.agent.config.elasticsearch）中设置的用户或 API 密钥没有足够的权限从 Elasticsearch 读取源映射。

要修复此错误，请确保 APM Server 具有所有必需的权限。 有关更多详细信息，请参阅 创建中央配置管理角色。

如果您从 APM Server 收到 HTTP 401 错误，请确保您使用的是配置为 Beats 的 API 密钥。 有关如何创建和配置兼容 API 密钥的详细信息，请参阅 创建用于写入事件的 API 密钥。