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

Java용 뉴렐릭 소개

뉴렐릭의 Java 에이전트를 사용하면 코드 내의 작은 오류에 이르기까지 성능 문제의 모든 것을 추적할 수 있습니다.에이전트는 매분 메트릭 타임슬라이스와 이벤트 데이터를 뉴렐릭 사용자 인터페이스에 표시합니다. 여기서 해당 데이터의 소유자는 로그인하고 데이터를 사용하여 웹사이트의 성능을 확인할 수 있습니다.

뉴렐릭 Java 에이전트를 사용하면, 느린 앱 튜토리얼에서 앱의 성능 문제를 해결할 수 있습니다.

설치

Java 에이전트를 사용하는 경우:

  1. 시스템이 Java 에이전트의 호환성 및 요구 사항을 충족하는지 확인합니다.
  2. 아직 계정이 없다면, 먼저 무료 계정을 신청합니다.
  3. 런처를 사용하거나 표준 설치 절차에 따라 Java 에이전트를 설치합니다. 툴 및 프레임워크에 따라 추가 설치 절차를 참조하여 Java 에이전트를 설치하거나 구성합니다.
설치 문서 읽기
자바 데이터 추가

뉴렐릭 UI에서 앱의 성능을 보려면 one.newrelic.com > All capabilities > APM & services > (select an app) > Summary로 이동합니다. APM 사용자 인터페이스에는 전용 JVM 메트릭 페이지, 트랜잭션오류 세부 정보, Java 스레드를 샘플링하고 스택 추적을 보고하는 스레드 프로파일러 도구 등이 포함됩니다.

또한 메트릭 및 이벤트 탐색기대시보드 등 다른 뉴렐릭 기능을 사용하여 에이전트 도구를 확장하고 데이터를 탐색할 수 있습니다.

시작 구성

Java 에이전트는 newrelic.jar와 동일한 디렉터리에 있어야 하는 newrelic.yml 파일에서 시작 구성을 읽어옵니다. Java 시스템 속성을 사용하여 설정을 재정의할 수도 있습니다.

에이전트는 시작(부트스트랩) 시 license_keyapp_name 설정이 필요합니다. newrelic.yml 파일에서 로그 파일 및 기타 설정의 위치를 맞춤화할 수 있습니다. 또한 앱 서버가 동일한 JVM에서 여러 애플리케이션을 실행하는 경우 이름 지정 설정을 조정할 수 있습니다.

구성 옵션

서버 측 구성을 사용하여 뉴렐릭 웹 인터페이스에서 애플리케이션 보고를 구성할 수 있습니다. JVM이 다시 시작되면 애플리케이션에 대해 보고하는 모든 에이전트에 변경 사항이 적용됩니다. 그러나 서버 측 구성을 사용하는 경우에도 로컬 구성 파일에서 필수 설정(license_keyapp_name)을 유지해야 합니다.

트랜잭션 트레이스와 오류 스냅샷 모두 선택적으로 HTTP 파라미터를 기록할 수 있습니다.때때로 HTTP 파라미터에는 신용 카드 번호 같은 민감한 정보가 포함됩니다.에이전트에는 HTTP 파라미터를 수집하지만 특정 명명된 파라미터를 제외시키는 것처럼 데이터 보안을 보장하기 위한 몇 가지 구성 옵션이 있습니다 .

APM 및 인프라 데이터에 대한 로그 보기

또한 로그와 애플리케이션의 데이터를 함께 가져와 더 쉽고 빠르게 문제를 해결할 수 있습니다. 문맥적 로그를 사용하면 앱의 UI에서 직접 오류 및 추적과 관련된 로그 메시지를 확인할 수 있습니다. 쿠버네티스 클러스터와 같은 인프라 데이터의 문맥적 로그를 볼 수도 있습니다. 다른 UI 페이지로 전환할 필요가 없습니다.

추가 계측

