인프라 에이전트 구성 설정

인프라 에이전트에는 동작을 미세 조정하기 위한 많은 구성 설정 세트가 있습니다. 여기에서 우리는:

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

아직도 New Relic 계정이 없으신가요? 영원히 무료로 가입하세요 .

시작하다

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

license_key 만 필수 설정입니다.

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

에이전트 변수

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`license_key`	`NRIA_LICENSE_KEY`	끈

예시:

license_key: 1234567890abcdefghijklmnopqrstuvwxyz1234

YML 옵션 이름	환경 변수	유형	기본값	버전
`fedramp`	`NRIA_FEDRAMP`	부울	잘못된	1.15.0

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

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

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

버전 1.0.804 이상부터 에이전트에서 보낸 데이터는 기본적으로 압축되어 있습니다. 페이로드 압축을 비활성화하려면 payload_compression_level 을 0으로 설정합니다.

중요

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

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

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

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

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

요청 시간이 초과되면 에이전트가 시작 시 New Relic의 플랫폼 가용성을 확인하기 위해 요청을 재시도하기 위해 대기하는 시간입니다.

YML 옵션 이름	환경 변수	유형	기본값	버전
`startup_connection_retry_time`	`NRIA_STARTUP_CONNECTION_RETRY_TIME`	끈	`5s`	1.0.936 - 1.2.30

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`startup_connection_timeout`	`NRIA_STARTUP_CONNECTION_TIMEOUT`	끈	`10s`	1.0.936

YML 옵션 이름	환경 변수	유형	기본값	버전
`self_instrumentation`	`NRIA_SELF_INSTRUMENTATION`	끈	`empty`	1.24.0

클라우드 변수

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

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

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

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

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

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

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

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

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`disable_cloud_instance_id`	`NRIA_DISABLE_CLOUD_INSTANCE_ID`	부울	`false`	1.0.220

YML 옵션 이름	환경 변수	유형	기본값	버전
`disable_cloud_metadata`	`NRIA_DISABLE_CLOUD_METADATA`	부울	`false`	1.0.690

도커 변수

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`docker_api_version`	`NRIA_DOCKER_API_VERSION`	끈	`1.24`	1.1.4

파일 시스템 변수

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

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

StorageSample 데이터를 수집할 때 에이전트가 무시할 저장 장치 목록입니다.

YML 옵션 이름	환경 변수	유형	기본값	버전
file_devices_ignored	`NRIA_FILE_DEVICES_IGNORED`	[]끈		1.0.220

YAML 속성의 예:

file_devices_ignored:
  - sda1
  - sda2

환경 변수의 예:

FILE_DEVICES_IGNORED="sda1,sda2"

호스트 이름 변수

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

자세한 내용은 엔터티 이름 확인 작동 방식 에 대한 설명서를 참조하세요.

YML 옵션 이름	환경 변수	유형	기본값	버전
`display_name`	`NRIA_DISPLAY_NAME`	끈	비어 있는	1.0.266

예시:

display_name: teslaOne

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`dns_hostname_resolution`	`NRIA_DNS_HOSTNAME_RESOLUTION`	부울	`true`	1.2.6

설정하면 전체 호스트 이름에 대해 보고되는 값입니다. 그렇지 않으면 에이전트는 정상적인 조회 동작을 수행합니다.

YML 옵션 이름	환경 변수	유형	기본값	버전
`override_hostname`	`NRIA_OVERRIDE_HOSTNAME`	끈		1.0.1015

예시:

my.custom-hostname.co.org

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`override_hostname_short`	`NRIA_OVERRIDE_HOSTNAME_SHORT`	끈		1.0.1015

예시:

my.custom-hostname

