• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

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

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

Ansible을 사용하여 인프라 에이전트를 구성하고 싶으십니까? 무료 로 New Relic 계정을 만드 십시오! 신용 카드가 필요하지 않습니다.

중요

이 역할은 항상 최신 릴리스 버전의 New Relic 에이전트를 설치하며 이전 버전 설치를 지원하지 않습니다.

샘플 코드

New Relic은 구성 관리 샘플 코드를 제공하여 많은 Ops 팀에서 공통적으로 사용하는 워크플로 및 도구를 사용하여 인프라 모니터링 에이전트를 설치하는 데 도움을 줍니다. 이것은 기본 Ansible 역할이며 사용자 정의된 워크플로를 만들기 위한 시작점으로 사용하기 위한 것입니다.

구성은 특정 설정 및 표준에 따라 다릅니다. Ansible 샘플 역할 및 추가 통합 정보를 보려면 Ansible Galaxy 문서를참조하십시오.

호환성 및 요구 사항

New Relic의 인프라 모니터링 에이전트가 포함된 Ansible 역할에는 지원되는 운영 체제가필요합니다.

Windows OS용 Ansible에 대한 도움이 필요한 경우 Ansible 설명서사이트에서 Windows 호스트 설정을 살펴보십시오.

이 역할은 Ansible Core 2.13 및 2.14와 Python 3.10에서 테스트되었습니다. 2.10 이전의 Ansible Core 버전은 지원되지 않습니다.

Ansible로 New Relic 설정

설치

앤서블 갤럭시

갤럭시에 연결

bash
$
ansible-galaxy install newrelic.newrelic_install

아직 설치되지 않은 경우 ansible.windowsansible.utils 있는지 확인하십시오.

bash
$
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 역할을 구성하는 데 사용할 수 있는 변수입니다.

변하기 쉬운

필수

설명

targets

필수의

호스트에서 실행할 대상 설치 목록입니다. 사용 가능한 옵션은 다음과 같습니다.

  • infrastructure (리눅스 및 윈도우즈)
  • logs (리눅스 및 윈도우즈)
  • apm-php (리눅스)
  • apm-nodejs (리눅스)
  • apm-dotnet (리눅스 및 윈도우즈)
  • apm-java (리눅스)
  • apache (리눅스)
  • mssql (윈도우즈)
  • mysql (리눅스)
  • nginx (리눅스)

tags

선택 과목

설치에 전달된 태그의 키-값 쌍입니다.

install_timeout_seconds

선택 과목

설치 작업에 대한 제한 시간을 설정합니다. 기본 제한 시간인 600초를 재정의합니다.

verbosity

선택 과목

설치에 대한 세부 정보 표시 옵션(debug 또는 trace)은 호스트의 로그 파일에 세부 정보 출력을 기록합니다.

기본값

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"
Copyright © 2024 New Relic Inc.

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