配置 APM 代理配置

编辑

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

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

这是一个示例配置

apm-server.agent.config.cache.expiration: 45s
apm-server.agent.config.elasticsearch.api_key: TiNAGG4BaaMdaH1tRfuU:KnR6yE41RrSowb0kQ0HWoA
APM 代理配置选项
编辑

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

apm-server.agent.config.cache.expiration编辑

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

apm-server.agent.config.elasticsearch编辑

采用与 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.elasticsearchoutput.elasticsearch (如果未设置 apm-server.agent.config.elasticsearch)中设置的用户或 API 密钥没有足够的权限从 Elasticsearch 读取源映射。

要解决此错误,请确保 APM Server 具有所有必需的权限。有关更多详细信息,请参阅 使用功能角色