Java 에이전트를 설치한 후 다음 방법 중 하나를 사용하여 계측을 확장합니다.

  • 커스텀 계측: 주석 또는 XML을 통해 Java 커스텀 계측을 구현합니다.

  • 분산 추적 활성화: 분산된 다중 서비스 아키텍처에 흘어져 있는 요청들의 경로를 확인합니다.

  • 커스텀 속성 수집: API 또는 XML 파일을 통해 커스텀 속성을 수집합니다.

  • Java 에이전트 API: API를 사용하여 Java 에이전트의 기능을 제어, 사용자 정의 또는 확장합니다.

  • 브라우저 계측: Java 에이전트를

    과 통합하여 엔드 유저 활동에 대한 가시성을 확보할 수 있습니다.

  • Java 커스텀 계측용 서킷 브레이커: 서킷 브레이커를 사용하여 과도한 계측으로부터 애플리케이션을 보호합니다.

  • YAML에 의한 커스텀 JMX 계측: YAML 커스텀 계측 파일을 사용하여 커스텀 JMX 메트릭을 확인합니다.

  • JVM 메트릭 페이지: JMX를 통해 가장 일반적인 애플리케이션 서버에서 메트릭을 수집합니다.

  • 오픈소스 텔레메트리: Kamon Reporter, OpenTelemetry exporter, Micrometer 메트릭 레지스트리Java Telemetry SDK 같은 다양한 툴을 제공합니다.

JVM을 다시 시작해야 하는 경우

구성 또는 커스텀 XML을 변경하면 거의 모든 경우에서 JVM을 다시 시작해야 합니다.재시작이 필요하지 않은 상황은 4가지뿐입니다.

아래 경우 JVM을 다시 시작할 필요가 없습니다.

코멘트

로그 수준 또는 감사 모드 변경

Java 에이전트 구성 파일에서 단순히 log_level 또는 audit_mode를 변경하는 경우 JVM을 다시 시작할 필요가 없습니다.

XML 파일 커스텀 계측

JVM 재시작 여부는 Java 에이전트 버전에 따라 다릅니다.

  • 3.15.0 이상: 확장 폴더에서 커스텀 계측 XML 파일을 업데이트하는 경우 업데이트가 1분 이내에 자동으로 다시 로드됩니다.
  • 3.15.0 미만의 Java 에이전트 버전:3.15.0 이전 버전의 에이전트를 사용하는 경우,JVM을 다시 시작해야 합니다.

서킷 브레이커 변경

Java 커스텀 계측을 위해 서킷 브레이커를 변경하는 경우 JVM을 다시 시작할 필요가 없습니다.

무시되었거나 예상된 오류

newrelic.yml 파일을 구성하여 오류를 무시하거나 예상하는 경우, JVM을 다시 시작할 필요가 없습니다.여기에는 Java 에이전트 버전 3.40.0 이상을 사용할 때 newrelic.yml 파일에 상태 코드 또는 클래스를 추가하는 것이 포함됩니다.예를 들어:

  • ignore_status_codes
  • expected_status_codes
  • ignore_classes
  • ignore_messages
  • expected_classes
  • expected_messages

다른 모든 변경 사항은 에이전트를 다시 시작해야 합니다. 즉, JVM을 다시 시작해야 합니다.

JSR 163 준수

뉴렐릭 Java 에이전트는 웹 트랜잭션을 모니터링하여 이에 대한 정보를 수신하고 강력한 데이터 보안 조치가 적용된 뉴렐릭 사용자 인터페이스에 해당 정보를 전달합니다. 에이전트는 JVM 실행에 대한 수정을 통해 JVM에 의해 활성화되는 JSR 163 호환 javaagent로 패키지됩니다. 일단 활성화되면 에이전트는 스스로를 클래스 로딩 스트림에 삽입하고 바이트 코드 계측(bci)을 사용하여 클래스 메서드를 계측합니다.

웹 애플리케이션에 미치는 영향을 최소화하도록 설계된 모든 클래스는 자체 클래스와 충돌하지 않도록 newrelic 패키지 네임스페이스에 있습니다. 에이전트는 ASM bci 엔진을 사용하여 소프트웨어 프로브를 삽입합니다.

에이전트는 운영 체제, Java 버전, 시스템 속성 및 뉴렐릭 구성 파일 같은 호스트 환경에 대한 기본 정보를 수신합니다.에이전트는 또한 JVM 및 JMX에서 데이터를 폴링합니다.

문제 해결 절차

문제가 있는 경우 해당 섹션의 데이터가 표시되지 않음 및 기타 문제 해결 문서를 참조하세요.

Copyright © 2024 New Relic Inc.

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