인프라 에이전트는 다양한 방식으로 구성할 수 있습니다. 기본 방법은 newrelic-infra.yml
파일에서 구성 변수 를 편집하는 것입니다.
구성 파일 템플릿은 인프라 구성 파일 템플릿 에서 사용할 수 있습니다. 환경 변수 를 설정하여 구성 파일을 재정의하거나 Ansible 또는 Puppet과 같은 구성 관리 도구 를 사용할 수도 있습니다.
인프라 에이전트와 작동하는 호스트 내 통합을 구성하려면 특정 통합 문서 를 참조하십시오.
중요 설정을 변경한 후에는 항상 에이전트를 다시 시작 해야 합니다. 통합 구성 업데이트의 경우는 에이전트를 다시 시작할 필요가 없습니다. (핫-리로드 지원)
구성 방법 및 우선 순위 인프라 에이전트를 구성하는 기본 방법은 newrelic-infra.yml
구성 파일입니다. 컨테이너화된 환경에 이상적인 환경 변수를 설정하여 구성 파일을 재정의할 수 있습니다.
환경 변수는 구성 파일을 재정의합니다. 구성 파일은 에이전트 기본값을 재정의합니다.
각 구성 방법에 대한 자세한 설명은 다음과 같습니다.
구성 파일( newrelic-infra.yml
) 위치 및 설명 인프라 에이전트를 구성하려면 newrelic-infra.yml
파일을 사용합니다. 기본 위치는 다음과 같습니다.
리눅스: /etc/newrelic-infra.yml
Windows: C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml
MacOS Intel: /usr/local/etc/newrelic-infra/newrelic-infra.yml
MacOS Apple Silicon: /opt/homebrew/etc/newrelic-infra/newrelic-infra.yml
샘플 구성 파일은 인프라 구성 파일 템플릿 을 참조하십시오.
환경 변수 구문 및 설명 환경 변수를 설정하려면 구성 파일의 변수 이름을 모두 대문자로 사용하고 접두사 NRIA_
를 사용합니다. 예: NRIA_LICENSE_KEY
. 컨테이너화된 환경에서는 환경 변수를 통해 라이선스와 태그 같은 구성 속성을 채웁니다.
인프라 구성 파일 템플릿 에 설명된 옵션에는 Env var
레이블이 지정된 해당 환경 변수가 포함됩니다. 환경 변수는 인프라 구성 설정 에도 나열됩니다.
이중 중괄호 {{MY_ENV_VAR}}
를 사용하여 구성 파일에서 환경 변수를 정의할 수도 있습니다. 예를 들어:
license_key : { { MY_LICENSE_KEY } }
호스트 내 통합과 함께 환경 변수 패스스루 사용 환경 변수를 사용 하여 호스트 내 통합 을 위한 구성 설정을 제어할 수 있으며, 이는 인프라 에이전트에 전달할 수 있습니다. 각 온-호스트 통합에 사용할 수 있는 변수는 각 통합에 대한 설명서에 나열되어 있으며 다음 방법 중 하나를 통해 설정할 수 있습니다.
passthrough_environment
옵션은 변수 이름에 대한 정규식을 지원합니다.
구성 파일 내부에서: 에이전트가 사용자가 설정한 환경 변수를 가져올 수 있도록 인프라 구성 파일 에 항목을 추가합니다.
명령줄에서: 다른 환경 변수를 사용하여 이러한 설정을 전달합니다.
NRIA_PASSTHROUGH_ENVIRONMENT = " HTTPS_PROXY,HTTP_PROXY "
각 통합에는 인수와 이름이 정확히 동일한 환경 변수를 정의하고 전달하여 덮어쓸 수 있는 변수 세트가 있습니다(예: redis
포트 인수를 대체하는 PORT 환경 변수).
{{}}
표기법을 사용하여 통합 구성 파일에서 환경 변수를 정의할 수도 있습니다. 예를 들어:
integration_name : com.newrelic.redis
password : { { MY_REDIS_PASSWORD } }
구성 옵션 살펴보기 정의, 기본값 및 관련 환경 변수를 포함해 구성할 수 있는 모든 설정 목록은 인프라 구성 설정 을 참조하십시오.
구성 파일 구조 에이전트 또는 통합 YAML 구성 파일을 수정하는 경우:
YAML 포맷 규칙 을 따릅니다.구성 옵션의 대소문자를 수정하지 마십시오. YAML 키는 대소문자를 구분합니다. 들여쓰기 레벨을 준수해야 합니다. \ 모든 들여쓰기는 일반적으로 두 개의 공백 문자로 비슷한 증분으로 되어 있습니다. 파일의 동일한 섹션에 있는 데이터는 동일한 수준의 들여쓰기를 사용해야 합니다. 하위 섹션을 공백 두 개로 들여씁니다. ( 커스텀 속성 및 네트워크 인터페이스 필터 의 예 참조) YAML 포맷은 숫자와 문자열을 구별합니다. 구성 값을 문자열로 구문 분석하려면 따옴표를 사용합니다. newrelic-infra.yml
템플릿은 인프라 에이전트 저장소 에서 사용할 수 있습니다. 인프라 에이전트와 함께 파일을 사용하기 전에 유효성 검사기 를 사용하여 구문이 정확한지 확인하십시오.
구성 관리 도구 구성 관리 툴을 사용하여 인프라 에이전트를 설치 및 관리하려면 다음 문서를 참조하십시오.
대규모 배포를 위한 다른 옵션은 워크플로우 자동화 를 참조하십시오.