구성 | New Relic Documentation

시사

이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다!

이 기능은 현재 출시 전 정책 에 따라 미리보기 프로그램의 일부로 제공됩니다.

전통적으로 뉴렐릭 에이전트 설정을 정의했던 values-newrelic.yaml 파일에는 이제 에이전트 제어에 대한 설정도 포함되어 있습니다. 이 파일에서 정의한 지표는 에이전트 제어와 해당 관리 에이전트의 작동 방식을 결정합니다. 이 파일은 로컬 설정 이라고 합니다.

다음은 설정의 예입니다.

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"
  userKey: "YOUR_USER_KEY"

# Values related to the agent control's Helm chart release.
# `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control/values.yaml`
agent-control-deployment:
  identityClientId: ""
  identityClientSecret: ""
  config:
    fleet_control:
      # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
      fleet_id: ""
      auth:
        # New Relic organization ID where agent will connect to.
        organizationId: "YOUR_ORGANIZATION_ID"

    # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
    subAgents:
      infrastructure:
        type: newrelic/com.newrelic.infrastructure:0.1.0
        content:
          # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/nri-bundle`
          # Recommended: check and define an explicit chart version (latest stable)
          chart_version: "*"
          chart_values:
            newrelic-infrastructure:
            enableProcessMetrics: true
      logs:
        type: newrelic/io.fluentbit:0.1.0
        content:
          # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging`
          # Recommended: check and define an explicit chart version (latest stable)
          chart_version: "*"
          chart_values:
            newrelic-logging:
              sendMetrics: true
      agent-operator:
        type: com.newrelic.k8s_agent_operator:0.1.0
        content:
          chart_version: "*"

