visão geral da extensão Diagnóstico do Azure

A extensão Diagnóstico do Azure é um agente no Azure Monitor que coleta dados de monitoramento do sistema operacional convidado dos recursos de computação do Azure, incluindo máquinas virtuais. Este artigo fornece uma visão geral de Diagnóstico do Azure extensão, a funcionalidade específica à qual ele dá suporte e opções para instalação e configuração.

Importante

Migrar da extensão de diagnóstico do Azure

Diagnóstico do Azure extensão foi descontinuada em 31 de março de 2026 e não há mais suporte. Não use novas implementações da extensão.

Para garantir o suporte contínuo e o acesso a novos recursos, migre das extensões de Diagnósticos do Azure para Linux (LAD) e Windows (WAD) para soluções alternativas seguindo as diretrizes de migração. Remova LAD ou WAD depois de configurar Azure Monitor Agent para evitar dados duplicados.

Para verificar quais extensões estão instaladas em uma única VM, selecione Extensões + aplicativos em Configurações em sua VM. Para examinar as extensões instaladas em todas as máquinas virtuais em assinaturas em que você tem acesso, use a seguinte consulta em Azure Resource Graph:

resources
| where type contains "extension"
| extend parsedProperties = parse_json(properties)
| extend publisher = tostring(parsedProperties.publisher)
| project-away parsedProperties
| where publisher == "Microsoft.Azure.Diagnostics"
| distinct id

Ele produz resultados semelhantes ao seguinte exemplo:

Screenshot mostrando os resultados de uma amostra Azure Resource Graph Query.

Diretrizes de migração

A extensão Diagnóstico do Azure foi preterida em 31 de março de 2026. Para garantir o suporte contínuo e o acesso a novos recursos, migre usando as seguintes opções com base no destino de dados:

Destino Opções de migração
Blobs do Armazenamento do Azure Se você estiver usando agentes WAD ou LAD para enviar dados ao armazenamento para armazenamento de longo prazo e custos mais baixos, migre para Azure Monitor Agent. Em seguida, você pode enviar dados para tabelas personalizadas com o plano auxiliar de baixo custo para registro de log eficiente em termos de custo e benefícios adicionais da análise de logs
Hubs de Eventos do Azure Se você estiver usando agentes WAD ou LAD para enviar dados para os Event Hubs, migre usando o recurso de exportação de dados do Azure Monitor Logs para enviar logs para os Event Hubs.
Métricas do Azure Monitor Para cenários de contador de desempenho do sistema operacional convidado da máquina virtual, migre para o uso do AMW como destino para contadores de desempenho OpenTelemetry. Para cenários de métricas personalizadas, migre para usar AMW como destino para Métricas OpenTelemetry.

Principais cenários

Use a extensão Diagnóstico do Azure se precisar:

Limitações da extensão de Diagnóstico do Azure:

  • Foi descontinuado em 31 de março de 2026.
  • Ele funciona apenas com recursos de Azure.
  • Ele tem capacidade limitada de enviar dados para logs de Azure Monitor.

Custos

Não há custo para a extensão Diagnóstico do Azure, mas poderão haver custos relacionados à ingestão de dados. Verifique os preços do Azure Monitor para o destino onde você está coletando dados.

Dados coletados

As tabelas a seguir listam os dados que podem ser coletados pela extensão de diagnóstico do Windows e do Linux.

Extensão de diagnóstico de Windows (WAD)

Fonte de dados Descrição
logs de eventos Windows Eventos do log de eventos do Windows.
Contadores de desempenho Valores numéricos que medem o desempenho de diferentes aspectos do sistema operacional e das cargas de trabalho.
Logs IIS Informações de uso para sites do IIS em execução no sistema operacional convidado.
Logs de aplicativo Rastreio de mensagens gravadas pelo seu aplicativo.
logs do .NET EventSource Eventos de escrita de código usando a classe .NET EventSource.
Logs do ETW baseados no manifesto Rastreamento de eventos para eventos Windows gerados por qualquer processo.
Despejos de memória (logs) Informações sobre o estado do processo se um aplicativo falhar.
Logs baseados em arquivo Logs criados por seu aplicativo ou serviço.
Logs de diagnóstico do agente Informações sobre Diagnóstico do Azure em si.

Extensão de diagnóstico do Linux (LAD)

Fonte de dados Descrição
syslog Eventos enviados para o sistema de log de eventos do Linux
Contadores de desempenho Valores numéricos que medem o desempenho de diferentes aspectos do sistema operacional e das cargas de trabalho
Arquivos de log Entradas enviadas a um log baseado em arquivo

Destinos de dados

