O que é a autoinstrumentação no Azure Monitor Application Insights?

A autoinstrumentação permite que o Application Insights disponibilize telemetria , como métricas, solicitações e dependências, em seu recurso do Application Insights. Ele fornece acesso fácil a experiências como o painel do aplicativo e o mapa do aplicativo.

O termo "autoinstrumentação" é um amálgama, uma mistura linguística onde partes de várias palavras se combinam numa nova palavra. "Autoinstrumentação" combina "auto" e "instrumentação". É amplamente utilizado na observabilidade de software e descreve o processo de adicionar código de instrumentação a aplicações sem que os desenvolvedores precisem escrever código manualmente.

O processo de autoinstrumentação varia de acordo com o idioma e a plataforma, mas geralmente envolve um botão de ativação/desativação no Azure Portal. O exemplo a seguir mostra um botão de alternar para a autoinstrumentação do Serviço de Aplicativo do Azure.

Gorjeta

Não fornecemos detalhes de instrumentação automática para todos os idiomas e plataformas neste artigo. Para obter informações detalhadas, selecione o link correspondente na tabela Ambientes suportados, idiomas e provedores de recursos. Em muitos casos, a autoinstrumentação é ativada por padrão.

Quais são as vantagens da autoinstrumentação?

• Não são necessárias alterações de código.
• O acesso ao código-fonte não é necessário.
• Não são necessárias alterações de configuração.
• A manutenção da instrumentação é eliminada.

Ambientes, idiomas e provedores de recursos suportados

A tabela a seguir mostra o estado atual da disponibilidade da autoinstrumentação.

São fornecidos links para obter mais informações para cada cenário suportado.

Nota

Se o seu ambiente de hospedagem ou provedor de recursos não estiver listado na tabela a seguir, a autoinstrumentação não será suportada. Nesse caso, recomendamos a instrumentação manual usando a Distro OpenTelemetry do Azure Monitor. Para obter mais informações, consulte Noções básicas de coleta de dados do Azure Monitor Application Insights.

Provedor de ambiente/recursos	.NET Framework	.NET Core / .NET	Java	Node.js	Píton
Serviço de Aplicativo do Azure no Windows - Publicar como código	✅ 🔗 ¹	✅ 🔗 ¹	✅ 🔗 ¹	✅ 🔗 ¹	❌
Serviço de Aplicativo do Azure no Windows - Publicar como contêiner ⁴	✅ 🔗 ²	✅ 🔗 ²	✅ 🔗 ²	✅ 🔗 ²	❌
Serviço de Aplicativo do Azure no Linux - Publicar como código	❌	✅ 🔗 ¹	✅ 🔗 ¹	✅ 🔗 ¹	✅ 🔗 ²
Serviço de Aplicativo do Azure no Linux - Publicar como contêiner ⁴	❌	✅ 🔗	✅ 🔗	✅ 🔗	❌
Azure Functions - básico	✅ 🔗 ¹	✅ 🔗 ¹	✅ 🔗 ¹	✅ 🔗 ¹	✅ 🔗 ¹
Azure Functions - dependências	❌	❌	✅ 🔗	❌	❌
Azure Spring Apps	❌	❌	✅ 🔗	❌	❌
Serviço Kubernetes do Azure (AKS)	❌	❌	✅ 🔗 ²	✅ 🔗 ²	❌
Máquinas Virtuais Azure Windows	✅ 🔗 ² ³	✅ 🔗 ² ³	✅ 🔗	❌	❌
Máquinas virtuais locais Windows	✅ 🔗 ³	✅ 🔗 ² ³	✅ 🔗	❌	❌
Agente independente - qualquer ambiente	❌	❌	✅ 🔗	❌	❌

Notas de rodapé

• ¹: O Application Insights está ativado por padrão e ativado automaticamente.
• ²: Este recurso está em pré-visualização pública. Consulte Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure.
• ³: Um agente deve ser implantado e configurado.
• ⁴: A autoinstrumentação suporta apenas aplicações de recipiente único. Para aplicações de vários contentores, é necessária a instrumentação manual usando a Distro OpenTelemetry do Azure Monitor.

Nota

Autoinstrumentação era conhecida como "codeless attach" (ligação sem código) antes de outubro de 2021.

Próximos passos

• Para rever as perguntas mais frequentes (FAQ), consulte Perguntas frequentes sobre autoinstrumentação
• Visão geral do Application Insights
• Painel de visão geral do Application Insights
• Application map (Mapeamento de aplicações)