에이전트 컨트롤 설정 및 설치

개요

에이전트 제어는 측정, 에이전트 에이전트의 관리를 단순화합니다. 이 가이드는 다양한 방법을 사용하여 쿠버네티스 클러스터, Linux 호스트 또는 Windows 호스트에 Control을 설치 및 제거하는 과정을 안내합니다.

에이전트 제어 설치

안내 설치

1. 뉴렐릭에 로그인하세요.
2. 올바른 계정을 선택했는지 확인하세요.
3. 통합 및 에이전트에서 Install Agent Control 클릭하거나 Agent Control을 검색하세요.

4. 설치 및 설정 과정을 완료하려면 다음 단계를 따르십시오.

5. 생성된 설정 파일을 컴퓨터로 다운로드하고 터미널에서 제공된 명령어를 실행하여 Control을 설치하십시오. 설치가 완료되면 Continue [계속]을 클릭하세요.
6. 설치가 성공적으로 완료되었는지 확인하기 위해 연결을 테스트하세요. 이 단계를 완료하는 데 5-10분이 걸릴 수 있습니다.
7. 이제 에이전트 컨트롤이 설치되어 실행 중이므로, 에이전트를 설정 및 관리 하거나 플릿 컨트롤을 사용하여 에이전트에 변경 사항을 배포할 준비가 되었습니다.

설치 후 예상되는 사항

설치 파일을 실행한 후 에이전트 제어는 감독자 서비스만 설정합니다. 측정 없음, 도구 배포는 자동으로 구현됩니다.

즉시 (0-2분):

• 0-30초: 에이전트 제어 서비스가 등록 및 시작됩니다.
• 30-60초: 플릿위험에 대한 첫 번째 연결이 설정되었습니다.
• 1～2분: 설정 동기화가 완료되고 호스트/클러스터가 플릿 컨트롤에 나타납니다.

필요한 다음 단계: 에이전트 컨트롤이 설치되고 플릿 컨트롤에 연결된 후, 배포하다 에이전트를 수동으로 구현하여 텔레트리 수집을 시작해야 합니다.

1. 뉴렐릭에 로그인하고 플릿위험으로 이동하세요.
2. 플릿을 선택하고 Entities [엔티티] 테이블에서 호스트/클러스터를 찾으십시오.
3. 플릿 컨트롤을 사용하여 호스트/클러스터에 에이전트(인프라 에이전트, NRDOT 등)를 배포하십시오.
4. 구현하다, 배포하다 에이전트가 시작되고 델메트리를 뉴렐릭으로 보낼 때까지 5-10분 정도 기다립니다.

인증에 대한 참고 사항

뉴럴릭 제어는 시스템 ID를 사용해야 하는데, 이는 서비스와 애플리케이션 간의 인증 및 신뢰 구축에 사용되는 비인간 ID입니다.

에이전트 컨트롤 안내 설치 프로세스 중에, Helm 차트의 값이나 호스트 명령에 포함된 클라이언트 자격 증명을 사용하여 첫 번째 시스템 ID가 생성됩니다. 이 시스템 ID에 대한 자격 증명은 12시간 후에 만료됩니다. 만료되면 에이전트 컨트롤 Helm 차트 배포 또는 호스트 명령이 플릿 컨트롤 서비스에 대한 인증에 실패하여 다음과 같은 오류가 발생합니다:

Error getting system identity auth token. The API endpoint returned 400: Expired client secret.

이 경우, Helm 차트 또는 호스트 명령을 새로운 시스템 ID 자격 증명으로 업데이트해야 합니다.

Helm 차트 예시:

global:
  cluster: "cluster-name"
  licenseKey: "*************************"
agentControlDeployment:
  chartValues:
    systemIdentity:
      organizationId: "00000000-0000-0000-0000-000000000000"
      parentIdentity:
        clientId: "CLIENT_ID"
        clientSecret: "CLIENT_SECRET"
    config:
      fleet_control:
        fleet_id: "SAMPLE_FLEET_ID"
      agents:
        ...

고급 Kubernetes 설정

기본적으로 에이전트 Control Helm 차트는 포함된 Flux CD 인스턴스를 활용하여 Kubernetes에서 에이전트의 수명 주기를 관리합니다. 에코시스템 요구 사항에 따라 기존 사용자 지정 Flux v2 설치를 활용하거나 연속 배포 인프라 구성 요소를 완전히 우회하도록 에이전트 컨트롤을 구성할 수 있습니다.

