New Relic의 최신 기능, 향상된 기능 및 중요한 보안 패치를 최대한 활용하려면 Java 에이전트를 최신 버전으로 업데이트하는 것이 좋습니다. 특정 에이전트 업데이트에 대한 추가 정보는 Java 에이전트 릴리스 정보 를 참조하십시오.
이 업데이트 절차에서는 New Relic Java 에이전트( newrelic.jar
)가 포함된 에이전트 루트 디렉터리 의 현재 콘텐츠 중 일부를 New Relic UI에서 새로 다운로드한 콘텐츠로 바꾸는 방법을 설명합니다.
최신 버전으로 업데이트
현재 사용 중인 Java 에이전트 버전을 식별하려면 java -jar newrelic.jar -v
을 실행합니다. Java 에이전트 버전이 콘솔에 인쇄됩니다.
그런 다음 최신 Java 에이전트 버전으로 업데이트하려면 다음을 수행합니다.
- 전체 Java 에이전트 루트 디렉터리 를 다른 위치에 백업합니다. 해당 디렉토리의 이름을
NewRelic_Agent#.#.#
으로 바꿉니다. 여기서#.#.#
은 에이전트 버전 번호입니다. - 에이전트를 다운로드합니다.
- 새 에이전트 다운로드 파일의 압축을 푼 다음
newrelic-api.jar
및newrelic.jar
을 원래 Java 에이전트 루트 디렉토리 에 복사합니다. - 이전
newrelic.yml
을 zip에서 새로 다운로드한newrelic.yml
과 비교 하고 필요한 경우 파일을 업데이트합니다 . - Java 디스패처를 다시 시작하십시오.
Java 에이전트 업데이트 후 문제가 발생하면 백업된 New Relic 에이전트 디렉터리에서 복원하십시오.
에이전트 구성 차이점 업데이트
에이전트의 새 버전을 출시할 때 newrelic.yml
에 새 설정을 추가합니다.diff
또는 다른 diffing 유틸리티를 사용하여 변경된 사항을 확인하고 이전 파일에 새 구성 설정을 추가할 수 있습니다.라이센스 키, 앱 이름 또는 기본 설정 변경 사항과 같이 파일에 대해 수행한 사용자 정의를 덮어쓰지 않도록 하십시오.
예를 들어, 자바 에이전트 버전 7.7.0 및 7.8.0에 대한 기본 newrelic.yml
파일을 diff
하는 경우 콘솔에 인쇄되는 결과는 다음과 같습니다.
➜ diff newrelic_7.7.0.yml newrelic_7.8.0.yml98c98< #forwarding:---> forwarding:100,101c100,101< # When true, application logs will be forwarded to New Relic. The default is false.< #enabled: false---> # When true, application logs will be forwarded to New Relic. The default is true.> enabled: true
이 예에서 이러한 행은 Java 에이전트 버전 7.8.0의 기본 newrelic.yml
에 추가되었습니다.7.8.0 이상으로 이동하는 경우 원래 newrelic.yml
에 이러한 새 줄을 추가해야 합니다.