Kubernetes에 OpenTelemetry Collector 설치

kube-state-metrics.enabled

부울

kube-state-metrics Helm 차트를

설치할지 여부를 지정합니다. 이 측정값은

infrastructure.enabled

true

로 설정되어 있고 Kube State 지표(KSM) 버전 1.8 이상을 직접 제공하지 않은 경우 필수입니다. KSM 버전 2.0 이상에서는 기본적으로 레이블과 주석이 비활성화되어 있습니다. KSM 설정에서

metricLabelsAllowlist

또는

metricAnnotationsAllowList

옵션을 사용하여 이를 활성화할 수 있습니다.

true

kube-state-metrics.prometheusScrape

부울

Prometheus가 KSM 엔드포인트를 자동으로 검색하는 기능을 비활성화합니다. 이렇게 하면 KSM이 이미 다른 Prometheus 인스턴스에서 모니터링되고 있는 경우 스크랩된 데이터가 중복될 가능성을 방지할 수 있습니다.

false

provider

문자열

귀하의 쿠버네티스 클러스터가 구현되거나 배포되는 cloud 공급업체 또는 환경을 지정합니다. 이 기준은 공급자에 특정한 알려진 설정 제약 조건을 설정합니다. 현재 지원되는 값은 Google Kubernetes Engine Autopilot 클러스터의 경우

"GKE_AUTOPILOT"

이고 Red Hat OpenShift의 경우

"OPEN_SHIFT"

입니다.

"GKE_AUTOPILOT"

image.repository

문자열

OpenTelemetry Collector 에 대한 도커 이미지를 정의합니다. Kubernetes 모니터링에 필요한 요구 사항을 충족하는 경우, 사용자 지정 수집기 이미지를 지정할 수 있습니다.

"newrelic/nrdot-collector-k8s"

image.pullPolicy

문자열

이미지 가져오기 정책을 결정합니다. 기본값은

IfNotPresent

이며, 이는 이미지가 이미 로컬에 존재하는 경우 이미지 가져오기를 건너뛴다는 의미입니다. 이 매개변수가 특정 값 없이 정의된 경우 기본값은

Always

입니다.

"IfNotPresent"

image.tag

문자열

기본 이미지 태그를 재정의합니다. 기본적으로 태그는 차트의

appVersion

으로 설정됩니다. 이 매개변수를 사용하여 수집기 이미지의 특정 버전을 지정합니다.

"1.1.0"

cluster

문자열

쿠버네티스 클러스터의 이름을 모니터로 정의합니다. 이는 필수 참가자입니다.

global.cluster

사용하여 구성할 수도 있습니다.

"my-eks-cluster"

licenseKey

문자열

인증을 위한 블루 클러스터 키를 지정합니다. 이는 필수 참가자입니다.

global.licenseKey

사용하여 구성할 수도 있습니다.

"NRAL-ABCDEFGHIJKLMN"

customSecretName

문자열

뉴렐릭 클러스터 키를 보유하는 사용자가 생성한 Kubernetes 비밀의 이름을 지정합니다. 라이선스 키를

values.yaml

파일에 직접 포함하지 않으려면 이 옵션을 사용하십시오.

global.customSecretName

사용하여 구성할 수도 있습니다.

"my-nr-license-secret"

customSecretLicenseKey

문자열

라이선스 키가 있는 Kubernetes Secret (

customSecretName

에 정의됨) 내의 키를 지정합니다. 시크릿에서 라이선스 키를 얻을 때 이 옵션을 사용하십시오.

global.customSecretLicenseKey

사용하여 구성할 수도 있습니다.

"licenseKey"

proxy

문자열

지정된 HTTP/HTTPS 프록시를 통해 모든 텔리메트리 데이터를 보내도록 OpenTelemetry Collector 멤버(Daemonset 및 구현, 배포 모두)를 구성합니다.

"http://your-proxy.example.com:3128"

podLabels

지도(핵심 가치)

모든 차트에 추가할 레이블을 지정합니다. 이러한 레이블은 Kubernetes 리소스를 구성하고 선택하는 데 사용할 수 있습니다.

{app.kubernetes.io/component: "otel-collector"}

labels

지도(핵심 가치)

