New Relic의 Ansible 역할을 사용하여 New Relic CLI 및 New Relic Open Installation 리포지토리를사용하여 New Relic Observability 노력을 확장할 수 있습니다. Ansible 사용 방법에 대한 지침은 Ansible 설명서를참조하십시오. 이것은 지역 사회가 지원하는 노력입니다.
Ansible을 사용하여 인프라 에이전트를 구성하고 싶으십니까? 무료 로 New Relic 계정을 만드 십시오! 신용 카드가 필요하지 않습니다.
중요
이 역할은 항상 최신 릴리스 버전의 New Relic 에이전트를 설치하며 이전 버전 설치를 지원하지 않습니다.
샘플 코드
뉴렐릭은 많은 Ops 팀에서 공통적으로 사용하는 도구와 군인 에이전트를 설치하는 데 도움이 되는 설정 관리 샘플 코드를 제공합니다. 이는 기본 Ansible 역할이며 사용자 정의된 워크플로우를 생성하기 위한 시작점으로 사용하기 위한 것입니다.
구성은 특정 설정 및 표준에 따라 다릅니다. Ansible 샘플 역할 및 추가 통합 정보를 보려면 Ansible Galaxy 문서를참조하십시오.
호환성 및 요구 사항
뉴렐릭의 에이전트 에이전트를 사용하는 Ansible 역할에는 지원되는 운영 시스템이 필요합니다.
Windows OS용 Ansible에 대한 도움이 필요한 경우 Ansible 설명서사이트에서 Windows 호스트 설정을 살펴보십시오.
이 역할은 Ansible Core 2.13 및 2.14와 Python 3.10에서 테스트되었습니다. 2.10 이전의 Ansible Core 버전은 지원되지 않습니다.
Ansible로 New Relic 설정
설치
앤서블 갤럭시
$ansible-galaxy install newrelic.newrelic_install
아직 설치되지 않은 경우 ansible.windows
및 ansible.utils
있는지 확인하십시오.
$ansible-galaxy collection install ansible.windows ansible.utils
수동
역할의 로컬 사본을 사용하려면 저장소를 복제하고 프로젝트 루트에서 make
를 실행하여 이 저장소를 ~/.ansible/roles/newrelic.newrelic_install
에 복사하면 역할이 Galaxy에서 설치된 것처럼 작동할 수 있습니다.
시작하기
newrelic.newrelic_install
역할을 사용하여 시작하려면 다음을 수행하십시오.
- 플레이북에 역할을 포함시키십시오.
- 필요한 변수를 사용자 정의합니다.
설치 후 신규 또는 기존 플레이북에 newrelic.newrelic_install
역할을 포함합니다. 다음은 인프라 에이전트를 설치하도록 역할을 구성하는 예입니다.
---- name: Install New Relic hosts: all roles: - role: newrelic.newrelic_install vars: targets: - infrastructure - logs tags: foo: bar environment: NEW_RELIC_API_KEY: <API key> NEW_RELIC_ACCOUNT_ID: <Account ID> NEW_RELIC_REGION: <Region>
역할 구성 변수
다음은 newrelic.newrelic_install
역할을 구성하는 데 사용할 수 있는 변수입니다.
변하기 쉬운 | 필수 | 설명 |
---|---|---|
| 필수의 | 호스트에서 실행할 대상 설치 목록입니다. 사용 가능한 옵션은 다음과 같습니다.
|
| 선택 과목 | 설치에 전달된 태그의 키-값 쌍입니다. |
| 선택 과목 | 설치 작업에 대한 제한 시간을 설정합니다. 기본 제한 시간인 600초를 재정의합니다. |
| 선택 과목 | 설치에 대한 세부 정보 표시 옵션( |
기본값
defaults/main.yml에서 설정:
cli_install_url
cli_install_download_location
target_name_map
verbosity_on_log_file_path_linux
verbosity_on_log_file_path_windows
default_install_timeout_seconds
환경 변수
값은 플레이북의 environment
키워드 아래에 설정됩니다.
NEW_RELIC_API_KEY
(필수의)NEW_RELIC_ACCOUNT_ID
(필수의)NEW_RELIC_REGION
(선택사항: 'US' 또는 'EU', 기본값 'US')
또한 선택적 HTTPS_PROXY
변수를 설정하여 설치에 대한 프록시를 활성화할 수 있습니다.
자세한 내용은 ansible의 원격 환경을 참조하세요.
중요 사항
logs
대상에는infrastructure
필요하며infrastructure
없이logs
를 지정하면 오류가 발생합니다.apm-nodejs
에이전트 설치는 PM2 에서 관리하는 앱에만 지원됩니다.npm
또는yarn
와 같은 패키지 관리자를 사용하거나 다른 설치 경로를 통해 에이전트를 설치하려면 문서 를 참조하세요.Windows용
apm-dotnet
에이전트 설치는 IIS에서 호스팅하는 앱에 대해서만 지원됩니다. Linux 설치는systemd
서비스로 실행되는 .NET 애플리케이션에 대해서만 지원됩니다.apm-java
에이전트 설치는 Tomcat, Wildfly/Jboss 및 Jetty(독립형)에서 실행되는 Java를 지원합니다.다음 통합에는 인프라 에이전트를 설치해야 합니다.
- apm-자바
- 아파치
- MSSQL
- mysql
- nginx
추가 예제 플레이북
- name: Install New Relic hosts: all roles: - role: newrelic.newrelic_install vars: targets: - infrastructure - logs - apm-php tags: foo: bar install_timeout_seconds: 1000 verbosity: debug environment: NEW_RELIC_API_KEY: <API key> NEW_RELIC_ACCOUNT_ID: <Account ID> NEW_RELIC_REGION: <Region> NEW_RELIC_APPLICATION_NAME: "My Application" HTTPS_PROXY: "http://my.proxy:8888"