통합 오류 추적 경험
오류 받은 편지함은 오류를 감지하고 분류하기 위한 통합 오류 추적 환경을 제공합니다.
더 빠른 오류 해결을 위해 팀에서 관심을 갖고 있는 애플리케이션 및 서비스 전반의 문제를 보고 분류합니다.
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)를 포함하지 마십시오. 이러한 값이 속성으로 수집되면 사용자에게 더 나은 서비스가 제공됩니다. 이러한 속성은 속성 탭 내의 오류 받은 편지함에서 개별 발생 수준과 오류 그룹 수준에서 볼 수 있습니다.
- 날짜/타임스탬프 사용에 주의하세요. 타임스탬프가 포함된 일부 오류 메시지를 포착하고 그룹화하지만 모든 형식을 인식한다고 보장할 수는 없습니다.
발생
오류 받은 편지함은 선택한 기간 내에 각 오류 그룹의 총 발생 횟수를 표시합니다. 해당 스파크라인 차트는 마우스를 가져가면 선택한 기간 동안의 하루 총 발생 횟수를 표시합니다.
필터 기준 정렬
오른쪽 상단의 드롭다운을 사용하여 그룹화된 오류 목록을 발생 횟수 또는 선택한 시간 범위에서 마지막으로 표시된 오류별로 정렬할 수 있습니다. 예를 들어 선택한 시간 선택기가 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: 오류 그룹이 일주일에 한 번 이하로 발생하는 경우 첫 번째 및 마지막 확인 날짜는 단일 발생 시간을 기준으로 추정됩니다. 일주일에 두 번 이상 나타나는 오류에 대해서만 처음 및 마지막으로 확인된 날짜만 정확하게 추적합니다.
분류 오류
오류 받은 편지함을 사용하면 기본 화면이나 오류 세부 정보 페이지에서 직접 오류 그룹을 분류할 수 있습니다. 분류를 통해 오류 받은 편지함에서 노이즈를 제거하고 주의가 필요한 영향력이 큰 오류에 집중할 수 있습니다.
오류 상태
받은편지함을 분류할 때 다양한 상태 중에서 선택할 수 있습니다. 오류를 즉시 해결하거나 무시되도록 표시할 수도 있습니다. 다른 경우에는 다음 버전이나 특정 버전에서 문제를 해결해야 할 수도 있습니다.
팁
Resolve in next version [다음 버전에서 해결] 및 Resolve in specific version [특정 버전에서 해결] 옵션은 팀에서 의미 체계 버전 관리를 사용하는 경우에만 지원됩니다.
에러스 인박스(errors inbox) UI에서는 언제 오류를 해결하고 싶은지 표시할 수 있습니다.
다음 상태 중 하나를 설정하고 받은편지함을 상태별로 필터링할 수 있습니다.
Unresolved: 오류 그룹의 기본 상태입니다.
다음 버전에서 해결: 다음 릴리스에서 이 오류 그룹을 해결하려면 이 상태를 사용하는 것이 좋습니다. 이 옵션을 활성화하려면, 벌레스 인박스(errors inbox)가 새 릴리스를 감지하고 오류 그룹이 실제로 해결되었는지 확인할 수 있도록 애플리케이션에 대한 추적 변경을 설정해야 합니다. 오류 그룹이 다음 버전이나 향후 버전에서 계속 감지되는 경우 오류 그룹은 자동으로 해결되지 않고 회귀로 표시되며 회귀에 대한 Slack 공지를 받게 됩니다.
특정 버전에서 해결: 다음 상황에서 오류 그룹을 해결하려면 이 옵션을 선택합니다.
- 특정 버전에서 오류 그룹이 해결될 것임을 알고 있는 경우
- 기존 버전에서는 해당 오류 그룹이 해결된 것으로 알고 있는 경우
- 특정 버전을 입력하려는 경우
이 옵션을 활성화하려면 애플리케이션이나 서비스에 대한 버전 추적을 설정해야 합니다. 동등하거나 더 높은 의미 버전의 오류 발생이 감지되면 오류 그룹은 자동으로 해결되지 않고 회귀로 표시되며 회귀에 대한 Slack 공지를 받게 됩니다.
해결: 오류 그룹을 해결됨으로 설정하면 해결된 오류 그룹을 포함하도록 필터가 업데이트되지 않는 한 기본 받은 편지함 보기에서 해당 그룹이 숨겨집니다. 오류 그룹을 해결된 것으로 표시한 후 오류 그룹 지문과 일치하는 이벤트가 발생하면 자동으로 상태가 Unresolved 로 재설정됩니다. 이는 회귀를 식별하는 데 유용할 수 있습니다.
무시: 무시된 오류를 포함하도록 필터가 업데이트되지 않거나 오류 그룹 무시를 중지할 때까지 받은 편지함 보기에서 오류 그룹을 숨깁니다.
예상 오류
오류 받은 편지함을 사용하면 APM 엔터티에 대해 예상되는 오류를 필터링할 수 있습니다. 오류를 예상대로 표시 하고 받은편지함에서 필터링하여 노이즈를 제거할 수 있습니다.
error.expected != true
: 기본값입니다. 이는 예상된 오류만 포함된 오류 그룹을 모두 숨기고 예상 오류와 예상치 못한 오류가 혼합된 오류 그룹을 "예상 포함" 태그로 표시합니다.
error.expected = true
: 이 필터는 그룹의 일부 또는 전체 오류가 예상되는 오류 그룹을 표시합니다. 이는 어떤 오류가 예상대로 표시되었는지 식별하는 데 유용할 수 있습니다.
error.expected 필터를 제거하면 예상대로 표시된 오류가 포함되어 있는지 여부에 관계없이 모든 오류 그룹이 표시됩니다.
예상 오류는 항상 알림에서 제거됩니다.
위의 모든 기능과 예상 오류 태그는 2023년 1월 21일 이후 오류에서 사용할 수 있습니다.
오류 정보
특정 오류 그룹을 클릭하면 문제의 전체 컨텍스트를 찾을 수 있는 오류 세부 정보 페이지로 이동합니다. 이 컨텍스트는 오류를 분류하고 올바른 팀이나 개인에게 할당하는 데 도움이 될 수 있습니다.
세부 정보 페이지의 다양한 탭이 작동하는 방식은 다음과 같습니다.
할당 오류
오류 그룹을 누구에게나 할당할 수 있습니다. 할당 드롭다운 메뉴에서 사용자를 선택하기만 하면 됩니다. New Relic 사용자가 아니더라도 모든 이메일 주소에 오류를 할당할 수도 있습니다.
오류 받은 편지함에서 필터를 업데이트하여 자신이나 팀원에게 할당된 오류만 표시할 수 있습니다.
오류 받은 편지함의 사용자 역할
표준 역할 제한(읽기 전용, 표준 등)은 오류 받은 편지함의 오류 그룹 설명 기능에서만 적용됩니다. 주석 기능 외부에서는 역할 제한이 적용되지 않습니다. 따라서 읽기 전용 사용자는 계정 내에서, 계정 외부에서 오류 그룹을 할당하고 오류 그룹의 상태(예: 무시됨, 해결됨, 해결되지 않음)를 업데이트할 수 있습니다.