기존 Flux 설치에 대한 지원

기본적으로 에이전트 Control Helm 차트는 포함된 Flux CD를 활용하여 Kubernetes 에서 에이전트의 수명 주기를 관리합니다. 하지만 조직에서 이미 GitOps에 Flux v2를 사용하고 있다면 기존 설치를 활용하도록 Control을 구성할 수 있습니다.

이 접근 방식은 에이전트 제어를 임베디드 연속 배포 엔진에서 분리하여 에이전트 제어의 관리 기능을 활용하는 동시에 클러스터 작업을 위한 단일 Flux 연결을 유지할 수 있도록 합니다.

요구 사항 및 호환성 에이전트 컨트롤과 함께 외부 Flux 설치를 사용하려면 환경이 다음 요구 사항을 충족해야 합니다. 이러한 사양에서 벗어나는 설정은 검증되지 않습니다.

• Flux 버전: Flux v2 이상.

• 필수 구성 요소: Flux 설치에는 다음이 포함되어야 합니다.

  • Helm 컨트롤러: HelmRelease CRD(helm.toolkit.fluxcd.io/v2)를 사용합니다.
  • 소스 컨트롤러: HelmRepository CRD(source.toolkit.fluxcd.io/v1)를 사용합니다.

• 접착스페이스 범위: Flux 외부는 에이전트 Control이 설치될 접착스페이스를 감시하도록 구성되어야 합니다(또는 모든 접착스페이스를 감시하도록 구성해야 합니다).

설정 이 모드를 활성화하려면 에이전트 컨트롤 Helm 차트 설정에서 번들로 제공되는 Flux 구성 요소를 명시적으로 비활성화해야 합니다.

values.yaml 파일에서 agentControlCd.enabled false 로 설정하세요.

global:
  cluster: "<YOUR_CLUSTER_NAME>"
  licenseKey: "<YOUR_LICENSE_KEY>"

# Disable the embedded Flux instance
agentControlCd:
  enabled: false

agentControlDeployment:
  chartValues:
    # ... other configurations ...

외부 Flux에 대한 권한 자체 Flux 설치를 사용하는 경우, 클러스터의 Flux 서비스 계정은 에이전트 컨트롤에서 생성된 설정을 적용하는 역할을 합니다. 따라서, 기존 Flux 인스턴스에서 뉴렐릭 리소스를 배포하려면 특정 권한이 필요합니다. 아래 접근 방식 중 하나를 적극 권장합니다:

• Cluster 관리자(권장): 가장 간단한 설정은 Flux 인스턴스가 cluster-admin 권한으로 실행되도록 하는 것입니다. 이는 Flux 커뮤니티 차트의 표준 설정이며 뉴렐릭 에이전트에 필요한 모든 필수 리소스(구현, 배포, DaemonSets, 서비스 등)를 관리할 수 있도록 보장합니다.
• 최소 권한 설정: 보안 정책에서 cluster-admin 사용을 제한하는 경우, Flux 서비스 계정에 소스 컨트롤러, Helm 컨트롤러, 컨트롤 및 설치하려는 모든 특정에 필요한 권한이 있는지 확인하기 위해 특정 ClusterRole 생성해야 합니다.

