인프라 에이전트 구성 설정

인프라 에이전트에는 동작을 미세 조정하기 위한 많은 구성 설정이 존재합니다. 이 문서에서는:

모든 구성 옵션을 설명합니다. (YAML 및 환경 변수 이름 모두)
설정이 무엇을 하고 언제 사용할 수 있는지 설명합니다.
변수 유형과 기본값(해당되는 경우)을 제공합니다.
해당되는 경우 최소 필수 에이전트 버전을 나열합니다.

중요

암호 관리를 사용하면, 민감한 데이터(예: 암호)를 통합의 구성 파일에 일반 텍스트로 쓰지 않고도 사용하도록 인프라와 에이전트 온호스트 통합을 구성할 수 있습니다. 자세한 내용은 암호 관리를 참조하십시오.

아직도 뉴렐릭 계정이 없으신가요? 영구 무료 계정을 신청하십시오.

시작하기

뉴렐릭 계정(영구 무료)을 만들고 인프라 에이전트를 설치한 후, 환경에 맞게 인프라 에이전트를 설정할 수 있습니다.

license_key만 필수 설정입니다.

이러한 모든 변수를 사용하는 방법의 예시는 GitHub의 샘플 구성 템플릿을 참조하십시오.

에이전트 변수

뉴렐릭 계정의 를 지정합니다. 에이전트는 이 키를 사용하여 서버의 메트릭을 뉴렐릭 계정과 연결합니다. 이 설정은 표준 설치 프로세스의 일부로 생성됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`license_key`	`NRIA_LICENSE_KEY`	문자열

예:

license_key: 1234567890abcdefghijklmnopqrstuvwxyz1234

YML 옵션 이름	환경 변수	Type	기본	버전
`fedramp`	`NRIA_FEDRAMP`	boolean.	`false`	1.15.0

에이전트가 사용할 수 있는 논리 프로세서의 수를 지정합니다. 이 값을 늘리면 서로 다른 코어 간에 부하를 분산하는 데 도움이 됩니다.

-1로 설정하면 에이전트는 환경 변수 GOMAXPROCS 읽기를 시도합니다. 이 변수가 설정되지 않은 경우 기본값은 호스트에서 사용 가능한 총 코어 수입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`max_procs`	`NRIA_MAX_PROCS`	정수	`1`	1.0.1002

버전 1.0.804 이상부터, 에이전트에서 전송된 데이터는 기본적으로 압축이 됩니다. 페이로드 압축을 비활성화하려면 payload_compression_level을 0으로 설정합니다.

중요

권장 사항: 이 설정을 변경하지 마십시오.

YML 옵션 이름	환경 변수	Type	기본	버전
`payload_compression_level`	`NRIA_PAYLOAD_COMPRESSION_LEVEL`	정수	`6`	1.0.804

에이전트가 시작 시 오류를 발생시키기 전에 뉴렐릭 플랫폼의 가용성을 확인하기 위해 요청을 재시도하는 횟수입니다.

negative value(음수값)으로 설정하면 에이전트는 성공할 때까지 연결을 계속 확인합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`startup_connection_retries`	`NRIA_STARTUP_CONNECTION_RETRIES`	정수	`6`	1.0.936

요청 시간이 초과되면 에이전트가 시작 시 뉴렐릭 플랫폼의 가용성을 확인하기 위해 요청을 재시도할 때까지 기다리는 시간입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`startup_connection_retry_time`	`NRIA_STARTUP_CONNECTION_RETRY_TIME`	문자열	`5s`	1.0.936 - 1.2.30

에이전트가 시작 시 뉴렐릭 플랫폼의 가용성 확인 요청이 시간 초과된 것으로 간주될 때까지 대기하는 시간입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`startup_connection_timeout`	`NRIA_STARTUP_CONNECTION_TIMEOUT`	문자열	`10s`	1.0.936

YML 옵션 이름	환경 변수	Type	기본	버전
`self_instrumentation`	`NRIA_SELF_INSTRUMENTATION`	문자열	`empty`	1.24.0

내장된 fluentbit 로깅 전달자를 통해 Agent Retry for Log Transmission을 활성화합니다. 정수 값은 의도된 재시도 횟수입니다. 다른 가능한 값에는 재시도 횟수를 무한으로 설정하는 False 및 재시도 기능을 완전히 끄는 no_retries가 포함됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`logging_retry_limit`	`NRIA_LOGGING_RETRY_LIMIT`	정수	`5`	1.29.1

클라우드 변수

