Trabalhar com o CloudWatch Logs no Visual Studio - AWS Kit de ferramentas com Amazon Q
Grupo de logs do CloudWatchFluxos de logs do CloudWatchEventos de logs do CloudWatchAcesso adicional aos logs do CloudWatch

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

Trabalhar com o CloudWatch Logs no Visual Studio

A integração do Amazon CloudWatch Logs permite monitorar, armazenar e acessar o CloudWatch Logs por meio do kit de ferramentas da AWS para Visual Studio com Amazon Q. Ter acesso aos recursos do CloudWatch Logs sem precisar sair do IDE melhora a eficiência ao simplificar o processo de desenvolvimento no CloudWatch Logs e reduzir interrupções no fluxo de trabalho. Os tópicos a seguir descrevem como trabalhar com os recursos e as funções básicas da integração do CloudWatch Logs.

Grupo de logs do CloudWatch

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

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

Para acessar o recurso View Log Groups e abrir o CloudWatch Log Groups Explorer, conclua as etapas a seguir.

  1. No AWS Explorer, expanda o Amazon CloudWatch.

  2. Clique duas vezes em Grupos de logs ou abra o menu de contexto (clique com o botão direito) e selecione Visualizar para abrir o CloudWatch Log Groups Explorer.

    nota

    O CloudWatch Log Groups Explorer abrirá no mesmo local da janela que o Solutions Explorer.

Filtrar grupos de logs

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.

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

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

Excluir grupos de logs

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 logs que você deseja excluir.

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

  3. Escolher o botão Sim exclui o grupo de logs selecionado e, em seguida, atualiza o CloudWatch Log Groups Explorer.

Atualizar grupos de logs

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

Copiar ARN do grupo de logs

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 logs do qual você deseja copiar um ARN.

  2. Escolha a opção Copiar ARN no menu.

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

Fluxos de logs do CloudWatch

Uma transmissão de log é uma sequência de eventos de log que compartilham a mesma fonte.

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

  1. No CloudWatch Log Groups Explorer, clique duas vezes em um grupo de logs ou clique com o botão direito em um grupo de logs e selecione Visualizar fluxo de logs no menu de contexto.

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

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

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

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

Atualizar fluxos de logs

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

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.

  2. Escolha a opção Copiar ARN no menu.

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

Baixar fluxos de logs

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.

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

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

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

Eventos de logs do CloudWatch

Eventos de logs são registros de atividades registradas pela aplicação ou pelo recurso que está sendo monitorado pelo CloudWatch.

Ações de eventos de logs

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

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

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

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

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.

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

  3. 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 (*""*). Para obter mais informações sobre padrões de filtro, consulte o tópico Filter and Pattern Syntax no Guia do Amazon CloudWatch.

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.

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

  3. 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 seleções atuais de filtro de data e hora.

Atualizar eventos de logs

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 logs do CloudWatch

Você pode acessar os logs do CloudWatch associados a outros recursos e serviços da AWS diretamente pelo kit de ferramentas da AWS para Visual Studio.

Lambda

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

nota

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

  1. No Explorer do kit de ferramentas da AWS, expanda Lambda.

  2. 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 Explorer do kit de ferramentas da AWS, expanda Lambda.

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

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

ECS

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 logs ao CloudWatch, cada contêiner de 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 Usar o driver de log awslogs.

  1. No Explorer do kit de ferramentas da AWS, expanda Amazon ECS.

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

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

  4. 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 Visualizar logs abrirá a caixa de diálogo Visualizar logs do CloudWatch para tarefa do ECS. Use o menu suspenso Contêiner para escolher o contêiner do qual você deseja visualizar os logs e selecione OK.

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