개요 | New Relic Documentation

Kubernetes 통합 버전 2에는 버전 3과 몇 가지 다른 설정 및 요구 사항이 있습니다. 이 문서에서는 버전 3과 다른 설정과 버전 2에 필요한 설정에 대해 설명합니다. 다르게 지정하지 않으면 버전 3의 설정을 사용할 수 있습니다.

주의

우리는 버전 2를 대체했으며 이를 사용해서는 안 된다는 점을 명심하세요. 우리는 여전히 버전 2를 사용하고 있는 사용자를 위해 이 문서를 유지 관리합니다.

현재 버전의 Kubernetes를 시작하려면 Kubernetes 통합 소개를 참조하세요.

버전 3 변경 사항을 이해하려면 Kubernetes 통합 버전 3 문서에 도입된 변경 사항을 참조하세요.

통합 버전 2로 제어 영역 모니터링

이 섹션에서는 통합 버전 2 이하에서 컨트롤 플레인 모니터링을 구성하는 방법을 다룹니다.

이러한 버전에는 유연성이 떨어지는 자동 검색 옵션이 있으며 외부 엔드포인트를 지원하지 않습니다. 최대한 빨리 버전 3 으로 업데이트하는 것이 좋습니다.

자동 검색 및 기본 설정: `hostNetwork` 및 `privileged`

v3 미만 버전에서 통합이 privileged: false 을 사용하여 배포되면 제어 영역 구성요소에 대한 hostNetwork 설정도 false 로 설정됩니다.

마스터 노드 및 제어 평면 구성 요소 검색

Kubernetes 통합은 kubeadm 라벨 지정 규칙을 사용하여 마스터 노드와 제어 영역 구성요소를 검색합니다. 이는 마스터 노드에 node-role.kubernetes.io/master="" 또는 kubernetes.io/role="master" 라벨이 지정되어야 함을 의미합니다.

제어 영역 구성요소에는 k8s-app 또는 tier 및 component 라벨이 있어야 합니다. 허용되는 라벨 조합 및 값은 다음 표를 참조하세요.

요소	상표	끝점
API 서버	Kubeadm / Kops / ClusterAPI `k8s-app=kube-apiserver` `tier=control-plane component=kube-apiserver` OpenShift `app=openshift-kube-apiserver apiserver=true`	`localhost:443/metrics` 기본적으로(구성 가능) 요청이 실패하면 `localhost:8080/metrics`
등	Kubeadm / Kops / ClusterAPI `k8s-app=etcd-manager-main` `tier=control-plane component=etcd` OpenShift `k8s-app=etcd`	`localhost:4001/metrics`
스케줄러	Kubeadm / Kops / ClusterAPI `k8s-app=kube-scheduler` `tier=control-plane component=kube-scheduler` OpenShift `app=openshift-kube-scheduler scheduler=true`	`localhost:10251/metrics`
컨트롤러 관리자	Kubeadm / Kops / ClusterAPI `k8s-app=kube-controller-manager` `tier=control-plane component=kube-controller-manager` OpenShift `app=kube-controller-manager kube-controller-manager=true`	`localhost:10252/metrics`

통합이 마스터 노드 내에서 실행 중임을 감지하면 위 표에 나열된 레이블과 일치하는 패드를 찾아서 노드에서 실행 중인 구성 요소를 찾으려고 합니다. 실행 중인 모든 구성 요소에 대해 통합은 해당 메트릭 엔드포인트에 요청을 보냅니다.

구성

제어 평면 모니터링은 마스터 노드 내부에서 실행되는 에이전트에 대해 자동입니다. 클라이언트 요청에 대해 상호 TLS 인증(mTLS)을 사용하기 때문에 실행하기 위해 추가 단계가 필요한 유일한 구성 요소는 etcd입니다. API 서버는 보안 포트 를 사용하여 쿼리하도록 구성할 수도 있습니다.

중요

OpenShift 4.x에 대한 제어 평면 모니터링에는 추가 구성이 필요합니다. 자세한 내용은 OpenShift 4.x 구성 섹션을 참조하십시오.

등

etcd 쿼리를 위해 mTLS를 설정하려면 다음 두 가지 구성 옵션을 설정해야 합니다.

