뉴렐릭 Java 에이전트는 newrelic.yml 파일에서 구성을 읽습니다. 기본적으로 에이전트는 newrelic.jar가 포함된 디렉토리에서 이 파일을 찾습니다. newrelic.config.file 시스템 속성을 정규화된 파일 이름으로 설정하여 구성 파일의 위치를 재정의할 수 있습니다.
뉴렐릭 계정을 생성하고(영구 무료), Java 에이전트를 설치하면 사용 환경에 맞게 Java 에이전트를 구성할 수 있습니다.
구성 파일 구조
newrelic.yml 파일에는 다양한 환경별로 섹션이 마련되어 있습니다.
- 테스트
- 개발
- 스테이징
- 프로덕션(기본값)
뉴렐릭은 이러한 각 환경에 common 섹션에 나와 있는 설정을 적용합니다. newrelic.environment 시스템 속성을 환경 이름으로 설정함으로써 다른 환경을 기본값으로 선택할 수 있습니다.
팁
newrelic.yml 템플릿을 사용할 수 있습니다.
newrelic.yml을 편집하는 경우, YAML 형식을 준수하도록 주의하십시오. 뉴렐릭의 Java 에이전트와 함께 파일을 사용하기 전에 YAML 유효성 검사기를 사용하여 구문이 정확한지 확인하고 다음 규칙을 따릅니다.
Java agent newrelic.yml | Requirements |
|---|---|
포맷 | YML 파일은 대소문자를 구분합니다. |
들여쓰기 | 모든 들여쓰기는 2자씩 증가해야 합니다. 다른 들여쓰기는 에이전트 시작 시
|
파일 변경 사항 | 변경 사항을 적용하려면 JVM 호스트 프로세스를 다시 시작해야 합니다. Exception: |
구성 설정 우선순위
구성 파일의 설정을 재정의하려면 시스템 속성 재정의를 사용합니다. 특정 환경에서는 환경 변수를 사용하여 구성 파일과 시스템 속성을 모두 재정의할 수도 있습니다. 환경 변수는 주로 Heroku를 지원하기 위해 존재합니다. 사용하면 서버 측 구성이 다른 모든 구성 설정보다 우선 적용됩니다.
Java 에이전트를 사용하면 서버 측 구성이 다른 모든 설정을 재정의합니다. 환경 변수는 Java 시스템 속성을 재정의합니다. 자바 속성은 newrelic.yml 파일의 사용자 구성 설정을 재정의합니다. 사용자 설정은 newrelic.yml 기본 설정보다 우선합니다.
Java 확장 디렉터리 구성
Java 에이전트는 프로세스 시작 시 구성 파일을 읽습니다. 파일이 있는 디렉터리를 식별하려면 새 디렉터리를 생성하거나 기존 확장 디렉터리를 지정하십시오.
설정 인덱스
다음 페이지에는 각 설정 영역에 대한 전체 설정 참조가 포함되어 있습니다.
| 설정 페이지 | 설명 |
|---|---|
| 일반 설정 | 핵심 설정: 라이선스 키, 앱 이름, 프록시, 고강도 보안, 확장 프로그램 |
| 트랜잭션 트레이서 설정 | 트랜잭션 추적, SQL 캡처, 트랜잭션 이벤트, 세그먼트, 메시지 트레이서 |
| 오류 수집기 설정 | 오류 수집, 무시/예상 클래스 및 상태 코드, 에러스 인박스(errors inbox) |
| 분산 추적 설정 | 분산 추적, 무한 추적, 스팬 이벤트, 크로스 애플리케이션 트레이서 |
| 문맥적 로그 설정 | 로그 포워딩, 로그 메트릭, 로컬 데코레이팅, 로깅 설정 |
| 속성 설정 | 속성 필터링, 포함/제외 목록, HTTP 속성 모드 |
| 보안 설정 | IAST 보안 에이전트, 취약점 감지 설정 |
| AI 모니터링 설정 | AI 모니터링 및 LLM 콘텐츠 기록 |
| 브라우저 모니터링 설정 | 브라우저 에이전트 자동 계측 및 속성 설정 |
| 비동기 계측 설정 | 비동기 토큰 및 세그먼트 타임아웃 설정 |
| OpenTelemetry 설정 | OpenTelemetry 트레이스, 메트릭 및 로그 신호 설정 |
| JFR 설정 | Java Flight Recorder 실시간 프로파일링 |
| 클래스 트랜스포머 설정 | Spring 트랜잭션 네이밍, 트레이스 어노테이션, 람다 트레이싱 |
| JMX 설정 | JMX 모니터링 및 메타데이터 연결 |
| 기타 설정 | 서킷 브레이커, 클라우드 설정, 사용률, 커스텀 대시보드, jar 수집기, JVM 난독화, 스레드 프로파일러 등 |
중요
반드시 구성해야 하는 두 가지 설정은 앱 이름과 라이선스 키입니다. newrelic.yml의 app_name 및 license_key (또는 NEW_RELIC_APP_NAME 및 NEW_RELIC_LICENSE_KEY 환경 변수)를 통해 설정합니다. 다른 모든 설정은 선택 사항입니다.