A extensão Diagnóstico do Azure para Windows e Linux sempre coleta dados em uma conta Armazenamento do Azure. Para obter uma lista de tabelas e blobs específicos em que esses dados são coletados, consulte Instale e configure a extensão do Diagnóstico do Azure para Windows e Use a extensão do Diagnóstico do Azure para Linux para monitorar métricas e logs.

Configure um ou mais coletores de dados para enviar dados a outros destinos. As seções a seguir listam os coletores disponíveis para a extensão de diagnóstico do Windows e do Linux.

Extensão de diagnóstico de Windows (WAD)

Destino Descrição
Métricas de Azure Monitor Colete dados de desempenho para Azure Monitor Métricas. Consulte Enviar métricas do sistema operacional convidado para o banco de dados de métricas do Azure Monitor.
Hubs de Eventos Use Hubs de Eventos do Azure para enviar dados fora do Azure. Confira Transmitir dados do Diagnóstico do Azure para os Hubs de Eventos do Azure.
Blobs do Armazenamento do Azure Escreva dados em blobs em Armazenamento do Azure além de tabelas.
Application Insights Para se integrar a outro monitoramento de aplicativos, colete dados de aplicativos em execução em sua VM para o Application Insights. Confira Enviar dados de diagnóstico para o Application Insights.

Você também pode coletar dados do WAD do armazenamento para um workspace do Log Analytics a fim de analisá-los com Logs do Azure Monitor, embora o agente do Log Analytics seja normalmente usado para essa funcionalidade. Ele pode enviar dados diretamente para uma área de trabalho do Log Analytics e suporta soluções e insights que fornecem mais funcionalidades. Confira Coletar logs de diagnóstico do Azure do Armazenamento do Azure.

Extensão de diagnóstico do Linux (LAD)

O LAD grava dados em tabelas em Armazenamento do Azure. Ele dá suporte aos coletores na tabela a seguir.

Destino Descrição
Hubs de Eventos Use Hubs de Eventos do Azure para enviar dados fora do Azure.
Blobs do Armazenamento do Azure Escreva dados em blobs em Armazenamento do Azure além de tabelas.
Métricas de Azure Monitor Instale o agente do Telegraf, além do LAD. Confira Coletar métricas personalizadas para uma VM Linux com o agente InfluxData Telegraf.

Instalação e configuração

A extensão de diagnóstico é implementada como uma extensão de máquina virtual em Azure, portanto, dá suporte às mesmas opções de instalação usando modelos Azure Resource Manager, o PowerShell e o CLI do Azure. Para obter informações sobre como instalar e manter extensões de máquina virtual, consulte Extensões e recursos de máquinavirtual para Windows e Extensões e recursos de máquinavirtual para Linux.

Você também pode instalar e configurar ambas as extensões de diagnóstico do Windows e do Linux no portal do Azure em Configurações de diagnóstico na seção Monitoramento do menu da máquina virtual.

Consulte os seguintes artigos para obter informações sobre como instalar e configurar a extensão de diagnóstico para Windows e Linux:

Sistemas operacionais compatíveis

As tabelas a seguir listam os sistemas operacionais compatíveis com WAD e LAD. Confira a documentação de cada agente para obter considerações exclusivas e o processo de instalação. Confira a documentação do Telegraf para ver os sistemas operacionais compatíveis com ele. Nós supomos que todos os sistemas operacionais sejam x64. O x86 não é compatível com nenhum sistema operacional.

Windows

Sistema operacional Suporte
Windows Server 2022
núcleo do Windows Server 2022
Windows Server 2019
núcleo do Windows Server 2019
Windows Server 2016
Núcleo do Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
Windows 11 Cliente & Pro
Windows 11 Enterprise (incluindo várias sessões)
Windows 10 1803 (RS4) e superior
Windows 10 Enterprise (incluindo várias sessões) e Pro (somente cenários de servidor)

Linux

Sistema operacional Suporte
CentOS Linux 9
CentOS Linux 8
CentOS Linux 7
Debian 12
Debian 11
Debian 10
Debian 9
Debian 8
Oracle Linux 9
Oracle Linux 8
Oracle Linux 7
Oracle Linux 6.4+
Servidor Red Hat Enterprise Linux 9
Servidor Red Hat Enterprise Linux 8*
Red Hat Enterprise Linux Server 7
SUSE Linux Enterprise Server 15
SUSE Linux Enterprise Server 12
Ubuntu 22.04 LTS
Ubuntu 20.04 LTS
Ubuntu 18.04 LTS
Ubuntu 16.04 LTS
Ubuntu 14.04 LTS

* Requer que o Python 2 esteja instalado no computador e que seja criado um alias para o comando python.

Outra documentação

Para obter mais informações, consulte os seguintes artigos.

Funções Web e de trabalho dos Serviços de Nuvem do Azure (clássico)

Azure Service Fabric

Monitorar e diagnosticar serviços em uma configuração de desenvolvimento de computador local

Próximas etapas