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 o Amazon Managed Service for Prometheus com o AWS Observability Accelerator
A AWS fornece ferramentas de observabilidade, incluindo monitoramento, registros em log, alertas e painéis, para seus projetos do Amazon Elastic Kubernetes Service (Amazon EKS). Isso inclui o Amazon Managed Service for Prometheus, o [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html), o [AWS Distro for OpenTelemetry](https://aws-otel.github.io/) e outras ferramentas. Para ajudá-lo a usar essas ferramentas em conjunto, a AWS fornece módulos do Terraform que configuram a observabilidade com esses serviços, chamados de [AWS Observability Accelerator](https://github.com/aws-observability/terraform-aws-observability-accelerator).
O Observability Accelerator da AWS fornece exemplos para monitorar a infraestrutura, implantações do [NGINX](https://nginx.org/en/) e outros cenários. Esta seção fornece um exemplo de infraestrutura de monitoramento dentro do seu cluster do Amazon EKS.
Os modelos e instruções detalhadas do Terraform podem ser encontrados na [página do GitHub do AWS Observability Accelerator for Terraform](https://github.com/aws-observability/terraform-aws-observability-accelerator). Você também pode ler a [postagem do blog anunciando o AWS Observability Accelerator](https://aws.amazon.com/blogs/mt/announcing-aws-observability-accelerator-to-configure-comprehensive-observability-for-amazon-eks/).
## Pré-requisitos
Para usar o AWS Observability Accelerator, você deve ter um cluster existente do Amazon EKS e os seguintes pré-requisitos:
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html): usada para chamar a funcionalidade da AWS a partir da linha de comando.
+ [kubectl](https://kubernetes.io/docs/tasks/tools/): usado para controlar seu cluster do EKS a partir da linha de comando.
+ [Terraform](https://learn.hashicorp.com/tutorials/terraform/install-cli): usado para automatizar a criação dos recursos para essa solução. Você deve configurar o provedor da AWS com um perfil do IAM que tenha acesso para criar e gerenciar o Amazon Managed Service for Prometheus, Amazon Managed Grafana e IAM em sua conta da AWS. Para obter mais informações sobre como configurar o provedor da AWS para o Terraform, consulte o [provedor da AWS](https://registry.terraform.io/providers/hashicorp/aws/latest/docs) na *documentação do Terraform*.
## Usando o exemplo de monitoramento de infraestrutura
O AWS Observability Accelerator fornece modelos de exemplo que usam os módulos do Terraform incluídos para instalar e configurar a observabilidade do seu cluster do Amazon EKS. Este exemplo demonstra o uso do Observability Accelerator da AWS para configurar o monitoramento da infraestrutura. Para obter mais detalhes sobre o uso desse modelo e os recursos adicionais que ele inclui, consulte a página [Cluster existente com a base do AWS Observability Accelerator e o monitoramento da infraestrutura](https://github.com/aws-observability/terraform-aws-observability-accelerator/tree/main/examples/existing-cluster-with-base-and-infra) no GitHub.
**Para usar o módulo do Terraform de monitoramento de infraestrutura**
1. Na pasta em que você deseja criar seu projeto, clone o repositório usando o comando a seguir.
```
git clone https://github.com/aws-observability/terraform-aws-observability-accelerator.git
```
1. Inicialize o Terraform com os comandos a seguir.
```
cd examples/existing-cluster-with-base-and-infra
terraform init
```
1. Crie um arquivo `terraform.tfvars`, como no exemplo a seguir. Use a região AWS e o ID do seu cluster do Amazon EKS.
```
# (mandatory) AWS Region where your resources will be located
aws_region = "eu-west-1"
# (mandatory) EKS Cluster name
eks_cluster_id = "my-eks-cluster"
```
1. Crie um espaço de trabalho do Amazon Managed Grafana, se você ainda não tiver um que queira usar. Para obter informações sobre como criar um espaço de trabalho, consulte [Crie seu primeiro espaço de trabalho](https://docs.aws.amazon.com/grafana/latest/userguide/getting-started-with-AMG.html#AMG-getting-started-workspace-create) no *Guia do usuário do Amazon Managed Grafana.*
1. Crie duas variáveis para que o Terraform use seu espaço de trabalho do Grafana executando os seguintes comandos na linha de comando. Você precisará substituir *grafana-workspace-id* pelo ID do seu espaço de trabalho do Grafana.
```
export TF_VAR_managed_grafana_workspace_id=grafana-workspace-id
export TF_VAR_grafana_api_key=`aws grafana create-workspace-api-key --key-name "observability-accelerator-$(date +%s)" --key-role ADMIN --seconds-to-live 1200 --workspace-id $TF_VAR_managed_grafana_workspace_id --query key --output text`
```
1. [Opcional] Para usar um espaço de trabalho existente do Amazon Managed Service for Prometheus, adicione o ID ao arquivo `terraform.tfvars`, como no exemplo a seguir, substituindo o *prometheus-workspace-id* pelo ID do espaço de trabalho do Prometheus. Se você não especificar um espaço de trabalho existente, um espaço de trabalho do Prometheus será criado para você.
```
# (optional) Leave it empty for a new workspace to be created
managed_prometheus_workspace_id = "prometheus-workspace-id"
```
1. Implante a solução com o seguinte comando.
```
terraform apply -var-file=terraform.tfvars
```
Isso criará recursos em sua conta da AWS, incluindo os seguintes:
+ Um novo espaço de trabalho do Amazon Managed Service for Prometheus (a menos que você tenha optado por usar um espaço de trabalho existente).
+ Configuração, alertas e regras do gerenciador de alertas em seu espaço de trabalho do Prometheus.
+ Nova fonte de dados e painéis do Amazon Managed Grafana em seu espaço de trabalho atual. A fonte de dados será chamada `aws-observability-accelerator`. Os painéis serão listados em **Painéis do Observability Accelerator**.
+ Um operador do [AWS Distro for OpenTelemetry](https://aws.amazon.com/otel/) configurado no cluster do Amazon EKS fornecido para enviar métricas ao seu espaço de trabalho do Amazon Managed Service for Prometheus.
Para visualizar seus novos painéis, abra o painel específico em seu espaço de trabalho do Amazon Managed Grafana. Para obter mais informações sobre o uso do Amazon Managed Grafana, consulte [Trabalhar em seu espaço de trabalho do Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-working-with-Grafana-workspace.html), no *Guia do usuário do Amazon Managed Grafana*.