Helm을 사용하여 새 Prometheus 서버에서 수집 설정

이 섹션의 지침을 통해 Amazon Managed Service for Prometheus를 빠르게 시작하고 실행할 수 있습니다. Amazon EKS 클러스터에 새 Prometheus 서버를 설정하면 새 서버는 기본 구성을 사용하여 Amazon Managed Service for Prometheus로 지표를 전송합니다. 이 방법의 사전 조건은 다음과 같습니다.

• 새 Prometheus 서버가 지표를 수집할 Amazon EKS 클러스터가 있어야 합니다.

• Amazon EKS 클러스터에는 Amazon EBS CSI 드라이버 (헬름 필요) 가 설치되어 있어야 합니다.

• 헬름 CLI 3.0 이상을 사용해야 합니다.

• 다음 섹션의 단계를 수행하려면 Linux 또는 macOS 컴퓨터를 사용해야 합니다.

1단계: 새 차트 Helm 리포지토리 추가

새 차트 Helm 리포지토리를 추가하려면 다음 명령을 입력합니다. 이러한 명령에 대한 자세한 내용은 Helm 리포지토리를 참조하세요.

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo add kube-state-metrics https://kubernetes.github.io/kube-state-metrics
helm repo update

2단계: Prometheus 네임스페이스 생성

다음 명령을 입력하여 Prometheus 서버 및 기타 모니터링 구성 요소에 대한 Prometheus 네임스페이스를 생성합니다. prometheus-namespace를 이 네임스페이스에 사용할 이름으로 바꿉니다.

kubectl create namespace prometheus-namespace

3단계: 서비스 계정의 IAM 역할 설정

문서화하는 온보딩 방법에 대해서는 Prometheus 서버가 실행되는 Amazon EKS 클러스터에서 서비스 계정에 대한 IAM 역할을 사용해야 합니다.

서비스 계정에 대한 IAM 역할을 사용할 경우 IAM 역할을 Kubernetes 서비스 계정에 연결할 수 있습니다. 이렇게 하면 이 서비스 계정에서는 이 서비스 계정을 사용하는 모든 포드에 있는 컨테이너에 AWS 권한을 제공할 수 있습니다. 자세한 내용은 서비스 계정에 대한 IAM 역할을 참조하세요.

이러한 역할을 아직 설정하지 않은 경우 Amazon EKS 클러스터의 지표 수집을 위한 서비스 역할 설정의 지침에 따라 역할을 설정하세요. 해당 섹션의 지침에는 eksctl을 사용해야 합니다. 자세한 내용은 Amazon Elastic Kubernetes Service 시작 - eksctl을 참조하세요.

참고

EKS를 사용하지 않거나 AWS 액세스 키와 비밀 키만 사용하여 Prometheus용 Amazon Managed Service에 액세스하는 경우에는 기반 SigV4를 사용할 수 없습니다. EKS-IAM-ROLE

4단계: 새 서버 설정 및 지표 수집 시작

Amazon Managed Service for Prometheus 워크스페이스로 지표를 전송하는 새 Prometheus 서버를 설치하려면 다음 단계를 따르세요.

새 Prometheus 서버를 설치하여 Amazon Managed Service for Prometheus 워크스페이스로 지표를 보내려면

1. 텍스트 편집기를 사용하여 다음 내용을 포함하는 my_prometheus_values_yaml이라는 파일을 생성합니다.

   • IAM_PROXY_PROMETHEUS_ROLE_ARN을 에서 생성한 ARN으로 바꾸십시오. amp-iamproxy-ingest-roleAmazon EKS 클러스터의 지표 수집을 위한 서비스 역할 설정

   • WORKSPACE_ID를 Amazon Managed Service for Prometheus 워크스페이스의 ID로 바꿉니다.

   • REGION을 Amazon Managed Service for Prometheus 워크스페이스의 리전으로 바꿉니다.

   ## The following is a set of default values for prometheus server helm chart which enable remoteWrite to AMP
   ## For the rest of prometheus helm chart values see: https://github.com/prometheus-community/helm-charts/blob/main/charts/prometheus/values.yaml
   ##
   serviceAccounts:
     server:
       name: amp-iamproxy-ingest-service-account
       annotations: 
         eks.amazonaws.com/role-arn: ${IAM_PROXY_PROMETHEUS_ROLE_ARN}
   server:
     remoteWrite:
       - url: https://aps-workspaces.${REGION}.amazonaws.com/workspaces/${WORKSPACE_ID}/api/v1/remote_write
         sigv4:
           region: ${REGION}
         queue_config:
           max_samples_per_send: 1000
           max_shards: 200
           capacity: 2500

2. 다음 명령을 입력하여 Prometheus 서버를 생성합니다.

   • Prometheus 출시 prometheus-chart-name이름으로 바꾸십시오.

   • prometheus-namespace를 Prometheus 네임스페이스의 이름으로 바꿉니다.

   helm install prometheus-chart-name prometheus-community/prometheus -n prometheus-namespace \
   -f my_prometheus_values_yaml

   참고

   여러 가지 방법으로 helm install 명령을 사용자 지정할 수 있습니다. 자세한 내용은 Helm 설명서의 Helm 설치를 참조하세요.