• 로그인지금 시작하세요

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

인프라 경고에 대한 REST API 호출

인프라 REST API를 사용하여 경고 조건을 추가, 업데이트, 삭제 및 나열합니다. 인프라 모니터링 UI 를 사용하여 개별 알림 조건을 관리할 수도 있습니다.

인프라 경고에 대한 REST API 호출은 API 탐색기 에서 사용할 수 없습니다.

API를 사용하는 이유

일관성

  • 인프라 모니터링 UI에서 매번 동일한 조건을 설정할 필요 없이 모든 클러스터에 대해 동일한 조건 세트를 정의합니다.
  • UI를 사용하여 하나씩 업데이트하지 않고도 여러 조건을 빠르게 관리할 수 있습니다.

유연성

  • 임의의 호스트 그룹에 대한 조건을 만듭니다.
  • 언제든지 오프라인 상태가 된 호스트에 대한 조건을 비활성화하거나 삭제할 수 있습니다.
  • 제외 필터링을 사용하여 조건을 만듭니다(예: environment NOT LIKE x ). 이에 대한 자세한 내용 은 제외 필터링에 대한 이 게시물을 참조하십시오.
  • AWS 클라우드 통합의 경우 아직 AWS에서 전송하지 않은 속성을 선택합니다.
  • 2차 또는 3차 측정항목에 대한 제한을 지정할 수 있는 where_clause 을 사용하여 복합 경고 조건을 생성합니다.
  • NRQL 경고 조건에 대한 500개 패싯 제한을 초과합니다.

신뢰할 수 있음

  • 조건이 마지막으로 업데이트된 시간을 감사합니다.

요구 사항

Infrastructure REST API를 사용하려면 다음이 필요합니다.

계정이 EU 데이터 센터의 데이터를 호스팅하는 경우 EU 지역 계정에 적절한 API 엔드포인트를 사용하고 있는지 확인하십시오.

인프라 API 호출 사용

다음은 몇 가지 기본 cURL 명령과 인프라 경고 조건에 대한 응답입니다. 조건 유형에 따라 호출에서 제공하는 DATA 정보는 POST(추가) 및 PUT(업데이트) 호출에 대해 달라집니다.

data 블록에 사용된 각 속성의 정의는 정의 섹션에서 찾을 수 있습니다.

GET 인프라 조건

인프라 조건 목록을 GET하거나 특정 인프라 조건 을 GET할 수 있습니다. 다음은 인프라 조건을 나열하기 위한 몇 가지 팁입니다.

  • 페이지 매김의 경우 limit (페이지당 레코드 수) 및 offset (건너뛸 레코드 수) 매개변수를 사용합니다. 기본값은 페이지당 50개 레코드이고 offset 는 0에서 시작합니다(레코드 건너뛰기).
  • 결과 범위를 특정 정책으로 지정하려면 policy_id 을 사용합니다.

GET 응답을 PUT 또는 POST 입력의 템플릿으로 사용하려면 created_at_epoch_millis , updated_at_epoch_millisid 정보를 제거해야 합니다.

인프라 조건 목록을 GET

curl -v -X GET --header "Api-Key: $API_KEY" "https://infra-api.newrelic.com/v2/alerts/conditions?policy_id=111111"

50개 제한을 초과하는 10개 인프라 조건 목록을 얻으려면:

curl -v -X GET --header "Api-Key: $API_KEY" "https://infra-api.newrelic.com/v2/alerts/conditions?policy_id=111111&offset=50&list=10"

특정 인프라 조건을 GET

단일 인프라 조건에 대한 정보를 얻으려면:

curl -v -X GET --header "Api-Key: $API_KEY" "https://infra-api.newrelic.com/v2/alerts/conditions/condition-id"

인프라 조건 생성(POST)

중요

새 조건(POST)을 추가할 때 "id": 을 포함하지 마십시오. 조건이 생성될 때 생성됩니다.

인프라 조건을 추가하려면 다음 기본 cURL 명령을 사용하십시오.

curl -X POST 'https://infra-api.newrelic.com/v2/alerts/conditions' -H 'Api-Key:$API_KEY' -i -H 'Content-Type: application/json' -d '{"data":{DATA object details}}'

추가할 인프라 조건 유형에 대한 세부정보를 DATA 객체( -d \ 섹션)에 포함합니다.

업데이트(PUT) 인프라 조건

인프라 조건을 업데이트할 때 변경해야 하는 필드만 포함하면 됩니다. API는 누락된 필드에 대한 기존 값을 유지합니다.

중요

type 조건을 변경하려면 PUT을 사용하지 마십시오. 대신 기존 조건을 삭제한 다음 새 조건 type모든 필드를 사용하여 새 조건을 추가(POST)하십시오.

인프라 조건을 업데이트하려면 이 기본 cURL 명령을 사용하십시오. 업데이트할 조건을 나타내려면 "id": 을 포함해야 합니다.

업데이트할 인프라 조건 유형에 대한 세부정보를 DATA 객체( -d \ 섹션)에 포함합니다.

인프라 조건 제거(DELETE)

인프라 조건을 삭제하려면 다음 기본 cURL 명령을 사용하십시오.