옵션	값
`ETCD_TLS_SECRET_NAME`	mTLS 구성을 포함하는 Kubernetes 시크릿의 이름입니다. 비밀에는 다음 키가 포함되어야 합니다. `cert`: 요청하는 클라이언트를 식별하는 인증서입니다. etcd의 신뢰할 수 있는 CA에서 서명해야 합니다. `key`: 클라이언트 인증서를 생성하는 데 사용되는 개인 키입니다. `cacert`: etcd 서버 인증서를 식별하는 데 사용되는 루트 CA입니다. `ETCD_TLS_SECRET_NAME` 옵션이 설정되어 있지 않으면 etcd 측정항목을 가져오지 않습니다.
`ETCD_TLS_SECRET_NAMESPACE`	`ETCD_TLS_SECRET_NAME` 에 지정된 보안 비밀이 생성된 네임스페이스입니다. 설정하지 않으면 `default` 네임스페이스가 사용됩니다.

옵션

값

ETCD_TLS_SECRET_NAME

mTLS 구성을 포함하는 Kubernetes 시크릿의 이름입니다.

비밀에는 다음 키가 포함되어야 합니다.

cert: 요청하는 클라이언트를 식별하는 인증서입니다. etcd의 신뢰할 수 있는 CA에서 서명해야 합니다.
key: 클라이언트 인증서를 생성하는 데 사용되는 개인 키입니다.
cacert: etcd 서버 인증서를 식별하는 데 사용되는 루트 CA입니다.
ETCD_TLS_SECRET_NAME 옵션이 설정되어 있지 않으면 etcd 측정항목을 가져오지 않습니다.

ETCD_TLS_SECRET_NAMESPACE

ETCD_TLS_SECRET_NAME 에 지정된 보안 비밀이 생성된 네임스페이스입니다. 설정하지 않으면 default 네임스페이스가 사용됩니다.

API 서버

기본적으로 API 서버 측정항목은 보안되지 않은 localhost:8080 엔드포인트를 사용하여 쿼리됩니다. 이 포트가 비활성화된 경우 보안 포트를 통해 이러한 메트릭을 쿼리할 수도 있습니다. 이를 활성화하려면 Kubernetes 통합 매니페스트 파일에서 다음 구성 옵션을 설정하십시오.

옵션	값
`API_SERVER_ENDPOINT_URL`	메트릭을 쿼리하기 위한 (보안) URL입니다. API 서버는 기본적으로 `localhost:443` 을 사용합니다. `ClusterRole` 이 매니페스트에서 찾은 최신 버전으로 업데이트되었는지 확인합니다. 버전 1.15.0에 추가됨

옵션

값

API_SERVER_ENDPOINT_URL

메트릭을 쿼리하기 위한 (보안) URL입니다. API 서버는 기본적으로 localhost:443 을 사용합니다.

ClusterRole 이 매니페스트에서 찾은 최신 버전으로 업데이트되었는지 확인합니다.

버전 1.15.0에 추가됨

중요

API 서버에서 사용하는 보안 포트에 따라 포트가 다를 수 있습니다.

예를 들어 Minikube에서 API 서버 보안 포트는 8443이므로 API_SERVER_ENDPOINT_URL 를 다음으로 설정해야 합니다. https://localhost:8443

오픈시프트 구성

OpenShift 4.x의 제어 플레인 구성 요소는 SSL 및 서비스 계정 기반 인증이 필요한 엔드포인트 URL을 사용합니다. 따라서 기본 Leavepoint URL을 사용할 수 없습니다.

중요

Helm을 통해 openshift 을 설치할 때 이러한 엔드포인트를 자동으로 포함하도록 구성을 지정합니다. openshift.enabled=true 및 openshift.version="4.x" 를 설정하면 보안 엔드포인트가 포함되고 /var/run/crio.sock 런타임이 활성화됩니다.

OpenShift에서 제어 플레인 모니터링을 구성하려면 사용자 정의된 매니페스트 에서 다음 환경 변수의 주석 처리를 제거하세요. URL 값은 OpenShift 4.x의 제어 플레인 모니터링 메트릭 엔드포인트에 대한 기본 기본 URL로 사전 구성되어 있습니다.

- name: "SCHEDULER_ENDPOINT_URL"
        value: "https://localhost:10259
        - name: "ETCD_ENDPOINT_URL"
        value: "https://localhost:9979"
        - name: "CONTROLLER_MANAGER_ENDPOINT_URL"
        value: "https://localhost:10257"
        - name: "API_SERVER_ENDPOINT_URL"
        value: "https://localhost:6443"

중요