에이전트가 클라우드 인스턴스에서 실행 중인 경우, 에이전트는 클라우드 유형을 감지하고 기본 메타데이터를 가져오려고 시도합니다. 클라우드 공급자 계정을 뉴렐릭과 연결할 때 확장된 클라우드 메타데이터(사용자 지정 리소스 태그 포함)로 메트릭을 보강할 수도 있습니다.

클라우드 감지에 실패한 경우 에이전트가 연결을 재시도하는 횟수를 설정합니다.

에이전트 초기화 중에 클라우드 감지가 실패하면 에이전트는 CloudRetryBackOffSec초 동안 기다린 후 재시도합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`cloud_max_retry_count`	`NRIA_CLOUD_MAX_RETRY_COUNT`	정수	`10`	1.2.6

에이전트가 메타데이터를 삭제할 때까지 대기하는 시간 간격을 초 단위로 설정합니다. 이 시간이 지나면 메타데이터가 만료되고 에이전트가 메타데이터를 다시 가져옵니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`cloud_metadata_expiry_sec`	`NRIA_CLOUD_METADATA_EXPIRY_SEC`	정수	`300`	1.2.6

클라우드 감지가 실패한 경우 에이전트가 클라우드 감지 재시도 사이에 대기하는 시간 간격을 초 단위로 설정합니다.

에이전트 초기화 중에 클라우드 감지가 실패하면 CloudMaxRetryCount번 재시도를 합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`cloud_retry_backoff_sec`	`NRIA_CLOUD_RETRY_BACKOFF_SEC`	정수	`60`	1.2.6

에이전트가 실행될 클라우드 공급자를 지정합니다. 기본값과 다른 값으로 설정되면 에이전트는 클라우드 공급자로부터 메타데이터(인스턴스 ID)를 성공적으로 얻을 때까지 기다렸다가 백엔드에 데이터를 제출합니다.

기본 동작을 사용하면, 에이전트도 클라우드 공급자를 감지하고 메타데이터를 가져오지만 에이전트를 차단하지 않습니다.

허용되는 값: "", "aws", "azure", "gcp", "alibaba"

YML 옵션 이름	환경 변수	Type	기본	버전
`cloud_provider`	`NRIA_CLOUD_PROVIDER`	문자열	`""`	1.40.1

DisableCloudMetadata와 유사하지만 호스트 별칭 플러그인에 대해서만 클라우드 메타데이터 수집을 비활성화합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`disable_cloud_instance_id`	`NRIA_DISABLE_CLOUD_INSTANCE_ID`	boolean.	`false`	1.0.220

YML 옵션 이름	환경 변수	Type	기본	버전
`disable_cloud_metadata`	`NRIA_DISABLE_CLOUD_METADATA`	boolean.	`false`	1.0.690

Docker 변수

캐시된 컨테이너 메타데이터가 만료되어 에이전트가 이를 다시 가져오는데 소요되는 시간(초)입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`container_cache_metadata_limit`	`NRIA_CONTAINER_CACHE_METADATA_LIMIT`	정수	`60`	1.0.801

YML 옵션 이름	환경 변수	Type	기본	버전
`docker_api_version`	`NRIA_DOCKER_API_VERSION`	문자열	`1.24`	1.1.4

파일 시스템 변수

에이전트가 지원하는 파일 시스템 유형 목록입니다. 이 값은 기본 목록의 하위 집합이어야 하며 기본 목록에 없는 항목은 삭제됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`custom_supported_file_systems`	`NRIA_CUSTOM_SUPPORTED_FILESYSTEMS`	[]string	Linux: `["xfs", "btrfs", "ext", "ext2", "ext3", "ext4", "hfs", "vxfs", "zfs"]` Windows: `["NTFS", "ReFS"]`	1.0.220

YML 옵션 이름

환경 변수

Type

기본

버전

custom_supported_file_systems

NRIA_CUSTOM_SUPPORTED_FILESYSTEMS

[]string

Linux: ["xfs", "btrfs", "ext", "ext2", "ext3", "ext4", "hfs", "vxfs", "zfs"]

Windows: ["NTFS", "ReFS"]

1.0.220

StorageSample 데이터를 수집할 때 에이전트가 무시할 스토리지 디바이스 목록입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`file_devices_ignored`	`NRIA_FILE_DEVICES_IGNORED`	[]string		1.0.220

YAML 속성의 예:

file_devices_ignored:
  - sda1
  - sda2

환경 변수의 예:

FILE_DEVICES_IGNORED="sda1,sda2"

호스트네임 변수