차트에서 생성되는 모든 Kubernetes 객체에 추가할 레이블을 지정합니다. 이러한 명칭은 구현, 배포, 서비스 및 기타 리소스에 광범위하게 적용됩니다.

{environment: "production"}

priorityClassName

문자열

차트별로 모든 파드 구현하다, 배포하다에 대한

priorityClassName

를 설정합니다. 이는 파드의 스케줄링 우선순위를 제어합니다.

global.priorityClassName

사용하여 구성할 수도 있습니다.

"system-cluster-critical"

dnsConfig

지도(핵심 가치)

차트별로 모든 파드 구현하다, 배포하다에 대한

dnsConfig

를 설정합니다. 이를 통해 파드에 대한 사용자 지정 DNS 설정을 할 수 있습니다.

global.dnsConfig

사용하여 구성할 수도 있습니다.

{nameservers: ["8.8.8.8"]}

daemonset.nodeSelector

지도(핵심 가치)

Daemonset 파드에 대한 노드 선택기를 설정하여 어떤 노드에서 스케줄링될지 제어합니다. 이 모델은 전역 노드 선택기를 재정의합니다.

{kubernetes.io/os: "linux"}

daemonset.tolerations

목록

Daemonset 파드에 대한 허용 범위를 지정하여 일치하는 테인트를 가진 노드에 스케줄링할 수 있도록 합니다. 이 조치는 전역 허용 범위를 무시합니다.

[{key: "node-role.kubernetes.io/master", effect: "NoSchedule"}]

daemonset.affinity

지도(핵심 가치)

Daemonset 파드에 대한 선호도를 구성하여 노드 또는 파드 레이블을 기반으로 스케줄링에 영향을 줍니다. 이 조치는 전역 친화도를 재정의합니다.

{nodeAffinity: {requiredDuringSchedulingIgnoredDuringExecution: {nodeSelectorTerms: [{matchExpressions: [{key: "disktype", operator: "In", values: ["ssd"]}]}]}}}

daemonset.podAnnotations

지도(핵심 가치)

Daemonset 파드에 추가할 주석을 지정합니다.

{prometheus.io/scrape: "true"}

daemonset.podSecurityContext

지도(핵심 가치)

Daemonset에 대한 파드 레벨의 보안 컨텍스트를 설정합니다. 이 평가자는 전역 패드 보안 컨텍스트를 재정의합니다.

{runAsUser: 1000}

daemonset.containerSecurityContext

지도(핵심 가치)

DaemonSet의 컨테이너 수준에서 보안 컨텍스트를 설정합니다. 이 파라미터는 전역 컨테이너 보안 컨텍스트를 재정의합니다. 이 차트의 기본값은

privileged: false

입니다.

{privileged: false}

daemonset.resources

지도(핵심 가치)

Daemonset 컨테이너에 대한 컴퓨트 리소스(CPU 및 메모리 requests 및 제한)를 정의합니다.

{limits: {cpu: "500m", memory: "512Mi"}, requests: {cpu: "200m", memory: "256Mi"}}

daemonset.envs

목록

Daemonset 컨테이너에 설정할 추가 환경 변수를 지정합니다.

[{name: "DEBUG_MODE", value: "true"}]

daemonset.envsFrom

목록

Daemonset 컨테이너에 대한 추가 환경 변수 소스를 지정합니다. 일반적으로 Secrets 또는 ConfigMaps에서 가져옵니다.

[{secretRef: {name: "my-daemonset-secret"}}]

daemonset.configMap.overrideConfig

지도(핵심 가치)

Daemonset에 대한 완벽한 OpenTelemetry 설정을 제공합니다. 설정된 경우, 이 매개변수는 기본 설정을 무시하고 Daemonset에 특정한 다른 설정 매개변수를 비활성화합니다.

receivers: {hostmetrics: {collection_interval: 30s}}

daemonset.configMap.extraConfig

지도(핵심 가치)

Daemonset에 대한 추가 OpenTelemetry 설정을 지정합니다. 이 매개변수가 설정되면 기본 설정에 수신자, 처리자, 내보내기 장치, 연결자 또는 파이프라인을 추가하여 설정을 확장합니다.

receivers: {custom_receiver: {}}

