Elastic APM 代理配置 API
编辑Elastic APM 代理配置 API
编辑APM 服务器公开 API 终结点，允许 Elastic APM 代理查询 APM 服务器以进行配置更改。有关此功能的更多信息，请参见 Kibana 中的 APM 代理配置。
| 名称 | 终结点 |
|---|---|
代理配置摄入 |
|
RUM 配置摄入 |
|
代理配置终结点接受 HTTP GET 和 HTTP POST 请求。如果配置了 API 密钥 或 密钥令牌，则必须对该终结点的请求进行身份验证。
service.name 是必需的查询字符串参数。
http(s)://{hostname}:{port}/config/v1/agents?service.name=SERVICE_NAME
将参数编码为正文中的 JSON 对象。service.name 是必需的参数。
http(s)://{hostname}:{port}/config/v1/agents
{
"service": {
"name": "test-service",
"environment": "all"
},
"CAPTURE_BODY": "off"
}
- 成功 -
200 - APM 服务器配置为从 Elasticsearch 获取代理配置，但配置无效 -
403 - APM 服务器正在启动或 Elasticsearch 无法访问 -
503
包含服务名称“test-service”的示例代理配置 GET 请求
curl -i http://127.0.0.1:8200/config/v1/agents?service.name=test-service
包含服务名称“test-service”的示例代理配置 POST 请求
curl -X POST http://127.0.0.1:8200/config/v1/agents \
-H "Authorization: Bearer secret_token" \
-H 'content-type: application/json' \
-d '{"service": {"name": "test-service"}}'
HTTP/1.1 200 OK
Cache-Control: max-age=30, must-revalidate
Content-Type: application/json
Etag: "7b23d63c448a863fa"
Date: Mon, 24 Feb 2020 20:53:07 GMT
Content-Length: 98
{
"capture_body": "off",
"transaction_max_spans": "500",
"transaction_sample_rate": "0.3"
}