보고를 위해 자동 생성된 호스트네임을 재정의합니다. 이는 인프라 모니터링에서 호스트네임을 각 호스트의 고유 식별자로 사용하기 때문에 동일한 이름을 가진 여러 호스트가 있는 경우에 유용합니다. 이 값은 엔터티 이름의 루프백 주소를 대체하는 데에도 사용됩니다.

보다 자세한 내용은 엔터티 이름 해결이 작동하는 방식에 대한 문서를 참조하십시오.

YML 옵션 이름	환경 변수	Type	기본	버전
`display_name`	`NRIA_DISPLAY_NAME`	문자열	empty	1.0.266

예:

display_name: teslaOne

true인 경우 호스트 주소의 역방향 조회를 수행하여 전체 호스트 이름을 확인합니다. 그렇지 않은 경우, Linux에서는 hostname 명령으로, Windows에서는 레지스트리의 TCP/IP 파라미터에서 검색됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`dns_hostname_resolution`	`NRIA_DNS_HOSTNAME_RESOLUTION`	boolean.	`true`	1.2.6

설정되면 전체 호스트네임에 대해 보고되는 값입니다. 그렇지 않은 경우, 에이전트가 정상적인 조회 동작을 수행합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`override_hostname`	`NRIA_OVERRIDE_HOSTNAME`	문자열		1.0.1015

예:

my.custom-hostname.co.org

설정되면 호스트네임에 대해 보고되는 값입니다. 그렇지 않은 경우, 에이전트는 정상적인 조회 동작을 수행합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`override_hostname_short`	`NRIA_OVERRIDE_HOSTNAME_SHORT`	문자열		1.0.1015

예:

my.custom-hostname

설치 변수