설치 변수

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`agent_dir`	`NRIA_AGENT_DIR`	끈	리눅스: `/var/db/newrelic-infra` Windows: `C:\Program Files\NewRelic\newrelic-infra\`	1.0.2

YML 옵션 이름

환경 변수

유형

기본값

버전

agent_dir

NRIA_AGENT_DIR

끈

리눅스: /var/db/newrelic-infra

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

1.0.2

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`plugin_dir`	`NRIA_PLUGIN_DIR`	끈	리눅스: `etc/newrelic-infra/integrations.d/` Windows: `\Program Files\NewRelic\newrelic-infra\inregrations.d`	1.0.2

YML 옵션 이름

환경 변수

유형

기본값

버전

plugin_dir

NRIA_PLUGIN_DIR

끈

리눅스: etc/newrelic-infra/integrations.d/

Windows:

\Program Files\NewRelic\newrelic-infra\inregrations.d

1.0.2

중요

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`custom_plugin_installation_dir`	`NRIA_CUSTOM_PLUGIN_INSTALLATION_DIR`	끈	비어 있는	1.0.2

통합 변수

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`passthrough_environment`	`NRIA_PASSTHROUGH_ENVIRONMENT`	[]끈	비어 있는	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 옵션 이름	환경 변수	유형	기본값	버전
`entityname_integrations_v2_update`	`NRIA_ENTITYNAME_INTEGRATIONS_V2_UPDATE`	부울	`false`	1.2.15

이 구성 매개변수를 true 으로 설정하면 에이전트가 HTTP 포트(기본적으로 8001 )를 열어 New Relic StatsD 백엔드에서 데이터를 수신합니다.

YML 옵션 이름	환경 변수	유형	기본값	버전
`http_server_enabled`	`NRIA_HTTP_SERVER_ENABLED`	부울	`false`	1.0.818

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`http_server_host`	`NRIA_HTTP_SERVER_HOST`	끈	`localhost`	1.0.818

http 서버가 New Relic StatsD 백엔드에서 데이터를 수신할 포트를 설정합니다.

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

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`remove_entities_period`	`NRIA_REMOVE_ENTITIES_PERIOD`	끈	`48h`	1.0.859

예시:

1h

인벤토리 변수

캐시된 인벤토리가 이 값보다 오래된 경우(예: 에이전트가 오프라인 상태이기 때문에) 에이전트는 자동으로 델타 저장소를 제거하고 다시 만듭니다.

YML 옵션 이름	환경 변수	유형	기본값	버전
`offline_time_to_reset`	`NRIA_OFFLINE_TIME_TO_RESET`	끈	`24h`	1.0.888

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`ignored_inventory`	`NRIA_IGNORED_INVENTORY`	끈[]	빈 목록	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"

리눅스 변수

에이전트 프로세스의 pid 파일이 생성되는 Linux의 위치입니다. 에이전트의 다른 인스턴스가 실행되고 있지 않은지 확인하기 위해 시작 시 사용됩니다.

YML 옵션 이름	환경 변수	유형	기본값	버전
`pid_file`	`NRIA_PID_FILE`	끈	`/var/run/newrelic-infra/newrelic-infra.pid`	1.0.2

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`ignore_reclaimable`	`NRIA_IGNORE_RECLAIMABLE`	부울	`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 옵션 이름	환경 변수	유형	기본값	버전
`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_level_entry_limit 디버그 메시지를 기록합니다.
debug: 레벨 오류, 경고, 정보 및 디버그의 로그 메시지를 표시합니다.
trace: 모든 로그 메시지가 표시됩니다.
중요
추적 수준 로깅은 많은 데이터를 매우 빠르게 생성할 수 있습니다. 문제를 재현하는 데 필요한 기간 동안만 추적 모드에서 에이전트를 실행한 다음 level: info 을 설정하고 에이전트를 다시 시작하여 자세한 로깅을 비활성화합니다. 또는 level : smart 를 설정할 수 있습니다. 그러면 스마트 상세 정보 표시 모드가 활성화됩니다.
YML 옵션 이름
환경 변수
유형
기본값
버전
level
NRIA_LOG_LEVEL
끈
설정되지 않음

YML 옵션 이름	환경 변수	유형	기본값	버전
`level`	`NRIA_LOG_LEVEL`	끈	설정되지 않음

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`format`	`NRIA_LOG_FORMAT`	끈	`text`	1.4.9

에이전트 로그를 New Relic의 로그 UI로 전달할 수 있습니다. 비활성화하려면 이 구성 옵션을 false 으로 설정하십시오.

YML 옵션 이름	환경 변수	유형	기본값	버전
`forward`	`NRIA_LOG_FORWARD`	부울	`false`	1.0.703

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`stdout`	`NRIA_LOG_STDOUT`	부울	`true`	1.0.703

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

중요

이 구성 옵션은 level 이 smart (스마트 레벨 활성화됨)로 설정된 경우에만 사용됩니다.

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

측정항목 변수

사용자 정의 속성은 인프라 에이전트의 데이터에 주석을 추가하는 데 사용되는 키-값 쌍(다른 도구의 태그와 유사)입니다. 이 메타데이터를 사용 하여 필터 세트를 만들고 결과를 그룹화 하고 데이터에 주석을 추가할 수 있습니다. 예를 들어, 시스템 환경(스테이징 또는 프로덕션), 시스템이 호스팅하는 서비스(예: 로그인 서비스) 또는 해당 시스템을 담당하는 팀을 나타낼 수 있습니다.

팁

에이전트는 Amazon Elastic Compute Cloud(Amazon EC2) 태그 를 포함하여 기본 속성 의 일부로 환경에 대한 많은 세부 정보를 수집합니다.

YML 옵션 이름	환경 변수	유형
`custom_attributes`	`NRIA_CUSTOM_ATTRIBUTES`	지도[문자열]인터페이스{}

사용자 정의 속성 목록을 사용하여 이 에이전트 인스턴스의 데이터에 주석을 추가하십시오. KEY: VALUE 에서와 같이 콜론 : 으로 키와 값을 구분하고 각 키-값 쌍을 줄 바꿈으로 구분합니다. 키는 슬래시 / 를 제외한 모든 유효한 YAML이 될 수 있습니다. 값은 공백을 포함한 모든 YAML 문자열이 될 수 있습니다.

YAML 속성의 예:

custom_attributes:
  environment: production
  service: login service
  team: alpha-team

환경 변수의 예:

NRIA_CUSTOM_ATTRIBUTES='{"customAttribute_1":"SOME_ATTRIBUTE","customAttribute_2": "SOME_ATTRIBUTE_2"}'

사용자 정의 속성으로 필터링하는 NRQL 예제:

FROM SystemSample SELECT * WHERE environment = 'production'

중요

인프라 에이전트 버전 1.12.0 이상이 필요합니다. 2020년 7월 20일 이전에 생성된 계정 및/또는 새로운 Guided Install을 사용하여 설치된 인프라 에이전트에는 기본적으로 이 변수가 활성화되어 있습니다.

프로세스 메트릭 을 New Relic으로 보낼 수 있습니다.

기본적으로 인프라 에이전트는 운영 체제의 프로세스에 대한 데이터를 보내지 않습니다. 에이전트는 metrics_process_sample_rate 이 -1 로 설정되지 않는 한 이러한 데이터를 계속 수집합니다.

모든 운영 체제의 프로세스에 대한 측정항목 데이터를 보고하려면 enable_process_metrics 을 true 로 설정합니다. 비활성화하려면 false 로 설정하십시오.

모든 프로세스 데이터를 전송하면 New Relic으로 전송되는 데이터의 양이 증가할 수 있습니다. 모니터링할 프로세스를 미세 조정하려면 include_matching_metrics 을 구성합니다.

기본적으로 메모리가 부족한 프로세스는 샘플링에서 제외됩니다. 자세한 내용은 disable-zero-mem-process-filter 를 참조하십시오.

YML 옵션 이름	환경 변수	유형	기본값	버전
`enable_process_metrics`	`NRIA_ENABLE_PROCESS_METRICS`	부울	`false`

중요

현재 이 설정은 운영 체제의 프로세스 메트릭에만 적용됩니다.

메트릭 속성 값을 기반으로 메트릭 데이터 전송을 제한할 수 있는 include_matching_metrics 을 구성하여 New Relic으로 전송되는 데이터의 양을 제어할 수 있습니다.

메트릭 속성에 대한 리터럴 또는 부분 값을 정의하여 메트릭 데이터를 포함합니다. 예를 들어, 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 을 Kubernetes 통합 을 위한 환경 변수로 구성하려면 env: 객체 내의 매니페스트에 추가합니다.

env:
    - name: NRIA_INCLUDE_MATCHING_METRICS
      value: |
        process.name:
          - regex "^java"
        process.executable:
          - "/usr/bin/python2"
          - regex "\\System32\\svchost"

기본값

YML 옵션 이름	환경 변수	유형	기본값	버전
`include_matching_metrics`	`NRIA_INCLUDE_MATCHING_METRICS`	metric.attribute: - 정규식 "패턴" - "끈" - "와일드카드가 있는 문자열*"

YML 옵션 이름

환경 변수

유형

기본값

버전

include_matching_metrics

NRIA_INCLUDE_MATCHING_METRICS

metric.attribute:

- 정규식 "패턴"

- "끈"

- "와일드카드가 있는 문자열*"

네트워크 인터페이스 필터 구성을 사용하여 인프라 에이전트에서 사용하지 않거나 흥미롭지 않은 네트워크 인터페이스를 숨길 수 있습니다. 이렇게 하면 데이터의 리소스 사용량, 작업 및 노이즈를 줄이는 데 도움이 됩니다.

중요

이 구성 설정에는 환경 변수가 지원되지 않습니다.

구성은 다음 패턴에 따라 특정 문자 또는 숫자 시퀀스로 시작하는 인터페이스를 찾을 수 있는 간단한 패턴 일치 메커니즘을 사용합니다.

{name}[other characters], 여기서 prefix 옵션을 사용하여 이름을 지정합니다.
[number]{name}[other characters], 여기서 index-1 옵션을 사용하여 이름을 지정합니다.
New Relic 인프라는 사용자가 수정할 수 있는 Linux 및 Windows 모두에서 사용할 수 있는 선별된 기본 필터 목록을 구현합니다.
YML 옵션 이름
환경 변수
유형
기본값
버전
network_interface_filters
지원되지 않음
맵[문자열][]문자열
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

YML 옵션 이름	환경 변수	유형	기본값	버전
`network_interface_filters`	지원되지 않음	맵[문자열][]문자열		1.0.220

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`disable_zero_mem_process_filter`	`NRIA_DISABLE_ZERO_MEM_PROCESS_FILTER`	부울	`false`	1.0.832

플러그인 변수

팁

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`disable_all_plugins`	`NRIA_DISABLE_ALL_PLUGINS`	부울	`false`	1.2.1

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

중요

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

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

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

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

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

중요

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

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

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

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

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

중요

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

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`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 옵션 이름	환경 변수	유형	기본값	버전
`rpm_interval_sec`	`NRIA_RPM_INTERVAL_SEC`	int64	`30`	1.0.316

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

