NerdGraph 튜토리얼: 경고 정책

New Relic 알림의 경우 NerdGraph API를 사용하여 알림 정책 을 관리할 수 있습니다.

팁

NerdGraph를 시작하는 방법은 NerdGraph 소개를 참조하세요.

정책 나열 및 필터링

policiesSearch 쿼리를 사용하면 계정당 모든 알림 정책 을 페이지로 나눌 수 있습니다.또한 계정 정책에서 일부 필터링 기능을 허용합니다.

다음은 예입니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch {
          policies {
            id
            name
            incidentPreference
          }
        }
      }
    }
  }
}

정책을 통해 페이지를 나누려면 초기 쿼리에서 nextCursor 필드를 요청해야 합니다.

커서 페이지 매김을 사용하면 응답에서 반환된 nextCursor 이 다시 비어 있을 때까지 결과 집합을 통해 계속 요청합니다. 이것은 결과의 끝에 도달했음을 의미합니다.

다음은 예입니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch {
          nextCursor
          policies {
            id
            name
            incidentPreference
          }
          totalCount
        }
      }
    }
  }
}

위의 코드는 다음과 같은 결과 집합을 반환합니다.

{
  "data": {
    "actor": {
      "account": {
        "alerts": {
          "policiesSearch": {
            "nextCursor": "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM=",
            "policies": [
              {
                "id": "3455",
                "incidentPreference": "PER_POLICY",
                "name": "First Policy Name"
              },
              {
                "id": "2123",
                "incidentPreference": "PER_POLICY",
                "name": "Another Policy"
              },
              // ... more policies here in reality
            ],
            "totalCount": 745
          }
        }
      }
    }
  }
}

따라서 후속 요청에서 커서가 비어 있을 때까지 다음과 같이 커서를 제공합니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(cursor: "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM=") {
          nextCursor
          policies {
            id
            name
            incidentPreference
          }
          totalCount
        }
      }
    }
  }
}

API는 하위 선택 ID로 정책 쿼리를 허용합니다. 이렇게 하면 귀하가 제공한 이러한 정책에 대한 정보만 반환됩니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(searchCriteria: {
          ids: [A_POLICY_ID, ANOTHER_POLICY_ID]
        }) {
          policies {
            id
            name
            incidentPreference
          }
        }
      }
    }
  }
}

API는 이름으로 정책 쿼리를 허용합니다. 정확한 이름으로 일치시키려면 name 를 사용하고 부분적으로 일치시키 nameLike 을 사용하십시오. 두 검색 기준 모두 대소문자를 구분하지 않습니다. 이렇게 하면 제공된 이름과 일치하는 정책에 대한 정보만 반환됩니다.

이 예에서는 이름에 "DevOps"가 포함된 정책을 찾고 싶습니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(searchCriteria: {
          nameLike: "DevOps"
        }) {
          policies {
            id
            name
          }
        }
      }
    }
  }
}

API를 사용하면 정책 ID로 쿼리할 수 있습니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policy(id: YOUR_POLICY_ID) {
          id
          name
          incidentPreference
        }
      }
    }
  }
}

정책 만들기

정책을 생성하려면 이름과 incidentPreference 를 제공합니다.

인시던트 기본 설정은 정책에서 생성된 각 조건에 대해 인시던트가 생성되는 방식을 구성합니다. 자세한 내용 은 인시던트 기본 설정 선택 에 대한 설명서를 참조하십시오.

mutation {
  alertsPolicyCreate(accountId: YOUR_ACCOUNT_ID, policy: {
    name: "Your Policy Name"
    incidentPreference: PER_CONDITION
  }) {
    id
    name
    incidentPreference
  }
}

정책 업데이트

정책을 업데이트할 때 정책의 모든 속성을 제공할 필요는 없습니다. 예를 들어, 이름만 업데이트하려는 경우에만 이름을 제공하면 됩니다.

mutation {
  alertsPolicyUpdate(accountId: YOUR_ACCOUNT_ID, id: YOUR_POLICY_ID, policy: {
    name: "Updated Policy Name"
  }) {
    id
    name
    incidentPreference
  }
}

정책 삭제

NerdGraph API를 통해 정책을 삭제할 수 있습니다. 삭제된 리소스에서 ID만 다시 요청할 수 있습니다.

mutation {
  alertsPolicyDelete(accountId: YOUR_ACCOUNT_ID, id: YOUR_POLICY_ID) {
    id
  }
}

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

팁

정책 나열 및 필터링

계정에 대한 모든 정책 나열

커서 페이지 매김으로 정책을 통해 페이지 매김

선택한 ID로 모든 정책 찾기

이름으로 모든 정책 찾기

아이디로 정책 찾기

정책 만들기

정책 업데이트

정책 삭제