에이전트가 캐시, 인벤토리, 통합 등에 대한 파일을 저장하는 디렉터리입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`agent_dir`	`NRIA_AGENT_DIR`	문자열	Linux: `/var/db/newrelic-infra` Windows: `C:\Program Files\NewRelic\newrelic-infra\`	1.0.2

YML 옵션 이름

환경 변수

Type

기본

버전

agent_dir

NRIA_AGENT_DIR

문자열

Linux: /var/db/newrelic-infra

Windows: C:\Program Files\NewRelic\newrelic-infra\

1.0.2

통합의 구성 파일이 포함된 디렉터리입니다.

각 통합에는 초기화 시 에이전트가 로드되는 사전 정의된 위치에 기본적으로 이름이 <integration_name>-config.yml인 자체 구성 파일이 있습니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`plugin_dir`	`NRIA_PLUGIN_DIR`	문자열	Linux: `etc/newrelic-infra/integrations.d/` Windows: `\Program Files\NewRelic\newrelic-infra\integrations.d`	1.0.2

YML 옵션 이름

환경 변수

Type

기본

버전

plugin_dir

NRIA_PLUGIN_DIR

문자열

Linux: etc/newrelic-infra/integrations.d/

Windows: \Program Files\NewRelic\newrelic-infra\integrations.d

1.0.2

통합을 설치할 커스텀 경로를 지정하여 agent_dir 외부에 설치할 수 있습니다. 에이전트가 설치된 통합을 찾을 때 우선순위가 있습니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`custom_plugin_installation_dir`	`NRIA_CUSTOM_PLUGIN_INSTALLATION_DIR`	문자열	Empty	1.0.2

통합 변수

모든 통합에 전달될 환경 변수 목록입니다. 통합에 동일한 이름의 기존 구성 옵션이 이미 존재하는 경우 환경 변수가 우선합니다.

인프라 에이전트 1.24.1부터 passthrough_environment는 변수 이름에 대한 정규식을 지원합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`passthrough_environment`	`NRIA_PASSTHROUGH_ENVIRONMENT`	[]string	Empty	1.0.719

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	기본	버전
`entityname_integrations_v2_update`	`NRIA_ENTITYNAME_INTEGRATIONS_V2_UPDATE`	boolean.	`false`	1.2.15

이 구성 파라미터를 true로 설정하면 에이전트가 HTTP 포트(기본적으로 8001)를 열어 뉴렐릭 StatsD 백엔드에서 데이터를 수신합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`http_server_enabled`	`NRIA_HTTP_SERVER_ENABLED`	boolean.	`false`	1.0.818

이 값을 설정하면 에이전트가 HTTPServerPort에서 수신을 시작하고 뉴렐릭 StatsD 백엔드에서 데이터를 수신합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`http_server_host`	`NRIA_HTTP_SERVER_HOST`	문자열	`localhost`	1.0.818

YML 옵션 이름	환경 변수	Type	기본	버전
`http_server_port`	`NRIA_HTTP_SERVER_PORT`	정수	`8001`	1.0.818

이 간격 동안 정보를 보고하지 않은 엔터티를 삭제하는 프로세스를 시작합니다.

유효한 시간 단위: s (초), m (분) 및 h (시간)

YML 옵션 이름	환경 변수	Type	기본	버전
`remove_entities_period`	`NRIA_REMOVE_ENTITIES_PERIOD`	문자열	`48h`	1.0.859

예:

1h

호스트에 많은 수의 프로세스가 있거나 통합 전반에서 수집된 대량의 데이터가 있는 경우 에이전트 대기열에 오버런 오류가 발생할 수 있습니다. 대기열이 가득 차서 발생하는 오류 메시지를 방지하려면 대기열 깊이를 늘리십시오.

YML 옵션 이름	환경 변수	Type	기본	버전
`event_queue_depth`	`NRIA_EVENT_QUEUE_DEPTH`	int64	`1000`	1.12.0

통합 SDK 동기화를 위한 영구 스토리지로 사용되는 임시 디렉터리를 정의합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`default_integrations_temp_dir`	`NRIA_DEFAULT_INTEGRATIONS_TEMP_DIR`	문자열	`/tmp/nr-integrations`	1.50.0

인프라 에이전트(예: OpenTelemetry 수집기 또는 Prometheus 노드 내보내기 툴) 이외의 소스에서 호스트를 계측하고, 에이전트 온-호스트 통합을 사용해 다른 계측 서비스를 계속 모니터링하려는 경우 이 설정을 사용합니다. 활성화되면, 에이전트는 호스트 인벤토리와 호스트 메타데이터로 장식된 통합 텔레메트리(이벤트 메트릭 및 인벤토리)를 보고하지만, 호스트 메트릭(CPU, 메모리, 디스크, 네트워크, 프로세스)는 비활성화됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`is_integrations_only`	`NRIA_IS_INTEGRATIONS_ONLY`	boolean.	`false`	1.53.0

인벤토리 변수

캐시된 인벤토리가 이 값보다 오래되면(예: 에이전트가 오프라인 상태이므로) 에이전트는 자동으로 델타 리포지토리를 제거하고 다시 만듭니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`offline_time_to_reset`	`NRIA_OFFLINE_TIME_TO_RESET`	문자열	`24h`	1.0.888

true로 설정하면 인벤토리 비동기 처리가 활성화되어 더 큰 인벤토리 페이로드를 처리할 수 있습니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`async_inventory_handler_enabled`	`NRIA_ASYNC_INVENTORY_HANDLER_ENABLED`	부울	`false`	1.40.1

에이전트가 무시한 인벤토리 경로 목록입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`ignored_inventory`	`NRIA_IGNORED_INVENTORY`	string[]	Empty list	1.0.336

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	기본	버전
`pid_file`	`NRIA_PID_FILE`	문자열	`/var/run/newrelic-infra/newrelic-infra.pid`	1.0.2

true인 경우 호스트 가상 메모리의 공식은 SReclaimable을 사용 가능한 메모리로 간주합니다. 그렇지 않은 경우, SReclaimable은 사용된 메모리의 일부로 간주됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`ignore_reclaimable`	`NRIA_IGNORE_RECLAIMABLE`	boolean.	`false`	1.2.6

로깅 변수

로그는 인프라 에이전트 로거를 구성하는 데 사용되는 키-값 맵입니다. 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	기본	버전
`file`	`NRIA_LOG_FILE`	문자열	아래 참조*

기본 경로:

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
문자열
설정되지 않음

YML 옵션 이름	환경 변수	Type	기본	버전
`level`	`NRIA_LOG_LEVEL`	문자열	설정되지 않음

로그 출력 형식을 정의합니다. 사용 가능한 값:

text: 일반 텍스트 출력, 로그 항목당 한 줄
json: JSON 형식의 출력, 로그 항목당 한 줄
YML 옵션 이름
환경 변수
Type
기본
버전
format
NRIA_LOG_FORMAT
문자열
text
1.4.9

YML 옵션 이름	환경 변수	Type	기본	버전
`format`	`NRIA_LOG_FORMAT`	문자열	`text`	1.4.9

에이전트 로그를 뉴렐릭의 로그 UI로 전달할 수 있습니다. 비활성화하려면 이 구성 옵션을 false로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`forward`	`NRIA_LOG_FORWARD`	boolean.	`false`	1.0.703

기본적으로 모든 로그는 표준 출력과 로그 파일에 모두 표시됩니다. 표준 출력에서 로그를 비활성화하려면 이 구성 옵션을 false로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`stdout`	`NRIA_LOG_STDOUT`	boolean.	`true`	1.0.703

smart_level_entry_limit 는 오류가 로그될 때 로그될 이전 디버그 메시지의 수를 나타냅니다. 예를 들어 한도가 5로 설정된 경우 디버그 로그는 오류가 로그가 될 때까지 메모리에 캐시되며, 이 시점에서 이전 5개의 디버그 메시지도 로그가 됩니다.

중요

이 구성 옵션은 level이 smart (Smart Level 활성화됨)로 설정된 경우에만 사용됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`smart_level_entry_limit`	`NRIA_SMART_LEVEL_ENTRY_LIMIT`	정수	`1000`	1.9.0

버전 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_size_mb`	`NRIA_LOG_ROTATE_MAX_SIZE_MB`	정수	`0` - 비활성화