deployment.nodeSelector

지도(핵심 가치)

구현 및 배포 파드에 대한 노드 선택기를 설정하여 해당 작업이 어떤 노드에서 실행될지 제어합니다. 이 모델은 전역 노드 선택기를 재정의합니다.

{kubernetes.io/hostname: "control-plane-node"}

deployment.tolerations

목록

구현 및 배포 파드에 대한 허용 오차를 지정하여 일치하는 테인트가 있는 노드에 스케줄링할 수 있도록 합니다. 이 조치는 전역 허용 범위를 무시합니다.

[{key: "CriticalAddonsOnly", operator: "Exists"}]

deployment.affinity

지도(핵심 가치)

구현, 배포 파드에 대한 유사성을 구성하여 노드 또는 파드 레이블을 기반으로 일정에 영향을 줍니다. 이 조치는 전역 친화도를 재정의합니다.

{podAntiAffinity: {requiredDuringSchedulingIgnoredDuringExecution: [{labelSelector: {matchLabels: {app: "my-app"}}, topologyKey: "kubernetes.io/hostname"}]}}

deployment.podAnnotations

지도(핵심 가치)

구현, 배포 파드에 추가할 추가 주석을 지정합니다.

{sidecar.istio.io/inject: "false"}

deployment.podSecurityContext

지도(핵심 가치)

구현, 배포에 대한 파드 수준에서 보안 컨텍스트를 설정합니다. 이 평가자는 전역 패드 보안 컨텍스트를 재정의합니다.

{fsGroup: 2000}

deployment.containerSecurityContext

지도(핵심 가치)

구현, 배포에 대한 컨테이너 수준에서 보안 컨텍스트를 설정합니다. 이 검증자는 전역 보안 컨텍스트를 재정의합니다.

{runAsNonRoot: true}

deployment.resources

지도(핵심 가치)

구현, 배포 컨테이너에 대한 컴퓨트 리소스(CPU 및 메모리 requests 및 제한)를 정의합니다.

{limits: {cpu: "200m", memory: "256Mi"}, requests: {cpu: "100m", memory: "128Mi"}}

deployment.envs

목록

구현 컨테이너에 대해 설정할 추가 환경 변수를 지정합니다.

[{name: "ENV_VAR", value: "some_value"}]

deployment.envsFrom

목록

일반적으로 Secrets 또는 ConfigMaps에서 구현, 배포 컨테이너에 대한 추가 환경 변수 소스를 지정합니다.

[{configMapRef: {name: "my-deployment-config"}}]

deployment.configMap.overrideConfig

지도(핵심 가치)

구현, 배포에 대한 완전한 OpenTelemetry 설정을 제공합니다. 설정된 경우, 이 템플릿은 기본 설정을 재정의하고 구현에 특정한 다른 설정 모델을 비활성화합니다.

receivers: {k8s_events: {collection_interval: 5s}}

deployment.configMap.extraConfig

지도(핵심 가치)

구현, 배포에 대한 추가 OpenTelemetry 설정을 지정합니다. 이 매개변수가 설정되면 기본 설정에 수신자, 처리자, 내보내기 장치, 연결자 또는 파이프라인을 추가하여 설정을 확장합니다.

exporters: {log: {verbosity: "detailed"}}

nodeSelector

지도(핵심 가치)

Daemonset과 구현 모두에 영향을 미치는 모든 파드 구현하다, 배포하다에 대한 노드 선택기를 차트로 설정합니다. 이 매개변수는

global.nodeSelector

사용하여 구성할 수도 있습니다.

{disktype: "ssd"}

tolerations

목록

차트에 따라 모든 파드 구현하다, 배포하다에 대한 허용 오차를 설정하여 일치하는 테인트가 있는 노드에 스케줄링할 수 있도록 합니다. 이 매개변수는

global.tolerations

사용하여 구성할 수도 있습니다.

[{key: "taint-key", operator: "Exists", effect: "NoSchedule"}]

affinity

지도(핵심 가치)

차트를 통해 모든 파드 구현하다, 배포하다에 대한 친화도를 구성하여 노드 또는 파드 레이블을 기반으로 스케줄링에 영향을 줍니다. 이 매개변수는

