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á.
# Como trabalhar com o CloudWatch Logs usando o AWS Toolkit for Visual Studio Code
O Amazon CloudWatch Logs permite centralizar os logs de todos os sistemas, aplicações e produtos da AWS que você usa em um único serviço altamente escalável. Você pode visualizá-los facilmente, pesquisá-los por códigos de erro ou padrões específicos, filtrá-los com base em campos específicos ou arquivá-los com segurança para análise futura. Para obter mais informações, consulte [O que é o Amazon CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatchLogs.html) no *Manual do usuário do Amazon CloudWatch*.
Os tópicos a seguir descrevem como usar o AWS Toolkit for Visual Studio Code para trabalhar com o CloudWatch Logs em uma conta da AWS.
**Topics**
+ [Visualizando grupos de CloudWatch registros e fluxos de registros](viewing-CloudWatch-logs.md)
+ [Trabalhando com eventos CloudWatch de log](working-CloudWatch-log-events.md)
+ [Pesquisar grupos de logs](cloud-watch-search.md)
+ [CloudWatch Logs Live Tail](cloudwatch-livetail.md)
# Visualizando CloudWatch grupos de registros e fluxos de registros usando o AWS Toolkit for Visual Studio Code
*Fluxo de logs* é uma sequência de eventos de log que compartilham a mesma origem. Cada fonte separada de registros no CloudWatch Logs forma um fluxo de registros separado.
Um *grupo de logs* é um grupo de fluxos de log que compartilham as mesmas configurações de retenção, monitoramento e controle de acesso. Você pode definir grupos de logs e especificar quais fluxos colocar em cada grupo. Não há limite para o número de streams de log que podem pertencer a um grupo de logs.
Para obter mais informações, consulte Como [trabalhar com grupos de registros e fluxos de registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Working-with-log-groups-and-streams.html) no *Guia do CloudWatch usuário da Amazon*.
**Topics**
+ [Visualização de grupos e fluxos de registros com o nó **CloudWatch Logs**](#viewing-log-groups)
## Visualização de grupos e fluxos de registros com o nó **CloudWatch Logs**
1. No VS Code, selecione **Exibir**, **Explorer** para abrir o AWS Explorer.
1. Clique no nó **CloudWatch Registros** para expandir a lista de grupos de registros.
Os grupos de registros da AWS região atual são exibidos no nó **CloudWatch Registros**.
1. Para exibir os fluxos de logs em um grupo de logs, clique com o botão direito do mouse no nome do grupo de logs e selecione **Visualizar fluxo de logs**.
![\[Visualizando fluxos de log em um grupo de CloudWatch registros no Explorer AWS\]](http://docs.aws.amazon.com/pt_br/toolkit-for-vscode/latest/userguide/images/cwl-log-streams.png)
1. Na **Paleta de comandos**, selecione um fluxo de logs do grupo para visualizar.
**nota**
A **paleta de comandos** exibe uma marcação de data e hora para o último evento em cada fluxo.
O [editor de **fluxo de logs**](working-CloudWatch-log-events.md) é iniciado para exibir os eventos de log do fluxo.
# Trabalhando com CloudWatch eventos de log em fluxos de log usando o AWS Toolkit for Visual Studio Code
Depois de abrir o editor de **fluxo de logs**, você poderá acessar os eventos de log em cada fluxo. Eventos de log são registros de atividades registradas pela aplicação ou recurso que estiver sendo monitorado.
**Topics**
+ [Exibir e copiar informações do fluxo de log](#viewing-log-events)
+ [Salve o conteúdo do editor de fluxo de log em um arquivo local](#saving-CW-logs)
## Exibir e copiar informações do fluxo de log
Ao abrir um fluxo de logs, o editor de **fluxo de logs** exibe a sequência de eventos de log do fluxo.
1. Para localizar e exibir um fluxo de logs, abra o editor de **fluxo de logs** (consulte [Visualizando grupos de CloudWatch registros e fluxos de registros](viewing-CloudWatch-logs.md)).
Cada linha que lista um evento tem um carimbo de data/hora para mostrar quando ele foi registrado.
1. É possível visualizar e copiar informações sobre os eventos do stream usando as seguintes opções:
+ Exibir eventos por tempo: exiba os eventos de log mais recentes e antigos escolhendo **Load newer events** (Carregar eventos mais recentes) ou **Load older events** (Carregar eventos mais antigos).
**nota**
O editor **Log Stream** (Fluxo de dados de log) inicialmente carrega um lote das 10.000 linhas mais recentes dos eventos de log ou 1 MB de dados de log (o que for menor). Se você escolher **Load newer events** (Carregar eventos mais recentes), o editor exibirá os eventos que foram registrados após o último lote ter sido carregado. Se você escolher **Load older events** (Carregar eventos mais antigos), o editor exibirá um lote de eventos que ocorreram antes daqueles exibidos atualmente.
+ Copiar eventos de log: selecione os eventos a serem copiados, clique com o botão direito e selecione **Copy** (Copiar) no menu.
+ Copie o nome do fluxo de logs: clique com o botão direito do mouse na guia **Fluxo de logs** e selecione **Copiar nome do fluxo de logs**.
**nota**
Você também pode usar a **paleta de comandos** para executar o comando **Copiar nome do fluxo de logs do kit de ferramentas da AWS **.
## Salve o conteúdo do editor de fluxo de log em um arquivo local
Você pode baixar o conteúdo do editor de fluxo de CloudWatch log em um `log` arquivo na sua máquina local.
**nota**
Com essa opção, você salva no arquivo apenas os eventos de log exibidos no momento no editor de fluxo de logs. Por exemplo, se o tamanho total de um fluxo de log for 5MB e somente 2MB for carregado no editor, o arquivo salvo também conterá apenas 2MB de dados de log. Para exibir mais dados a serem salvos, escolha **Load newer events** (Carregar eventos mais recentes) ou **Load older events** (Carregar eventos mais antigos) no editor.
1. Para localizar e copiar o fluxo de logs, abra o editor de **fluxo de logs** (consulte [Visualizando grupos de CloudWatch registros e fluxos de registros](viewing-CloudWatch-logs.md)).
1. Selecione o ícone **Salvar** ao lado da guia que exibe o nome do fluxo de logs.
**nota**
Você também pode usar a **paleta de comandos** para executar a opção **Salvar o conteúdo atual do fluxo de logs do kit de ferramentas da AWS **.
1. Use a caixa de diálogo para selecionar ou criar uma pasta de download para o arquivo de log e clique em **Save** (Salvar).
# Pesquisar grupos de logs do CloudWatch
Você pode usar Pesquisar grupo de logs para pesquisar todos os fluxos de logs em um grupo de logs.
Para obter informações detalhadas sobre o serviço Amazon CloudWatch Logs, consulte o tópico [Trabalhar com grupos de logs e fluxos de logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Working-with-log-groups-and-streams.html) no *Guia do usuário do Amazon CloudWatch*.
## Pesquisar grupos de logs na paleta de comandos do VS Code
Para pesquisar grupos de logs usando a paleta de comandos do VS Code, siga as etapas abaixo.
Para obter informações detalhadas sobre filtros e padrões do Amazon CloudWatch Logs, consulte a seção [Sintaxe de padrões de filtros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html) no *Guia do usuário do Amazon CloudWatch*.
1. No VS Code, abra a **paleta de comandos** pressionando **cmd\$1shift\$1p** (Windows: **ctrl\$1shift\$1p**).
1. Na paleta de comandos, insira o comando **AWS: Search Log Group**, selecione-o para abrir a caixa de diálogo de pesquisa de grupo de logs no VS Code e siga as instruções para continuar.
**nota**
Na primeira solicitação, você tem a opção de mudar de região da AWS antes de passar para as próximas etapas.
1. Na solicitação **Selecionar grupo de logs (1/3)**, escolha o grupo de logs que você deseja pesquisar.
1. Na solicitação **Selecionar filtro de tempo (2/3)**, escolha o filtro de tempo a ser aplicado à pesquisa.
1. Na solicitação **Pesquisar grupo de logs... (3/3)**, insira o padrão de pesquisa no campo fornecido e pressione a tecla **Enter** para continuar ou a tecla **ESC** para cancelar a pesquisa.
1. Os resultados da pesquisa serão abertos no editor do VS Code quando a pesquisa for concluída.
## Pesquisar grupo de logs no AWS Explorer
Para pesquisar grupos de logs no AWS Toolkit for Visual Studio Code Explorer, siga as etapas abaixo.
1. No AWS Toolkit for Visual Studio Code Explorer, expanda o **CloudWatch**.
1. Abra o menu de contexto (clique com o botão direito do mouse) do grupo de logs que deseja pesquisar e selecione **Pesquisar grupo de logs** para abrir o prompt de pesquisa.
1. Siga as instruções selecionando um período para continuar.
1. Quando solicitado, insira o padrão de pesquisa no campo fornecido e pressione a tecla **Enter** para continuar ou a tecla **ESC** para cancelar a pesquisa.
1. Os resultados da pesquisa serão abertos no editor do VS Code quando a pesquisa for concluída.
## Trabalhar com resultados de pesquisa de log
Ao concluir uma pesquisa bem-sucedida de grupo de logs do CloudWatch, os resultados são abertos no editor do VS Code. Os procedimentos a seguir descrevem como trabalhar com resultados de pesquisa de log.
**nota**
Ao visualizar um único fluxo de logs, os recursos a seguir são limitados aos resultados do fluxo de logs ativo no momento.
**Salvar os resultados da pesquisa de grupo de logs**
Para salvar localmente os resultados da pesquisa de grupo de logs, siga as etapas abaixo.
1. Nos resultados da pesquisa do grupo de logs, selecione o botão do ícone **Salvar log em arquivo**, localizado no canto superior direito do editor do VS Code.
1. Na solicitação **Salvar como**, especifique o nome e o local em que você deseja salvar o arquivo.
1. Selecione **OK** para salvar o arquivo na máquina local.
**Alterar o intervalo de tempo: período**
Para alterar o período ativo nos resultados da pesquisa do grupo de logs, siga as etapas abaixo.
1. Nos resultados de pesquisa do grupo de logs, escolha o botão do ícone **Pesquisar por data...**, localizado no canto superior direito do editor do VS Code.
1. Na solicitação **Selecionar filtro de tempo**, escolha um novo período para os resultados da pesquisa de log.
1. Os resultados são atualizados quando a solicitação **Selecionar filtro de tempo** é fechada.
**Alterar o padrão de pesquisa**
Para alterar o padrão de pesquisa que está ativo nos resultados da pesquisa do grupo de logs, siga as etapas abaixo.
1. Nos resultados da pesquisa do grupo de logs, selecione o botão do ícone **Pesquisar por padrão...**, localizado no canto superior direito do editor do VS Code.
1. Na solicitação **Pesquisar grupo de logs**, insira o novo padrão de pesquisa no campo fornecido.
1. Pressione a tecla **Enter** para fechar o prompt e atualizar os resultados com o novo padrão de pesquisa.
# Amazon CloudWatch Logs Live Tail
Transmissão ao vivo de seus eventos de log do CloudWatch Logs à medida que eles são consumidos em um grupo de logs específico com o Amazon CloudWatch Logs Live Tail.
Para obter mais informações sobre os atributos do Live Tail, consulte [Solução de problemas com o CloudWatch Logs Live Tail](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html) no *Guia do usuário do Amazon CloudWatch Logs*.
As sessões Live Tail acumulam custos por tempo de uso da sessão, por minuto. Para obter informações sobre preços, consulte a guia *Logs* na seção **Nível pago** do [Guia de preços do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
## Iniciar uma sessão Live Tail na paleta de comandos do VS Code
Para pesquisar grupos de logs usando a paleta de comandos do VS Code, siga as etapas abaixo.
Para obter informações detalhadas sobre filtros e padrões do Amazon CloudWatch Logs, consulte a seção [Sintaxe de padrões de filtros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html) no *Guia do usuário do Amazon CloudWatch*.
**Iniciar uma sessão de encerramento na paleta de comandos**
1. No VS Code, abra a **Paleta de Comandos** pressionando **cmd\$1shift\$1p** (Windows: **ctrl\$1shift\$1p**).
1. Na **Paleta de Comandos**, insira o comando `AWS: Tail Log Group`, selecione-o para abrir a caixa de diálogo **Grupo de logs Tail** no VS Code e siga os prompts para continuar.
**nota**
Na primeira instrução, você tem a opção de mudar de região da AWS antes de passar para as próximas etapas.
1. No prompt **Grupo de logs Tail (1/3)**, escolha o grupo de logs que você deseja pesquisar.
1. No prompt **Incluir eventos de log de... (2/3)**, escolha o filtro de fluxo de logs a ser aplicado à sessão de encerramento.
1. No prompt **Fornecer padrão de filtro de log de eventos... (3/3)**, insira o padrão de pesquisa no campo fornecido e pressione a tecla **Enter** para continuar ou a tecla **ESC** para cancelar a pesquisa.
1. Após a conclusão, seus resultados são transmitidos para o editor de códigos do VS Code
**nota**
Se uma sessão do Live Tail em execução na janela do VS Code corresponder à configuração de um comando recém-enviado do Tail Log Group, uma nova sessão não será iniciada. Em vez disso, sua sessão existente se torna o editor de texto ativo.
## Iniciar uma sessão Live Tail usando o AWS Explorer
Para iniciar uma sessão Live Tail usando o AWS Toolkit Explorer, siga as etapas abaixo.
**Iniciando uma sessão final a partir do AWS Explorer**
1. No AWS Toolkit Explorer, expanda o **Amazon CloudWatch**.
1. Abra o menu de contexto (clique com o botão direito do mouse) do grupo de logs que deseja pesquisar e selecione **Grupos de log Tail** para abrir o prompt de pesquisa.
1. Siga os prompts para continuar.
1. Seus resultados serão transmitidos para o editor de código do VS Code.
## Interromper uma sessão Live Tail
Há duas maneiras de interromper uma sessão de Tailing em execução.
**Interrompendo uma sessão de encerramento**
1. Clique em **Stop tailing** CodeLens na parte inferior do documento de texto da sessão final.
1. Feche todos os editores que contêm o documento de texto da sessão final.