자바 에이전트 오류 구성

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

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

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

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

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

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

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

오류 보고 구성

중요

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

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

구성 옵션	세부
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 상태 코드 또는 예외 클래스 이름 목록과 선택적 오류 메시지를 기반으로 오류를 무시하거나 오류를 예상할 수 있습니다. 오류를 무시하면 지정된 예외 클래스 또는 코드가 보고되지 않습니다. 조금도. 오류를 예상 하면 지정된 예외 클래스 또는 코드가 애플리케이션의 오류율 및 Apdex 점수 에 영향을 미치지 않도록 방지합니다. 이를 통해 오류율 또는 Apdex 점수를 기반으로 한 경고를 방지하면서 문제 해결을 위해 오류 정보를 유지할 수 있습니다. 이러한 설정은 동적이므로 실행 중인 에이전트는 JVM을 다시 시작하지 않고도 newrelic.yml 에 대한 변경 사항을 알 수 있습니다. 자세한 내용과 예는 Java 에이전트 구성 파일 을 참조하십시오.

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

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

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

기본적으로 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

애플리케이션 비즈니스 로직의 일부로 예상되는 오류가 오류율이나 Apdex 점수에 영향을 미치지 않도록 방지할 수 있지만 여전히 APM에 보고됩니다. 이렇게 하면 이러한 오류로 인해 발생하는 경고(오류율 및 Apdex 점수 기반)를 방지하면서 문제 해결을 위해 UI에 오류 정보를 유지할 수 있습니다.

다음은 예상되는 오류에 대한 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에서 직접 오류 및 추적과 관련된 로그 메시지를 볼 수 있습니다.

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

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

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

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

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

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

오류 보고 구성

중요

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

오류 수집 활성화

특정 오류 무시

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

오류 구성 우선 순위

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

예상 오류 보고(YAML 및 API)

예상 오류 보고(YAML 없음)

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

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

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

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

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