max_files 유지되어야 하는 아카이브된 로그 파일 수를 지정합니다. 이 값을 초과하면 오래된 파일이 삭제됩니다. max_files가 0이면 파일 수 제한이 비활성화됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`max_files`	`NRIA_LOG_ROTATE_MAX_FILES`	정수	`0`

compression_enabled를 true로 설정하면 로그 파일에 대한 압축을 활성화할 수 있습니다. 압축이 활성화된 경우 회전된 파일은 gzip 포맷을 가지며 더 적은 디스크 공간을 사용합니다.

중요

로그 회전 중에, 압축이 활성화되면 특히 max_size_mb 값이 1000 보다 큰 경우 에이전트 CPU 사용량이 증가할 수 있습니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`compression_enabled`	`NRIA_LOG_ROTATE_COMPRESSION_ENABLED`	boolean.	`false`

file_pattern 아카이브된 로그 파일의 이름 포맷을 지정합니다. 기본적으로 새 파일 이름은 original-file_YYYY-MM-DD_hh-mm-ss.log 패턴을 사용합니다.

다음 타임스탬프 필드를 사용하여 파일 이름 패턴을 맞춤화할 수 있습니다.

YYYY: Year
MM: Month
DD: Day
hh: Hour
mm: Minute
ss: Secound
에이전트는 자동으로 해당 타임스탬프 필드를 파일 회전 시간으로 교체합니다. 예:
```
log:
  level: info
  file: /var/log/newrelic-infra/newrelic-infra.log
  rotate:
    max_size_mb: 1000
    file_pattern: rotated.YYYY-MM-DD_hh-mm-ss.log
```
YML 옵션 이름
환경 변수
Type
기본
버전
file_pattern
NRIA_LOG_ROTATE_FILE_PATTERN
문자열
file_YYYY-MM-DD_hh-mm-ss.file_extension

YML 옵션 이름	환경 변수	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
`custom_attributes`	`NRIA_CUSTOM_ATTRIBUTES`	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	기본	버전
`enable_process_metrics`	`NRIA_ENABLE_PROCESS_METRICS`	boolean.	`false`

활성화되면, 프로세스가 컨테이너에서 실행되는 경우 에이전트가 프로세스 샘플에 컨테이너 정보를 추가합니다.

이러한 정보에는 컨테이너 ID, 컨테이너 이름, 이미지 ID, 이미지 이름 및 컨테이너 라벨이 포함됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`process_container_decoration`	`NRIA_PROCESS_CONTAINER_DECORATION`	boolean.	`true`	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

기본

버전

include_matching_metrics

NRIA_INCLUDE_MATCHING_METRICS

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

기본

버전

exclude_matching_metrics

NRIA_EXCLUDE_MATCHING_METRICS

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 - lo index-1: - tun
Windows용 기본 네트워크 인터페이스 필터:
Loop, isatap으로 시작되는 네트워크 인터페이스, 또는 Local
다음 예시(구성 파일에 추가됨)는 기본 필터를 덮어쓰기합니다. 이렇게 하면 Loop로 시작하는 네트워크 인터페이스가 무시됩니다.
network_interface_filters: prefix: - Loop

ZeroRSSFilter는 샘플링에서 메모리를 사용하지 않는 프로세스를 제외합니다. 에이전트가 ProcessSample에 이러한 프로세스를 포함하도록 필터를 비활성화합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`disable_zero_mem_process_filter`	`NRIA_DISABLE_ZERO_MEM_PROCESS_FILTER`	boolean.	`false`	1.0.832

플러그인 변수

팁

DisableAllPlugins를 true로 설정하여 모든 변수를 빠르게 비활성화하고 필요한 옵션만 활성화할 수 있습니다.

CloudSecurityGroups 플러그인의 샘플링 기간(초)입니다. 최소값은 30입니다. 비활성화하려면 -1로 설정합니다.

