eb logs

Descrição

O comando eb logs tem duas finalidades distintas: habilitar ou desabilitar o streaming de log para o CloudWatch Logs e recuperar logs de instância ou logs do CloudWatch Logs. Com a opção --cloudwatch-logs (-cw), o comando habilita ou desabilita o streaming de logs. Sem essa opção, ele recupera logs.

Ao recuperar logs, especifique a opção --all, --zip ou --stream para recuperar logs completos. Se você não especificar nenhuma dessas opções, o Elastic Beanstalk recuperará logs finais.

O comando processa logs do ambiente especificado ou do ambiente padrão. Os logs relevantes variam por tipo de contêiner. Se o diretório raiz contiver um arquivo platform.yaml especificando uma plataforma personalizada, esse comando também processará logs do ambiente do compilador.

Para obter mais informações, consulte Usando o Elastic CloudWatch Beanstalk com o Amazon Logs.

Sintaxe

Como habilitar ou desabilitar o streaming de logs para o CloudWatch Logs:

eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [environment-name]

Para recuperar logs de instâncias:

eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance instance-id] [--log-group log-group] [environment-name]

Para recuperar logs de integridade do ambiente:

eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [environment-name]

Opções

Name (Nome)	Descrição
-cw [enable | disable] ou --cloudwatch-logs [enable | disable]	Habilita ou desabilita o streaming de logs para o CloudWatch Logs. Se nenhum argumento for fornecido, o streaming de logs será habilitado. Se a opção --cloudwatch-log-source (-cls) não for especificada, o streaming de logs de instância será habilitado ou desabilitado.
-cls instance | environment-health | all ou --cloudwatch-log-source instance | environment-health | all	Especifica a origem dos logs ao trabalhar com o CloudWatch Logs. Com o formulário de habilitação ou desabilitação do comando, esses são os logs para os quais habilitar ou desabilitar o streaming do CloudWatch Logs. Com o formulário de recuperação do comando, esses são os logs a serem recuperados do CloudWatch Logs. Valores válidos: Com o --cloudwatch-logs (enable ou disable) – instance | environment-health | all Sem --cloudwatch-logs (retrieve) - instance | environment-health Significados dos valores: instance (padrão) – logs de instâncias environment-health – logs de integridade do ambiente (compatível somente quando a integridade avançada está habilitada no ambiente) all - as duas origens do log
-a ou --all	Recupera logs completos e salva-os no diretório .elasticbeanstalk/logs.
-z ou --zip	Recupera logs completos, compacta-os em um arquivo .zip e, em seguida, salva o arquivo no diretório .elasticbeanstalk/logs.
--stream	Transmite (saídas contínuas) logs completos. Com essa opção, o comando continua a ser executado até que você o interrompa (pressione Ctrl+C).
-i instance-id ou --instance instance-id	Recupera apenas os logs de uma instância especificada.
-g log-group ou --log-group log-group	Especifica o grupo de registros do CloudWatch Logs a partir do qual recuperar logs. A opção é válida somente quando o streaming de logs de instância para o CloudWatch Logs está habilitado. Se o streaming de log de instância estiver habilitado, e você não especificar a opção --log-group, o grupo de logs padrão será um dos seguintes: Amazon Linux 2: /aws/elasticbeanstalk/environment-name/var/log/eb-engine.log Plataformas Windows – /aws/elasticbeanstalk/environment-name/EBDeploy-Log Amazon Linux AMI (AL1): /aws/elasticbeanstalk/environment-name/var/log/eb-activity.log nota Em 18 de julho de 2022, o Elastic Beanstalk definiu o status de todas as ramificações de plataforma baseadas no Amazon Linux AMI (AL1) como descontinuadas. Para obter mais informações sobre como migrar para uma ramificação da plataforma Amazon Linux 2023 atual e totalmente compatível, consulte Migrar a aplicação Linux do Elastic Beanstalk para o Amazon Linux 2023 ou Amazon Linux 2. Para obter informações sobre o grupo de logs correspondente a cada arquivo de log, visite Como o Elastic Beanstalk configura os registros CloudWatch .
Opções comuns

Resultado

Por padrão, exibe os logs diretamente no terminal. Usa um programa de paginação para exibir a saída. Pressione Q ou q para sair.

Com --stream, mostra os logs existentes no terminal e continua em execução. Pressione Ctrl+C para sair.

Com --all e --zip, salva os logs em arquivos locais e exibe o local do arquivo.

Exemplos

O exemplo a seguir permite o streaming de logs de instância para o CloudWatch Logs.

$ eb logs -cw enable
Enabling instance log streaming to CloudWatch for your environment
After the environment is updated you can view your logs by following the link:
https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/environment-name/
Printing Status:
2018-07-11 21:05:20    INFO: Environment update is starting.
2018-07-11 21:05:27    INFO: Updating environment environment-name's configuration settings.
2018-07-11 21:06:45    INFO: Successfully deployed new configuration to environment.

O exemplo a seguir recupera os logs de instância em um arquivo .zip.

$ eb logs --zip
Retrieving logs...
Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip