Exemplo: uso de CloudWatch métricas personalizadas da Amazon - AWS Elastic Beanstalk

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

Exemplo: uso de CloudWatch métricas personalizadas da Amazon

Este tópico fornece um exemplo de configuração que integra as métricas do Elastic Beanstalk CloudWatch com o agente da Amazon para plataformas baseadas no Amazon Linux 2 e versões posteriores. O exemplo de configuração usa arquivos e comandos em um arquivo .ebextensions de configuração.

CloudWatch A Amazon é um serviço web que permite monitorar, gerenciar e publicar várias métricas, bem como configurar ações de alarme com base nos dados das métricas. Você pode definir métricas personalizadas para seu próprio uso, e o Elastic Beanstalk enviará essas métricas para a Amazon. CloudWatch Depois que a Amazon CloudWatch contiver suas métricas personalizadas, você poderá visualizá-las no CloudWatch console da Amazon.

Importante

Os scripts de CloudWatch monitoramento da Amazon estão obsoletos. Agora, o CloudWatch agente substituiu os scripts de CloudWatch monitoramento para coletar métricas e registros.

Se você ainda estiver migrando dos scripts de monitoramento obsoletos para o agente e precisar de informações sobre os scripts de monitoramento, consulte Obsoleto: colete métricas usando os scripts de monitoramento no Guia do usuário da Amazon CloudWatch . EC2

O CloudWatch agente da Amazon

O CloudWatch agente da Amazon permite a coleta de CloudWatch métricas e registros de EC2 instâncias da Amazon e servidores locais em todos os sistemas operacionais. O agente oferece suporte a métricas coletadas no nível do sistema. Ele também oferece suporte para a coleta de métricas personalizadas de aplicações ou serviços. Para obter mais informações sobre o CloudWatch agente da Amazon, consulte Coleta de métricas e registros com o CloudWatch agente no Guia CloudWatch do usuário da Amazon.

nota

O Elastic Beanstalk Enhanced Health Reporting tem suporte nativo para publicar uma ampla variedade de métricas de instâncias e ambientes em. CloudWatch Para mais detalhes, consulte Publicação de métricas CloudWatch personalizadas da Amazon para um ambiente.

Arquivo de configuração .Ebextensions

Este exemplo usa arquivos e comandos em um arquivo de configuração.ebextensions para configurar e executar o CloudWatch agente da Amazon na plataforma Amazon Linux 2. O agente faz parte do pacote do Amazon Linux 2. Se você estiver usando um sistema operacional diferente, etapas adicionais para instalar o agente podem ser necessárias. Para obter mais informações, consulte Instalando o CloudWatch agente no Guia CloudWatch do usuário da Amazon.

Para usar esse exemplo, salve-o em um arquivo nomeado cloudwatch.config em um diretório nomeado no nível superior do diretório do seu projeto e, .ebextensions em seguida, implante seu aplicativo usando o console do Elastic Beanstalk (inclua o diretório.ebextensions no seu pacote de origem) ou o EB. CLI

Para obter mais informações sobre esses arquivos de configuração, consulte Personalização avançada de ambiente com arquivos de configuração (.ebextensions).

.ebextensions/cloudwatch.config

files: "/opt/aws/amazon-cloudwatch-agent/bin/config.json": mode: "000600" owner: root group: root content: | { "agent": { "metrics_collection_interval": 60, "run_as_user": "root" }, "metrics": { "namespace": "System/Linux", "append_dimensions": { "AutoScalingGroupName": "${aws:AutoScalingGroupName}" }, "metrics_collected": { "mem": { "measurement": [ "mem_used_percent" ] } } } } container_commands: start_cloudwatch_agent: command: /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a append-config -m ec2 -s -c file:/opt/aws/amazon-cloudwatch-agent/bin/config.json

Este arquivo tem duas seções:

  • files: essa seção adiciona o arquivo de configuração do agente. Ele indica quais métricas e registros o agente deve enviar para a Amazon CloudWatch. Neste exemplo, estamos enviando apenas a métrica mem_used_percent. Para obter uma lista completa das métricas em nível de sistema suportadas pelo CloudWatch agente da Amazon, consulte Métricas coletadas pelo CloudWatch agente no Guia CloudWatch do usuário da Amazon.

  • container_commands: essa seção contém o comando que inicia o agente, passando o arquivo de configuração como um parâmetro. Para obter mais detalhes sobre o container_commands, consulte Comandos de contêiner.

Permissões

As instâncias em seu ambiente precisam das IAM permissões adequadas para publicar CloudWatch métricas personalizadas da Amazon usando o CloudWatch agente da Amazon. Você pode conceder permissões às instâncias do ambiente adicionando-as ao perfil da instância do ambiente. Você pode adicionar permissões ao perfil da instância antes ou depois da implantação de seu aplicativo.

Para conceder permissões para publicar CloudWatch métricas
  1. Abra o IAM console em https://console.aws.amazon.com/iam/.

  2. No painel de navegação, escolha Perfis.

  3. Escolha a função de perfil da instância de seu ambiente. Por padrão, quando você cria um ambiente com o console CLI do Elastic Beanstalk ou EB, isso é. aws-elasticbeanstalk-ec2-role

  4. Escolha a aba Permissões.

  5. Em Permissions Policies (Políticas de permissões), na seção Permissions (Permissões) escolha Attach policies (Anexar políticas).

  6. Em Anexar permissões, escolha a política AWS gerenciada CloudWatchAgentServerPolicy. Clique em Attach Policy (Anexar política).

Para obter mais informações sobre o gerenciamento de políticas, consulte Como trabalhar com políticas no Guia IAM do usuário.

Visualizando métricas no CloudWatch console

Depois de implantar o arquivo de CloudWatch configuração em seu ambiente, verifique o CloudWatchconsole da Amazon para ver suas métricas. As métricas personalizadas estarão localizadas no CWAgentnamespace.

Para obter mais informações, consulte Visualização das métricas disponíveis no Guia CloudWatch do usuário da Amazon.