• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

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

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

자바 에이전트 오류 구성

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)

다음을 통해 재정의할 예정입니다. newrelic.yml

이러한 noticeError 버전에서 보고된 오류는 newrelic.yml 예상 오류 구성을 재정의합니다. 이 API에 대한 호출은 오류가 yml에서 무시 된 것으로 구성된 경우 재정의됩니다. 자세한 내용은 오류 구성 우선 순위 를 참조하십시오.

다음 noticeError(...) API 호출을 사용하여 자동으로 보고되지 않는 오류를 보고하고 API에서 예상 오류 로 구성합니다(yml 예상 오류 구성 재정의).

구성 파일을 통해 오류를 무시하거나 예상합니다.

버전 3.40.0 이상에서는 YAML 기반 설정을 사용하여 오류가 보고되는 방식을 제어할 수 있습니다. 이를 통해 예외 클래스 이름 목록과 선택적인 오류 메시지를 기반으로 HTTP 상태 코드 or 을 기반으로 오류를 예상하거나 무시할 수 있습니다.

  • Ignoring errors 지정된 예외 클래스 또는 코드가 에 전혀 보고되지 않도록 합니다.

  • Expecting errors 지정된 예외 클래스 또는 코드가 애플리케이션의 오류율Apdex 점수 에 영향을 미치는 것을 방지합니다. 이를 통해 오류율 또는 Apdex 점수에 따른 알림을 피하면서 문제 해결 목적으로 오류 정보를 유지할 수 있습니다.

    이러한 설정은 동적이므로 실행 중인 에이전트는 JVM을 다시 시작하지 않고도 newrelic.yml 에 대한 변경 사항을 확인할 수 있습니다. 자세한 내용과 예시는 저항력 구성 파일을 참조하세요.

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

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

  • 쉼표로 구분된 목록 또는 점선 범위로 표시되는 HTTP 상태 코드의 주어진 범위

  • 패키지/클래스의 정규화된 이름

    and

    및 선택적으로 제공된 오류 메시지 문자열을 사용하는 쉼표로 구분된 목록

오류 구성 우선 순위

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

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

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

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

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

  1. Errors

    페이지에서 추적을 클릭하여

    Error details

    페이지.

  2. 오류 세부정보 페이지에서

    See logs

    클릭합니다.

  3. 개별 로그 메시지와 관련된 세부 정보를 보려면 메시지를 직접 클릭하십시오.

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

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

  1. 아직 활성화되지 않은 경우 서버 측 구성을 활성화합니다 .

  2. 예상대로 표시하려는 오류가 있는 애플리케이션 의 서버 측 구성 메뉴로 이동하십시오 .

  3. Error collection

    아래에서

    Ignore

    또는

    Exclude expected errors

    에 대해 구성하려는 오류에 대한 HTTP 코드 또는 오류 클래스를 입력합니다.

  4. Save

    선택합니다.

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

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.