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

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

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

문제 신고

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

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

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

최대 한도

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

상태

한계

타임스탬프 값의 연령대

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

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

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

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

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

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

일일 지수 이름당 최대 고유 시계열(카디널리티)

10만

분당 최대 페이로드

100k (자세히 알아보기)

측정항목당 최대 속성

도면 1

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

255자

속성 키의 최대 문자 수

255자

최대 측정항목 속성 값 길이

4096자

허용된 HTTP 프로토콜

HTTPS만

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

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

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

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

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

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

배정밀도 부동 소수점 숫자로 변환하기 위해 반올림이 필요한 숫자 double 값입니다.

배정밀도 부동 소수점 숫자로 변환하기 위해 반올림이 필요한 숫자 double 값은 거부됩니다.

이에 대한 예는 1.12345678901234567E18 입니다. double은 이렇게 큰 값을 포함할 수 있지만 이를 정확하게 표현하기에는 정밀도가 충분하지 않습니다( 1.12345678901234573E18 로 반올림해야 함).

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

페이로드 크기

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

페이로드 형식

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

속성 명명 구문

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

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

상태

한계

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

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

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

추가 계정 조건

Metric API 한도는 개별 계정 수준에서 적용됩니다. DPM 및 카디널리티의 기본 제한 범위는 무료 버전 조직의 경우 3M, 일부 유료 조직의 경우 최대 10.2M입니다. 조직의 한도를 이해하려면 한도 UI를 참조하세요. 유료 조직의 요청에 따라 DPM 및 카디널리티를 15M까지 늘릴 수 있습니다. 분당 최대 페이로드는 사례별로 100,000 이상으로 조정될 수 있습니다. 지표 속도 제한 변경을 요청하려면 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 이기 때문에 측정항목이 유효하지 않습니다.

Example: Metric value used as an attribute (invalid)

[
{
"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 가 포함됩니다.

Exception: name 속성 키로 사용할 수 있습니다.

제한된 측정항목 값

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

Copyright © 2024 New Relic Inc.

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