아래는 ClusterRole 예시로, 컨트롤 및 Flux 구성 요소가 상호 운용되는 데 필요한 최소 권한을 보여줍니다.

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: external-flux-agent-control-role
rules:
  # Permissions required by Flux to operate Agent Control components
  - apiGroups: ["apiextensions.k8s.io"]
    resources: ["customresourcedefinitions"]
    verbs: ["get"]
  - apiGroups: ["coordination.k8s.io"]
    resources: ["leases"]
    verbs: ["get", "create", "update"]
  - apiGroups: ["rbac.authorization.k8s.io"]
    resources: ["clusterroles", "rolebindings"]
    verbs: ["get", "create", "delete"]
  - apiGroups: [""]
    resources: ["configmaps"]
    verbs: ["watch"]
  - apiGroups: [""]
    resources: ["events"]
    verbs: ["create", "patch"]
  - apiGroups: [""]
    resources: ["namespaces"]
    verbs: ["create"]
  - apiGroups: [""]
    resources: ["serviceaccounts"]
    verbs: ["get", "create", "delete"]
  - apiGroups: [""]
    resources: ["services"]
    verbs: ["get", "create"]
  - apiGroups: ["apps"]
    resources: ["deployments"]
    verbs: ["create"]
  - apiGroups: ["autoscaling"]
    resources: ["horizontalpodautoscalers"]
    verbs: ["get", "create"]
  - apiGroups: ["batch"]
    resources: ["jobs"]
    verbs: ["get", "list", "watch", "create", "delete"]

  # Permissions required by Agent Control logic
  - apiGroups: ["helm.toolkit.fluxcd.io", "newrelic.com", "source.toolkit.fluxcd.io"]
    resources: ["*"]
    verbs: ["*"]
  - apiGroups: [""]
    resources: ["secrets"]
    verbs: ["*"]
  - apiGroups: [""]
    resources: ["configmaps"]
    verbs: ["get", "list", "create", "patch", "update", "delete", "deletecollection"]
  - apiGroups: [""]
    resources: ["namespaces"]
    verbs: ["get"]
  - apiGroups: ["apps"]
    resources: ["daemonsets", "deployments", "statefulsets"]
    verbs: ["get", "list", "watch"]

지원 범위 외부 Flux 설치를 사용할 때 뉴렐릭 지원은 에이전트 제어 소프트웨어(유효한 설정 매니페스트 생성)로 제한됩니다. 이 모드에서는 다음과 같은 공동 책임 스키마를 고려해야 합니다:

• 뉴렐릭 책임: 에이전트 제어가 뉴렐릭 백앤드와 올바르게 상호작용하고 유효한 HelmRelease 및 HelmRepository 정의를 생성하는지 확인합니다.
• 고객의 책임: 귀하는 자신의 Flux 설치의 상태, 버전 유지 관리, 네트워킹, 문제 해결, 문제 해결에 대한 책임이 있습니다. 외부 Flux 컨트롤러의 설정 또는 오류로 인해 발생하는 문제는 Control 지원 범위에서 제외됩니다.

Flux 없이 에이전트 제어 설치

에이전트 컨트롤의 역할이 관리되는 에이전트를 설치하거나 업그레이드하는 것이 아니라 설정을 전달하는 것으로 제한되는 경우, Flux 없이 에이전트 컨트롤을 설치할 수 있습니다. 이 모드에서 에이전트 컨트롤은 에이전트 수명 주기를 관리할 수 없습니다. 즉, 에이전트를 설치하거나 업그레이드하지 않으며 플릿 컨트롤을 통해 설정만 푸시합니다. 에이전트 컨트롤 및 관리되는 모든 에이전트를 직접 설치하고 업그레이드해야 합니다. 주요 사용 사례는 파이프라인 컨트롤 게이트웨이입니다: 에이전트 컨트롤은 파이프라인 컨트롤 게이트웨이 설정 변경 사항을 전달합니다.

Flux 없이 에이전트 컨트롤을 설치하려면 Helm 값에서 agentControlCd.enabled 을(를) false (으)로 설정하세요. 에이전트 컨트롤은 어떠한 Flux 객체도 생성하거나 모니터하지 않습니다.

global:
  cluster: "<YOUR_CLUSTER_NAME>"
  licenseKey: "<YOUR_LICENSE_KEY>"

agentControlCd:
  enabled: false

agentControlDeployment:
  chartValues:
    # ... other configurations ...

뉴렐릭의 안내 설치를 통해 파이프라인 컨트롤 게이트웨이를 설치할 때, 생성된 values 파일은 이미 agentControlCd.enabled: false을(를) 설정합니다. 수동으로 편집할 필요가 없습니다.

설치 확인

Kubernetes

1. 다음 명령을 실행하여 파드의 상태를 확인하십시오. 에이전트 컨트롤은 보안상의 이유로 다른 네임스페이스에 하위 에이전트를 설치합니다. 모든 것이 제대로 작동하는지 확인하려면 에이전트 컨트롤 파드가 newrelic-agent-control 네임스페이스에서 실행 중이고 하위 에이전트 파드가 newrelic과(와) 같은 다른 네임스페이스에서 실행 중인지 확인하십시오.

$
kubectl get pods -n newrelic-agent-control    # Check Agent Control pods
$
  kubectl get pods -n newrelic                  # Check subagent pods

