오류가 캡처되는 방식, 무시하거나 예상된 것으로 처리할 오류, 오류 이벤트가 샘플링되는 방식을 맞춤 설정하려면 루비 에이전트의 오류 수집기를 구성하십시오.
오류 수집기 에이전트는 기본적으로 잡히지 않는 모든 예외를 수집하고 보고합니다. 이러한 구성 옵션을 사용하면 오류 수집을 사용자 지정할 수 있습니다.
무시되고 예상되는 오류에 대한 정보 는 APM의 오류 분석에 대한 이 페이지를 참조하십시오 . NewRelic::Agent.notice_error Ruby 메서드를 통해 예상 오류를 설정하려면 Ruby 에이전트 API를 참조하세요 .
error_collector.capture_events error_collector.enabled 유형
부울
기본값
true
환경 변수
NEW_RELIC_ERROR_COLLECTOR_ENABLED
true 인 경우 에이전트는 추적된 오류 및 오류 수 측정항목을 캡처합니다.
error_collector.expected_classes 에이전트가 예상대로 처리해야 하는 오류 클래스 목록입니다.
주의 이 옵션은 환경 변수를 통해 설정할 수 없습니다.
error_collector.expected_messages 메시지 목록에 대한 오류 클래스 맵. 여기에 지정된 클래스 중 하나의 오류가 발생할 때 오류 메시지에 여기에 해당하는 문자열 중 하나가 포함되어 있으면 해당 오류는 예상대로 처리됩니다.
주의 이 옵션은 환경 변수를 통해 설정할 수 없습니다.
error_collector.expected_status_codes 유형
문자열
기본값
""
환경 변수
NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES
쉼표로 구분된 HTTP 상태 코드 및/또는 상태 코드 범위 목록입니다(예: 404, 429, 500-599). 오류에 상태 코드가 있는 경우, 일치하는 상태 코드와 관련된 오류는 예상된 것으로 처리됩니다.
error_collector.ignore_classes 유형
정렬
기본값
["ActionController::RoutingError", "Sinatra::NotFound"]
환경 변수
None
에이전트가 무시해야 하는 오류 클래스 목록입니다.
주의 이 옵션은 환경 변수를 통해 설정할 수 없습니다.
error_collector.ignore_messages 유형
해시시
기본값
{ThreadError: ["queue empty"]}
환경 변수
None
메시지 목록에 대한 오류 클래스 맵. 여기에 지정된 클래스 중 하나의 오류가 발생할 때 오류 메시지에 여기에 해당하는 문자열 중 하나가 포함되어 있으면 해당 오류는 무시됩니다.
주의 이 옵션은 환경 변수를 통해 설정할 수 없습니다.
error_collector.ignore_status_codes 유형
문자열
기본값
""
환경 변수
NEW_RELIC_ERROR_COLLECTOR_IGNORE_STATUS_CODES
쉼표로 구분된 HTTP 상태 코드 및/또는 상태 코드 범위 목록입니다(예: 404, 429, 500-599). 오류에 상태 코드가 있는 경우, 일치하는 상태 코드와 연결된 오류는 무시됩니다.
error_collector.max_backtrace_frames error_collector.backtrace_truncate_location 유형
문자열
기본값
"middle"
환경 변수
NEW_RELIC_ERROR_COLLECTOR_BACKTRACE_TRUNCATE_LOCATION
프레임 수가 error_collector.max_backtrace_frames 을(를) 초과할 때 백트레이스에서 자를 위치를 지정합니다. 옵션은 top (처음부터 프레임 제거), middle (처음과 끝을 보존하면서 중간에서 프레임 제거) 또는 end (끝에서 프레임 제거)입니다.
error_collector.max_event_samples_stored 유형
정수
기본값
100
환경 변수
NEW_RELIC_ERROR_COLLECTOR_MAX_EVENT_SAMPLES_STORED
수집 주기당 보고되는 최대 TransactionError 이벤트 수를 정의합니다.
받은편지함 구성 오류 다음 환경 변수 중 하나를 설정하면 소프트웨어의 어떤 버전에서 오류가 발생했는지 식별하는 데 도움이 됩니다.
NEW_RELIC_METADATA_SERVICE_VERSION 배포된 코드 버전(대부분의 경우 1.2.3로 표시되는 버전)이 포함된 이벤트 데이터에 대해 tags.service.version을 생성하지만 항상 그런 것은 아닙니다.NEW_RELIC_METADATA_RELEASE_TAG 릴리스 태그(예: v0.1.209 또는 release-209)가 포함된 이벤트 데이터에 tags.releaseTag을(를) 생성합니다.NEW_RELIC_METADATA_COMMIT 커밋 SHA를 포함하는 이벤트 데이터에 대해 tags.commit을 생성합니다. 전체 SHA를 사용하거나 처음 7자만 사용할 수 있습니다(예: 734713b).에러스 인박스(errors inbox) 는 오류를 생성하는 소프트웨어 버전을 자동으로 추적합니다.