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

# Trabalhando com CloudWatch registros no Visual Studio
<a name="cloudwatch-log-overview"></a>

A integração do Amazon CloudWatch Logs permite monitorar, armazenar e acessar CloudWatch registros do AWS Toolkit for Visual Studio com o Amazon Q. Ter acesso aos recursos do Logs, sem CloudWatch a necessidade de sair do IDE, melhora a eficiência simplificando o processo de desenvolvimento de registros e reduzindo as interrupções CloudWatch no fluxo de trabalho. Os tópicos a seguir descrevem como trabalhar com os recursos e funções básicos da integração do CloudWatch Logs.

**Topics**
+ [CloudWatch Grupos de registros](#cloudwatch-log-overview-groups)
+ [CloudWatch Fluxos de log](#cloudwatch-log-overview-logstream)
+ [CloudWatch Registrar eventos](#cloudwatch-log-overview-logevents)
+ [Acesso adicional aos CloudWatch registros](#cloudwatch-log-overview-additional)

## CloudWatch Grupos de registros
<a name="cloudwatch-log-overview-groups"></a>

Um `log group` é um grupo de `log streams` que compartilham as mesmas configurações de retenção, monitoramento e controle de acesso. Não há limite para o número de streams de log que podem pertencer a um grupo de logs.

### Visualizar grupos de logs
<a name="cloudwatch-log-overview-groups-view"></a>

O `View Log Groups` recurso exibe uma lista de grupos de CloudWatch log no Log Groups Explorer.

Para acessar o recurso Exibir grupos de registros e abrir o Explorador de grupos de CloudWatch registros, conclua as etapas a seguir.

1. No AWS Explorer, expanda a **Amazon CloudWatch**.

1. Clique duas vezes em **Grupos de registros** ou abra o menu de contexto (clique com o botão direito do mouse) e selecione **Exibir** para abrir o Explorador de **grupos de CloudWatch registros**.
**nota**  
O CloudWatch Log Groups Explorer abrirá no mesmo local da janela que o Solutions Explorer.

### Filtrar grupos de logs
<a name="cloudwatch-log-overview-groups-filter"></a>

Sua conta individual pode conter milhares de grupos de logs diferentes. Para simplificar a busca de grupos específicos, use o recurso `filtering` descrito abaixo. 

1. No **CloudWatch Log Groups Explorer**, coloque o cursor na barra de pesquisa localizada na parte superior da janela.

1. Comece a digitar um prefixo relacionado aos grupos de logs que você está procurando.

1. CloudWatch O **Log Groups Explorer** é atualizado automaticamente para mostrar resultados que correspondam aos termos de pesquisa que você especificou na etapa anterior.

### Excluir grupos de logs
<a name="cloudwatch-log-overview-groups-delete"></a>

Para excluir um grupo de logs específico, consulte o procedimento a seguir.

1. No **CloudWatch Log Groups Explorer**, clique com o botão direito do mouse no Grupo de Log que você deseja excluir.

1. Quando solicitado, confirme que deseja excluir o grupo de logs selecionado no momento.

1. Escolher o botão **Sim** exclui o grupo de log selecionado e, em seguida, atualiza o **CloudWatch Log Groups Explorer**.

### Atualizar grupos de logs
<a name="cloudwatch-log-overview-groups-refresh"></a>

**Para atualizar a lista atual de grupos de registros exibida no **Explorer de grupos de CloudWatch registros**, escolha o botão do **ícone Atualizar** localizado na barra de ferramentas.**

### Copiar ARN do grupo de logs
<a name="cloudwatch-log-overview-groups-copyarn"></a>

Para copiar o ARN de um grupo de logs específico, conclua as etapas descritas abaixo.

1. No **CloudWatch Log Groups Explorer**, clique com o botão direito do mouse no Grupo de Log do qual você deseja copiar um ARN.

1. Escolha a opção **Copiar ARN** no menu.

1. O ARN agora está copiado para a área de transferência local e pronto para ser colado.

## CloudWatch Fluxos de log
<a name="cloudwatch-log-overview-logstream"></a>

Fluxo de logs é uma sequência de eventos de log que compartilham a mesma origem.

**nota**  
Ao visualizar os fluxos de logs, atente-se para as seguintes propriedades:  
Por padrão, os fluxos de logs são classificados pelo registro de data e hora do evento mais recente.
As colunas associadas a um fluxo de logs podem ser classificadas em ordem crescente ou decrescente, alternando o **cursor localizado nos cabeçalhos das colunas**.
As entradas filtradas só podem ser classificadas pelo **Nome do fluxo de logs**.

### Visualizar fluxos de logs
<a name="cloudwatch-log-overview-logstream-view"></a>

1. No **Explorer de grupos de CloudWatch registros**, clique duas vezes em um grupo de registros ou clique com o botão direito do mouse em um grupo de registros e selecione **Exibir fluxo de registros** no menu de contexto.

1. Uma nova guia será aberta na janela do **documento**, que contém uma lista dos fluxos de logs associados ao grupo de logs.

### Filtrar fluxos de logs
<a name="cloudwatch-log-overview-logstream-filter"></a>

1. Na guia **Fluxos de logs**, na janela do **documento**, coloque o cursor na barra de pesquisa.

1. Comece a digitar um prefixo relacionado ao fluxo de logs que você está procurando.

1. Conforme você digita, a tela atual é atualizada automaticamente para filtrar os fluxos de log de acordo com sua entrada.

### Atualizar fluxos de logs
<a name="cloudwatch-log-overview-logstream-refresh"></a>

Para atualizar a lista atual de fluxos de logs exibidos na janela do **documento**, escolha o botão do **ícone Atualizar**, localizado na **barra de ferramentas**, ao lado da **barra de pesquisa**.

### Copiar ARN dos fluxos de logs
<a name="cloudwatch-log-overview-logstream-copyarn"></a>

Para copiar o ARN de um fluxo de logs específico, conclua as etapas descritas abaixo.

1. Na guia **Fluxos de logs**, na janela do **documento**, clique com o botão direito no fluxo de logs do qual você deseja copiar um ARN.

1. Escolha a opção **Copiar ARN** no menu.

1. O ARN agora está copiado para a área de transferência local e pronto para ser colado.

### Baixar fluxos de logs
<a name="cloudwatch-log-overview-logstream-delete"></a>

O recurso **Exportar fluxo de logs** baixa e armazena o fluxo de logs selecionado localmente, onde ele pode ser acessado por ferramentas e software personalizados para processamento adicional.

1. Na guia **Fluxos de logs**, na janela do **documento**, clique com o botão direito no fluxo de logs que você deseja baixar.

1. Escolha **Exportar fluxo de logs** para abrir a caixa de diálogo **Exportar para um arquivo de texto**.

1. Escolha o local onde você deseja armazenar o arquivo localmente e especifique um nome no campo de texto fornecido.

1. Confirme o download selecionando **OK**. O status do download é exibido no **Centro de Status de Tarefas do Visual Studio**.

## CloudWatch Registrar eventos
<a name="cloudwatch-log-overview-logevents"></a>

Eventos de log são registros de atividades registradas pelo aplicativo ou recurso que está sendo monitorado pelo CloudWatch.

### Ações de eventos de logs
<a name="cloudwatch-log-overview-logevents-actions"></a>

Os eventos de logs são exibidos como uma tabela. Por padrão, os eventos são classificados do evento mais antigo para o mais recente.

As seguintes ações estão associadas a eventos de logs no Visual Studio:
+ Modo de texto encapsulado: você pode alternar o texto encapsulado clicando em um evento.
+ Botão de quebra de texto: localizado na `document window toolbar`, esse botão ativa e desativa a quebra de texto em todas as entradas.
+ Copiar mensagens para a área de transferência: selecione as mensagens que você deseja copiar, clique com o botão direito na seleção e escolha **Copiar** (atalho de teclado `Ctrl + C`).

### Visualizar eventos de logs
<a name="cloudwatch-log-overview-logevents-view"></a>

1. Na janela do **documento**, escolha uma guia que contenha uma lista de fluxos de logs. 

1. Clique duas vezes em um fluxo de logs ou clique com o botão direito em um fluxo de logs e selecione **Visualizar fluxo de logs** no menu.

1. Uma nova guia de **evento de logs** será aberta na janela do **documento**, que contém uma tabela de eventos de logs associados ao fluxo de logs escolhido.

### Filtrar eventos de logs
<a name="cloudwatch-log-overview-logevents-filter"></a>

Há três maneiras de filtrar eventos de logs: por conteúdo, intervalo de tempo ou ambos. Para filtrar eventos de logs por conteúdo e intervalo de tempo, primeiro filtre as mensagens por conteúdo ou intervalo de tempo e, em seguida, filtre esses resultados pelo outro método.

Para filtrar eventos de logs por conteúdo:

1. Na guia de **Evento de logs**, na janela do **documento**, coloque o cursor na barra de pesquisa, localizada na parte superior da janela.

1. Comece a digitar um termo ou frase relacionada aos eventos de logs que você está procurando.

1. Conforme você digita, a exibição atual começa automaticamente a filtrar os eventos de logs.
**nota**  
Os padrões de filtro diferenciam letras maiúsculas de minúsculas. Você pode melhorar os resultados da pesquisa colocando termos exatos e frases com caracteres não alfanuméricos entre aspas duplas (\$1""\$1). Para obter informações mais detalhadas sobre padrões de filtro, consulte o tópico [Filtro e sintaxe de padrões](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html) no CloudWatch guia da Amazon.

Para visualizar eventos de logs gerados durante um intervalo de tempo específico:

1. Na guia de **Evento de logs**, na janela do **documento**, escolha o botão do **ícone do Calendário**, localizado na **barra de ferramentas**. 

1. Usando os campos fornecidos, especifique o intervalo de tempo que você deseja pesquisar.

1. Os resultados filtrados são atualizados automaticamente conforme você especifica as restrições de data e hora.
**nota**  
A opção **Limpar filtro** limpa todas as suas seleções de date-and-time filtro atuais.

### Atualizar eventos de logs
<a name="cloudwatch-log-overview-logevents-refresh"></a>

Para atualizar a lista atual de eventos de logs exibida na guia **Eventos de logs**, escolha o botão do **ícone Atualizar**, localizado na **barra de ferramentas**.

## Acesso adicional aos CloudWatch registros
<a name="cloudwatch-log-overview-additional"></a>

Você pode acessar CloudWatch os registros associados a outros AWS serviços e recursos diretamente do AWS kit de ferramentas no Visual Studio.

### Lambda
<a name="cloudwatch-log-overview-additional-lambda"></a>

Para visualizar os fluxos de logs associados a uma função do Lambda:

**nota**  
Sua função de execução do Lambda deve ter as permissões apropriadas para enviar registros para CloudWatch o Logs. Para obter mais informações sobre as permissões do Lambda necessárias para o CloudWatch Logs, consulte o [https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs)

1. No AWS Toolkit Explorer, **expanda Lambda**.

1. Clique com o botão direito na função que você deseja visualizar e escolha **Visualizar logs** para abrir os fluxos de logs associados na janela do **documento**.

Para visualizar fluxos de logs usando a integração `function view` com o Lambda:

1. No AWS Toolkit Explorer, **expanda Lambda**.

1. Clique com o botão direito na função que você deseja visualizar e escolha **Visualizar função** para abrir a visualização de função na janela do **documento**.

1. Em `function view`, alterne para a guia **Logs**. Os fluxos de log associados à função do Lambda escolhida são exibidos.

### ECS
<a name="cloudwatch-log-overview-additional-ecs"></a>

Para visualizar recursos de log associados a um contêiner de tarefas do ECS, conclua o procedimento a seguir.

**nota**  
Para que o serviço Amazon ECS envie registros para CloudWatch, cada contêiner de uma determinada tarefa do Amazon ECS deve atender à configuração necessária. Para obter informações adicionais sobre a instalação e as configurações necessárias, consulte o guia [Usando o driver de registro de AWS registros](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html).

1. No AWS Toolkit Explorer, expanda o **Amazon ECS**.

1. Escolha o cluster do Amazon ECS que você deseja visualizar para abrir uma nova guia **Cluster do ECS**, na janela do **documento**.

1. No menu de navegação, localizado no lado esquerdo da guia **Cluster do ECS**, escolha **Tarefas** para listar todas as tarefas associadas ao cluster.

1. Na visualização **Tarefas**, selecione uma tarefa e escolha o link **Visualizar logs**, localizado no canto inferior esquerdo.
**nota**  
Essa visualização lista todas as tarefas contidas no cluster. O link de `View Logs` só fica visível para cada tarefa que atende à configuração de logs necessária.  
Se uma tarefa estiver associada a um único contêiner, o link **Visualizar logs** abrirá o fluxo de logs desse contêiner.
**Se uma tarefa estiver associada a vários contêineres, o link **Exibir registros** abrirá a caixa de diálogo **Exibir CloudWatch registros da tarefa do ECS**, use o menu suspenso **Contêiner:** para escolher o contêiner do qual você deseja visualizar os registros e, em seguida, escolha OK.**

1. Uma nova guia é aberta na janela do **documento** exibindo os fluxos de logs associados à sua seleção de contêineres.