2. 뉴렐릭에 로그인하고 Fleet Control [플릿위험] 으로 이동하세요.
3. 함대 페이지로 가서 설치 중에 선택한 함대를 선택하세요.
4. 쿠버네 Entities [티스] 클러스터 목록에서 귀하의 쿠버네티스 클러스터가 나타나는지 확인하세요.
5. 클러스터에 대한 측정, 로그 상태가 healthy 인지 확인하세요.

Linux

• newrelic-agent-control 서비스의 상태를 확인하세요:

  bash

  카피

  $
  sudo systemctl status newrelic-agent-control

  서비스가 Failed 또는 Stopped 상태로 표시되면 에이전트가 설치되었지만 정상적인 작동을 방해하는 문제가 있음을 의미합니다. journalctl (또는 이와 유사한 Linux 도구)를 사용하여 에이전트 서비스 로그를 확인하십시오.

  bash

  카피

  $
  journalctl -u newrelic-agent-control

  인사이트를 사용할 수 없는 경우 에이전트를 디버그 모드로 실행하여 자세한 로그에 액세스하여 서비스를 시작할 수 없는 이유에 대해 자세히 알아보세요.

• 서비스가 설치되지 않은 경우 안내 설치의 CLI 설치 명령 끝에 --debug 추가하고 다시 실행해 보세요. 이 기능을 사용하면 설치 스크립트에 대한 자세한 로깅이 활성화되어 오류를 설명하는 추가적인 컨텍스트를 제공할 수 있습니다.

• 선택적으로 문제 해결, 설치 해결을 돕기 위해 로그를 뉴렐릭으로 보내라는 메시지가 표시되면 yes 에 응답하세요. 제출이 완료되면 다음 NRQL 쿼리를 사용하여 로그에 액세스할 수 있습니다.

  SELECT * FROM Log WHERE hostname = `your-host-name`

  카피

윈도우

1. newrelic-agent-control 서비스의 상태를 확인하세요:

   관리자 권한으로 PowerShell을 열고 다음 명령을 실행하세요.

   Get-Service -Name newrelic-agent-control | Format-List Status, StartType

   카피

   정상 상태일 때 예상되는 출력:

   Status    : Running
   StartType : Automatic

   카피

2. 에이전트 제어 상태 엔드포인트를 확인합니다.

   Invoke-WebRequest -Uri "http://localhost:51200/status" -UseBasicParsing

   카피

   정상적인 에이전트 제어는 "healthy": true 이 포함된 JSON 응답을 반환해야 합니다.

3. 뉴렐릭에 로그인하고 Fleet Control [플릿위험] 으로 이동하세요.

4. 함대 페이지로 가서 설치 중에 선택한 함대를 선택하세요.

5. Entities [엔티티] 테이블에서 Windows 호스트가 목록에 나타나는지 확인하십시오.

6. 호스트의 측정 및 계측 상태가 정상 인지 확인하십시오.

에이전트 제어 서비스가 2-3분 이내에 플릿독성에 연결되지 않으면 Windows 호스트 문제 해결, 해결을 참조하세요.

에이전트 제어 제거

Kubernetes

쿠버네티스 클러스터에서 Agent Control을 제거하려면 다음 명령을 실행하세요:

$
helm list --all-namespaces

리눅스 호스트

Linux 호스트에서 에이전트 컨트롤을 제거하려면:

1. 제거 스크립트를 실행하세요:

   bash

   카피

   $
   sudo sh /usr/lib/newrelic-agent-control/uninstall.sh

   이 스크립트는 다음과 같은 작업을 수행합니다.

   • newrelic-agent-control 서비스를 중지하세요
   • 패키지 매니저를 감지하십시오.
   • 시스템에서 모든 에이전트 컨트롤 파일이 제거되도록 패키지 매니저 purge를 실행하십시오.

Windows 호스트

Windows 호스트에서 Agent Control을 제거하려면:

1. 관리자 권한으로 PowerShell을 엽니다.

2. 제거 스크립트를 실행하세요:

   PowerShell.exe -ExecutionPolicy Bypass -File "C:\Program Files\New Relic\newrelic-agent-control\uninstall.ps1"

   카피

   이 스크립트는 다음과 같은 작업을 수행합니다.

   • newrelic-agent-control 서비스를 중지하세요
   • 서비스 등록을 삭제하세요
   • 에이전트 컨트롤 디렉터리와 파일을 삭제하십시오.