配置 APM 代理配置

通过 APM 代理配置，您可以从应用程序 UI 中微调 APM 代理。更改会自动传播到您的 APM 代理，因此无需重新部署应用程序。

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

这是一个示例配置

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

以下选项仅适用于 APM Server 二进制用户。您可以在 apm-server.yml 配置文件的 apm-server.agent.config 部分中指定这些选项

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

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

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

当 APM Server 尝试获取 APM 代理配置时，您可能会在 APM Server 中看到以下任一 HTTP 403 错误

APM 代理日志

"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 具有所有必需的权限。有关更多详细信息，请参阅 使用功能角色。