配置 APM 代理配置

APM 代理配置允许您在 APM 应用程序中微调 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 代理配置会自动从 Elasticsearch 中获取，使用 output.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 具有所有必需的权限。有关更多详细信息，请参阅 APM Server 代理集中配置管理。