global.affinity

사용하여 구성할 수도 있습니다.

{podAffinity: {requiredDuringSchedulingIgnoredDuringExecution: [{labelSelector: {matchLabels: {app: "otel-collector"}}, topologyKey: "kubernetes.io/hostname"}]}}

podSecurityContext

지도(핵심 가치)

모든 파드 구현하다, 배포하다에 대해 파드 수준에서 보안 컨텍스트를 차트별로 설정합니다. 이 매개변수는

global.securityContext.pod

사용하여 구성할 수도 있습니다.

{runAsGroup: 3000}

containerSecurityContext

지도(핵심 가치)

파드 구현하다, 배포하다의 모든 컨테이너에 대해 컨테이너 수준에서 차트별로 보안 컨텍스트를 설정합니다. 이 매개변수는

global.securityContext.container

사용하여 구성할 수도 있습니다.

{allowPrivilegeEscalation: false}

rbac.create

부울

Helm 차트를 사용하여 서비스 계정, 역할 및 역할 바인딩과 같은 역할 기반 액세스 제어(RBAC) 리소스를 생성할지 여부를 지정합니다.

true

또는

false

serviceAccount.create

부울

수집기 파드에 대해 Kubernetes ServiceAccount를 생성할지 여부를 지정합니다.

true

으로 설정되고

serviceAccount.name

지정되지 않은 경우 전체 이름 템플릿을 사용하여 이름이 생성됩니다.

true

또는

false

serviceAccount.name

문자열

ServiceAccount에 대한 사용자 지정 이름을 지정합니다. 설정되지 않았고

serviceAccount.create

이

true

인 경우 차트에서 이름을 생성합니다.

"my-otel-sa"

serviceAccount.annotations

지도(핵심 가치)

생성된 ServiceAccount에 추가할 주석을 지정합니다.

{eks.amazonaws.com/role-arn: "arn:aws:iam::123456789012:role/MyEKSFargateRole"}

verboseLog

부울

이 통합에 대한 디버그 수준 로깅을 활성화합니다.

global.verboseLog

을 사용하여 전역적으로 설정하면 모든 통합에 대한 디버그 로그가 활성화됩니다.

true

또는

false

nrStaging

부울

수집기에게 모든 데이터를 뉴렐릭 스테이징 백앤드로 보내도록 지시합니다. 이 옵션을 사용하려면 유효한 스테이징 라이선스 키가 필요합니다. 이 매개변수는

global.nrStaging

사용하여 구성할 수도 있습니다.

true

또는

false

receivers.prometheus.enabled

부울

prometheus

수신기의 데이터 수집 활성화 여부를 지정합니다.

true

또는

false

receivers.prometheus.scrapeInterval

문자열

prometheus

수신기에 대한 스크래핑 간격을 설정하여 메트릭이 수집되는 빈도를 결정합니다.

1m

receivers.k8sEvents.enabled

부울

k8sEvents

수신기가 Kubernetes 이벤트를 수집하도록 활성화할지 여부를 지정합니다.

true

또는

false

receivers.hostmetrics.enabled

부울

hostmetrics

수신기가 호스트 수준 메트릭 수집을 위해 활성화되어 있는지 여부를 지정합니다.

true

또는

false

receivers.hostmetrics.scrapeInterval

문자열

hostmetrics

수신기에 대한 스크래핑 간격을 설정합니다.

1m

receivers.kubeletstats.enabled

부울

Kubelet에서 메트릭을 수집하기 위해

kubeletstats

수신기가 활성화되었는지 여부를 지정합니다.

true

또는

false

receivers.kubeletstats.scrapeInterval

문자열

kubeletstats

수신기에 대한 스크래핑 간격을 설정합니다.

1m

receivers.filelog.enabled

부울

파일(일반적으로 컨테이너 로그)에서 로그를 수집하기 위해

filelog

수신기가 활성화되었는지 여부를 지정합니다.

true

또는

false

lowDataMode

부울

뉴렐릭 Kubernetes 사용자 인터페이스를 밝히는 데 필요한 필수 지표만 전송하는 모드를 활성화합니다. 이는 데이터 수집량을 줄이는 데 도움이 됩니다.

true

또는

false