curl -v -X DELETE --header "Api-Key: $API_KEY" "https://infra-api.newrelic.com/v2/alerts/conditions/condition_id"

조건의 유형

정의

cURL 명령을 형식화할 때 필요에 따라 이 값을 사용하십시오. API 호출에 나타나는 순서가 아니라 알파벳 순서로 나열됩니다.

정의

comparison ( 열거 )

조건 유형: infra_metric , infra_process_running

임계값을 정의하는 데 사용되는 값입니다. 예: "["above", "below", "equal"] .

critical_threshold 그리고 warning_threshold

조건 유형: 모두

이 개체는 위반을 열기 전에 임계값을 식별합니다.

  • critical_threshold 은(는) 필수 항목입니다.

  • warning_threshold 은 선택사항이며 infra_metric 조건에서만 사용할 수 있습니다.

    이 개체의 키는 조건 유형에 따라 다릅니다.

    조건 유형: infra_metric 형식:

    "critical_threshold":{
    "value":<number>,
    "duration_minutes":<integer>,
    "time_function":"any" or "all"
    },

    조건 유형: infra_process_running 형식:

    "critical_threshold":{
    "value":<integer>,
    "duration_minutes":<integer>,
    },

    조건 유형: infra_host_not_reporting 형식:

    "critical_threshold":{
    "duration_minutes":<integer>,
    },

enabled ( 부울 )

조건 유형: 모두

조건이 켜져 있는지 여부 true 또는 false .

event_type ( 문자열 )

조건 유형: infra_metric

메트릭 이벤트 예를 들어 시스템 메트릭, 프로세스 메트릭, 스토리지 메트릭 또는 네트워크 메트릭이 있습니다. 이는 인프라 통합을 위해 자동으로 채워집니다. 예: StorageSample 또는 SystemSample .

filter ( 문자열 )

조건 유형: 모두

UI에서 조건이 만들어진 경우 where_clause 대신 filter 이 나타납니다. 예를 들어:

{and: [{is: {ec2InstanceType: "m3.medium"}}]}

권장 사항: 새 조건을 만들 때 where_clause 을 사용합니다.

id ( 정수 )

조건 유형: 모두

URL에 있는 조건 ID입니다.

  • GET: 이 값은 GET 응답에 나타납니다.
  • PUT: 이 값을 DATA 섹션에 포함합니다.
  • POST: DATA 섹션에 이것을 포함하지 마십시오.
  • 삭제: -X DELETE 호출에 이 값을 포함합니다.

integration_provider ( 문자열 )

조건 유형: infra_metric

통합 알림의 경우 event_type } 대신 integration_provider 을 사용합니다. 유효한 값을 보려면: 클라우드 서비스에 대한 New Relic 문서에서 데이터 찾기 및 사용 섹션을 확인하십시오.

예: AWS RDS 모니터링 통합 문서에서 DatastoreSample 이벤트 유형이 DB 인스턴스의 경우 RdsDbInstance 또는 Aurora DB 클러스터의 경우 RdsDbClusterintegration_provider 값과 함께 사용될 수 있음을 확인할 수 있습니다.

name ( 문자열 )

조건 유형: 모두

인프라 경고 조건의 이름입니다. 예를 들어:

"[test] process running"

policy_id ( 정수 )

조건 유형: 모두

조건과 연결된 경고 정책의 계정 ID에 대한 고유 ID입니다. 예: 1234567890 . 이것은 정책의 전역 ID가 아닙니다.

process_where_clause ( 문자열 )

조건 유형: infra_process_running

특히 프로세스 실행 경고 조건에서 프로세스에 적용된 모든 필터. 이 매개변수는 이러한 유형의 경보 조건에 필수입니다. 예를 들어:

"commandName = '\''java'\''"

runbook_url ( 문자열 )

조건 유형: all

알림에 표시할 Runbook URL입니다.

select_value ( 문자열 )

조건 유형: infra_metric

대상이 되는 메트릭을 식별하기 위한 속성 이름입니다. 예: "cpuPercent" , "diskFreePercent" , "memoryResidentSizeBytes", or "memoryFreeBytes/memoryTotalBytes*100" . 이는 인프라 통합을 위해 자동으로 채워집니다. 예: diskFreePercent .

type ( 열거 )

조건 유형: 모두

인프라 경고 조건 유형: "infra_process_running" , "infra_metric" 또는 "infra_host_not_reporting" .

violation_close_timer ( 정수 )

조건 유형: 모두

시간으로 표시되는 위반 시간 제한 설정입니다. 가능한 값은 0 , 1 , 2 , 4 , 8 , 12 , 24 , 48 , 72 입니다. 이는 위반이 자동으로 종료되기 전에 경과할 시간을 결정합니다.

새 조건의 경우 값이 제공되지 않으면 다음 기본값이 사용됩니다.

  • 모든 조건: 24 hours

    기존 조건을 업데이트할 때 값이 제공되면 기존 값을 재정의하지만 이미 열린 위반에는 영향을 미치지 않습니다.

where_clause ( 문자열 )

조건 유형: 모두

해당하는 경우 사용된 모든 인프라 호스트 필터 를 식별합니다. 예를 들어:

"(`hostname` LIKE '\''%cassandra%'\'')",
Copyright © 2022 New Relic Inc.