• 로그인지금 시작하기

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

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

문제 신고

메트릭 API 제한 및 제한된 속성

이 문서에서는 다음을 포함하여 Metric API 에 대한 데이터 요구 사항을 설명합니다.

  • 최대 한도
  • 제한된 속성
  • 제한된 측정항목 값

최대 한도

다음 기본 제한이 모든 지표 데이터에 적용됩니다.

상태

한계

타임스탬프 값의 연령대

48시간 이전 또는 보고된 시간으로부터 24시간 이후의 타임스탬프로 보고된 메트릭은 삭제됩니다.

분당 최대 데이터 포인트(DPM)

3-1,500만 DPM (자세히 알아보기)

계정당 하루 최대 고유 시계열(카디널리티)

1-1500만 (자세히 알아보기)

시계열은 메트릭 이름과 속성의 고유한 단일 조합입니다.

1일 측정항목 이름당 최대 고유 시계열(카디널리티)

10만

분당 최대 페이로드

100k (자세히 알아보기)

측정항목당 최대 속성

도면 1

최대 측정항목 속성 이름 길이

255자

속성 키의 최대 문자 수

255자

최대 측정항목 속성 값 길이

4096자

허용된 HTTP 프로토콜

HTTPS만

최소 또는 최대 Java long 값을 벗어나는 숫자 long 값

최소 또는 최대 Java long 값을 벗어나는 숫자 long 값은 거부됩니다.

  • 숫자가 공통 블록에 있으면 전체 블록이 삭제됩니다.
  • 숫자가 메트릭 데이터 포인트에 있으면 숫자가 있는 메트릭 데이터 포인트가 삭제됩니다.

최소 또는 최대 Java 이중 값을 벗어나는 숫자 이중 값

최소 또는 최대 Java 이중 값을 벗어나는 숫자 이중 값은 거부됩니다.

  • 숫자가 공통 블록에 있으면 전체 블록이 삭제됩니다.
  • 숫자가 메트릭 데이터 포인트에 있으면 숫자가 있는 메트릭 데이터 포인트가 삭제됩니다.

페이로드 크기

총 최대 크기 또는 길이: POST당 최대 1MB(10^6바이트) . 압축을 사용하는 것이 좋습니다.

페이로드 형식

페이로드는 UTF-8 로 인코딩되어야 합니다.

속성 명명 구문

속성 이름은 영숫자, 콜론( : ), 마침표( . ) 및 밑줄( _ )의 조합일 수 있습니다.

다음 기본 제한은 Prometheus 원격 쓰기 통합을 통해 수집된 데이터에만 적용됩니다.

상태

한계

5분 간격으로 계정당 최대 고유 개수 및 요약 시계열(카디널리티)

1-1500만 (자세히 알아보기)

시계열은 메트릭 이름과 속성의 고유한 단일 조합입니다. 이 제한을 초과하여 수신된 시계열은 삭제됩니다. 이 제한은 표준 메트릭 제한 이전 및 추가로 적용됩니다.

추가 계정 조건

Metric API 제한은 개별 계정 수준에서 적용됩니다. DPM 및 카디널리티에 대한 기본 제한은 무료 계층 조직의 경우 3M에서 일부 유료 조직의 경우 최대 1020만입니다. 조직의 제한을 이해하려면 제한 UI 를 참조하십시오. 유료 조직의 요청에 따라 DPM 및 카디널리티를 15M까지 늘릴 수 있습니다. 분당 최대 페이로드는 사례별로 100k 이상으로 조정할 수 있습니다. 메트릭 비율 제한에 대한 변경을 요청하려면 New Relic 계정 담당자에게 문의하거나 지원 포털 을 방문하십시오.

비율 제한 위반

이 섹션에서는 속도 제한을 초과할 때 Metric API가 작동하는 방식과 제한을 초과한 경우 대응하는 방법을 설명합니다.

제한된 속성

이러한 속성은 New Relic 플랫폼에 의해 제한됩니다. 메트릭 데이터 포인트의 속성 섹션에서 이러한 키와 함께 제출된 모든 값은 데이터 포인트를 삭제하거나 값을 생략하거나 덮어쓰게 합니다.

기인하다

설명

newrelic.source

metricAPI 값으로 재설정됩니다.

metricName

이것은 각 데이터 포인트에 전달된 name 값으로 재설정됩니다. 이렇게 하면 name 이 속성 키가 될 수 있습니다.

endTimestamp

timestamp interval.ms 은 데이터 포인트에 대해 endTimestamp 로 변환됩니다.

이러한 속성은 내부적으로 엔터티를 식별하는 데 사용됩니다. 메트릭 데이터 포인트의 속성 섹션에서 이러한 키로 제출된 모든 값은 UI의 누락된 엔터티 또는 예상 엔터티와 연결되지 않은 원격 분석과 같은 정의되지 않은 동작을 유발할 수 있습니다. 자세한 내용은 엔터티 합성 을 참조하십시오.

기인하다

설명

entity.guid

New Relic이 엔티티에 할당한 고유 식별자입니다.

entity.name

사람이 읽을 수 있는 엔터티 이름으로 UI에서 엔터티를 식별하는 데 자주 사용됩니다.

entity.type

호스트, 애플리케이션 등과 같은 다양한 유형의 엔티티를 구별하는 데 사용됩니다.

추가 제한 사항은 다음과 같습니다.

제한

코멘트

측정항목 및 속성 이름

메트릭 이름과 속성 이름에 동일한 값을 전달할 수 없습니다.

다음 예에서는 측정항목의 이름이 service.errors.all 이고 속성이 service.errors.all 이기 때문에 측정항목이 유효하지 않습니다.

예: 속성으로 사용된 메트릭 값(잘못됨)

[
  {
    "metrics": [
      {
        "name": "service.errors.all",
        "type": "count",
        "value": 15,
        "timestamp": 1531414060739,
        "interval.ms": 10000,
        "attributes": {
          "service.response.statuscode": "400",
          "service.errors.all": "test",
          "service.name": "foo"
        }
      }
    ]
  }
]

예약어

accountID , appIdeventType 와 같은 예약어 를 사용하지 마십시오. 또한 백틱( `` )을 사용하지 않는 한 NRQL 구문 용어를 사용하지 않아야 합니다.

메트릭 JSON 내의 키

메트릭 JSON 내에서 사용되는 모든 키는 속성 키가 될 수 없습니다. 여기에는 interval.ms , timestamp , value , common , min , max , count , summetrics 가 포함됩니다.

예외: name 을 속성 키로 사용할 수 있습니다.

제한된 측정항목 값

valueNaN (숫자가 아님), positive infinity 또는 negative infinity 인 Metric API에 제출된 모든 측정항목 데이터는 삭제됩니다.

Copyright © 2022 New Relic Inc.

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