중요

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`facter_home_dir`	`NRIA_FACTER_HOME_DIR`	끈		1.1.7

프록시 변수

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

NRIA_PROXY
proxy
HTTP_PROXY
HTTPS_PROXY

에이전트가 New Relic과 통신하기 위해 프록시를 사용하도록 요구하는 방화벽 규칙이 시스템에 있을 수 있습니다. 그렇다면 https :// user : password @ hostname : port 형식으로 프록시 URL을 설정하십시오. HTTP 또는 HTTPS일 수 있습니다.

YML 옵션 이름	환경 변수	유형	기본값	버전
`proxy`	`NRIA_PROXY`	끈	비어 있는	1.0.308

예시:

https://proxy_user:access_10@proxy_01:1080

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`ignore_system_proxy`	`NRIA_IGNORE_SYSTEM_PROXY`	부울	`false`	1.0.1002

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`ca_bundle_dir`	`NRIA_CA_BUNDLE_DIR`	끈		1.0.296

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`ca_bundle_file`	`NRIA_CA_BUNDLE_FILE`	끈		1.0.296

true 으로 설정하면 프록시가 HTTPS 연결을 사용하도록 구성된 경우에만 작동합니다.

HTTPS 프록시에 유효한 인증 기관의 인증서가 있는 경우.
ca_bundle_file 또는 ca_bundle_dir 구성 속성에 HTTPS 프록시 인증서가 포함된 경우.
YML 옵션 이름
환경 변수
유형
기본값
버전
proxy_validate_certificates
NRIA_PROXY_VALIDATE_CERTIFICATES
부울
false
1.3.0

