更新监控配置设置
所需角色
此资源需要 Project Automation Admin
角色。
Resource
基本 URL: https://cloud.mongodb.com/api/public/v 1.0
PUT /groups/{PROJECT-ID}/automationConfig/monitoringAgentConfig
请求
路径参数
名称 | 类型 | 必要性 | 说明 |
---|---|---|---|
PROJECT-ID | 字符串 | 必需 | 唯一的 24-十六进制数字string ,用于标识拥有该配置的项目。 |
查询参数
以下查询参数为可选参数:
名称 | 类型 | 必要性 | 说明 | 默认 | ||||||
---|---|---|---|---|---|---|---|---|---|---|
pretty | 布尔 | Optional | 指示响应正文是否应采用 美观打印 的标志 格式。 |
| ||||||
envelope | 布尔 | Optional | 指示是否将响应包装在信封中的标志。 某些 API 客户端无法访问 HTTP 响应标头或状态代码。要解决这个问题,可在查询中设置 envelope=true。 对于返回一个结果的端点,响应体包括:
|
|
正文参数
要使用 MongoDB 助手更改这些设置,请在请求正文中包含一个或多个参数。
Parameter | 类型 | 必要性 | 说明 |
---|---|---|---|
configOverrides | 对象 | Optional | 由于您的监控设置与MongoDB Agent的监控设置不同而需要更改的 MongoDB Agent设置列表。从旧版代理升级到 MongoDB Agent时,请配置此选项。 |
logPath | 字符串 | Optional | 此 MongoDB 助手写入日志的绝对文件路径。 如果未指定,则在基于 UNIX 和 Linux 的系统上,日志将写入标准错误 ( |
logRotate | 对象 | Optional | 此 MongoDB Agent 轮换监控日志的阈值。 |
logRotate .sizeThresholdMB | 整型 | Optional | 此 MongoDB Agent 轮换日志文件之前的最大大小(以 MB 为单位)。 |
logRotate .timeDurationHrs | 整型 | Optional | 此 MongoDB Agent 轮换日志文件的小时数。 |
用户名 | 字符串 | Optional | 在应用程序数据库中托管监控日志的 MongoDB 用户。 如果使用API为 MongoDB Agent 启用身份验证,请在执行此端点时将此参数设置为mms-自动化 。 |
响应
Parameter | 类型 | 必要性 | 说明 |
---|---|---|---|
configOverrides | 对象 | Optional | 由于您的监控设置与MongoDB Agent的监控设置不同而需要更改的 MongoDB Agent设置列表。从旧版代理升级到 MongoDB Agent时,请配置此选项。 |
logPath | 字符串 | Optional | 此 MongoDB 助手写入日志的绝对文件路径。 如果未指定,则在基于 UNIX 和 Linux 的系统上,日志将写入标准错误 ( |
logRotate | 对象 | Optional | 此 MongoDB Agent 轮换监控日志的阈值。 |
logRotate .sizeThresholdMB | 整型 | Optional | 此 MongoDB Agent 轮换日志文件之前的最大大小(以 MB 为单位)。 |
logRotate .timeDurationHrs | 整型 | Optional | 此 MongoDB Agent 轮换日志文件的小时数。 |
用户名 | 字符串 | Optional | 在应用程序数据库中托管监控日志的 MongoDB 用户。 如果使用API为 MongoDB Agent 启用身份验证,请在执行此端点时将此参数设置为mms-自动化 。 |
请求示例
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ 2 --header "Accept: application/json" \ 3 --header "Content-Type: application/json" \ 4 --include \ 5 --request PUT "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/monitoringAgentConfig" 6 --data '{ 7 "configOverrides" : { 8 "mmsBaseUrl" : "http://new.example.org" 9 }, 10 "logPath": "/var/log/mongodb-mms-automation/monitoring-agent.log", 11 "logRotate": { 12 "sizeThresholdMB": 1000, 13 "timeThresholdHrs": 12 14 }, 15 "username": "mms-automation" 16 }'
响应
响应标头
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
响应体
此端点返回一个空的JSON对象。