Docs Menu
Docs Home
/
MongoDB Ops Manager
/ / / /

모든 전역 경고 구성 가져오기

이 페이지의 내용

  • 필수 역할
  • 요청
  • 요청 경로 매개변수
  • 요청 쿼리 매개변수
  • 요청 본문 매개변수
  • 응답
  • 응답 문서
  • results embeddedDocument
  • 요청 예시
  • 응답 예시
  • 응답 헤더
  • 응답 본문

모든 전역 경고 구성을 조회합니다.

다음과 같은 할당된 역할을 사용하여 이 엔드포인트를 성공적으로 호출할 수 있습니다.

기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

GET /globalAlertConfigs

이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.

이름
유형
필요성
설명
기본값
pageNum
숫자
옵션
결과의 하위 섹션을 반환하는 1부터 시작하는 정수입니다.
1
itemsPerPage
숫자
옵션
페이지당 반환할 항목 수. 최대 500개까지 가능합니다.
100
pretty
부울
옵션
응답 본문이 프리티프린트 에 있어야 하는지 여부를 나타내는 플래그입니다. 형식.
false
envelope
부울
옵션

응답을 엔벨로프에 래핑할지 여부를 나타내는 플래그입니다.

일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope : true를 설정합니다.

결과 목록을 반환하는 엔드포인트의 경우 content 객체는 엔벨로프입니다. Ops Manager가 응답 본문에 status 필드를 추가합니다.

false

이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.

응답 JSON 문서에는 result 객체 배열, link 객체 배열, 조회된 result 객체의 총 개수가 포함되어 있습니다.

이름
유형
설명
results
배열
배열에는 results 내장된 문서 섹션에 자세히 설명된 각 항목에 대해 하나의 객체가 포함됩니다.
links
배열
배열에 하위 리소스 및/또는 관련 리소스에 대한 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
totalCount
숫자
결과 집합에 있는 총 항목 수의 정수 개수입니다. 전체 결과 집합이 페이지로 매겨진 경우 results 배열의 객체 수보다 클 수 있습니다.

결과 는 하나의 경고 구성입니다.

이름
유형
설명
created
문자열
ISO 8601 의 타임스탬프 경고 구성이 생성된 시점의 UTC 날짜 및 시간 형식입니다.
enabled
부울
경고 구성의 활성화 여부를 지정하는 토글입니다.
eventTypeName
문자열

이 경고 구성이 Atlas가 경고를 트리거하는 이벤트 유형입니다.

경고를 생성하는 이벤트 유형을 검토하려면 경고 유형을 참조하세요.

Ops Manager 감사 로그에 포함된 이벤트의 전체 목록은 감사 이벤트를 참조하세요.

forAllGroups
부울

전역 경고 구성을 모든 그룹에 적용할지 여부를 지정하는 토글입니다. 또한 tags 배열을 사용하여 특정 그룹을 구성 대상으로 지정할 수 있는지 여부에도 영향을 줍니다.

true 이면 구성이 모든 그룹에 적용됩니다. tags 배열을 통해 특정 그룹을 대상으로 경고 구성을 지정할 수 있습니다.

false 인 경우 구성은 groupIds 배열에 지정된 그룹에만 적용됩니다. groupIds 배열에 프로젝트를 하나 이상 지정해야 합니다. 이 경고 구성에는 tags 배열을 사용할 수 없습니다.

groupIds
문자열 배열
이 경고 구성이 적용되는 그룹의 ID입니다. 이 필드는 forAllGroups 이(가) false(으)로 설정된 경우에만 적용됩니다.
id
문자열
경고 구성의 고유 식별자입니다.
matchers
객체 배열

이 전역 경고 구성과 객체를 일치시킬 때 적용할 규칙입니다. MongoDB Ops Manager는 경고 조건에 대해 이러한 모든 규칙과 일치하는 엔터티만 확인합니다.

eventTypeName 가 호스트, 복제본 세트 또는 샤드 cluster에 대한 이벤트를 지정하는 경우에만 matchers 배열을 사용하여 필터링할 수 있습니다.

matchers.fieldName
문자열

일치시킬 대상 객체의 필드 이름입니다.

  • 호스트 경고는 이러한 필드를 지원합니다.

    • HOSTNAME

    • PORT

    • HOSTNAME_AND_PORT

    • REPLICA_SET_NAME

    • TYPE_NAME

  • 복제본 세트 경고는 이러한 필드를 지원합니다.

    • REPLICA_SET_NAME

    • SHARD_NAME

    • CLUSTER_NAME

  • Sharded cluster 경고는 다음과 같은 필드를 지원합니다.

    • CLUSTER_NAME

    • SHARD_NAME

