모든 전역 경고 구성 가져오기
모든 전역 경고 구성을 조회합니다.
필수 역할
다음과 같은 할당된 역할을 사용하여 이 엔드포인트를 성공적으로 호출할 수 있습니다.
요청
기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
GET /globalAlertConfigs
요청 경로 매개변수
이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.
요청 쿼리 매개변수
이름 | 유형 | 필요성 | 설명 | 기본값 |
---|---|---|---|---|
pageNum | 숫자 | 옵션 | 결과의 하위 섹션을 반환하는 1부터 시작하는 정수입니다. | 1 |
itemsPerPage | 숫자 | 옵션 | 페이지당 반환할 항목 수. 최대 500개까지 가능합니다. | 100 |
pretty | 부울 | 옵션 | false | |
envelope | 부울 | 옵션 | 응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 결과 목록을 반환하는 엔드포인트의 경우 | false |
요청 본문 매개변수
이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.
응답
응답 문서
응답 JSON 문서에는 result 객체 배열, link 객체 배열, 조회된 result 객체의 총 개수가 포함되어 있습니다.
이름 | 유형 | 설명 |
---|---|---|
results | 배열 | 배열에는 results 내장된 문서 섹션에 자세히 설명된 각 항목에 대해 하나의 객체가 포함됩니다. |
links | 배열 | 배열에 하위 리소스 및/또는 관련 리소스에 대한 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다. |
totalCount | 숫자 | 결과 집합에 있는 총 항목 수의 정수 개수입니다. 전체 결과 집합이 페이지로 매겨진 경우 results 배열의 객체 수보다 클 수 있습니다. |
results
embeddedDocument
각 결과 는 하나의 경고 구성입니다.
이름 | 유형 | 설명 |
---|---|---|
created | 문자열 | ISO 8601 의 타임스탬프 경고 구성이 생성된 시점의 UTC 날짜 및 시간 형식입니다. |
enabled | 부울 | 경고 구성의 활성화 여부를 지정하는 토글입니다. |
eventTypeName | 문자열 | 이 경고 구성이 Atlas가 경고를 트리거하는 이벤트 유형입니다. 경고를 생성하는 이벤트 유형을 검토하려면 경고 유형을 참조하세요. Ops Manager 감사 로그에 포함된 이벤트의 전체 목록은 감사 이벤트를 참조하세요. |
forAllGroups | 부울 | 전역 경고 구성을 모든 그룹에 적용할지 여부를 지정하는 토글입니다. 또한
|
groupIds | 문자열 배열 | 이 경고 구성이 적용되는 그룹의 ID입니다. 이 필드는 forAllGroups 이(가) false (으)로 설정된 경우에만 적용됩니다. |
id | 문자열 | 경고 구성의 고유 식별자입니다. |
matchers | 객체 배열 | 이 전역 경고 구성과 객체를 일치시킬 때 적용할 규칙입니다. MongoDB Ops Manager는 경고 조건에 대해 이러한 모든 규칙과 일치하는 엔터티만 확인합니다.
|
matchers.fieldName | 문자열 | 일치시킬 대상 객체의 필드 이름입니다.
다른 모든 유형의 경고는 매처를 지원하지 않습니다. |
matchers.operator | 문자열 | 필드 값을 테스트하는 연산자입니다. 가능한 값은 다음과 같습니다.
|
matchers.value | 문자열 | 지정된 연산자로 테스트할 값입니다.
|
metricThreshold | 객체 | 이 경고 구성이 경고를 trigger 하도록 하는 임계값입니다. eventTypeName 이(가) OUTSIDE_METRIC_THRESHOLD (으)로 설정된 경우에만 표시됩니다. |
metricThreshold.metricName | 문자열 | |
metricThreshold.mode | 문자열 | 이 값은 AVERAGE 으)로 설정되고 현재 지표 값을 평균으로 계산합니다. |
metricThreshold.operator | 문자열 |
|
metricThreshold.threshold | 숫자 | 이 경고 구성을 벗어나는 임계값으로 Atlas가 경고를 트리거합니다. |
metricThreshold.units | 문자열 |
허용되는 값은 다음과 같습니다.
예를 예시 메모리 소비를 측정하는 지표에는 |
notifications | 객체 배열 | 알림 MongoDB Ops Manager는 이 경고 구성에서 설명하는 경고를 감지하면 전송합니다. |
notifications.apiToken | 문자열 | Slack API 토큰 또는 Bot 토큰. API 또는 통합 키가 필요한 타사 통합을 생성한 후 다음과 같은 경우 키가 부분적으로 편집된 상태로 표시됩니다.
|
notifications.channelName | 문자열 | Slack 채널 이름입니다. SLACK 알림에만 표시됩니다. |
notifications.delayMin | 숫자 | 경고 조건이 감지된 후 MongoDB Ops Manager가 첫 번째 알림을 보내기 전에 대기할 시간(분)입니다. |
notifications.emailAddress | 문자열 | 알림을 보낼 이메일 주소입니다. EMAIL 알림에만 표시됩니다. |
notifications.emailEnabled | 부울 | MongoDB Ops Manager가 이메일 알림을 보낼지 여부를 토글합니다. GROUP 및 USER 알림에만 존재합니다. |
notifications.intervalMin | 숫자 | 이 경고 구성이 Atlas가 트리거하는 확인되지 않았거나 해결되지 않은 경고에 대한 연속 알림 사이에 대기할 시간(분)입니다. |
notifications.[n] .webhookSecret | 문자열 | 알림을 수락하고 전달하는 Webhook으로 인증하는 데 사용되는 값입니다. Ops Manager는
웹훅 알림을 생성한 후 경고 를 보거나 편집할 때 URL 이 부분적으로 수정되고 시크릿은 완전히 수정됩니다. |
notifications.[n] .webhookUrl | 문자열 | 이 알림을 Atlas Triggers 웹훅의 URL 입니다. Ops Manager는
웹훅 알림을 생성한 후 경고 를 보거나 편집할 때 URL 이 부분적으로 수정되고 시크릿은 완전히 수정됩니다. |
notifications.microsoftTeamsWebhookUrl | 문자열 | Microsoft Teams 채널 수신 웹훅 URL입니다. 웹후크 알림에 대한 경고를 보거나 편집할 때 URL은 부분적으로 편집된 상태로 표시되고 비밀번호는 완전히 편집된 상태로 표시됩니다. |
notifications.notificationToken | 문자열 | HipChat API 토큰. API 또는 통합 키가 필요한 타사 통합을 생성한 후 다음과 같은 경우 키가 부분적으로 편집된 상태로 표시됩니다.
|
notifications.roomName | 문자열 | HipChat 채팅방 이름입니다. HIP_CHAT 알림에만 표시됩니다. |
notifications.serviceKey | 문자열 | PagerDuty 통합 키입니다. API 또는 통합 키가 필요한 타사 통합을 생성한 후 다음과 같은 경우 키가 부분적으로 편집된 상태로 표시됩니다.
|
notifications.smsEnabled | 부울 | MongoDB Ops Manager가 SMS 알림을 보낼지 여부를 토글합니다. GROUP 및 USER 알림에만 존재합니다. |
notifications.typeName | 문자열 | 이 경고 구성의 경고 알림 유형 Atlas Triggers입니다. 가능한 값은 다음과 같습니다.
|
notifications.username | 문자열 | 알림을 보낼 MongoDB Ops Manager 사용자의 이름입니다. USER 알림에만 표시됩니다. |
threshold | 객체 | 이 경고 구성이 경고를 trigger 하도록 하는 임계값입니다.
|
threshold.operator | 문자열 |
|
threshold.threshold | 숫자 | 이 경고 구성을 벗어나는 임계값으로 Atlas가 경고를 트리거합니다. |
tags | 문자열 배열 | 이 경고 구성과 연결된 태그입니다. |
typeName | 문자열 | 이 필드는 더 이상 사용되지 않으며 무시됩니다. |
updated | 문자열 | ISO 8601 의 타임스탬프 이 경고 구성이 마지막으로 업데이트된 날짜 및 시간 형식(UTC )입니다. |
요청 예시
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ 2 --header "Accept: application/json" \ 3 --include \ 4 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/globalAlertConfigs"
응답 예시
응답 헤더
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}
응답 본문
1 { 2 "links": [ 3 ], 4 "results": [ 5 { 6 "created": "2019-10-02T12:34:04Z", 7 "enabled": true, 8 "eventTypeName": "RS_BIND_ERROR", 9 "forAllGroups": true, 10 "groupIds": [], 11 "id": "{GLOBAL-ALERT-CONFIG-ID}", 12 "links": [ 13 ], 14 "matchers": [], 15 "notifications": [ 16 { 17 "delayMin": 0, 18 "intervalMin": 60, 19 "typeName": "ADMIN" 20 } 21 ], 22 "tags": [], 23 "typeName": "BACKUP", 24 "updated": "2019-10-02T12:34:04Z" 25 }, 26 { 27 "created": "2019-10-02T12:34:04Z", 28 "enabled": true, 29 "eventTypeName": "BACKUP_TOO_MANY_RETRIES", 30 "forAllGroups": true, 31 "groupIds": [], 32 "id": "{GLOBAL-ALERT-CONFIG-ID}", 33 "links": [ 34 ], 35 "matchers": [], 36 "notifications": [ 37 { 38 "delayMin": 0, 39 "intervalMin": 60, 40 "typeName": "ADMIN" 41 } 42 ], 43 "tags": [], 44 "typeName": "BACKUP", 45 "updated": "2019-10-02T12:34:04Z" 46 }, 47 { 48 "created": "2019-10-02T12:34:04Z", 49 "enabled": true, 50 "eventTypeName": "BACKUP_IN_UNEXPECTED_STATE", 51 "forAllGroups": true, 52 "groupIds": [], 53 "id": "{GLOBAL-ALERT-CONFIG-ID}", 54 "links": [ 55 ], 56 "matchers": [], 57 "notifications": [ 58 { 59 "delayMin": 0, 60 "intervalMin": 60, 61 "typeName": "ADMIN" 62 } 63 ], 64 "tags": [], 65 "typeName": "BACKUP", 66 "updated": "2019-10-02T12:34:04Z" 67 } 68 ], 69 "totalCount": 3 70 }