중요

이 플러그인은 에이전트가 AWS 인스턴스에서 실행 중인 경우에만 활성화됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`cloud_security_group_refresh_sec`	`NRIA_CLOUD_SECURITY_GROUP_REFRESH_SEC`	int64	`60`	1.0.692

Daemontools 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`daemontools_interval_sec`	`NRIA_DAEMONTOOLS_INTERVAL_SEC`	int64	`15`	1.0.316

Dpkg 플러그인의 샘플링 기간(초)입니다. 최소값은 30입니다. 비활성화하려면 -1로 설정합니다. 파라미터가 구성 파일에 명시적으로 설정되지 않은 경우 DisableAllPlugins를 true로 설정하여 비활성화할 수 있습니다.

중요

이는 root 또는 privileged 실행 모드와 Debian 기반 배포판에서만 활성화됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`dpkg_interval_sec`	`NRIA_DPKG_INTERVAL_SEC`	int64	`30`	1.0.316

Facter 플러그인의 샘플링 기간(초)입니다. 최소값은 30입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`facter_interval_sec`	`NRIA_FACTER_INTERVAL_SEC`	int64	`30`	1.0.316

KernelModules 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

중요

kernel_modules_refresh_sec root 또는 privileged 실행 모드에서만 활성화됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`kernel_modules_refresh_sec`	`NRIA_KERNEL_MODULES_REFRESH_SEC`	int64	`10`	1.0.755

NetworkInterface 플러그인의 샘플링 기간(초)입니다. 최소값은 30입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`network_interface_interval_sec`	`NRIA_NETWORK_INTERFACE_INTERVAL_SEC`	int64	`60`	1.0.329

Rpm 플러그인의 샘플링 기간(초)입니다. 최소값은 30입니다. 비활성화하려면 -1로 설정합니다.

중요

rpm_interval_sec 에이전트가 RedHat, RedHat AWS 또는 SUSE 배포에 대해 루트 또는 권한 모드에서 실행되는 경우에만 활성화됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`rpm_interval_sec`	`NRIA_RPM_INTERVAL_SEC`	int64	`30`	1.0.316

SELinux 플러그인의 샘플링 기간(초)입니다. 최소값은 30입니다. 비활성화하려면 -1로 설정합니다. SelinuxEnableSemodule이 false로 설정된 경우 이 옵션은 무시됩니다. 보다 자세한 내용은 SELinux모듈 비활성화와 관련된 문제 해결 문서를 참조하십시오.

중요

SELinux 에이전트가 루트 모드에서 실행될 때만 활성화됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`selinux_interval_sec`	`NRIA_SELINUX_INTERVAL_SEC`	int64	`30`	1.0.316

Sshd 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`sshd_config_refresh_sec`	`NRIA_SSHD_CONFIG_REFRESH_SEC`	int64	`15`	1.0.755

Supervisor 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`supervisor_interval_sec`	`NRIA_SUPERVISOR_INTERVAL_SEC`	int64	`15`	1.0.316

Sysctl 플러그인의 샘플링 기간(초)입니다. 최소값은 30입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`sysctl_interval_sec`	`NRIA_SYSCTL_INTERVAL_SEC`	int64	`60`	1.0.316

Systemd 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`systemd_interval_sec`	`NRIA_SYSTEMD_INTERVAL_SEC`	int64	`30`	1.0.316

sysv 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`sysvinit_interval_sec`	`NRIA_SYSVINIT_INTERVAL_SEC`	int64	`30`	1.0.316

Upstart 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`upstart_interval_sec`	`NRIA_UPSTART_INTERVAL_SEC`	int64	`30`	1.0.316

Users 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`users_refresh_sec`	`NRIA_USERS_REFRESH_SEC`	int64	`30`	1.0.755

Puppet's Facter에 대한 HOME 환경 변수를 설정합니다. 정의되지 않은 경우 기본값은 현재 사용자의 홈 디렉터리입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`facter_home_dir`	`NRIA_FACTER_HOME_DIR`	문자열		1.1.7

프록시 변수

인프라 에이전트 버전 1.3.1 이상의 경우 프록시 구성 설정의 우선순위는 다음과 같습니다.

NRIA_PROXY
proxy
HTTP_PROXY
HTTPS_PROXY

시스템에 에이전트가 뉴렐릭과 통신하기 위해 프록시를 사용해야 하는 방화벽 규칙이 있을 수 있습니다. 그렇다면 프록시 URL을 https://user:password@hostname:port 포맷으로 설정합니다. HTTP 또는 HTTPS일 수 있습니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`proxy`	`NRIA_PROXY`	문자열	Empty	1.0.308