다른 모든 유형의 경고는 매처를 지원하지 않습니다.

matchers.operator
문자열

필드 값을 테스트하는 연산자입니다. 가능한 값은 다음과 같습니다.

  • EQUALS

  • NOT_EQUALS

  • CONTAINS

  • NOT_CONTAINS

  • STARTS_WITH

  • ENDS_WITH

  • REGEX

matchers.value
문자열

지정된 연산자로 테스트할 값입니다.

matchers.fieldName 로 설정된 TYPE_NAME 경우 다음 값을 일치시킬 수 있습니다.

  • PRIMARY

  • SECONDARY

  • STANDALONE

  • CONFIG

  • MONGOS

metricThreshold
객체
이 경고 구성이 경고를 trigger 하도록 하는 임계값입니다. eventTypeName 이(가) OUTSIDE_METRIC_THRESHOLD(으)로 설정된 경우에만 표시됩니다.
metricThreshold.metricName
문자열
확인할 지표의 이름입니다. globalAlerts 리소스 의 metricName 필드 와 동일한 값을 지원합니다. 사용 가능한 값 목록은 글로벌 경고의 측정 유형을 참조하세요.
metricThreshold.mode
문자열
이 값은 AVERAGE 으)로 설정되고 현재 지표 값을 평균으로 계산합니다.
metricThreshold.operator
문자열

metricThreshold.threshold 에 대해 현재 지표 값을 확인할 때 적용할 연산자입니다. 가능한 값은 다음과 같습니다.

  • GREATER_THAN

  • LESS_THAN

metricThreshold.threshold
숫자
이 경고 구성을 벗어나는 임계값으로 Atlas가 경고를 트리거합니다.
metricThreshold.units
문자열

metricThreshold.threshold 의 단위입니다. 단위는 메트릭 유형에 따라 다릅니다.

허용되는 값은 다음과 같습니다.

  • RAW

  • BITS

  • BYTES

  • KILOBITS

  • KILOBYTES

  • MEGABITS

  • MEGABYTES

  • GIGABITS

  • GIGABYTES

  • TERABYTES

  • PETABYTES

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

예를 예시 메모리 소비를 측정하는 지표에는 BYTES, 시간을 측정하는 지표에는 HOURS 를 사용할 수 있습니다.

notifications
객체 배열
알림 MongoDB Ops Manager는 이 경고 구성에서 설명하는 경고를 감지하면 전송합니다.
notifications.apiToken
문자열

Slack API 토큰 또는 Bot 토큰. SLACK 알림에만 표시됩니다. 나중에 토큰이 유효하지 않게 되면 MongoDB Ops Manager는 프로젝트 소유자에게 이메일을 보내고 토큰을 제거합니다.

API 또는 통합 키가 필요한 타사 통합을 생성한 후 다음과 같은 경우 키가 부분적으로 편집된 상태로 표시됩니다.

  • UI를 통해 경고를 보거나 편집합니다.

  • API 를 통해 타사 통합 설정을 쿼리합니다.

notifications.channelName
문자열
Slack 채널 이름입니다. SLACK 알림에만 표시됩니다.
notifications.delayMin
숫자
경고 조건이 감지된 후 MongoDB Ops Manager가 첫 번째 알림을 보내기 전에 대기할 시간(분)입니다.
notifications.emailAddress
문자열
알림을 보낼 이메일 주소입니다. EMAIL 알림에만 표시됩니다.
notifications.emailEnabled
부울
MongoDB Ops Manager가 이메일 알림을 보낼지 여부를 토글합니다. GROUPUSER 알림에만 존재합니다.
notifications.intervalMin
숫자
이 경고 구성이 Atlas가 트리거하는 확인되지 않았거나 해결되지 않은 경고에 대한 연속 알림 사이에 대기할 시간(분)입니다.
notifications.[n]
.webhookSecret
문자열

알림을 수락하고 전달하는 Webhook으로 인증하는 데 사용되는 값입니다.

Ops Manager는 notifications.[n].typeName 을(를) WEBHOOK (으)로 설정하거나 다음 중 하나에 해당하는 경우 이 값을 반환합니다.

  • notification.[n].webhookSecret 을(를) 비어 있지 않은 문자열로 설정합니다.

  • 관리 콘솔에서 기본값 webhookSecret 를 설정하다 합니다.

