• 로그인지금 시작하세요

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

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

문제 신고

Ansible로 New Relic Java 에이전트 설치

APM for Java 를 사용하면 설치 및 구성에 Ansible 역할을 사용할 수 있습니다.

호환성 및 요구 사항

Java 에이전트에 대한 New Relic의 Ansible 역할 은 오픈 소스이며 커뮤니티에서 지원합니다. Linux 서버의 Tomcat, Jetty 및 Wildfly(이전의 JBoss)에서 실행되는 애플리케이션을 계측하도록 Java 에이전트 설정을 지원합니다. 가장 일반적인 에이전트 매개변수는 Ansible 변수를 통해 구성할 수 있습니다.

이 역할을 실행 하려면 Ansible을 설치 해야 합니다. Ansible은 중앙 서버에서 실행되어 대상 호스트를 구성합니다. 이러한 호스트는 Linux를 실행하고 unzip 이(가) 설치되어 있어야 합니다. 역할은 가장 널리 사용되는 Linux 배포판과 호환되어야 합니다.

프로세스 개요

설치 및 구성에는 다음과 같은 몇 가지 단계가 포함될 수 있습니다.

1단계. 역할 설치

이 역할을 설치하려면 Ansible을 실행하는 시스템에서 ansible-galaxy 명령을 사용합니다.

$ ansible-galaxy install newrelic.newrelic_java_agent

그러면 Ansible Galaxy 에서 역할을 다운로드하고 Ansible 플레이북에서 사용할 수 있습니다.

2단계. 역할을 플레이북에 통합

include_role 모듈을 사용하여 플레이북에서 역할을 호출해야 합니다. 역할의 GitHub 리포지토리에는 다음과 같이 시작할 수 있는 예제 플레이북 이 포함되어 있습니다.

- hosts: YOUR_HOST_GROUP
  vars:
    nr_java_agent_config:
      license_key: YOUR_LICENSE_KEY
      app_name: YOUR_APP_NAME
      log_file_path: /tmp/newrelic

    server_type: tomcat
    server_root: /var/lib/tomcat8
    jvm_conf_file: /usr/share/tomcat8/bin/setenv.sh
    server_user: tomcat8
    server_group: tomcat8
    service_name: tomcat8
    restart_web_server: true

  tasks:
   - include_role:
       name: newrelic.newrelic_java_agent

vars 섹션에는 에이전트 자체에 대한 설정과 역할의 설치 프로세스를 구성하기 위한 여러 변수가 들어 있는 nr_java_agent_config 사전이 있습니다. 자세한 내용은 에이전트 구성역할 구성 에 대한 섹션을 참조하십시오.

3단계. 역할 구성

이러한 변수는 설치 프로세스를 구성하는 데 사용됩니다. 대부분이 필요합니다. 자세한 내용 은 GitHub의 예제를 참조하십시오.

변하기 쉬운

설명

server_type

필수 . 애플리케이션에서 사용하는 웹 서버입니다. 가능한 값은 tomcat , jettywildfly (독립 실행형 모드 전용)입니다.

server_root

필수 . 호스트에서 웹 서버의 위치입니다. 에이전트의 JAR, 구성 및 (기본적으로) 로그 파일은 이 디렉터리의 하위 디렉터리에 있습니다.

jvm_conf_file

필수 . New Relic Java 에이전트를 참조하기 위한 웹 서버 구성 파일의 경로입니다. 예를 들어 Tomcat의 경우 일반적으로 setenv.sh 파일입니다. 파일이 존재하지 않는 경우 파일에 따라 생성될 수 있습니다. server_type.

server_user

server_group

필수 . 웹 서버가 실행되는 사용자 및 그룹입니다. newrelic.jarnewrelic.yml 파일의 소유권을 설정하는 데 사용됩니다.

restart_web_server

선택 사항 . 기본값: true . false 로 설정하면 에이전트를 설치한 후 역할이 웹 서버를 다시 시작하지 않습니다. 에이전트는 웹 서버가 다시 시작될 때까지 활성화되지 않습니다.

service_name

필수 ( restart_web_serverfalse 로 설정되지 않은 경우). 웹 서버가 실행되는 서비스 이름입니다. 에이전트가 설치된 후 웹 서버를 다시 시작하기 위해 Ansible에서 사용합니다.

nr_java_agent_version

선택 사항 ; 기본값: current 설치할 Java 에이전트의 버전을 지정합니다. current 은(는) 최신 버전을 설치합니다. 5.9.0 와 같은 특정 버전을 설치할 수도 있습니다. 사용 가능한 버전은 Java 에이전트 다운로드 디렉토리 를 참조하십시오.

4단계. 에이전트 구성

다음 변수는 Java 에이전트 자체를 구성하는 데 사용됩니다. 이는 사용 가능한 옵션 중 일부일 뿐입니다. 지원되는 변수의 전체 목록은 GitHub의 README 파일을 참조하십시오. 에이전트를 구성하는 방법에 대한 자세한 내용은 Java 에이전트 구성 을 참조하십시오.

변하기 쉬운

설명

license_key

필수 . 귀하의 New Relic 라이센스 키 .

app_name

필수 . 계측 중인 애플리케이션의 이름입니다. 자세한 내용은 앱 이름 지정 을 참조하세요.

proxy_host

proxy_port

proxy_user

proxy_password

proxy_scheme

선택 사항 . 프록시를 통해 New Relic 수집기에 연결하는 경우 이러한 값으로 프록시 설정을 구성할 수 있습니다.

labels

선택 사항 . 에이전트에 대한 사용자 구성 가능한 사용자 정의 레이블. 레이블은 이름-값 쌍입니다. 이름과 값은 255자로 제한되며 콜론(:)이나 세미콜론(;)을 포함할 수 없습니다. 값은 세미콜론으로 구분된 키-값 쌍 목록이어야 합니다(예: Server:One;Data Center:Primary .

5단계. 사용자 지정 계측 활성화(선택 사항)

맞춤 계측 을 활성화하려면 custom_instrumentation_files 변수를 사용하여 XML 파일 목록을 제공할 수 있습니다. 예를 들어 플레이북에 다음과 같은 항목을 추가하여 설치 중인 모든 Java 에이전트가 my_instrumentation.xml 이라는 파일을 사용하도록 지정할 수 있습니다.

vars:
custom_instrumentation_files:
- /path/to/my_instrumentation.xml

자세한 내용은 GitHub의 README예제 를 참조하십시오.

더 많은 도움을 받으려면

추가 도움이 필요하면 GitHub의 newrelic/newrelic-java-agent-ansible-role 에서 문제를 제출하세요 .

Copyright © 2022 New Relic Inc.

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