예:

https://proxy_user:access_10@proxy_01:1080

true로 설정하면 HTTPS_PROXY와 HTTP_PROXY 환경 변수가 무시됩니다. 이는 에이전트가 메트릭 수집기에 직접 연결하고 기존 시스템 프록시를 건너뛰어야 하는 경우에 유용합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`ignore_system_proxy`	`NRIA_IGNORE_SYSTEM_PROXY`	boolean.	`false`	1.0.1002

HTTPS_PROXY 옵션이 자체 서명된 인증서가 있는 프록시를 참조하는 경우 이 옵션은 프록시 인증서를 사용할 수 있는 디렉터리의 경로를 지정합니다.디렉터리의 인증서는 .pem 확장자로 끝나야 합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`ca_bundle_dir`	`NRIA_CA_BUNDLE_DIR`	문자열		1.0.296

HTTPS_PROXY 옵션이 자체 서명된 인증서가 있는 프록시를 참조하는 경우 이 옵션은 인증서 파일의 경로를 지정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`ca_bundle_file`	`NRIA_CA_BUNDLE_FILE`	문자열		1.0.296

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	기본	버전
`metrics_network_sample_rate`	`NRIA_METRICS_NETWORK_SAMPLE_RATE`	정수	`10`	1.0.308

프로세스 샘플의 샘플 속도(초)입니다. 최소값은 20입니다. 프로세스 샘플을 완전히 비활성화하려면 metrics_process_sample_rate를 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`metrics_process_sample_rate`	`NRIA_METRICS_PROCESS_SAMPLE_RATE`	정수	`20`	1.0.308

저장 샘플의 샘플 속도(초)입니다. 최소값은 5입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`metrics_storage_sample_rate`	`NRIA_METRICS_STORAGE_SAMPLE_RATE`	정수	`20`	1.0.308

시스템 샘플의 샘플 속도(초)입니다. 최소값은 5입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`metrics_system_sample_rate`	`NRIA_METRICS_SYSTEM_SAMPLE_RATE`	정수	`5`	1.0.308

NFS 스토리지 샘플의 샘플 속도(초)입니다. 최소값은 5입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`metrics_nfs_sample_rate`	`NRIA_METRICS_NFS_SAMPLE_RATE`	정수	`20`	1.5.40

세부적인 NFS 메트릭입니다. 활성화되면 에이전트는 NFS 메트릭의 전체 목록을 제공합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`detailed_nfs`	`NRIA_DETAILED_NFS`	boolean.	`false`	1.5.40

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	기본	버전
`pool`	`NRIA_NTP_METRICS_POOL`	[]string	비어 있습니다. public NTP servers를 확인하십시오.	1.33.0

보안 변수

SEModule을 사용하여 설치된 정책 모듈의 버전을 가져옵니다. 비활성화된 경우 SELinux 플러그인은 SEStatus를 사용하여 상태만 검색합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`selinux_enable_semodule`	`NRIA_SELINUX_ENABLE_SEMODULE`	boolean.	`true`	1.0.864

true일 때 에이전트는 ProcessSample의 commandLine 속성에서 명령 인수를 제거합니다.

팁

민감한 정보가 유출되는 것을 방지하기 위한 보안 조치입니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`strip_command_line`	`NRIA_STRIP_COMMAND_LINE`	boolean.	`true`	1.0.149

상태 엔드포인트 변수

로컬 상태 정보를 제공하는 에이전트에서 상태 서버를 활성화합니다. 사용 가능한 엔드포인트는 다음과 같습니다.

기본 상태 엔드포인트 예(오류 없음):

bash

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

기본 상태 엔드포인트(오류 있음):

bash

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

오류 엔드포인트 예:

bash

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

이는 기본 상태 엔드포인트와 유사하지만 오류가 있는 항목만 필터링합니다.

엔터티 엔드포인트 예:

bash

$curl http://localhost:8003/v1/status/entity
{
  "guid":"MMMMNjI0NjR8SU5GUkF8TkF8ODIwMDg3MDc0ODE0MTUwNTMy",
  "key":"your-host-name"
}

에이전트/호스트 엔터티에 대한 정보를 반환합니다. 에이전트에 에이전트/호스트 엔터티에 대한 정보가 없으면 응답 상태 코드 204 ("콘텐츠 없음")가 반환됩니다. 따라서 에이전트가 엔터티 데이터를 제공할 때까지 여러 요청이 필요할 수 있습니다.

중요