웹훅 알림을 생성한 후 경고 를 보거나 편집할 때 URL 이 부분적으로 수정되고 시크릿은 완전히 수정됩니다.

notifications.[n]
.webhookUrl
문자열

이 알림을 Atlas Triggers 웹훅의 URL 입니다.

Ops Manager는 notifications.[n].typeName 을(를) WEBHOOK (으)로 설정하거나 다음 중 하나에 해당하는 경우 이 값을 반환합니다.

  • notification.[n].webhookURL 을(를) 비어 있지 않은 문자열로 설정합니다.

  • 관리 콘솔 페이지에서 기본값 webhookUrl 를 설정하다 합니다.

웹훅 알림을 생성한 후 경고 를 보거나 편집할 때 URL 이 부분적으로 수정되고 시크릿은 완전히 수정됩니다.

notifications.microsoftTeamsWebhookUrl
문자열

Microsoft Teams 채널 수신 웹훅 URL입니다. MICROSOFT_TEAMS 알림에만 표시됩니다.

웹후크 알림에 대한 경고를 보거나 편집할 때 URL은 부분적으로 편집된 상태로 표시되고 비밀번호는 완전히 편집된 상태로 표시됩니다.

notifications.notificationToken
문자열

HipChat API 토큰. HIP_CHAT 알림에만 표시됩니다. 나중에 토큰이 유효하지 않게 되면 MongoDB Ops Manager는 프로젝트 소유자에게 이메일을 보내고 토큰을 제거합니다.

API 또는 통합 키가 필요한 타사 통합을 생성한 후 다음과 같은 경우 키가 부분적으로 편집된 상태로 표시됩니다.

  • UI를 통해 경고를 보거나 편집합니다.

  • API 를 통해 타사 통합 설정을 쿼리합니다.

notifications.roomName
문자열
HipChat 채팅방 이름입니다. HIP_CHAT 알림에만 표시됩니다.
notifications.serviceKey
문자열

PagerDuty 통합 키입니다. PAGER_DUTY 알림에만 표시됩니다. 나중에 키가 유효하지 않게 되면 MongoDB Ops Manager는 프로젝트 소유자에게 이메일을 보내고 키를 제거합니다.

API 또는 통합 키가 필요한 타사 통합을 생성한 후 다음과 같은 경우 키가 부분적으로 편집된 상태로 표시됩니다.

  • UI를 통해 경고를 보거나 편집합니다.

  • API 를 통해 타사 통합 설정을 쿼리합니다.

notifications.smsEnabled
부울
MongoDB Ops Manager가 SMS 알림을 보낼지 여부를 토글합니다. GROUPUSER 알림에만 존재합니다.
notifications.typeName
문자열

이 경고 구성의 경고 알림 유형 Atlas Triggers입니다. 가능한 값은 다음과 같습니다.

  • ADMIN

  • GROUP

  • USER

  • EMAIL

  • SMS ( MongoDB Ops Manager 가 Twilio 통합 을 위해 구성된 경우에만 사용 가능합니다.)

  • HIPCHAT

  • SLACK

  • PAGER_DUTY

notifications.username
문자열
알림을 보낼 MongoDB Ops Manager 사용자의 이름입니다. USER 알림에만 표시됩니다.
threshold
객체

이 경고 구성이 경고를 trigger 하도록 하는 임계값입니다. eventTypeName 이 다음 값 중 하나로 설정된 경우에만 표시됩니다.

  • TOO_FEW_HEALTHY_MEMBERS

  • TOO_MANY_UNHEALTHY_MEMBERS

threshold.operator
문자열

threshold.threshold 에 대해 현재 지표 값을 확인할 때 적용할 연산자입니다. 가능한 값은 다음과 같습니다.

  • GREATER_THAN

  • LESS_THAN

threshold.threshold
숫자
이 경고 구성을 벗어나는 임계값으로 Atlas가 경고를 트리거합니다.
tags
문자열 배열
이 경고 구성과 연결된 태그입니다.
typeName
문자열
이 필드는 더 이상 사용되지 않으며 무시됩니다.
updated
문자열
ISO 8601 의 타임스탬프 이 경고 구성이 마지막으로 업데이트된 날짜 및 시간 형식(UTC )입니다.
1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2 --header "Accept: application/json" \
3 --include \
4 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/globalAlertConfigs"
HTTP/1.1 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
HTTP/1.1 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}

돌아가기

전역 경고 구성