기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Helm을 사용하여 새 Prometheus 서버에서 수집 설정
<a name="AMP-onboard-ingest-metrics-new-Prometheus"></a>

이 섹션의 지침을 통해 Amazon Managed Service for Prometheus를 빠르게 시작하고 실행할 수 있습니다. Amazon EKS 클러스터에 새 Prometheus 서버를 설정하면 새 서버는 기본 구성을 사용하여 Amazon Managed Service for Prometheus로 지표를 전송합니다. 이 방법의 사전 조건은 다음과 같습니다.
+ 새 Prometheus 서버가 지표를 수집할 Amazon EKS 클러스터가 있어야 합니다.
+ Amazon EKS 클러스터에 [Amazon EBS CSI 드라이버](https://docs.aws.amazon.com/eks/latest/userguide/ebs-csi.html)가 설치되어 있어야 합니다(Helm에서 요구됨).
+ Helm CLI 3.0 이상을 사용해야 합니다.
+ 다음 섹션의 단계를 수행하려면 Linux 또는 macOS 컴퓨터를 사용해야 합니다.

## 1단계: 새 차트 Helm 리포지토리 추가
<a name="AMP-onboard-new-Prometheus-HelmRepo"></a>

새 차트 Helm 리포지토리를 추가하려면 다음 명령을 입력합니다. 이러한 명령에 대한 자세한 내용은 [Helm 리포지토리](https://helm.sh/docs/helm/helm_repo/)를 참조하세요.

```
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 네임스페이스 생성
<a name="AMP-onboard-new-Prometheus-namespace"></a>

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

```
kubectl create namespace prometheus-namespace
```

## 3단계: 서비스 계정의 IAM 역할 설정
<a name="AMP-onboard-new-Prometheus-IRSA"></a>

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

서비스 계정에 대한 IAM 역할을 사용할 경우 IAM 역할을 Kubernetes 서비스 계정에 연결할 수 있습니다. 이렇게 하면 이 서비스 계정에서는 이 서비스 계정을 사용하는 모든 포드에 있는 컨테이너에 AWS 권한을 제공할 수 있습니다. 자세한 내용은 [서비스 계정에 대한 IAM 역할](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html)을 참조하세요.

이러한 역할을 아직 설정하지 않은 경우 [Amazon EKS 클러스터의 지표 수집을 위한 서비스 역할 설정](set-up-irsa.md#set-up-irsa-ingest)의 지침에 따라 역할을 설정하세요. 해당 섹션의 지침에는 `eksctl`을 사용해야 합니다. 자세한 내용은 [Amazon Elastic Kubernetes Service 시작 - `eksctl`](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html)을 참조하세요.

**참고**  
EKS 또는를 사용하지 않고 액세스 키 AWS 와 보안 키만 사용하여 Amazon Managed Service for Prometheus에 액세스하는 경우 `EKS-IAM-ROLE` 기반 SigV4를 사용할 수 없습니다.

## 4단계: 새 서버 설정 및 지표 수집 시작
<a name="AMP-onboard-ingest-metrics-new-Prometheus-Helm"></a>

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

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

1. 텍스트 편집기를 사용하여 다음 내용을 포함하는 `my_prometheus_values_yaml`이라는 파일을 생성합니다.
   + *IAM\$1PROXY\$1PROMETHEUS\$1ROLE\$1ARN*을 [Amazon EKS 클러스터의 지표 수집을 위한 서비스 역할 설정](set-up-irsa.md#set-up-irsa-ingest)에서 생성한 **amp-iamproxy-inges-role**의 ARN으로 바꿉니다.
   + *WORKSPACE\$1ID*를 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
   ```

1. 다음 명령을 입력하여 Prometheus 서버를 생성합니다.
   + *prometheus-chart-name*을 Prometheus 릴리스 이름으로 바꿉니다.
   + *prometheus-namespace*를 Prometheus 네임스페이스의 이름으로 바꿉니다.

   ```
   helm install prometheus-chart-name prometheus-community/prometheus -n prometheus-namespace \
   -f my_prometheus_values_yaml
   ```
**참고**  
여러 가지 방법으로 `helm install` 명령을 사용자 지정할 수 있습니다. 자세한 내용은 *Helm 설명서*의 [Helm 설치](https://helm.sh/docs/helm/helm_install/)를 참조하세요.