안내 설치를 사용하는 경우 이 설정이 기본적으로 활성화됩니다. 에이전트 설치가 성공했는지 확인하는 데 도움이 됩니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`status_server_enabled`	`NRIA_STATUS_SERVER_ENABLED`	boolean.	`false`	1.19.0

윈도우 변수

Windows 서비스 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`windows_services_refresh_sec`	`NRIA_WINDOWS_SERVICES_REFRESH_SEC`	int64	`30`	1.0.755

Windows 업데이트 플러그인의 샘플링 기간(초)입니다. 최소값은 10입니다. 비활성화하려면 -1로 설정합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`windows_updates_refresh_sec`	`NRIA_WINDOWS_UPDATES_REFRESH_SEC`	int64	`60`	1.0.755

프로그램 파일 디렉터리와 다른 경로에 데이터를 저장할 경로를 정의합니다.

%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
리눅스: 해당 없음
1.0.755

호스트에 설치된 핫픽스 목록을 검색하는 Windows 업데이트 플러그인을 활성화합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`enable_win_update_plugin`	`NRIA_ENABLE_WIN_UPDATE_PLUGIN`	boolean.	`false`	1.0.274

true인 경우 에이전트는 Windows WMI(Windows용 메트릭을 가져오는에이전트의 레거시 방법, 예: StorageSampler)를 사용하도록 강제되고 새 방법(PDH 라이브러리 사용)을 비활성화합니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`legacy_storage_sampler`	`NRIA_LEGACY_STORAGE_SAMPLER`	boolean.		1.0.1051

이 구성 옵션을 사용하면 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	기본	버전
`win_removable_drives`	`NRIA_WIN_REMOVABLE_DRIVES`	boolean.	`true`	1.3.1

true로 설정하면 WMI에서 프로세스 정보를 가져오고 제한된 환경에서 쿼리 액세스 검사를 건너뜁니다.

YML 옵션 이름	환경 변수	Type	기본	버전
`enable_wmi_proc_data`	`NRIA_ENABLE_WMI_PROC_DATA`	boolean.	`false`	1.3.1

HTTP 클라이언트

백엔드 통신에 사용되는 HTTP 클라이언트를 구성합니다.

뉴렐릭 백엔드에 대한 모든 요청에 포함될 사용자 정의 HTTP 헤더입니다.

http:
  headers:
    "Proxy-Authorization": "myToken"

YML 옵션 이름	환경 변수	Type	버전
`headers`	`NRIA_HTTP_HEADERS`	키-값 맵	1.41.0

다음 단계는?

이외에도:

에이전트의 구성을 더 잘 이해할 수 있습니다.
템플릿을 사용하여 구성 파일을 생성할 수 있습니다.
에이전트를 관리하는 방법을 확인할 수 있습니다.

중요

시작하기 .css-21sua1{background:none;border:none;width:0;padding:0;}

에이전트 변수

FedRAMP

max_procs

payload_compression_level

startup_connection_retries

startup_connection_retry_time

startup_connection_timeout

self_instrumentation

logging_retry_limit

클라우드 변수

cloud_max_retry_count

cloud_metadata_expiry_sec

cloud_retry_backoff_sec

cloud_provider

disable_cloud_instance_id

disable_cloud_metadata

Docker 변수

container_cache_metadata_limit

docker_api_version

파일 시스템 변수

custom_supported_file_systems

file_devices_ignored

호스트네임 변수

display_name

dns_hostname_resolution

override_hostname

override_hostname_short

설치 변수

agent_dir

plugin_dir

custom_plugin_installation_dir

통합 변수

passthrough_environment

entityname_integrations_v2_update

http_server_enabled

http_server_host

http_server_port

remove_entities_period

event_queue_depth

default_integrations_temp_dir

is_integrations_only

인벤토리 변수

offline_time_to_reset

enable_async_inventory

ignored_inventory

Linux 변수

pid_file

ignore_reclaimable

로깅 변수

로그

팁

메트릭 변수

custom_attributes

enable_process_metrics

process_container_decoration

include_matching_metrics

exclude_matching_metrics

network_interface_filters

disable_zero_mem_process_filter

플러그인 변수

팁

disable_all_plugins

cloud_security_group_refresh_sec

daemontools_interval_sec

dpkg_interval_sec

facter_interval_sec

kernel_modules_refresh_sec

network_interface_interval_sec

rpm_interval_sec

selinux_interval_sec

sshd_config_refresh_sec

supervisor_interval_sec

sysctl_interval_sec

systemd_interval_sec

sysvinit_interval_sec

upstart_interval_sec

users_refresh_sec

시작하기