Exemplo: uso de CloudWatch métricas personalizadas da Amazon

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. O CloudWatch agente agora 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 CloudWatch no Guia do usuário do Amazon EC2.

O CloudWatch agente da Amazon

O CloudWatch agente da Amazon permite a coleta de CloudWatch métricas e registros de instâncias do Amazon EC2 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ância e ambiente no. CloudWatch Para mais detalhes, consulte Publicar métricas personalizadas do Amazon CloudWatch 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 chamado cloudwatch.config em um diretório chamado .ebextensions no nível superior do diretório do projeto e implante a aplicação usando o console do Elastic Beanstalk (inclua o diretório .ebextensions em seu pacote de origem) ou na CLI do EB.

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 fetch-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 permissões adequadas do IAM 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 console do IAM 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, ao criar um ambiente com o console do Elastic Beanstalk ou com a CLI do EB, ela é 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 Trabalhar com políticas no Guia do usuário do IAM.

Visualizando métricas no CloudWatch console

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

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