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 de configuração .ebextensions
.
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.
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â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).
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 ocontainer_commands
, consulte Comandos de contêiner.
.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
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
Abra o console do IAM em https://console.aws.amazon.com/iam/
. -
No painel de navegação, selecione Perfis.
-
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
. -
Escolha a aba Permissões.
-
Em Permissions Policies (Políticas de permissões), na seção Permissions (Permissões) escolha Attach policies (Anexar políticas).
-
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 CloudWatchconsole da Amazon
Para obter mais informações, consulte Visualização das métricas disponíveis no Guia CloudWatch do usuário da Amazon.