인프라 에이전트에는 동작을 미세 조정하기 위한 많은 구성 설정이 존재합니다. 이 문서에서는:
- 모든 구성 옵션을 설명합니다. (YAML 및 환경 변수 이름 모두)
- 설정이 무엇을 하고 언제 사용할 수 있는지 설명합니다.
- 변수 유형과 기본값(해당되는 경우)을 제공합니다.
- 해당되는 경우 최소 필수 에이전트 버전을 나열합니다.
중요
암호 관리를 사용하면, 민감한 데이터(예: 암호)를 통합의 구성 파일에 일반 텍스트로 쓰지 않고도 사용하도록 인프라와 에이전트 온호스트 통합을 구성할 수 있습니다. 자세한 내용은 암호 관리를 참조하십시오.
아직도 뉴렐릭 계정이 없으신가요? 영구 무료 계정을 신청하십시오.
시작하기
뉴렐릭 계정(영구 무료)을 만들고 인프라 에이전트를 설치한 후, 환경에 맞게 인프라 에이전트를 설정할 수 있습니다.
license_key
만 필수 설정입니다.
이러한 모든 변수를 사용하는 방법의 예시는 GitHub의 샘플 구성 템플릿을 참조하십시오.
에이전트 변수
뉴렐릭 계정의 를 지정합니다. 에이전트는 이 키를 사용하여 서버의 메트릭을 뉴렐릭 계정과 연결합니다. 이 설정은 표준 설치 프로세스의 일부로 생성됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
예:
license_key: 1234567890abcdefghijklmnopqrstuvwxyz1234
Fedramp 엔드포인트을 사용해야 하는지 여부를 지정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
에이전트가 사용할 수 있는 논리 프로세서의 수를 지정합니다. 이 값을 늘리면 서로 다른 코어 간에 부하를 분산하는 데 도움이 됩니다.
-1
로 설정하면 에이전트는 환경 변수 GOMAXPROCS
읽기를 시도합니다. 이 변수가 설정되지 않은 경우 기본값은 호스트에서 사용 가능한 총 코어 수입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
에이전트가 시작 시 오류를 발생시키기 전에 뉴렐릭 플랫폼의 가용성을 확인하기 위해 요청을 재시도하는 횟수입니다.
negative value(음수값)으로 설정하면 에이전트는 성공할 때까지 연결을 계속 확인합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
| 1.0.936 |
요청 시간이 초과되면 에이전트가 시작 시 뉴렐릭 플랫폼의 가용성을 확인하기 위해 요청을 재시도할 때까지 기다리는 시간입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
| 1.0.936 - 1.2.30 |
에이전트가 시작 시 뉴렐릭 플랫폼의 가용성 확인 요청이 시간 초과된 것으로 간주될 때까지 대기하는 시간입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
| 1.0.936 |
Agent's Self Instrumentation을 활성화합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
|
내장된 fluentbit 로깅 전달자를 통해 Agent Retry for Log Transmission을 활성화합니다. 정수 값은 의도된 재시도 횟수입니다. 다른 가능한 값에는 재시도 횟수를 무한으로 설정하는 False
및 재시도 기능을 완전히 끄는 no_retries
가 포함됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
클라우드 변수
에이전트가 클라우드 인스턴스에서 실행 중인 경우, 에이전트는 클라우드 유형을 감지하고 기본 메타데이터를 가져오려고 시도합니다. 클라우드 공급자 계정을 뉴렐릭과 연결할 때 확장된 클라우드 메타데이터(사용자 지정 리소스 태그 포함)로 메트릭을 보강할 수도 있습니다.
클라우드 감지에 실패한 경우 에이전트가 연결을 재시도하는 횟수를 설정합니다.
에이전트 초기화 중에 클라우드 감지가 실패하면 에이전트는 CloudRetryBackOffSec
초 동안 기다린 후 재시도합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
| 1.2.6 |
에이전트가 메타데이터를 삭제할 때까지 대기하는 시간 간격을 초 단위로 설정합니다. 이 시간이 지나면 메타데이터가 만료되고 에이전트가 메타데이터를 다시 가져옵니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
| 1.2.6 |
클라우드 감지가 실패한 경우 에이전트가 클라우드 감지 재시도 사이에 대기하는 시간 간격을 초 단위로 설정합니다.
에이전트 초기화 중에 클라우드 감지가 실패하면 CloudMaxRetryCount
번 재시도를 합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
| 1.2.6 |
에이전트가 실행될 클라우드 공급자를 지정합니다. 기본값과 다른 값으로 설정되면 에이전트는 클라우드 공급자로부터 메타데이터(인스턴스 ID)를 성공적으로 얻을 때까지 기다렸다가 백엔드에 데이터를 제출합니다.
기본 동작을 사용하면, 에이전트도 클라우드 공급자를 감지하고 메타데이터를 가져오지만 에이전트를 차단하지 않습니다.
허용되는 값: ""
, "aws"
, "azure"
, "gcp"
, "alibaba"
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
| 1.40.1 |
DisableCloudMetadata
와 유사하지만 호스트 별칭 플러그인에 대해서만 클라우드 메타데이터 수집을 비활성화합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
| 1.0.220 |
클라우드 메타데이터 수집을 비활성화합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
Docker 변수
캐시된 컨테이너 메타데이터가 만료되어 에이전트가 이를 다시 가져오는데 소요되는 시간(초)입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
| 1.0.801 |
Docker 클라이언트 API 버전을 지정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
|
파일 시스템 변수
에이전트가 지원하는 파일 시스템 유형 목록입니다. 이 값은 기본 목록의 하위 집합이어야 하며 기본 목록에 없는 항목은 삭제됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| []string | Linux: Windows: | 1.0.220 |
StorageSample
데이터를 수집할 때 에이전트가 무시할 스토리지 디바이스 목록입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| []string | 1.0.220 |
YAML 속성의 예:
file_devices_ignored: - sda1 - sda2
환경 변수의 예:
FILE_DEVICES_IGNORED="sda1,sda2"
호스트네임 변수
보고를 위해 자동 생성된 호스트네임을 재정의합니다. 이는 인프라 모니터링에서 호스트네임을 각 호스트의 고유 식별자로 사용하기 때문에 동일한 이름을 가진 여러 호스트가 있는 경우에 유용합니다. 이 값은 엔터티 이름의 루프백 주소를 대체하는 데에도 사용됩니다.
보다 자세한 내용은 엔터티 이름 해결이 작동하는 방식에 대한 문서를 참조하십시오.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 | empty | 1.0.266 |
예:
display_name: teslaOne
true
인 경우 호스트 주소의 역방향 조회를 수행하여 전체 호스트 이름을 확인합니다. 그렇지 않은 경우, Linux에서는 hostname 명령으로, Windows에서는 레지스트리의 TCP/IP 파라미터에서 검색됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
설정되면 전체 호스트네임에 대해 보고되는 값입니다. 그렇지 않은 경우, 에이전트가 정상적인 조회 동작을 수행합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 | 1.0.1015 |
예:
my.custom-hostname.co.org
설정되면 호스트네임에 대해 보고되는 값입니다. 그렇지 않은 경우, 에이전트는 정상적인 조회 동작을 수행합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 | 1.0.1015 |
예:
my.custom-hostname
설치 변수
에이전트가 캐시, 인벤토리, 통합 등에 대한 파일을 저장하는 디렉터리입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 | Linux: Windows: | 1.0.2 |
통합의 구성 파일이 포함된 디렉터리입니다.
각 통합에는 초기화 시 에이전트가 로드되는 사전 정의된 위치에 기본적으로 이름이 <integration_name>-config.yml
인 자체 구성 파일이 있습니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 | Linux: Windows: | 1.0.2 |
통합을 설치할 커스텀 경로를 지정하여 agent_dir
외부에 설치할 수 있습니다. 에이전트가 설치된 통합을 찾을 때 우선순위가 있습니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 | Empty | 1.0.2 |
통합 변수
모든 통합에 전달될 환경 변수 목록입니다. 통합에 동일한 이름의 기존 구성 옵션이 이미 존재하는 경우 환경 변수가 우선합니다.
인프라 에이전트 1.24.1부터 passthrough_environment
는 변수 이름에 대한 정규식을 지원합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| []string | Empty |
YAML 속성의 예(기본적으로 /etc/newrelic-infra.yml
에 있는 에이전트의 구성 파일 내부):
passthrough_environment: - HOST - PORT - NRIA_.*
환경 변수의 예:
NRIA_PASSTHROUGH_ENVIRONMENT="HOST,PORT,NRIA_.*"
Windows 호스트의 경우: PATHEXT
는 MS Windows 환경 변수입니다. 이 함수는 모든 명령줄에서 실행 가능한 파일을 표시하는 파일 확장자를 결정하기 위합니다. 이렇게 하면 일반적인 Flex 통합에 대해 "...이 cmdlet, 함수, 스크립트 파일의 이름으로 인식되지 않습니다..."라고 표시되는 오류가 해결됩니다.
passthrough_environment: - PATHEXT
에이전트는 통합 프로토콜 버전 3에 대해 엔터티 이름(키)에 대한 루프백-주소 교체를 자동으로 활성화합니다. 프로토콜 버전 2를 사용 중이고 이 동작을 원하는 경우 entityname_integrations_v2_update
옵션을 활성화합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
| 1.2.15 |
이 구성 파라미터를 true
로 설정하면 에이전트가 HTTP 포트(기본적으로 8001
)를 열어 뉴렐릭 StatsD 백엔드에서 데이터를 수신합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
이 값을 설정하면 에이전트가 HTTPServerPort
에서 수신을 시작하고 뉴렐릭 StatsD 백엔드에서 데이터를 수신합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
|
http 서버가 뉴렐릭 StatsD 백엔드에서 데이터를 수신할 포트를 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
이 간격 동안 정보를 보고하지 않은 엔터티를 삭제하는 프로세스를 시작합니다.
유효한 시간 단위: s
(초), m
(분) 및 h
(시간)
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
|
예:
1h
호스트에 많은 수의 프로세스가 있거나 통합 전반에서 수집된 대량의 데이터가 있는 경우 에이전트 대기열에 오버런 오류가 발생할 수 있습니다. 대기열이 가득 차서 발생하는 오류 메시지를 방지하려면 대기열 깊이를 늘리십시오.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
통합 SDK 동기화를 위한 영구 스토리지로 사용되는 임시 디렉터리를 정의합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
|
인프라 에이전트(예: OpenTelemetry 수집기 또는 Prometheus 노드 내보내기 툴) 이외의 소스에서 호스트를 계측하고, 에이전트 온-호스트 통합을 사용해 다른 계측 서비스를 계속 모니터링하려는 경우 이 설정을 사용합니다. 활성화되면, 에이전트는 호스트 인벤토리와 호스트 메타데이터로 장식된 통합 텔레메트리(이벤트 메트릭 및 인벤토리)를 보고하지만, 호스트 메트릭(CPU, 메모리, 디스크, 네트워크, 프로세스)는 비활성화됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
인벤토리 변수
캐시된 인벤토리가 이 값보다 오래되면(예: 에이전트가 오프라인 상태이므로) 에이전트는 자동으로 델타 리포지토리를 제거하고 다시 만듭니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
|
true로 설정하면 인벤토리 비동기 처리가 활성화되어 더 큰 인벤토리 페이로드를 처리할 수 있습니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 부울 |
|
에이전트가 무시한 인벤토리 경로 목록입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| string[] | Empty list |
YAML 속성의 예:
ignored_inventory: - files/config/stuff.bar - files/config/stuff.foo
환경 변수의 예:
NRIA_IGNORED_INVENTORY="files/config/stuff.bar,files/config/stuff.foo"
Linux 변수
에이전트 프로세스의 pid
파일이 생성되는 Linux의 위치입니다. 에이전트의 다른 인스턴스가 실행되고 있지 않은지 확인하기 위해 시작 시 사용됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
| 1.0.2 |
true인 경우 호스트 가상 메모리의 공식은 SReclaimable
을 사용 가능한 메모리로 간주합니다. 그렇지 않은 경우, SReclaimable
은 사용된 메모리의 일부로 간주됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
로깅 변수
로그는 인프라 에이전트 로거를 구성하는 데 사용되는 키-값 맵입니다. YAML 속성의 예:
log: file: '/var/log/newrelic-infra/newrelic-infra.log' level: debug forward: true stdout: false
환경 변수의 예:
NRIA_LOG_FILE='/var/log/newrelic-infra/newrelic-infra.log'NRIA_LOG_LEVEL='smart'NRIA_LOG_FORWARD='false'NRIA_LOG_STDOUT='true'
로그의 파일 경로를 정의합니다.
기본 설치는 로그 디렉터리를 만들고 file
구성 옵션에서 이 파일 경로 값을 설정합니다.이 로그 디렉터리는 아래와 같이 OS마다 다릅니다.
로그의 파일 경로를 맞춤화하려면 이 구성 옵션을 변경합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 | 아래 참조* |
기본 경로:
Linux: 정의되지 않은 경우 표준 출력에만 로깅합니다.
Windows, 에이전트 버전 1.0.944 이상:
C:\%ProgramData%\New Relic\newrelic-infra\newrelic-infra.log디렉터리를 생성할 수 없는 경우:
C:\Program Files\New Relic\newrelic-infra\newrelic-infra.log
로그 레벨을 정의합니다. 사용 가능한 값:
info
: 레벨 오류, 경고 및 정보의 로그 메시지를 표시합니다.smart
: smart verbose mode를 활성화합니다. smart verbose mode는 오류가 기록될 때 마지막smart_level_entry_limit
디버그 메시지를 로깅합니다.debug
: 레벨 오류, 경고, 정보 및 디버그의 로그 메시지를 표시합니다.trace
: 모든 로그 메시지가 표시됩니다.중요
트레이스 레벨 로깅은 많은 데이터를 매우 빠르게 생성할 수 있습니다. 문제를 재현하는 데 필요한 기간 동안만 트레이스 모드에서 에이전트를 실행한 다음
level: info
를 설정하고 에이전트를 다시 시작하여 세부적인 로깅을 비활성화합니다. 또는 smart verbose mode를 활성화하는level
:smart
를 설정할 수 있습니다.YML 옵션 이름
환경 변수
Type
기본
버전
level
NRIA_LOG_LEVEL
문자열
설정되지 않음
로그 출력 형식을 정의합니다. 사용 가능한 값:
text
: 일반 텍스트 출력, 로그 항목당 한 줄json
: JSON 형식의 출력, 로그 항목당 한 줄YML 옵션 이름
환경 변수
Type
기본
버전
format
NRIA_LOG_FORMAT
문자열
text
에이전트 로그를 뉴렐릭의 로그 UI로 전달할 수 있습니다. 비활성화하려면 이 구성 옵션을 false
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
기본적으로 모든 로그는 표준 출력과 로그 파일에 모두 표시됩니다. 표준 출력에서 로그를 비활성화하려면 이 구성 옵션을 false
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
smart_level_entry_limit
는 오류가 로그될 때 로그될 이전 디버그 메시지의 수를 나타냅니다. 예를 들어 한도가 5
로 설정된 경우 디버그 로그는 오류가 로그가 될 때까지 메모리에 캐시되며, 이 시점에서 이전 5개의 디버그 메시지도 로그가 됩니다.
중요
이 구성 옵션은 level
이 smart
(Smart Level 활성화됨)로 설정된 경우에만 사용됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
버전 v1.28.0부터 내장된 로그 회전(rotate) 기능을 사용할 수 있습니다. 기본적으로 로그 회전은 비활성화되어 있습니다. 활성화하려면 max_size_mb
옵션을 사용하여 로그 파일의 최대 크기를 지정해야 합니다. 인프라 에이전트 로그 파일이 정해진 크기에 도달하면 현재 로그 파일이 새 파일로 회전됩니다.
log: level: info file: /var/log/newrelic-infra/newrelic-infra.log rotate: max_size_mb: 1000 # Required max_files: 5 # Optional compression_enabled: true # Optional file_pattern: YYYY-MM-DD_hh-mm-ss.log # Optional
max_size_mb
인프라 에이전트 로그 파일의 최대 크기(MB)를 지정합니다. 파일이 정해진 크기에 도달하면 현재 로그가 새로운 파일로 회전됩니다. max_size_mb
가 0
이면 내장된 로그 회전이 비활성화됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
max_files
유지되어야 하는 아카이브된 로그 파일 수를 지정합니다. 이 값을 초과하면 오래된 파일이 삭제됩니다. max_files
가 0
이면 파일 수 제한이 비활성화됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
compression_enabled
를 true
로 설정하면 로그 파일에 대한 압축을 활성화할 수 있습니다. 압축이 활성화된 경우 회전된 파일은 gzip
포맷을 가지며 더 적은 디스크 공간을 사용합니다.
중요
로그 회전 중에, 압축이 활성화되면 특히 max_size_mb
값이 1000
보다 큰 경우 에이전트 CPU 사용량이 증가할 수 있습니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
file_pattern
아카이브된 로그 파일의 이름 포맷을 지정합니다. 기본적으로 새 파일 이름은 original-file_YYYY-MM-DD_hh-mm-ss.log
패턴을 사용합니다.
다음 타임스탬프 필드를 사용하여 파일 이름 패턴을 맞춤화할 수 있습니다.
YYYY
: YearMM
: MonthDD
: Dayhh
: Hourmm
: Minutess
: Secound에이전트는 자동으로 해당 타임스탬프 필드를 파일 회전 시간으로 교체합니다. 예:
log:level: infofile: /var/log/newrelic-infra/newrelic-infra.logrotate:max_size_mb: 1000file_pattern: rotated.YYYY-MM-DD_hh-mm-ss.logYML 옵션 이름
환경 변수
Type
기본
버전
file_pattern
NRIA_LOG_ROTATE_FILE_PATTERN
문자열
file_YYYY-MM-DD_hh-mm-ss.file_extension
팁
인프라스트럭처 에이전트(Infrastructure Agent) 버전 1.28.0은 로깅 설정에서 이전 버전과 호환이 가능하도록 개선되었습니다. 레거시 설정과 이를 새로운 구조에 연결하는 방법은 github 문서를 참조하십시오.
메트릭 변수
커스텀 속성은 인프라 에이전트의 데이터에 주석을 추가하는 데 사용되는 키-값 쌍(다른 도구의 태그와 유사)입니다. 이 메타데이터를 사용하여 엔터티를 필터링하고 결과를 그룹화하여 데이터에 주석을 추가할 수 있습니다. 예를 들어 머신의 환경(스테이징 또는 프로덕션), 머신이 호스트하는 서비스(예: 로그인 서비스) 또는 해당 머신을 담당하는 팀을 표시할 수 있습니다.
팁
에이전트는 Amazon Elastic Compute Cloud(Amazon EC2) 태그를 포함, 기본 속성의 일부로 환경에 대한 많은 세부 정보를 수집합니다.
YML 옵션 이름 | 환경 변수 | Type |
---|---|---|
|
| map[string]interface{} |
커스텀 속성 목록을 사용하여 이 에이전트 인스턴스의 데이터에 주석을 추가합니다. KEY: VALUE
처럼 콜론 :
으로 키와 값을 구분하고 각 키-값 쌍을 줄 바꿈으로 구분합니다. 키는 슬래시 /
를 제외한 모든 유효한 YAML이 될 수 있습니다. 값은 공백을 포함한 모든 YAML 문자열이 될 수 있습니다. 키를 label.
로 시작하면 해당 호스트가 다른 클라우드 환경에서 실행되고 클라우드 태그나 클라우드 레이블이 태그의 결합된 장식에서 상호 작용하는 경우에도 키가 그대로 유지됩니다. 반면에, 해당 환경에서 실행하거나 인프라 에이전트의 데이터를 클라우드 모니터링과 결합하는 경우 custom_labels
에 gcp.
또는 azure.
접두사가 붙을 수 있습니다.
YAML 속성의 예:
custom_attributes: label.environment: production label.service: login service label.team: alpha-team
환경 변수의 예:
NRIA_CUSTOM_ATTRIBUTES='{"label.customAttribute_1":"SOME_ATTRIBUTE","label.customAttribute_2": "SOME_ATTRIBUTE_2"}'
커스텀 속성별로 필터링하는 NRQL 예시:
FROM SystemSample SELECT * WHERE label.environment = 'production'
중요
인프라 에이전트 버전 1.12.0 이상이 필요합니다. 2020년 7월 20일 이전에 생성된 계정 및/또는 새로운 안내 설치를 사용하여 설치된 인프라 에이전트에는 기본적으로 이 변수가 활성화되어 있습니다.
뉴렐릭으로 프로세스 메트릭을 전송할 수 있습니다.
기본적으로 인프라 에이전트는 운영 체제의 프로세스에 대한 데이터를 보내지 않습니다. 에이전트는 metrics_process_sample_rate
이 -1
로 설정되지 않는 한 이러한 데이터를 계속 수집합니다.
모든 운영 체제 프로세스에 대한 메트릭 데이터를 보고하려면 enable_process_metrics
를 true
로 설정합니다. 비활성화하려면 false
로 설정합니다.
모든 프로세스 데이터를 보내면 뉴렐릭으로 전송되는 데이터 양이 증가할 수 있습니다. 모니터링할 프로세스를 세부적으로 조정하려면 include_matching_metrics
또는 exclude_matching_metrics
을 설정합니다.
기본적으로 메모리가 부족한 프로세스는 샘플링에서 제외됩니다. 보다 자세한 내용은 disable-zero-mem-process-filter를 참조하십시오.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
활성화되면, 프로세스가 컨테이너에서 실행되는 경우 에이전트가 프로세스 샘플에 컨테이너 정보를 추가합니다.
이러한 정보에는 컨테이너 ID, 컨테이너 이름, 이미지 ID, 이미지 이름 및 컨테이너 라벨이 포함됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
| 1.55.0 |
중요
현재 이 설정은 운영 체제의 프로세스 메트릭에만 적용됩니다.
메트릭 속성 값을 기반으로 메트릭 데이터 전송을 제한할 수 있는 include_matching_metrics
를 설정하여 뉴렐릭으로 전송되는 데이터의 양을 제어할 수 있습니다.
메트릭 속성에 대한 리터럴 또는 부분 값을 정의하여 메트릭 데이터를 포함시킵니다. 예를 들어, process.name
이 ^java
정규식과 일치하는 모든 프로세스의 host.process.cpuPercent
가 전송되도록 선택할 수 있습니다.
이 예시에서는 실행 파일과 이름을 사용하여 프로세스 메트릭을 포함시켰습니다.
include_matching_metrics: # You can combine attributes from different metrics process.name: - regex "^java" # Include all processes starting with "java" process.executable: - "/usr/bin/python2" # Include the Python 2.x executable - regex "\\System32\\svchost" # Include all svchost executables
값에 명령줄 인수를 포함해야 하는 경우 strip_command_line
을 false로 설정합니다. (인프라 에이전트는 기본적으로 비밀 누출을 방지하기 위해 CLI 인수를 제거합니다.)
동일한 항목에 대해 include_matching_metrics
와 exclude_matching_metrics
가 모두 있는 경우, 포함(include)이 우선합니다.
include_matching_metrics
를 쿠버네티스 통합을 위한 환경 변수로 구성하려면 이를 env:
오브젝트 내에 있는 매니페스트에 추가합니다.
env: - name: NRIA_INCLUDE_MATCHING_METRICS value: | process.name: - regex "^java" process.executable: - "/usr/bin/python2" - regex "\\System32\\svchost"
기본
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| metric.attribute: - regex "pattern" - "string" - "string-with-wildcard*" |
중요
현재 이 설정은 운영 체제의 프로세스 메트릭에만 적용됩니다.
메트릭 속성 값을 기반으로 메트릭 데이터 전송을 제한할 수 있는 exclude_matching_metrics
를 설정하여 뉴렐릭으로 전송되는 데이터의 양을 제어할 수 있습니다.
메트릭 속성에 리터럴 값이나 부분 값을 정의하여 메트릭 데이터를 제외시킵니다. 예를 들어, process.name
이 ^java
정규 표현식과 일치하는 모든 프로세스의 host.process.cpuPercent
를 보내지 않도록 선택할 수 있습니다.
이 예에서는 실행 파일과 이름을 사용하여 프로세스 메트릭을 제외시킵니다.
exclude_matching_metrics: # You can combine attributes from different metrics process.name: - regex "^java" # Exclude all processes starting with "java" process.executable: - "/usr/bin/python2" # Exclude the Python 2.x executable - regex "\\System32\\svchost" # Exclude all svchost executables
exclude_matching_metrics
를 쿠버네티스 통합을 위한 환경 변수로 구성하려면 이를 env:
오브젝트 내에 있는 매니페스트에 추가합니다.
env: - name: NRIA_EXCLUDE_MATCHING_METRICS value: | process.name: - regex "^java" process.executable: - "/usr/bin/python2" - regex "\\System32\\svchost"
기본
1.57.0
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| metric.attribute: - regex "pattern" - "string" - "string-with-wildcard*" |
네트워크 인터페이스 필터 구성을 사용하여 인프라 에이전트에서 사용하지 않거나 관심이 없는 네트워크 인터페이스를 숨길 수 있습니다. 이렇게 하면 데이터의 리소스 사용량, 작업 및 노이즈를 줄이는 데 도움이 됩니다.
중요
이 구성 설정에서는 환경 변수가 지원되지 않습니다.
구성은 다음 패턴 중 하나를 따르는 특정 문자 또는 숫자 시퀀스로 시작하는 인터페이스를 찾을 수 있는 간단한 패턴 매치 메커니즘을 사용합니다.
{name}[other characters]
, 여기서prefix
옵션을 사용하여 이름을 지정합니다.[number]{name}[other characters]
, 여기서index-1
옵션을 사용하여 이름을 지정합니다.뉴렐릭 인프라는 Linux 및 Windows 모두에서 사용할 수 있는 선별된 기본 필터 목록을 구현하며, 사용자는 이를 수정할 수 있습니다.
YML 옵션 이름
환경 변수
Type
기본
버전
network_interface_filters
지원되지 않음
map[string][]string
1.0.220
Linux용 기본 네트워크 인터페이스 필터:
dummy
,lo
,vmnet
,sit
,tun
,tap
으로 시작되는 네트워크 인터페이스, 또는veth
tun
이 포함된 네트워크 인터페이스, 또는tap
다음 예시(구성 파일에 추가됨)는 기본 필터를 덮어쓰기합니다. 이렇게 하면
dummy
또는lo
로 시작하거나, 일련의 숫자가 앞에 오고 뒤에 다른 문자가 오는tun
이 포함된 네트워크 인터페이스를 무시합니다.network_interface_filters:prefix:- dummy- loindex-1:- tun
Windows용 기본 네트워크 인터페이스 필터:
Loop
,isatap
으로 시작되는 네트워크 인터페이스, 또는Local
다음 예시(구성 파일에 추가됨)는 기본 필터를 덮어쓰기합니다. 이렇게 하면
Loop
로 시작하는 네트워크 인터페이스가 무시됩니다.network_interface_filters:prefix:- Loop
ZeroRSSFilter
는 샘플링에서 메모리를 사용하지 않는 프로세스를 제외합니다. 에이전트가 ProcessSample
에 이러한 프로세스를 포함하도록 필터를 비활성화합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
| 1.0.832 |
플러그인 변수
팁
DisableAllPlugins
를 true
로 설정하여 모든 변수를 빠르게 비활성화하고 필요한 옵션만 활성화할 수 있습니다.
모든 플러그인을 비활성화하려면 이 옵션을 true
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
CloudSecurityGroups
플러그인의 샘플링 기간(초)입니다. 최소값은 30
입니다. 비활성화하려면 -1
로 설정합니다.
중요
이 플러그인은 에이전트가 AWS 인스턴스에서 실행 중인 경우에만 활성화됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Daemontools
플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Dpkg
플러그인의 샘플링 기간(초)입니다. 최소값은 30
입니다. 비활성화하려면 -1
로 설정합니다. 파라미터가 구성 파일에 명시적으로 설정되지 않은 경우 DisableAllPlugins
를 true
로 설정하여 비활성화할 수 있습니다.
중요
이는 root
또는 privileged
실행 모드와 Debian 기반 배포판에서만 활성화됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Facter
플러그인의 샘플링 기간(초)입니다. 최소값은 30
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
KernelModules
플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
중요
kernel_modules_refresh_sec
root
또는 privileged
실행 모드에서만 활성화됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
| 1.0.755 |
NetworkInterface
플러그인의 샘플링 기간(초)입니다. 최소값은 30
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
| 1.0.329 |
Rpm
플러그인의 샘플링 기간(초)입니다. 최소값은 30
입니다. 비활성화하려면 -1
로 설정합니다.
중요
rpm_interval_sec
에이전트가 RedHat, RedHat AWS 또는 SUSE 배포에 대해 루트 또는 권한 모드에서 실행되는 경우에만 활성화됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
SELinux
플러그인의 샘플링 기간(초)입니다. 최소값은 30
입니다. 비활성화하려면 -1
로 설정합니다. SelinuxEnableSemodule
이 false로 설정된 경우 이 옵션은 무시됩니다. 보다 자세한 내용은 SELinux
모듈 비활성화와 관련된 문제 해결 문서를 참조하십시오.
중요
SELinux
에이전트가 루트 모드에서 실행될 때만 활성화됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Sshd
플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
| 1.0.755 |
Supervisor
플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Sysctl
플러그인의 샘플링 기간(초)입니다. 최소값은 30
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Systemd
플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
sysv
플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Upstart
플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Users
플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
| 1.0.755 |
감독자 소켓의 위치입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
| 1.0.2 |
Puppet's Facter에 대한 HOME
환경 변수를 설정합니다. 정의되지 않은 경우 기본값은 현재 사용자의 홈 디렉터리입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
프록시 변수
인프라 에이전트 버전 1.3.1 이상의 경우 프록시 구성 설정의 우선순위는 다음과 같습니다.
NRIA_PROXY
proxy
HTTP_PROXY
HTTPS_PROXY
시스템에 에이전트가 뉴렐릭과 통신하기 위해 프록시를 사용해야 하는 방화벽 규칙이 있을 수 있습니다. 그렇다면 프록시 URL을 https://user:password@hostname:port 포맷으로 설정합니다. HTTP 또는 HTTPS일 수 있습니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 | Empty |
예:
https://proxy_user:access_10@proxy_01:1080
true
로 설정하면 HTTPS_PROXY
와 HTTP_PROXY
환경 변수가 무시됩니다. 이는 에이전트가 메트릭 수집기에 직접 연결하고 기존 시스템 프록시를 건너뛰어야 하는 경우에 유용합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
HTTPS_PROXY
옵션이 자체 서명된 인증서가 있는 프록시를 참조하는 경우 이 옵션은 프록시 인증서를 사용할 수 있는 디렉터리의 경로를 지정합니다.디렉터리의 인증서는 .pem
확장자로 끝나야 합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
HTTPS_PROXY
옵션이 자체 서명된 인증서가 있는 프록시를 참조하는 경우 이 옵션은 인증서 파일의 경로를 지정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 문자열 |
true
로 설정하면 프록시가 HTTPS 연결을 사용하도록 구성된 경우에만 작동합니다.
HTTPS 프록시에 유효한 인증 기관의 인증서가 있는 경우
ca_bundle_file
또는ca_bundle_dir
구성 속성에 HTTPS 프록시 인증서가 포함된 경우YML 옵션 이름
환경 변수
Type
기본
버전
proxy_validate_certificates
NRIA_PROXY_VALIDATE_CERTIFICATES
boolean.
false
1.3.0
다음 프록시 구성 정보를 인벤토리로 보냅니다.
HTTPS_PROXY
HTTP_PROXY
proxy ca_bundle_dir
ca_bundle_file
ignore_system_proxy
proxy_validate_certificates
YML 옵션 이름
환경 변수
Type
기본
버전
proxy_config_plugin
NRIA_PROXY_CONFIG_PLUGIN
boolean.
true
1.3.0
프록시 구성에 문제가 있는 경우 프록시 문제 해결을 참조하십시오.
샘플 변수
네트워크 샘플의 샘플 속도(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
프로세스 샘플의 샘플 속도(초)입니다. 최소값은 20
입니다. 프로세스 샘플을 완전히 비활성화하려면 metrics_process_sample_rate
를 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
저장 샘플의 샘플 속도(초)입니다. 최소값은 5
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
시스템 샘플의 샘플 속도(초)입니다. 최소값은 5
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
NFS 스토리지 샘플의 샘플 속도(초)입니다. 최소값은 5
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
세부적인 NFS 메트릭입니다. 활성화되면 에이전트는 NFS 메트릭의 전체 목록을 제공합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
NTP 오프셋 변수
ntp_metrics
시간 오프셋 메트릭을 구성하는 데 사용되는 키-값 맵입니다. 활성화된 상태에서 NTP 호스트 목록이 제공되면, 에이전트는 호스트의 ntp offset
메트릭(초 단위)을 제공합니다. 이 값은 제공된 NTP 호스트 풀에 대해 분단위 간격(interval
)마다 확인됩니다(기본값 및 최소값은 15분). 간격 사이에 마지막으로 알려진 오프셋이 보고됩니다. 보고된 오프셋이 몇 초를 넘어가면 알림 조건, NRQL 쿼리 및 대시보드의 데이터 갭에 문제가 발생할 수 있습니다.
YAML 속성의 예:
ntp_metrics: enabled: true pool: - time.cloudflare.com - time.google.com interval: 15 timeout: 10
환경 변수의 예:
NRIA_NTP_METRICS_POOL='time.cloudflare.com,time.google.com'NRIA_NTP_METRICS_ENABLED='true'NRIA_NTP_METRICS_INTERVAL='15'NRIA_NTP_METRICS_TIMEOUT='10'
NTP 오프셋 메트릭을 활성화/비활성화하는 플래그입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
쿼리할 NTP 호스트 목록을 정의합니다. 여러 호스트가 정의되면 모든 호스트가 쿼리되고 보고된 메트릭은 호스트 사이의 평균 값이 됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| []string | 비어 있습니다. public NTP servers를 확인하십시오. |
제공된 풀에서 NTP 오프셋을 요청하는 간격을 분 단위로 정의합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
NTP 호스트에 대한 요청의 타임아웃(초)을 정의합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
|
보안 변수
SEModule을 사용하여 설치된 정책 모듈의 버전을 가져옵니다. 비활성화된 경우 SELinux 플러그인은 SEStatus를 사용하여 상태만 검색합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
| 1.0.864 |
true
일 때 에이전트는 ProcessSample
의 commandLine
속성에서 명령 인수를 제거합니다.
팁
민감한 정보가 유출되는 것을 방지하기 위한 보안 조치입니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
| 1.0.149 |
상태 엔드포인트 변수
로컬 상태 정보를 제공하는 에이전트에서 상태 서버를 활성화합니다. 사용 가능한 엔드포인트는 다음과 같습니다.
기본 상태 엔드포인트 예(오류 없음):
$curl http://localhost:8003/v1/status${$ "checks": {$ "endpoints": [$ {$ "url": "https://infrastructure-command-api.newrelic.com/agent_commands/v1/commands",$ "reachable": true$ },$ {$ "url": "https://infra-api.newrelic.com/infra/v2/metrics",$ "reachable": true$ },$ {$ "url": "https://identity-api.newrelic.com/identity/v1",$ "reachable": true$ },$ {$ "url": "https://infra-api.newrelic.com/inventory",$ "reachable": true$ }$ ]$ },$ "config": {$ "reachability_timeout": "10s"$ }$}
기본 상태 엔드포인트(오류 있음):
$curl http://localhost:8003/v1/status${$ "checks": {$ "endpoints": [$ {$ "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics",$ "reachable": false,$ "error": "endpoint check timeout exceeded"$ },$ {$ "url": "https://infra-api.newrelic.com/infra/v2/metrics",$ "reachable": true$ },$ {$ "url": "https://identity-api.newrelic.com/identity/v1",$ "reachable": true$ },$ {$ "url": "https://infra-api.newrelic.com/inventory",$ "reachable": true$ }$ ]$ },$ "config": {$ "reachability_timeout": "10s"$ }$}
오류 엔드포인트 예:
$curl http://localhost:18003/v1/status/errors${$ "checks": {$ "endpoints": [$ {$ "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics",$ "reachable": false,$ "error": "endpoint check timeout exceeded"$ }$ ]$ },$ "config": {$ "reachability_timeout": "10s"$ }$}
이는 기본 상태 엔드포인트와 유사하지만 오류가 있는 항목만 필터링합니다.
엔터티 엔드포인트 예:
$curl http://localhost:8003/v1/status/entity${$ "guid":"MMMMNjI0NjR8SU5GUkF8TkF8ODIwMDg3MDc0ODE0MTUwNTMy",$ "key":"your-host-name"$}
에이전트/호스트 엔터티에 대한 정보를 반환합니다. 에이전트에 에이전트/호스트 엔터티에 대한 정보가 없으면 응답 상태 코드 204 ("콘텐츠 없음")가 반환됩니다. 따라서 에이전트가 엔터티 데이터를 제공할 때까지 여러 요청이 필요할 수 있습니다.
중요
안내 설치를 사용하는 경우 이 설정이 기본적으로 활성화됩니다. 에이전트 설치가 성공했는지 확인하는 데 도움이 됩니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
| 1.19.0 |
상태 서버 엔드포인트에 대한 포트를 정의합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| 정수 |
| 1.19.0 |
윈도우 변수
Windows 서비스 플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
Windows 업데이트 플러그인의 샘플링 기간(초)입니다. 최소값은 10
입니다. 비활성화하려면 -1
로 설정합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| int64 |
|
프로그램 파일 디렉터리와 다른 경로에 데이터를 저장할 경로를 정의합니다.
%AppDir%/data
: 델타 데이터 저장에 사용%AppDir%/user_data
: 사용자 생성 JSON 파일의 외부 디렉터리%AppDir%/newrelic-infra.log
: 로그 파일 구성 옵션이 정의되지 않은 경우 이 디렉터리 경로를 기본으로 사용YML 옵션 이름
환경 변수
Type
기본
버전
app_data_dir
NRIA_APP_DATA_DIR
문자열
Windows:
env(ProgramData)\New Relic\newrelic-infra
리눅스: 해당 없음
호스트에 설치된 핫픽스 목록을 검색하는 Windows 업데이트 플러그인을 활성화합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
| 1.0.274 |
true
인 경우 에이전트는 Windows WMI(Windows용 메트릭을 가져오는에이전트의 레거시 방법, 예: StorageSampler
)를 사용하도록 강제되고 새 방법(PDH 라이브러리 사용)을 비활성화합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
이 구성 옵션을 사용하면 newrelic-infra.exe
프로세스 우선순위를 다음 값 중 하나로 높일 수 있습니다.
Normal
Idle
High
RealTime
BelowNormal
AboveNormal
YML 옵션 이름
환경 변수
Type
기본
버전
win_process_priority_class
NRIA_WIN_PROCESS_PRIORITY_CLASS
문자열
1.0.989
예:
Normal
Windows 에이전트가 드라이브 A:
및 B:
가 이동식 드라이브로 매핑될 때 보고할 수 있도록 합니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
true로 설정하면 WMI에서 프로세스 정보를 가져오고 제한된 환경에서 쿼리 액세스 검사를 건너뜁니다.
YML 옵션 이름 | 환경 변수 | Type | 기본 | 버전 |
---|---|---|---|---|
|
| boolean. |
|
HTTP 클라이언트
백엔드 통신에 사용되는 HTTP 클라이언트를 구성합니다.
뉴렐릭 백엔드에 대한 모든 요청에 포함될 사용자 정의 HTTP 헤더입니다.
http: headers: "Proxy-Authorization": "myToken"
YML 옵션 이름 | 환경 변수 | Type | 버전 |
---|---|---|---|
|
| 키-값 맵 |
다음 단계는?
이외에도:
- 에이전트의 구성을 더 잘 이해할 수 있습니다.
- 템플릿을 사용하여 구성 파일을 생성할 수 있습니다.
- 에이전트를 관리하는 방법을 확인할 수 있습니다.