오류 받은 편지함은 오류를 감지하고 분류하기 위한 통합 오류 추적 환경을 제공합니다.
- 더 빠른 오류 해결을 위해 팀에서 관심을 갖고 있는 애플리케이션 및 서비스 전반의 문제를 보고 분류합니다.
- Slack의 자세한 오류 정보가 포함된 사전 알림.
- 속성을 분석하여 오류 이벤트 간의 유사성을 표시하고 근본 원인을 표시하는 오류 프로필.
- 전체 스택의 컨텍스트에서 오류를 분석하고 정밀하게 오류를 해결합니다.
- , , 및 AWS Lambda 함수에 대한 오류는 모두 동일한 받은 편지함에 캡처됩니다.
시작할 준비가 되셨습니까? 첫 번째 워크로드 생성 에 대한 문서를 참조하십시오.
오류 모니터링
오류 받은 편지함을 설정하고 나면 스택의 모든 오류를 사전에 모니터링할 수 있습니다.
오류 그룹
오류 그룹은 고유한 오류를 구성하는 이벤트 집합입니다. 오류 그룹은 장기간 저장되며 고유한 오류에 대한 메트릭, 활동 로그, 토론 및 기본 정보를 포함합니다. 오류 그룹은 엔터티 에 연결되어 있으므로 한 오류 받은편지함에서 오류 그룹의 상태를 변경하면 해당 엔터티를 포함하는 다른 모든 받은편지함에 영향을 줍니다.
오류 그룹 작동 방식
오류 이벤트는 동일한 지문을 공유할 때 오류 그룹으로 그룹화됩니다. 이벤트가 New Relic에 의해 수집됨에 따라 지문을 출력하는 일련의 관리 규칙을 통해 이벤트를 실행합니다. 모든 고유한 지문에는 연결된 단일 오류 그룹이 있습니다.
New Relic 관리 규칙은 오류 데이터를 정규화하여 "유사" 오류를 고유한 그룹으로 그룹화하는 UUID, 16진수 값 및 이메일 주소와 같은 고유한 값을 식별하고 무시합니다. New Relic account ID, entity ID, error class, error message, stack trace 및 exception 는 모두 지문에 영향을 줄 수 있는 데이터입니다.
오늘 오류 받은 편지함에 다음 중 해당하는 것이 있습니까?
- 응용 프로그램에 가장 적합한 방식으로 그룹화되지 않은 오류입니다.
- 병합된 것을 보고자 하는 병합되지 않은 여러 그룹.
- 고유한 오류 그룹의 일일 한도를 초과하도록 하는 열악한 그룹화로 인한 "시끄러운" 받은 편지함.
- 관련 없는 오류가 포함된 받은 편지함의 오류 그룹입니다.
오류를 잘 그룹화하면 오류 받은 편지함이 시스템의 문제를 더 잘 분류하고 진단하는 데 도움이 됩니다. 오류 수신함은 기본 그룹화 세트를 제공하지만 경우에 따라 조정이 필요합니다.
오류 그룹을 조정하는 두 가지 옵션이 있습니다. 사용자 정의 속성을 사용하여 오류 메시지를 업데이트하거나 고유한 오류 그룹을 생성합니다.
나만의 오류 그룹 만들기
현재 많은 에이전트에는 New Relic에 제출되기 전에 코드에서 오류를 확인하고 오류 그룹을 지정할 수 있는 기능이 있습니다. 그러면 지정된 그룹이 오류 이벤트의 error.group.name 속성으로 추가됩니다. 시작하려면 아래 APM 링크나 브라우저 에이전트 문서에서 사용자 정의 오류 그룹을 지정하는 방법에 대한 정보를 확인하세요. 이렇게 하면 에이전트가 수집한 오류와 속성이 보존되고 원하는 대로 그룹화됩니다.
지원되는 APM 에이전트:
귀하의 언어를 지원하지 않더라도 error.group.name 맞춤 속성으로 설정할 수 있습니다. 이는 이벤트가 사용자 지정 그룹에 속하지만 캡처된 이벤트에 다른 에이전트 속성이 없다는 신호입니다.
의미 있는 오류 그룹 생성을 위한 모범 사례
당사의 관리형 규칙은 미리 정의된 패턴 세트를 기반으로 자동 오류 그룹화를 제공할 수 있지만 가능한 모든 조합을 인식하는 것은 불가능합니다. 따라서 오류 메시지에서 변동성이 높은 값을 제거하면 오류가 올바르게 그룹화됩니다.
예를 들어 다음 두 오류 메시지를 고려하십시오.
- "구문 분석 오류: 124를 입력했는데 허용되지 않습니다."
- "구문 분석 오류: 456을 입력했는데 허용되지 않습니다."
이러한 오류 메시지는 유사해 보이지만 숫자가 4자리(124)보다 짧기 때문에 이러한 오류 발생이 제대로 그룹화될 가능성이 적습니다. 추가 정보가 있는 경우(예: 오류 메시지에 포함하려는 SQL 문, ID 등)은 사용자 정의 속성을 통해 보낼 수 있습니다.
권장사항:
- 오류 메시지에 4자리 미만의 숫자를 사용하지 마십시오.
- 오류 메시지에 특수 문자를 포함하지 마십시오.
- 오류 메시지 내에 SQL 문을 포함하지 마십시오.
- 오류 메시지에 스택 추적을 포함하지 마십시오. 스택 추적은 오류 메시지로 전송될 때 형식이 지정되지 않으므로 CodeStream 통합에서 작동하지 않습니다.
- 변동성이 큰 데이터(예: ID, 날짜, JSON)는 포함하지 마세요. 이러한 값이 속성으로 수집되면 사용자에게 더 나은 서비스가 제공됩니다. 이러한 속성은 Profiles [프로필] 드롭다운 메뉴의 오류 그룹 수준뿐만 아니라 개별 발생 수준에서도 볼 수 있습니다.
- 날짜/타임스탬프 사용에 주의하세요. 타임스탬프가 포함된 일부 오류 메시지를 포착하고 그룹화하지만 모든 형식을 인식한다고 보장할 수는 없습니다.
발생
오류 받은 편지함은 선택한 기간 내에 각 오류 그룹의 총 발생 횟수를 표시합니다. 해당 스파크라인 차트는 마우스를 가져가면 선택한 기간 동안의 하루 총 발생 횟수를 표시합니다.
필터 기준 정렬
오른쪽 상단의 드롭다운을 사용하여 그룹화된 오류 목록을 발생 횟수 또는 선택한 시간 범위에서 마지막으로 표시된 오류별로 정렬할 수 있습니다. 예를 들어 선택한 시간 선택기가 Jan 24 5:00pm ET -- Jan 24 5:45pm ET 이고 마지막으로 본 항목을 기준으로 정렬하면 가장 최근에 발생한 항목이 먼저 포함된 항목으로 정렬된 오류 그룹이 표시됩니다.
회귀 태그
새 오류가 해결된 오류 그룹의 지문과 일치하면 오류 그룹에 회귀 태그가 지정됩니다. 회귀된 오류 그룹의 상태가 변경되면 회귀 태그가 사라집니다.
예상 오류 태그
그룹의 모든 오류 발생이 예상되는 경우 오류 그룹에는 expected 태그가 지정됩니다. 일부 오류 발생이 예상되고 일부는 그렇지 않은 경우 contains expected 태그가 지정됩니다. 이 태그는 2023년 1월 21일 이후의 모든 오류에 사용할 수 있습니다.
예상대로 오류를 표시하는 방법에 대해 자세히 알아보세요.
일괄 작업
Edit groups 드롭다운 메뉴를 사용하여 오류를 일괄적으로 해결, 무시 또는 해결 취소할 수 있습니다.
여러 오류 그룹(최대 2,000개)의 상태를 한 번에 업데이트할 수 있습니다. 받은편지함 보기에서 Error groups 확인란을 선택하여 받은편지함의 모든 오류 그룹을 업데이트합니다. 개별 오류 그룹을 선택하여 상태를 업데이트할 수도 있습니다.
처음 및 마지막으로 본 날짜
코드/시스템의 변경과 관련시키기 위해 오류 그룹이 처음 발견된 시점을 아는 것이 매우 유용하다는 것을 알고 있습니다. 처음 및 마지막으로 본 날짜의 정확성은 아래에 요약된 세 가지 시나리오에 따라 다릅니다.
Scenario 1: 오류 그룹이 2022년 5월 17일 또는 그 이후에 처음 생성된 경우 처음 표시된 값과 마지막으로 표시된 값이 정확합니다.
Scenario 2: 오류 그룹이 2022년 5월 17일 이전에 처음 생성된 경우 처음 표시된 날짜가 정확하지 않습니다. 처음 표시된 날짜는 2022년 5월 17일이거나 가장 먼저 발생한 날짜입니다(선택한 기간이 2022년 5월 17일 이전인 경우). 마지막으로 본 값이 정확합니다.
Scenario 3: 오류 그룹이 일주일에 한 번 이하로 발생하는 경우 첫 번째 및 마지막 확인 날짜는 단일 발생 시간을 기준으로 추정됩니다. 일주일에 두 번 이상 나타나는 오류에 대해서만 처음 및 마지막으로 확인된 날짜만 정확하게 추적합니다.
분류 오류
오류 받은 편지함을 사용하면 기본 화면이나 오류 세부 정보 페이지에서 직접 오류 그룹을 분류할 수 있습니다. 분류를 통해 오류 받은 편지함에서 노이즈를 제거하고 주의가 필요한 영향력이 큰 오류에 집중할 수 있습니다.
오류 상태
받은편지함을 분류할 때 다양한 상태 중에서 선택할 수 있습니다. 오류를 즉시 해결하거나 무시되도록 표시할 수도 있습니다. 다른 경우에는 다음 버전이나 특정 버전에서 문제를 해결해야 할 수도 있습니다. 해결 옵션에 대한 자세한 내용은 버전 추적을 참조하세요.
예상 오류
오류 받은 편지함을 사용하면 APM 엔터티에 대해 예상되는 오류를 필터링할 수 있습니다. 오류를 예상대로 표시 하고 받은편지함에서 필터링하여 노이즈를 제거할 수 있습니다.
- error.expected != true: 기본값입니다. 이는 예상된 오류만 포함된 오류 그룹을 모두 숨기고 예상 오류와 예상치 못한 오류가 혼합된 오류 그룹을 "예상 포함" 태그로 표시합니다.
- error.expected = true: 이 필터는 그룹의 일부 또는 전체 오류가 예상되는 오류 그룹을 표시합니다. 이는 어떤 오류가 예상대로 표시되었는지 식별하는 데 유용할 수 있습니다.
- error.expected 필터를 제거하면 예상대로 표시된 오류가 포함되어 있는지 여부에 관계없이 모든 오류 그룹이 표시됩니다.
- 예상 오류는 항상 알림에서 제거됩니다.
- 위의 모든 기능과 예상 오류 태그는 2023년 1월 21일 이후 오류에서 사용할 수 있습니다.
오류 정보
오류 인박스(errors inbox)에서 특정 오류 그룹을 클릭하면 문제의 전체 내용을 보여주는 팝업 보기가 표시됩니다.
왼쪽 패널에서는 해당 오류가 발생한 모든 항목을 집계한 세부정보를 찾을 수 있습니다.
- 지표: 영향을 받은 사용자 수, 처음 확인, 마지막 확인
- 발생 횟수: 지난 30분 동안 오류가 발생한 횟수
- 버전별 발생 횟수: 배포 버전별로 오류가 발생한 횟수
- 프로필: 영향을 받은 속성(분석을 위해 프로필을 클릭하세요)
오른쪽 패널에서 해당 오류의 단일 발생에 대한 세부정보를 찾을 수 있습니다.
오류 수 및 빈도
관련 계정
스택 추적
분산 추적
컨텍스트 내 로그인](/docs/log/log-context/log-in-context
오류 속성 목록
상세 보기에서 오른쪽 상단의 토글을 사용하여 특정 오류를 순환하여 오류의 첫 번째 인스턴스, 마지막 인스턴스 또는 그 사이의 모든 인스턴스 사이를 탐색할 수 있습니다.
분산 추적을설정했고 오류와 관련된 샘플링된 추적이 있는 경우 추적 세부 정보를 볼 수 있는 옵션이 표시됩니다. 기본 분산 추적 페이지로 이동하지 않고 추적 정보를 보는 빠른 방법입니다.
Distributed traces 라벨이 붙은 왼쪽 창에서 제목을 확장하여 이 오류 그룹의 오류와 관련된 모든 트레이스 목록을 표시할 수 있습니다. 또는 Explore all 클릭하여 모든 트레이스 목록을 열 수 있습니다.
Distributed trace 에서는 이 페이지에 표시된 오류 발생과 관련된 트레이스를 볼 수 있습니다. 폭포 보기에서 트레이스의 범위를 보려면 다음을 수행하세요.
트레이스 이름을 직접 클릭하거나 오른쪽에 화살표가 있는 아이콘을 클릭하세요. 이렇게 하면 오류가 있는 트레이스 범위를 강조 표시하는 폭포식 포커스 보기가 표시됩니다.
모든 범위를 클릭할 수 있는 필터링되지 않은 폭포를 열려면 Explore 클릭하세요.
할당 오류
오류 그룹을 누구에게나 할당할 수 있습니다. 할당 드롭다운 메뉴에서 사용자를 선택하기만 하면 됩니다. New Relic 사용자가 아니더라도 모든 이메일 주소에 오류를 할당할 수도 있습니다.
오류 받은 편지함에서 필터를 업데이트하여 자신이나 팀원에게 할당된 오류만 표시할 수 있습니다.
오류 받은 편지함의 사용자 역할
표준 역할 제한(읽기 전용, 표준 등)은 오류 받은 편지함의 오류 그룹 설명 기능에서만 적용됩니다. 주석 기능 외부에서는 역할 제한이 적용되지 않습니다. 따라서 읽기 전용 사용자는 계정 내에서, 계정 외부에서 오류 그룹을 할당하고 오류 그룹의 상태(예: 무시됨, 해결됨, 해결되지 않음)를 업데이트할 수 있습니다.