Ansible을 사용하여 인프라 에이전트 구성

New Relic의 Ansible 역할을 사용하여 New Relic CLI 및 New Relic Open Installation 리포지토리를사용하여 New Relic Observability 노력을 확장할 수 있습니다. Ansible 사용 방법에 대한 지침은 Ansible 설명서를참조하십시오. 이것은 지역 사회가 지원하는 노력입니다.

Ansible을 사용하여 인프라 에이전트를 구성하고 싶으십니까? 무료 로 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역할을 사용하여 시작하려면 다음을 수행하십시오.

1. 플레이북에 역할을 포함시키십시오.
2. 필요한 변수를 사용자 정의합니다.

설치 후 신규 또는 기존 플레이북에 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 역할을 구성하는 데 사용할 수 있는 변수입니다.

기본값

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의 원격 환경을 참조하세요.

추가 예제 플레이북

- 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"