이 문서에서는 다음을 포함하여 Metric API 에 대한 데이터 요구 사항을 설명합니다.
- 최대 한도
- 제한된 속성
- 제한된 측정항목 값
최대 한도
다음 기본 제한이 모든 지표 데이터에 적용됩니다.
상태 | 한계 |
|---|---|
타임스탬프 값의 연령대 | 48시간 이전 또는 보고된 시간으로부터 24시간 이후의 타임스탬프로 보고된 메트릭은 삭제됩니다. |
계정당 일일 최대 고유 시계열(카디널리티) | 1-1500만 (자세히 알아보기) 시계열은 지표 이름과 속성의 고유한 단일 조합입니다. |
일일 지수 이름당 최대 고유 시계열(카디널리티) | 10만 |
분당 최대 페이로드 | 100k (자세히 알아보기) |
측정항목당 최대 속성 | 150 |
최대 측정항목 속성 이름 길이 | 255자 |
속성 키의 최대 문자 수 | 255자 |
최대 측정항목 속성 값 길이 | 4096자 |
허용된 HTTP 프로토콜 | HTTPS만 |
최소 또는 최대 Java long 값을 벗어나는 숫자 long 값 | 최소 또는 최대 Java long 값을 벗어나는 숫자 long 값은 거부됩니다.
|
최소 또는 최대 Java 이중 값을 벗어나는 숫자 이중 값 | 최소 또는 최대 Java 이중 값을 벗어나는 숫자 이중 값은 거부됩니다.
|
배정밀도 부동 소수점 숫자로 변환하기 위해 반올림이 필요한 숫자 double 값입니다. | 배정밀도 부동 소수점 숫자로 변환하기 위해 반올림이 필요한 숫자 double 값은 거부됩니다. 이에 대한 예는
|
페이로드 크기 | 총 최대 크기 또는 길이: 1MB (10^6 bytes) maximum per POST. 압축을 사용하는 것이 좋습니다. |
페이로드 형식 | 페이로드는 UTF-8 으로 인코딩되어야 합니다. |
속성 명명 구문 | 속성 이름은 영숫자, 콜론( |
다음 기본 제한은 Prometheus 원격 쓰기 통합을 통해 수집된 데이터에만 적용됩니다.
상태 | 한계 |
|---|---|
5분 간격으로 계정당 최대 고유 개수 및 요약 시계열(카디널리티) | 1-1500만 (자세히 알아보기) 시계열은 지표 이름과 속성의 고유한 단일 조합입니다. 이 제한을 초과하여 수신된 시계열은 삭제됩니다. 이 제한은 표준 지표 제한 이전 및 추가로 적용됩니다. |
추가 계정 조건
메트릭 API 한도는 개별 계정 수준에서 적용됩니다. 기본 카디널리티 한도는 무료 에디션을 사용하는 조직의 경우 300만에서 일부 유료 조직의 경우 최대 1,020만까지입니다. 조직의 한도를 파악하려면 한도 UI를 참조하세요. 유료 조직의 경우 요청 시 카디널리티를 15M까지 늘릴 수 있습니다. 분당 최대 페이로드는 사례별로 100k 이상으로 조정할 수 있습니다. 메트릭 속도 제한 변경을 요청하려면 뉴렐릭 계정 담당자에게 문의하거나 지원 포털을 방문하세요.
속도 제한 사건
이 섹션에서는 속도 제한을 초과할 때 Metric API가 작동하는 방식과 제한을 초과한 경우 대응하는 방법을 설명합니다.
제한된 속성
이러한 속성은 New Relic 플랫폼에 의해 제한됩니다. 메트릭 데이터 포인트의 속성 섹션에서 이러한 키와 함께 제출된 모든 값은 데이터 포인트를 삭제하거나 값을 생략하거나 덮어쓰게 합니다.
기인하다 | 설명 |
|---|---|
|
|
| 이것은 각 데이터 포인트에 전달된 |
|
|
이러한 속성은 내부적으로 엔터티를 식별하는 데 사용됩니다. 메트릭 데이터 포인트의 속성 섹션에서 이러한 키로 제출된 모든 값은 UI의 누락된 엔터티 또는 예상 엔터티와 연결되지 않은 원격 분석과 같은 정의되지 않은 동작을 유발할 수 있습니다. 자세한 내용은 엔터티 합성 을 참조하십시오.
기인하다 | 설명 |
|---|---|
| New Relic이 엔티티에 할당한 고유 식별자입니다. |
| 사람이 읽을 수 있는 엔터티 이름으로 UI에서 엔터티를 식별하는 데 자주 사용됩니다. |
| 호스트, 애플리케이션 등과 같은 다양한 유형의 엔티티를 구별하는 데 사용됩니다. |
추가 제한 사항은 다음과 같습니다.
제한 | 코멘트 |
|---|---|
측정항목 및 속성 이름 | 메트릭 이름과 속성 이름에 동일한 값을 전달할 수 없습니다. 다음 예에서는 측정항목의 이름이 Example: Metric value used as an attribute (invalid) |
예약어 |
|
메트릭 JSON 내의 키 | 메트릭 JSON 내에서 사용되는 모든 키는 속성 키가 될 수 없습니다. 여기에는 Exception: |
제한된 측정항목 값
value 이 NaN (숫자가 아님), positive infinity 또는 negative infinity 인 Indicator API 에 제출된 모든 Indicator 데이터는 삭제됩니다. 유한하지 않은 값으로 인해 NrIntegrationError 이벤트가 발생할 수 있습니다.