에이전트 유형

중요

Agent Control 및 뉴렐릭 Control은 일반적으로 Kubernetes 에서 사용할 수 있습니다. Linux 및 Windows 호스트 지원은 공개 미리 보기 프로그램에 포함되어 있습니다, 사전 출시 정책에 따라.

에이전트 유형 정의는 에이전트 컨트롤이 특정 에이전트를 식별, 다운로드, 설정 및 실행하는 방법을 설명하는 YAML 파일입니다. 선언된 변수는 플릿 컨트롤이 플릿에서 하위 에이전트를 배포하거나 업데이트할 때 운영자에게 노출하는 설정 스키마를 형성하기도 합니다. 모든 정의는 메타데이터, 변수 및 배포의 세 가지 주요 섹션과 파일이 작성된 스키마 언어의 버전을 지정하는 최상위 protocol_version 필드로 구성됩니다.

메타데이터

메타데이터 섹션은 에이전트 유형, 즉 name, namespace, version, 타겟 platform (host 또는 kubernetes) 및 operating_system (호스트 기반 유형에 필요)을 식별합니다. 에이전트 컨트롤은 이러한 필드를 사용하여 정의를 고유하게 지정하고 올바른 배포 엔진으로 전달합니다.

변수

변수 섹션은 운영자가 설정에 하위 에이전트를 추가할 때 설정할 수 있는 구성 가능한 입력을 선언합니다. 각 변수에는 type (예: string, bool 또는 yaml), 선택적 default 및 허용되는 값의 선택적 variants 목록이 있습니다. 변수는 ${nr-var:variable_name}을(를) 사용하여 배포 섹션 전체에서 참조됩니다.

전개

배포 섹션에서는 에이전트 컨트롤이 타겟 플랫폼에 에이전트를 설치하고 실행하는 방법을 설명합니다. 이 섹션은 여러 하위 섹션으로 구성됩니다.

packages: 에이전트가 시작되기 전에 다운로드할 OCI 아티팩트 ― 일반적으로 에이전트 바이너리 또는 통합 패키지입니다.
executables: 에이전트 컨트롤이 시작, 모니터 및 다시 시작할 프로세스 목록입니다. 이 섹션이 없는 에이전트 유형은 관리형 통합(OHI)으로 처리되며, 에이전트 컨트롤은 해당 아티팩트를 처리하지만 실행은 다른 에이전트에 위임합니다.
health: 에이전트 컨트롤이 에이전트의 정상 여부를 결정하는 방법 ― 프로세스 존재 여부, HTTP 엔드포인트 확인 또는 둘 다를 통해 결정합니다.
filesystem: 설정 파일이나 인증서와 같이 에이전트를 시작하기 전에 에이전트 제어가 호스트에 쓰는 개별 파일 또는 디렉터리입니다.
shared_filesystem: 동일한 에이전트 컨트롤 인스턴스에서 관리하는 다른 에이전트가 액세스할 수 있는 공유 드롭 존에 기록된 항목입니다. OHI 에이전트 유형이 설정 및 바이너리를 인프라 에이전트에 전달하는 데 사용됩니다.

전체 스키마 참조 및 사용 가능한 모든 필드는 에이전트 유형 스키마 참조를 확인해 주십시오.

연결된 에이전트 유형

한 에이전트 유형이 공유 파일 시스템에 아티팩트(설정, 바이너리 또는 기타 파일)를 쓰고 다른 에이전트 유형이 동일한 경로에서 읽도록 설정된 경우 두 에이전트 유형이 연결 됩니다. 작성자에게는 executables 섹션이 없을 수 있으며, 에이전트 컨트롤은 아티팩트를 관리하지만 이를 위한 프로세스를 시작하지는 않습니다. 대신, 리더 에이전트에는 공유 파일 시스템의 잘 알려진 경로에서 바이너리 및 설정을 검색하고 실행하는 기본 제공 로직이 있어 작성자를 대신하여 애드온을 효과적으로 실행합니다.

공유 파일 시스템 루트는 다음과 같습니다.

운영 체제	길
Linux	`/var/lib/newrelic-agent-control/shared-filesystem`
윈도우	`C:\ProgramData\New Relic\newrelic-agent-control\shared-filesystem`

동일한 Agent Control 인스턴스에서 관리하는 모든 에이전트는 이 루트를 공유합니다. 하위 디렉터리 이름은 연결된 에이전트 유형 간의 규칙에 따라 선택됩니다.