사용자 정의 ETCD_ENDPOINT_URL 이 정의되었더라도 etcd를 구성하려면 HTTPS 및 mTLS 인증이 필요합니다. OpenShift에서 etcd에 대한 mTLS를 구성하는 방법에 대한 자세한 내용은 OpenShift에서 etcd에 대한 mTLS 설정을 참조하세요.

쿠버네티스 로그

자세한 로그를 생성하고 버전 및 설정 정보를 얻으려면 아래 정보를 확인하세요.

Kubernetes 통합의 경우, 서비스 에이전트는 오류 발생 시에만 로그인 항목을 추가합니다. 가장 일반적인 오류는 표준(상세하지 않은) 로그에 표시됩니다. 직접적으로 또는 블루렐릭 지원팀을 통해 보다 심층적인 조사를 수행하는 경우 자세한 정보 표시 모드를 활성화할 수 있습니다.

주의

Verbose 모드에서는 로그 파일로 전송되는 정보의 양이 크게 늘어납니다. 문제 해결 목적으로만 이 모드를 일시적으로 활성화하고 완료되면 로그 수준을 재설정하십시오.

매니페스트 파일을 사용하여 자세한 로깅을 활성화하려면 다음 안내를 따르세요.

자세한 로깅 활성화: 배포 파일에서 NRIA_VERBOSE 값을 1 로 설정합니다.
다음을 실행하여 수정된 구성을 적용합니다.
bash
```
$kubectl apply -f your_newrelic_k8s.yaml
```
몇 분 동안 또는 충분한 활동이 발생할 때까지 자세한 정보 표시 모드를 그대로 둡니다.
상세 모드 비활성화: NRIA_VERBOSE 값을 다시 0 로 설정합니다.
다음을 실행하여 복원된 구성을 적용합니다.
bash
```
$kubectl apply -f your_newrelic_k8s.yaml
```
환경의 노드 목록을 가져옵니다.
bash
```
$kubectl get nodes --all-namespaces
```

인프라 및 kube-state-metrics 포드 목록을 가져옵니다.

bash

$kubectl get pods --all-namespaces -o wide | egrep 'newrelic|kube-state-metrics'

kube-state-metrics에 연결하는 Pod에서 로그를 가져옵니다.
kube-state-metrics 서비스 설정을 검색합니다.

Kubernetes 통합의 경우 인프라 에이전트는 오류가 발생한 경우에만 로그 항목을 추가합니다. 가장 일반적인 오류는 표준(상세하지 않은) 로그에 표시됩니다. 직접적으로 또는 New Relic 지원을 통해 보다 심층적인 조사를 수행하는 경우 자세한 정보 표시 모드를 활성화할 수 있습니다.

주의

Helm을 사용하여 자세한 로깅을 활성화하려면 다음 안내를 따르세요.

다음 명령을 실행합니다.

bash

$helm upgrade -n <namespace> --reuse-values newrelic-bundle --set newrelic-infrastructure.verboseLog=true newrelic/nri-bundle

몇 분 동안 또는 충분한 활동이 발생할 때까지 자세한 정보 표시 모드를 그대로 둡니다.

필요한 정보가 있으면 자세한 로깅을 비활성화합니다.

bash

$helm upgrade --reuse-values newrelic-bundle --set newrelic-infrastructure.verboseLog=false newrelic/nri-bundle

다음을 실행하여 복원된 구성을 적용합니다.
bash
```
$kubectl apply -f your_newrelic_k8s.yaml
```
환경의 노드 목록을 가져옵니다.
bash
```
$kubectl get nodes --all-namespaces
```

인프라 및 kube-state-metrics 포드 목록을 가져옵니다.

bash

$kubectl get pods --all-namespaces -o wide | egrep 'newrelic|kube-state-metrics'

kube-state-metrics에 연결하는 Pod에서 로그를 가져옵니다.
kube-state-metrics 서비스 설정을 검색합니다.

kube-state-metrics 에 연결하는 Pod에서 로그를 가져오려면 다음 안내를 따르세요.

다음 명령을 실행합니다.

bash

$kubectl get pods --all-namespaces -o wide | grep kube-state-metrics

다음과 유사한 출력을 찾습니다.

bash

$kube-system   kube-state-metrics-5c6f5cb9b5-pclhh     2/2
$    Running   4          4d        172.17.0.3   minikube

kube-state-metrics 과 동일한 노드에서 실행 중인 New Relic 포드를 가져옵니다.

bash

