As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar a ingestão de um novo servidor Prometheus usando o Helm
<a name="AMP-onboard-ingest-metrics-new-Prometheus"></a>

As instruções nesta seção permitem que você comece a usar o Amazon Managed Service for Prometheus rapidamente. Você configura um novo servidor Prometheus em um cluster do Amazon EKS, e o novo servidor usa uma configuração padrão para enviar métricas para o Amazon Managed Service for Prometheus. Este método tem os seguintes pré-requisitos:
+ Você deve ter um cluster do Amazon EKS do qual o novo servidor do Prometheus coletará métricas.
+ Seu cluster do Amazon EKS deve ter um [driver do Amazon EBS CSI](https://docs.aws.amazon.com/eks/latest/userguide/ebs-csi.html) instalado (necessário ao Helm).
+ Você deve usar a CLI do Helm 3.0 ou posterior.
+ Você deve usar um computador Linux ou macOS para executar as etapas nas seções a seguir.

## Etapa 1: Adicionar novos repositórios de charts do Helm
<a name="AMP-onboard-new-Prometheus-HelmRepo"></a>

Insira os comandos a seguir para adicionar novos repositórios de charts do Helm. Para obter mais informações sobre esses comandos, consulte o [Repositório do 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
```

## Etapa 2: Criar um namespace do Prometheus
<a name="AMP-onboard-new-Prometheus-namespace"></a>

Digite o comando a seguir para criar um namespace do Prometheus para o servidor Prometheus e outros componentes de monitoramento. *prometheus-namespace*Substitua pelo nome que você deseja para esse namespace.

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

## Etapa 3: Configurar perfis do IAM para as contas de serviço
<a name="AMP-onboard-new-Prometheus-IRSA"></a>

Para o método de integração que estamos documentando, é necessário usar perfis do IAM para as contas de serviço no cluster do Amazon EKS em que o servidor do Prometheus está em execução. 

Com os perfis do IAM para contas de serviço, é possível associar um perfil do IAM a uma conta de serviço do Kubernetes. Essa conta de serviço pode fornecer permissões da AWS para os contêineres em qualquer pod que use essa conta de serviço. Para obter mais informações, consulte [Perfis do IAM para contas de serviço](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html).

Se você ainda não configurou esses perfis, siga as instruções em [Configurar perfis de serviço para a ingestão de métricas de clusters do Amazon EKS](set-up-irsa.md#set-up-irsa-ingest) para configurar os perfis. As instruções nessa seção exigem o uso do `eksctl`. Para obter mais informações, consulte [Conceitos básicos do Amazon Elastic Kubernetes Service – `eksctl`](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html). 

**nota**  
Quando você não está usando o EKS ou AWS está usando apenas a chave de acesso e a chave secreta para acessar o Amazon Managed Service para Prometheus, você não pode usar `EKS-IAM-ROLE` o SigV4 baseado.

## Etapa 4: Configurar o novo servidor e começar a ingerir métricas
<a name="AMP-onboard-ingest-metrics-new-Prometheus-Helm"></a>

Para instalar o novo servidor Prometheus que envia métricas para seu espaço de trabalho do Amazon Managed Service for Prometheus, siga estas etapas.

**Instalar o novo servidor Prometheus que envia métricas para seu espaço de trabalho do Amazon Managed Service for Prometheus**

1. Use um editor de textos para criar um arquivo chamado `my_prometheus_values_yaml` com o conteúdo a seguir.
   + *IAM\$1PROXY\$1PROMETHEUS\$1ROLE\$1ARN*Substitua pelo ARN do **amp-iamproxy-ingest-role**que você criou em. [Configurar perfis de serviço para a ingestão de métricas de clusters do Amazon EKS](set-up-irsa.md#set-up-irsa-ingest)
   + *WORKSPACE\$1ID*Substitua pelo ID do seu espaço de trabalho do Amazon Managed Service for Prometheus.
   + *REGION*Substitua pela região do seu espaço de trabalho do 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. Insira o comando a seguir para criar o servidor Prometheus.
   + Substitua *prometheus-chart-name* pelo nome da versão do Prometheus.
   + *prometheus-namespace*Substitua pelo nome do seu namespace Prometheus.

   ```
   helm install prometheus-chart-name prometheus-community/prometheus -n prometheus-namespace \
   -f my_prometheus_values_yaml
   ```
**nota**  
É possível personalizar o comando `helm install` de várias maneiras. Para obter mais informações, consulte [Helm install](https://helm.sh/docs/helm/helm_install/) na *documentação do Helm*.