온-호스트 통합(OHI)

온-호스트 통합(OHI)은 Agent Control에서 연결된 에이전트의 주요 예이며, 다른 에이전트는 Agent Control에서 시작된 프로세스를 가지고 있지만 OHI 에이전트는 자체 프로세스가 없으며 Agent Control에서 절대 시작되지 않습니다. 이를 통해 Agent Control은 뉴렐릭 Infrastructure 통합의 전체 수명 주기를 관리하여 다운로드, 구성, 업그레이드 및 제거를 수행하는 동시에, 공유 파일 시스템에서 통합 바이너리를 검색하고 실행하는 인프라 에이전트에 실행을 위임할 수 있습니다.

인프라 에이전트 및 OHI 에이전트 관계

OHI 에이전트 유형이 설치되면 Agent Control은 OCI를 통해 통합 바이너리를 다운로드하고 공유 파일 시스템에 두 개의 항목을 기록합니다:
- infra-agent-ohi-configs/ 아래의 설정 파일(예: nri-redis.yaml)
- infra-agent-ohi-binaries/ 아래의 통합 바이너리(예: nri-redis)

인프라 에이전트 하위 에이전트는 이러한 공유 디렉터리를 가리키는 환경 변수로 구성됩니다:

변하기 쉬운	공유 파일 시스템 경로	목적
`NRIA_PLUGIN_DIR`	`…/infra-agent-ohi-configs`	통합 설정 검색
`NRIA_CUSTOM_PLUGIN_INSTALLATION_DIR`	`…/infra-agent-ohi-binaries`	통합 바이너리 검색
`NRIA_SAFE_BIN_DIR`	`…/infra-agent-ohi-binaries`	허용된 바이너리 실행 경로

인프라 에이전트는 다음 스캔 주기에서 구성 및 바이너리를 가져와 통합 실행을 시작합니다.
```
shared-filesystem/
├── infra-agent-ohi-configs/      # Integration YAML configs (read by NRIA_PLUGIN_DIR)
│   ├── nri-redis.yaml
│   └── nri-mysql.yaml
└── infra-agent-ohi-binaries/     # Integration binaries (read by NRIA_CUSTOM_PLUGIN_INSTALLATION_DIR)
    ├── nri-redis
    └── nri-mysql
```

중요

OHI 에이전트 유형은 자체 프로세스가 없으며 실행을 위해 전적으로 인프라 에이전트에 의존합니다. OHI 에이전트 유형을 배포하기 전에 동일한 Agent Control 인스턴스에 com.newrelic.infrastructure을(를) 하위 에이전트로 구성해야 합니다.

지원되는 에이전트 유형

현재 지원

에이전트 유형	Kubernetes 지원	Linux 호스트 지원	Windows 호스트 지원
뉴렐릭 인프라 에이전트	✅ 네	공개 미리보기	공개 미리보기
아파치	✅ 네	공개 미리보기	공개 미리보기
몸을 풀다	✅ 네	공개 미리보기	공개 미리보기
멤캐시드	✅ 네	공개 미리보기	공개 미리보기
MySQL	✅ 네	공개 미리보기	공개 미리보기
NGINX	✅ 네	공개 미리보기	공개 미리보기
PostgreSQL	✅ 네	공개 미리보기	공개 미리보기
Redis	✅ 네	공개 미리보기	공개 미리보기
뉴렐릭 OpenTelemetry Collector (NRDOT)	✅ 네	✅ 네	⚠️ 실험용
Fluent Bit	✅ 네	🚫 아니요	🚫 아니요
뉴렐릭 Prometheus 에이전트	✅ 네	🚫 아니요	🚫 아니요
뉴렐릭 eBPF 에이전트	✅ 네	⚠️ 실험용	🚫 아니요
APM 에이전트(.NET, 지속, Node, 끌어당김, 루비)	🚫 아니요	🚫 아니요	🚫 아니요

중요

에이전트별 권한: 에이전트 제어는 유연한 권한 관리를 제공하도록 설계되었습니다. 에이전트 Control 자체는 기능을 수행하는 데 일정 수준의 액세스 권한이 필요하지만, 개별 에이전트에 부여하는 권한은 해당 에이전트의 특정 요구 사항에 맞게 조정됩니다. 아래에서 각 에이전트 유형에 필요한 권한에 대한 세부 정보를 확인할 수 있습니다.