$kubectl describe node minikube | grep newrelic-infra

다음과 유사한 출력을 찾습니다.

bash

$default                    newrelic-infra-5wcv6                     100m (5%)
$0 (0%)      100Mi (5%)       100Mi (5%)

다음을 실행하여 노드에 대한 로그를 검색합니다.
bash
```
$kubectl logs newrelic-infra-5wcv6
```

마스터 노드에서 실행 중인 포드에서 로그를 가져오려면:

마스터로 레이블이 지정된 노드를 가져옵니다.

bash

$kubectl get nodes -l node-role.kubernetes.io/master=""

또는,

bash

$kubectl get nodes -l kubernetes.io/role="master"

다음과 유사한 출력을 찾습니다.

bash

$NAME                         STATUS  ROLES   AGE   VERSION
$ip-10-42-24-4.ec2.internal   Ready   master  42d   v1.14.8

이전 단계에서 반환된 노드 중 하나에서 실행 중인 New Relic 포드를 가져옵니다.
bash
```
$kubectl get pods --field-selector spec.nodeName=ip-10-42-24-4.ec2.internal -l name=newrelic-infra --all-namespaces
```
다음과 유사한 출력을 찾습니다.
bash
```
$newrelic-infra-whvzt
```
다음 명령을 실행하여 노드에 대한 로그를 검색합니다.
bash
```
$kubectl logs newrelic-infra-whvzt
```

Kubernetes에서 실행되는 서비스 모니터링

Kubernetes의 모니터링 서비스는 인프라 에이전트와 호스트 내 통합 및 자동 검색 메커니즘을 활용하여 지정된 선택기가 있는 포드를 가리키는 방식으로 작동합니다.

수행 방법을 알아보려면 Helm 차트 문서를 사용하여 서비스 모니터링 활성화를 확인하세요. nri-bundle 차트의 values.yml 파일에 추가된 Redis 통합을 위한 yaml 구성을 보여주는 버전 2의 예시를 확인하세요.

newrelic-infrastructure:
    integrations_config:
    - name: nri-redis.yaml
    data:
    discovery:
    command:
    # Run NRI Discovery for Kubernetes
    # https://github.com/newrelic/nri-discovery-kubernetes
    exec: /var/db/newrelic-infra/nri-discovery-kubernetes --tls --port 10250
    match:
    label.app: redis
    integrations:
    - name: nri-redis
    env:
    # using the discovered IP as the hostname address
    HOSTNAME: ${discovery.ip}
    PORT: 6379
    labels:
    env: test

Kubernetes 통합 구성에 서비스 YAML 추가

Kubernetes 통합 버전 2를 사용하는 경우 DaemonSet의 spec 의 volumes 및 volumeMounts 섹션에 이 ConfigMap에 대한 항목을 추가하여 ConfigMap의 모든 파일이 /etc/newrelic-infra/integrations.d/ 에 마운트되도록 해야 합니다. .

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

개요

주의

통합 버전 2로 제어 영역 모니터링

자동 검색 및 기본 설정: `hostNetwork` 및 `privileged`

마스터 노드 및 제어 평면 구성 요소 검색

구성

중요

등

API 서버

중요

오픈시프트 구성

중요

중요

쿠버네티스 로그

매니페스트 파일을 사용하여 자세한 로깅 활성화

주의

Helm을 사용하여 자세한 로깅 활성화

주의

kube-state-metrics에 연결하는 포드에서 로그 가져오기

마스터 노드에서 실행 중인 Pod에서 로그 가져오기

Kubernetes에서 실행되는 서비스 모니터링

Kubernetes 통합 구성에 서비스 YAML 추가

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

개요

주의

통합 버전 2로 제어 영역 모니터링 .css-21sua1{background:none;border:none;width:0;padding:0;}

자동 검색 및 기본 설정: hostNetwork 및 privileged

마스터 노드 및 제어 평면 구성 요소 검색

구성

중요

등

API 서버

중요

오픈시프트 구성

중요

중요

쿠버네티스 로그

Helm을 사용하여 자세한 로깅 활성화

kube-state-metrics에 연결하는 포드에서 로그 가져오기

마스터 노드에서 실행 중인 Pod에서 로그 가져오기

Kubernetes에서 실행되는 서비스 모니터링

Kubernetes 통합 구성에 서비스 YAML 추가

통합 버전 2로 제어 영역 모니터링

자동 검색 및 기본 설정: `hostNetwork` 및 `privileged`