이 샘플은 두 가지 관리 에이전트( Kubernetes 에이전트 에이전트 및 포워딩용 Fluent Bit 와 함께 에이전트 제어를 구성하는 방법을 보여줍니다. 예를 들어 Fluent Bit 로그 수집기에 대한 상태 지표를 보내지 않으려면 설치 명령을 실행하기 전에 YAML 파일에서 sendMetrics: false 설정하기만 하면 됩니다.

클러스터 전체에 구성을 중앙에서 배포하려면 Fleet Control의 Configurations [구성] 섹션에서 동일한 YAML 콘텐츠를 정의합니다.그런 다음 원격 구현, 배포의 일부로 클러스터의 전체 집합에 설정을 적용할 수 있습니다. 이것을 원격 설정 파일이라고 합니다.

원격 설정을 사용하면 환경 전반에서 일관된 에이전트 동작이 보장되고, 변경 관리가 간소화되며, 로컬 YAML 파일을 수동으로 관리하지 않고도 옵저버빌리티를 확장할 수 있습니다.

에이전트 Control은 Kubernetes ConfigMaps 를 사용하여 설정 설정을 저장하고 적용합니다. 로컬 및 원격 설정이 모두 있는 경우 기본적으로 원격 설정이 우선합니다. 의도적으로 원격 설정을 무시하고 로컬 설정으로 돌아가려면 플릿 취소를 통해 빈 원격 설정을 구현하거나 배포할 수 있습니다. 이 변경 사항은 선택한 함대의 모든 클러스터 에 적용됩니다.

사용 가능한 모든 구성 설정을 살펴보려면 values-newrelic.yaml 을 참조하세요.

샘플 설정

다음 예는 다양한 에이전트 세트를 관리하기 위해 에이전트 제어를 구성하는 방법을 보여줍니다. 이 설정은 초기 설치 중이나 플릿위험의 원격 설정의 일부로 사용될 수 있습니다.

뉴렐릭 Infrastructure and Fluent Bit

이 예시에서는 배포하다 에이전트 제어를 부하 모니터링 및 Fluent Bit 통해 생성 수집에 사용합니다.

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"
  userKey: "YOUR_USER_KEY"

# See `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control/values.yaml`
agent-control-deployment:
  identityClientId: ""
  identityClientSecret: ""
  config:
    fleet_control:
      # Optional
      # fleet_id: YOUR_FLEET_ENTITY_GUID
      auth:
        organizationId: "YOUR_ORGANIZATION_ID"
    subAgents:
      infrastructure:
        type: newrelic/com.newrelic.infrastructure:0.1.0
        content:
          # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/nri-bundle`
          # Recommended: check and define an explicit chart version (latest stable)
          chart_version: "*"

          #chart_values:
          #  newrelic-infrastructure:
          #    enableProcessMetrics: true
      logs:
        type: newrelic/io.fluentbit:0.1.0
        content:
          # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging`
          # Recommended: check and define an explicit chart version (latest stable)
          chart_version: "*"

          #chart_values:
          #  newrelic-logging:
          #    sendMetrics: true
      agent-operator:
        type: com.newrelic.k8s_agent_operator:0.1.0
        chart_version: "*"

사용자 정의 수집기 설정을 갖춘 OpenTelemetry

이 예제는 OpenTelemetry (NRDOT) 수집기의 뉴렐릭 분포를 사용하여 배포하다 에이전트 제어를 수행하고 관리되는 nr-k8s-otel-collector Helm 차트 에서 filelog 수신기를 비활성화합니다.

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"
# Values related to the agent control's Helm chart release.
# `https://github.com/newrelic/helm-charts/blob/master/charts/agent-control/values.yaml`
agent-control-deployment:
  identityClientId: ""
  identityClientSecret: ""
  config:
    fleet_control:
      # Optional: Specify a fleet_id (entity guid) to automatically connect to an existing fleet.
      fleet_id: ""
      auth:
        # New Relic organization ID where agent will connect to.
        organizationId: "YOUR_ORGANIZATION_ID"

    # List of managed agents that will be deployed. The key represents the name of the agent and the value holds the configuration.
    subAgents:
      infrastructure:
        type: newrelic/com.newrelic.infrastructure:0.1.0
        content:
          # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/nri-bundle%60
          # Recommended: check and define an explicit chart version (latest stable)
          chart_version: "*"
      agent-operator:
        type: newrelic/com.newrelic.k8s_agent_operator:0.1.0
        content:
          chart_version: "*"
      fluentbit:
        type: newrelic/io.fluentbit:0.1.0
        content:
          # Ref: `https://github.com/newrelic/helm-charts/tree/master/charts/newrelic-logging`
          # Recommended: check and define an explicit chart version (latest stable)
          chart_version: "*"
          chart_values:
            global:
              lowDataMode: true
      prometheus:
        type: newrelic/com.newrelic.prometheus:0.1.0
        content:
          chart_version: "*"
          chart_values:
            global:
              lowDataMode: true
            newrelic-prometheus-agent:
              config:
                kubernetes:
                  integrations_filter:
                    enabled: false

원격 설정: 뉴렐릭 인프라

이 예에서는 플릿 위험을 사용하여 Kubernetes 용 뉴렐릭 인프라 에이전트를 원격으로 구성하는 방법을 보여줍니다. enableProcessMetrics: true 설정하여 프로세스 메트릭 수집을 활성화합니다.

원격 설정: Fluent Bit

이 예에서는 플로릿 위험을 통해 원격으로 Fluent Bit 구성했습니다. sendMetrics: true 설정하여 로그 수집기에서 상태 지표 보고를 활성화합니다.

원격 설정: Prometheus

이 예에서는 플릿위험을 사용하여 원격으로 Prometheus 에이전트를 구성합니다. low-data mode 사용하여 Telmetri 볼륨을 줄이고 기본 통합을 비활성화할 수 있습니다.

원격 설정: OpenTelemetry

중요

Kubernetes 비밀번호를 생성하여 Newrelrik 라이선스 키를 안전하게 저장하고 licenseKey 값을 대체하여 chart_values 에서 사용합니다.

customSecretName: "your-secret-name"
customSecretLicenseKey: "your-secret-key"

플릿 전체에 걸쳐 구현하다, 배포하다 OpenTelemetry 설정을 정의하고 구현하려면 플릿 컨트롤을 사용하는 것이 좋습니다. OpenTelemetry 원격으로 구성하려면 아래 표시된 구조를 사용하여 플릿 확률에서 설정을 만듭니다. lowDataMode 또는 receivers.filelog.enabled 과 같은 값을 조정하고 필요에 따라 다른 관련 Helm 차트 설정을 포함할 수 있습니다.

chart_version: "*"
chart_values:
  newrelic-prometheus-agent:
    lowDataMode: true

프록시 구성

에이전트 Control은 기업 프록시 또는 네트워크 중개자를 통해 트래픽을 라우팅하기 위한 프록시 설정을 지원합니다. 프록시 구성은 환경 변수를 통해 설정하거나 구성 파일에서 직접 설정할 수 있습니다.

프록시 우선순위

에이전트 제어는 다음 우선순위에 따라 프록시 설정을 사용합니다.

proxy 에이전트 Control 설정의 설정 필드
HTTP_PROXY 환경 변수
HTTPS_PROXY 환경 변수

중요

프록시 설정은 현재 서명 검증을 위한 인증서 가져오기와 호환되지 않습니다. 프록시를 설정해야 하는 경우 다음 옵션을 사용할 수 있습니다.

해당 EndPoint에 대한 requests 프록시를 건너뛸 수 있도록 https://newrelic.com 에 예외를 추가합니다(권장).
fleet_control.signature_validation.certificate_pem_file_path 통해 로컬 인증서를 사용합니다(인증서 순환은 수동으로 처리해야 함)
fleet_control.signature_validation.enabled: false 설정하여 서명 유효성 검사를 비활성화합니다(보안상의 이유로 권장하지 않음)

자체 서명 인증서를 사용한 프록시 설정

자체 서명 인증서를 사용하여 HTTPS 인증을 사용하는 프록시 설정의 경우 CA 인증서 번들을 제공하고 프록시 인증을 구성해야 합니다.

global:
  cluster: "YOUR_CLUSTER_NAME"
  licenseKey: "YOUR_LICENSE_KEY"

agent-control-deployment:
  config:
    agentControl:
      content:
        proxy:
          url: https://proxy-service:8080
    subAgents: {}

  # Mount CA certificate bundle to Agent Control
  extraVolumeMounts:
    - mountPath: /etc/ssl/certs/
      name: ca-certs
  extraVolumes:
    - name: ca-certs
      secret:
        secretName: ca-certs

# Configure Flux components to use proxy
flux2:
  sourceController:
    extraEnv:
      # Configure Flux source-controller to proxy all requests
      - name: HTTPS_PROXY
        value: https://proxy-service:8080
      # Except for in-cluster requests
      - name: "NO_PROXY"
        value: ".cluster.local.,.cluster.local,cluster.local,.svc,127.0.0.0/8,10.0.0.0/8"
    volumeMounts:
      # Mount CA certificate bundle to source-controller trust root store. The bundle should contain the
      # proxy CA cert.
      - mountPath: /etc/ssl/certs/
        name: ca-certs
    volumes:
        - name: ca-certs
          secret:
            secretName: ca-certs

관리형 에이전트에 대한 프록시 설정

주의

에이전트 제어에서 프록시를 구성하면 관리하는 에이전트에 대해 동일한 프록시 설정이 자동으로 구성되지 않습니다 . 각 에이전트에는 해당 에이전트의 특정 설정 형식 및 요구 사항에 따라 별도로 설정해야 하는 자체 프록시 설정이 있습니다.

프록시를 사용하는 경우 각 관리 에이전트에 대한 프록시 설정도 개별적으로 구성해야 합니다. 프록시 설정 옵션은 각 에이전트의 특정 문서를 참조하세요.

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

구성

시사

에이전트 Control 설정

샘플 설정

뉴렐릭 Infrastructure and Fluent Bit

인프라 및 Fluent Bit에 대한 로컬 구성

사용자 정의 수집기 설정을 갖춘 OpenTelemetry

OpenTelemetry 설정

원격 설정: 뉴렐릭 인프라

원격 설정

원격 설정: Fluent Bit

Fluent Bit 설정

원격 설정: Prometheus

프로메테우스 설정

원격 설정: OpenTelemetry

프로메테우스 설정

중요

프록시 구성

프록시 우선순위

중요

자체 서명 인증서를 사용한 프록시 설정

Kubernetes 프록시 설정 예시

관리형 에이전트에 대한 프록시 설정

주의

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

구성

시사

샘플 설정.css-21sua1{background:none;border:none;width:0;padding:0;}

뉴렐릭 Infrastructure and Fluent Bit

인프라 및 Fluent Bit에 대한 로컬 구성

사용자 정의 수집기 설정을 갖춘 OpenTelemetry

OpenTelemetry 설정

원격 설정: 뉴렐릭 인프라

원격 설정

원격 설정: Fluent Bit

Fluent Bit 설정

원격 설정: Prometheus

프로메테우스 설정

원격 설정: OpenTelemetry

프로메테우스 설정

프록시 구성

프록시 우선순위

중요

자체 서명 인증서를 사용한 프록시 설정

Kubernetes 프록시 설정 예시

관리형 에이전트에 대한 프록시 설정

주의

샘플 설정