자바 에이전트 오류 구성

APM의 Java 에이전트는 애플리케이션 내에서 발생하는 오류에 대한 자세한 정보를 보고합니다. 이를 통해 애플리케이션의 성능이나 최종 사용자의 경험에 영향을 미칠 수 있는 문제 영역에 대한 통찰력을 얻을 수 있습니다.

Java 에이전트 버전 3.40.0 이상 에는 다음을 포함하여 오류가 보고되는 방식을 제어할 수 있는 몇 가지 구성 옵션이 있습니다.

오류율 또는 Apdex에 영향을 미치지 않도록 예상 오류 구성
오류 무시
자동으로 보고되지 않는 오류 보고

오류 데이터 보기에 대한 자세한 내용은 오류 분석 을 참조하십시오. 모든 에이전트의 오류 데이터에 대한 개요는 APM의 오류 관리 를 참조하십시오.

일반적으로 보고되는 오류 예

Java 에이전트는 다음 시나리오에서 오류를 보고합니다.

오류 보고	Comments
처리되지 않은 오류(스택 추적 포함)	Java 에이전트가 추적한 트랜잭션 내에서 처리되지 않은 오류가 발생하면 전체 스택 추적과 함께 오류가 보고됩니다.
HTTP 상태 코드(스택 추적 없음)	애플리케이션의 트랜잭션이 HTTP 상태 코드(예: 클라이언트 오류의 경우 `400` 를 생성하면 스택 추적 없이 오류를 보고합니다. 그 이유는 다음과 같습니다. 애플리케이션 서버가 오류 조건을 감지하고 상태 코드를 명시적으로 설정했습니다. 또는 프로그램 로직이 오류 조건을 감지했으므로 예외 개체나 스택이 없습니다. 이러한 유형의 트랜잭션에 스택 추적을 포함하려면 `noticeError(...)` API 호출을 사용해야 합니다.
`noticeError(...)` API 호출	Java 에이전트가 `noticeError(...)` API 호출을 사용하여 명시적으로 호출하는 경우 트랜잭션 내에서 발생하는지 여부에 관계없이 오류가 보고됩니다. 보고된 정보는 Javadocs 에 설명된 대로 `noticeError(...)` API 호출에 사용된 매개변수에 따라 다릅니다.
100% 이상 보고되는 범위 없는 오류	저항 에이전트는 프로세서와 관련되지 않은 오류인 범위가 지정되지 않은 오류를 보고할 수 있습니다. 이로 인해 타임슬라이스에 하나의 트랜잭션이 있을 수 있고 동일한 타임슬라이스에 여러 오류가 있을 수 있습니다. 이 상황에서 뉴렐릭은 오류율 over 100% 을 표시합니다.

오류 보고 구성

중요

이 기능을 사용하려면 최신 릴리스 (Java 에이전트 3.40.0 이상)로 업그레이드 하십시오.

Java 에이전트는 오류가 보고되는 방식을 제어하는 몇 가지 유연한 구성 옵션을 제공합니다.

Config options	Details
UI를 통해 오류를 구성합니다.	서버 측 config 를 통해 오류를 무시하거나 예상대로 표시할 수 있습니다.
다음을 통해 예정된 오류로 구성 `newrelic.yml`	이러한 `noticeError` 버전에서 보고된 오류는 `newrelic.yml` 에서 예상 오류 로 구성할 수 있습니다. 이 API에 대한 호출은 오류가 `newrelic.yml` 에서 무시 된 것으로 구성된 경우 무시됩니다. 자세한 내용은 오류 구성 우선 순위 를 참조하십시오. 이 `noticeError()` API 호출을 사용하여 자동으로 보고되지 않는 오류를 보고하고 `newrelic.yml` 에서 예상 오류 로 구성합니다. `noticeError(Throwable throwable)` `noticeError(Throwable throwable, Map<String, String> params)`
다음을 통해 재정의할 예정입니다. `newrelic.yml`	이러한 `noticeError` 버전에서 보고된 오류는 `newrelic.yml` 예상 오류 구성을 재정의합니다. 이 API에 대한 호출은 오류가 yml에서 무시 된 것으로 구성된 경우 재정의됩니다. 자세한 내용은 오류 구성 우선 순위 를 참조하십시오. 다음 `noticeError(...)` API 호출을 사용하여 자동으로 보고되지 않는 오류를 보고하고 API에서 예상 오류 로 구성합니다(yml 예상 오류 구성 재정의). `noticeError(String message, boolean expected)` `noticeError(String message, Map<String, String> params, boolean expected)` `noticeError(Throwable throwable, boolean expected)` `noticeError(Throwable throwable, Map<String, String> params, boolean expected)`
구성 파일을 통해 오류를 무시하거나 예상합니다.	버전 3.40.0 이상에서는 YAML 기반 설정을 사용하여 오류가 보고되는 방식을 제어할 수 있습니다. 이를 통해 예외 클래스 이름 목록과 선택적인 오류 메시지를 기반으로 HTTP 상태 코드 or 을 기반으로 오류를 예상하거나 무시할 수 있습니다. Ignoring errors 지정된 예외 클래스 또는 코드가 에 전혀 보고되지 않도록 합니다. Expecting errors 지정된 예외 클래스 또는 코드가 애플리케이션의 오류율 및 Apdex 점수 에 영향을 미치는 것을 방지합니다. 이를 통해 오류율 또는 Apdex 점수에 따른 알림을 피하면서 문제 해결 목적으로 오류 정보를 유지할 수 있습니다. 이러한 설정은 동적이므로 실행 중인 에이전트는 JVM을 다시 시작하지 않고도 newrelic.yml 에 대한 변경 사항을 확인할 수 있습니다. 자세한 내용과 예시는 저항력 구성 파일을 참조하세요.

오류 수집을 위한 YAML 기반 구성

오류 수집을 위한 YAML 기반 구성을 사용하면 특정 오류를 완전히 무시하거나 애플리케이션의 오류율 및 Apdex 점수에 영향을 미치는 예상 오류를 제외할 수 있습니다. 다음 기준에 따라 오류를 무시 또는 예상으로 표시할 수 있습니다.

쉼표로 구분된 목록 또는 점선 범위로 표시되는 HTTP 상태 코드의 주어진 범위
패키지/클래스의 정규화된 이름
and
및 선택적으로 제공된 오류 메시지 문자열을 사용하는 쉼표로 구분된 목록

기본적으로 Java 에이전트에는 모든 YAML 기반 오류 구성 옵션이 있는 error_collector 섹션이 포함되어 있습니다. 오류 수집은 다음과 같이 활성화하거나 비활성화할 수 있습니다.

error_collector:
  enabled: true

특별한 관심이 없는 오류는 완전히 무시할 수 있습니다. 무시할 오류 식별:

APM에 보고되지 않습니다.

애플리케이션의 오류율이나 Apdex 점수에는 영향을 미치지 않습니다.

다음은 오류를 무시하기 위한 YAML 기반 구성 옵션을 보여주는 예입니다.

error_collector:
    enabled: true

    ignore_classes:
      - "com.example.ErrorClassToIgnore"

    ignore_messages:
      com.example.OtherErrorClassToIgnore:
        - "some error message to ignore"

    ignore_status_codes: 404,507-511

애플리케이션 비즈니스 로직의 일부로 expected 인 오류는 오류율이나 Apdex 점수에 영향을 미치지 않도록 방지할 수 있지만 여전히 APM에 보고됩니다. 이를 통해 문제 해결을 위해 UI 에 오류 정보를 유지하는 동시에 이러한 오류로 인해 발생하는 알림(설명율 및 Apdex 점수 기준)을 방지할 수 있습니다.

다음은 예상되는 오류에 대한 YAML 기반 구성 옵션을 보여주는 예입니다.

error_collector:
    enabled: true

    expected_classes:
      - "com.example.ExpectedErrorClass"

    expected_messages:
      com.example.OtherExpectedErrorClass:
        - "some expected error message"

    expected_status_codes: 406,500-504

오류 구성 우선 순위

오류 구성의 우선 순위는 다음과 같습니다.

서버 측 구성 (YAML 파일에 값 오버레이)
ignore_* YAML의 구성
expected noticeError(..) API 호출의 매개변수
expected_* YAML의 구성

다음은 다양한 API 호출과 YAML 구성을 결합한 결과의 예입니다.

YAML 구성:

error_collector:
  ignore_classes:
    - "com.example.ErrorClass"

그리고

API 호출:

noticeError(com.example.ErrorClass)

결과:

YAML ignore_classes 은 noticeError API 호출을 재정의하고 오류는 무시됩니다.

YAML 구성:

error_collector:
  expected_classes:
    - "com.example.ErrorClass"

그리고

API 호출:

noticeError(com.newrelic.Exception)

결과:

noticeError API 호출의 expected 매개변수는 기본적으로 true이고 YAML expected_classes 구성에는 오류 클래스가 포함되어 있습니다. 따라서 오류가 보고되고 expected 으로 표시됩니다.

YAML 구성:

error_collector:
  ignore_classes:
    - "com.example.ErrorClass"

그리고

API 호출:

noticeError(com.newrelic.Exception, expected = true)

결과:

YAML ignore_classes 은 noticeError API 호출의 expected 매개변수를 재정의하므로 오류가 무시됩니다.

YAML 구성:

error_collector:
  expected_classes:
    - "com.example.ErrorClass"

그리고

API 호출:

noticeError(com.newrelic.Exception, expected = false)

결과:

noticeError API 호출의 expected 매개변수는 YAML의 expected_classes 를 재정의합니다. 따라서 오류는 정상으로 보고됩니다( expected 로 표시되지 않음).

YAML 구성:

error_collector:
  ignore_classes:
    - "com.example.ErrorClass"

그리고

추가 YAML 구성:

error_collector:
  expected_classes:
    - "com.example.ErrorClass"

결과:

YAML ignore_classes/ignore_messages 은 YAML expected_classes/expected_messages 을 재정의하므로 오류가 무시됩니다. 이 동일한 원칙이 ignore_status_codes 및 expected_status_codes 에 적용됩니다.

오류 세부정보에 대한 로그 검사

로그와 애플리케이션의 데이터를 함께 가져와 문제 해결을 더 쉽고 빠르게 할 수 있습니다. 컨텍스트의 로그를 사용하면 앱의 UI에서 직접 오류 및 추적과 관련된 로그 메시지를 볼 수 있습니다.

Errors
페이지에서 추적을 클릭하여
Error details
페이지.
오류 세부정보 페이지에서
See logs
클릭합니다.
개별 로그 메시지와 관련된 세부 정보를 보려면 메시지를 직접 클릭하십시오.

UI를 통해 무시 및 예상 오류 구성

APM UI를 통해 예상 오류 를 구성하려면:

아직 활성화되지 않은 경우 서버 측 구성을 활성화합니다 .
예상대로 표시하려는 오류가 있는 애플리케이션 의 서버 측 구성 메뉴로 이동하십시오 .
Error collection
아래에서
Ignore
또는
Exclude expected errors
에 대해 구성하려는 오류에 대한 HTTP 코드 또는 오류 클래스를 입력합니다.
Save
선택합니다.

UI에서 예상 오류를 보는 방법에 대한 정보는 예상 오류 보기 를 참조하십시오.

사용자의 편의를 위해 제공되는 기계 번역입니다.

일반적으로 보고되는 오류 예

오류 보고 구성

중요

오류 수집을 위한 YAML 기반 구성

오류 수집 활성화

특정 오류 무시

예상 오류가 오류율 및 Apdex에 영향을 미치지 않도록 방지

오류 구성 우선 순위

오류 클래스 무시(YAML이 API 재정의)

예상 오류 보고(YAML 및 API)

예상 오류 보고(YAML 없음)

YAML ignore_classes가 API 예상 매개변수를 재정의합니다.

API 예상 매개변수는 YAML expected_classes를 재정의합니다.

YAML에서 예상되는 재정의 무시

오류 세부정보에 대한 로그 검사

UI를 통해 무시 및 예상 오류 구성

사용자의 편의를 위해 제공되는 기계 번역입니다.

자바 에이전트 오류 구성

일반적으로 보고되는 오류 예 .css-21sua1{background:none;border:none;width:0;padding:0;}

오류 보고 구성

중요

오류 수집을 위한 YAML 기반 구성

특정 오류 무시

예상 오류가 오류율 및 Apdex에 영향을 미치지 않도록 방지

오류 구성 우선 순위

오류 클래스 무시(YAML이 API 재정의)

예상 오류 보고(YAML 및 API)

예상 오류 보고(YAML 없음)

YAML ignore_classes가 API 예상 매개변수를 재정의합니다.

API 예상 매개변수는 YAML expected_classes를 재정의합니다.

YAML에서 예상되는 재정의 무시

오류 세부정보에 대한 로그 검사

UI를 통해 무시 및 예상 오류 구성

일반적으로 보고되는 오류 예