• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

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

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

문제 신고

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

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

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

API를 사용하는 이유

일관성

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

유연성

신뢰할 수 있음

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

요구 사항

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

조직이 EU 데이터 센터에서 데이터를 호스팅하는 경우 EU 지역 엔드포인트를사용하고 있는지 확인하십시오.

인프라 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&limit=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 © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.