다음 프록시 구성 정보를 인벤토리로 보냅니다.

HTTPS_PROXY
HTTP_PROXY
proxy ca_bundle_dir
ca_bundle_file
ignore_system_proxy
proxy_validate_certificates
YML 옵션 이름
환경 변수
유형
기본값
버전
proxy_config_plugin
NRIA_PROXY_CONFIG_PLUGIN
부울
true
1.3.0

프록시 구성에 문제가 있는 경우 프록시 문제 해결 을 참조하십시오.

샘플 변수

네트워크 샘플의 샘플 속도(초)입니다. 최소값은 10 입니다. 비활성화하려면 -1 로 설정하십시오.

YML 옵션 이름	환경 변수	유형	기본값	버전
`metrics_network_sample_rate`	`NRIA_METRICS_NETWORK_SAMPLE_RATE`	정수	`10`	1.0.308

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

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

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

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

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

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

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

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`detailed_nfs`	`NRIA_DETAILED_NFS`	부울	`false`	1.5.40

보안 변수

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`selinux_enable_semodule`	`NRIA_SELINUX_ENABLE_SEMODULE`	부울	`true`	1.0.864

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

팁

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`strip_command_line`	`NRIA_STRIP_COMMAND_LINE`	부울	`true`	1.0.149

Windows 변수

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

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

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`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 옵션 이름
환경 변수
유형
기본값
버전
app_data_dir
NRIA_APP_DATA_DIR
끈
Windows: env(ProgramData)\New Relic\newrelic-infra
리눅스:
해당 없음
1.0.755

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`enable_win_update_plugin`	`NRIA_ENABLE_WIN_UPDATE_PLUGIN`	부울	`false`	1.0.274

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

YML 옵션 이름	환경 변수	유형	기본값	버전
`legacy_storage_sampler`	`NRIA_LEGACY_STORAGE_SAMPLER`	부울		1.0.1051

이 구성 옵션을 사용하면 newrelic-infra.exe 프로세스 우선 순위를 다음 값 중 하나로 높일 수 있습니다.

Normal
Idle
High
RealTime
BelowNormal
AboveNormal
YML 옵션 이름
환경 변수
유형
기본값
버전
win_process_priority_class
NRIA_WIN_PROCESS_PRIORITY_CLASS
끈
1.0.989
예시:
```
Normal
```

Windows 에이전트가 드라이브 A: 및 B: 이(가) 이동식 드라이브로 매핑될 때 보고할 수 있도록 합니다.

YML 옵션 이름	환경 변수	유형	기본값	버전
`win_removable_drives`	`NRIA_WIN_REMOVABLE_DRIVES`	부울	`true`	1.3.1

다음은 뭐지?

당신은 또한 수:

에이전트의 구성을 더 이해합니다.
템플릿을 사용하여 구성 파일을 만듭니다.
에이전트를 관리하는 방법을 확인하십시오.

사용자의 편의를 위해 제공되는 기계 번역입니다.

시작하다

에이전트 변수

페드램프

max_procs

페이로드_압축_레벨

시작_연결_재시도

시작_연결_재시도_시간

startup_connection_timeout

self_instrumentation

클라우드 변수

cloud_max_retry_count

cloud_metadata_expiry_sec

cloud_retry_backoff_sec

disable_cloud_instance_id

disable_cloud_metadata

도커 변수

container_cache_metadata_limit

docker_api_version

파일 시스템 변수

custom_supported_file_systems

file_devices_ignored

호스트 이름 변수

이름 표시하기

dns_hostname_resolution

재정의_호스트 이름

override_hostname_short

설치 변수

에이전트_디렉토리

플러그인_디렉토리

custom_plugin_installation_dir

통합 변수

통과 환경

entityname_integrations_v2_update

http_server_enabled

http_server_host

http_server_port

remove_entities_period

인벤토리 변수

offline_time_to_reset

무시된 인벤토리

리눅스 변수

PID_파일

ignore_reclaimable

로깅 변수

통나무

측정항목 변수

custom_attributes

enable_process_metrics

include_matching_metrics

network_interface_filters

disable_zero_mem_process_filter

플러그인 변수

팁

disable_all_plugins

cloud_security_group_refresh_sec

daemontools_interval_sec

dpkg_interval_sec

factor_interval_sec

kernel_modules_refresh_sec

network_interface_interval_sec

rpm_interval_sec

selinux_interval_sec

sshd_config_refresh_sec

감독자_간격_초

sysctl_interval_sec

systemd_interval_sec

sysvinit_interval_sec

upstart_interval_sec

users_refresh_sec

감독자_rpc_sock

factor_home_dir

프록시 변수

대리

ignore_system_proxy

ca_bundle_dir

ca_bundle_file

proxy_validate_certificates

proxy_config_plugin