이 문서에는 사용자 정의 이벤트 및 관련 속성 을 삽입하고 사용하기 위한 일반 요구 사항 및 규칙이 포함되어 있습니다. 사용하는 방법에 따라 추가 요구 사항이 적용될 수 있습니다.
다음과 같은 여러 가지 방법으로 New Relic에 맞춤 이벤트 를 보고할 수 있습니다.
- 에이전트 API
- 이벤트 API (이벤트 API 사용 시 추가 요구 사항이 있습니다.)
- 에이전트 API 및 (맞춤
PageAction
이벤트에는 추가 요구사항이 있습니다.) - 모바일 모니터링 SDK
일반적인 요구 사항
사용자 지정 이벤트 및 속성을 보고할 때 지원되는 데이터 유형, 명명 구문 및 크기에 대한 다음 일반 요구 사항을 따르십시오.
요구 사항 | 설명 |
---|---|
유효 탑재량 | 총 최대 크기 또는 길이: 1MB (10^6 bytes) maximum per POST. 압축을 사용하는 것이 좋습니다. 페이로드는 UTF-8 으로 인코딩되어야 합니다. 이벤트 API에는 추가 HTTP 속도 제한이 있습니다 . |
속성 데이터 유형 | 속성 값은 문자열, 숫자 정수 또는 부동 소수점일 수 있습니다. 날짜 및 시간 데이터 형식 지정에 대한 자세한 내용은 사용자 지정 날짜/시간 을 참조하십시오. |
속성 제한 | 속성 이름의 최대 길이: 255자. 맞춤 속성 값의 최대 길이:
|
이벤트 및 속성의 명명 구문 | 이벤트 이름은 영숫자, 콜론( 이름을 문자로 시작하는 것이 좋습니다. 다른 이름으로 시작하는 경우 쿼리할 때 이름 주위에 백틱을 넣어야 합니다. 쿼리에 백틱이 필요한 경우에 대한 자세한 내용은 NRQL 참조를참조하세요. NRQL에서 사용하도록 예약된 단어를 사용 하지 마십시오. 이벤트 이름의 최대 길이: 255자. |
널 값 | 데이터베이스는 null 값을 가진 데이터를 저장하지 않습니다. |
예약어
이벤트 및 속성의 이름으로 다음 예약어를 사용하지 마십시오. 그렇지 않으면 예기치 않은 결과가 발생할 수 있습니다.
중요
이것은 완전한 목록이 아닙니다. 일반적으로 미래의 New Relic 기능과의 충돌을 피하기 위해 MySQL 예약어 를 사용하지 마십시오.
Keyword | Description |
---|---|
| 예약된 속성 이름입니다. 포함된 경우 수집 중에 삭제됩니다. |
| 값은 정수여야 합니다. 정수가 아니면 속성 이름과 값이 수집 중에 삭제됩니다. |
| New Relic에 저장된 이벤트 유형입니다. New Relic 에이전트 및 스크립트는 일반적으로 이를 |
금지된 |
|
| Unix epoch 타임스탬프여야 합니다. 타임스탬프는 초 또는 밀리초 단위로 정의할 수 있습니다. 서버의 현재 시간에서 +/-1일(24시간)이어야 합니다. |
로그 전달 조건 | 다음 키는 인프라 에이전트의 로그 전달 기능에 의해 예약됩니다: |
NRQL 구문 용어 | 점으로 구분된 속성을 포함하여 NRQL 구문 용어를 속성 이름으로 사용해야 하는 경우 역따옴표로 묶어야 합니다. 예:
|
이벤트 유형 제한
eventType
값의 현재 한도는 지정된 24시간 동안 계정당(조직당이 아님) 250개입니다. 계정이 이 한도를 초과하면 New Relic은 데이터를 필터링하거나 삭제할 수 있습니다. 이벤트 유형은 다음과 같습니다.
- New Relic 에이전트 및 통합의 기본 이벤트
- 상담원의 맞춤 이벤트 또는
- 이벤트 API의 사용자 정의 이벤트