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á.

# Ingerir métricas do Prometheus no espaço de trabalho
<a name="AMP-onboard-ingest-metrics"></a>

Uma forma de ingerir métricas é usar um *agente* autônomo do Prometheus (uma instância do Prometheus em execução no modo Agente) para extrair métricas do cluster e encaminhá-las para o Amazon Managed Service for Prometheus para armazenamento e monitoramento. Esta seção explica como configurar a ingestão de métricas no espaço de trabalho do Amazon Managed Service for Prometheus a partir do Amazon EKS configurando uma nova instância do agente do Prometheus usando o Helm.

Para gerar métricas no Amazon EKS, como Kubernetes ou métricas em nível de nó, você pode usar os complementos da comunidade Amazon EKS. Para obter mais informações, consulte [Complementos comunitários disponíveis](https://docs.aws.amazon.com/eks/latest/userguide/community-addons.html#_available_community_add_ons) no *Guia do usuário do Amazon EKS*.

Para obter informações sobre outras formas de ingerir dados no Amazon Managed Service for Prometheus, incluindo como proteger métricas e criar métricas de alta disponibilidade, consulte [Ingerir métricas no seu espaço de trabalho do Amazon Managed Service for Prometheus](AMP-ingest-methods.md).

**nota**  
As métricas ingeridas em um espaço de trabalho são armazenadas durante 150 dias por padrão e, em seguida, excluídas automaticamente. Você pode ajustar o período de retenção configurando seu espaço de trabalho em um máximo de até 1.095 dias (3 anos). Para obter mais informações, consulte [Configurar seu espaço de trabalho](https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-workspace-configuration.html).

As instruções nesta seção permitem que você comece a usar o Amazon Managed Service for Prometheus rapidamente. Elas consideram que você já tenha [criado um espaço de trabalho](AMP-onboard-create-workspace.md). Nesta seção, você configura um novo servidor do Prometheus em um cluster do Amazon EKS, e o novo servidor usa uma configuração padrão para atuar como agente a fim de enviar métricas ao 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-quick-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-quick-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-agent-namespace}}Substitua pelo nome que você deseja para esse namespace.

```
kubectl create namespace {{prometheus-agent-namespace}}
```

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

Para esse método de ingestão, é necessário usar perfis do IAM para contas de serviço no cluster do Amazon EKS em que o agente 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 então fornecer AWS permissões 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-quick-ingest-metrics-new-Prometheus-Helm"></a>

Para instalar o novo agente do Prometheus e enviar métricas para o espaço de trabalho do Amazon Managed Service for Prometheus, siga estas etapas.

**Como instalar o novo agente do Prometheus e enviar métricas para o 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\_PROXY\_PROMETHEUS\_ROLE\_ARN}}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\_ID}}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-agent-namespace}}Substitua pelo nome do seu namespace Prometheus.

   ```
   helm install {{prometheus-chart-name}} prometheus-community/prometheus -n {{prometheus-agent-namespace}} \
   -f my_prometheus_values_yaml
   ```