Compartilhar via

O que é a instrumentação automática para o Application Insights do Azure Monitor?

  • Artigo

A instrumentação automática permite que o Application Insights disponibilize telemetria como métricas, solicitações e dependências disponíveis no seu recurso do Application Insights. Ela fornece acesso fácil a experiências como o painel do aplicativo e o mapa do aplicativo.

O termo "autoinstrumentação" é um portmanteau, uma mistura linguística onde partes de várias palavras se combinam em uma nova palavra. "Autoinstrumentação" combina "auto" e "instrumentação". Ele é amplamente usado na observabilidade de software e descreve o processo de adição de código de instrumentação a aplicativos sem codificação manual por desenvolvedores.

O processo de autoinstrumentação varia de acordo com o idioma e a plataforma, mas geralmente envolve um botão de alternância no portal do Azure. O exemplo a seguir mostra um botão de alternância para a autoinstrumentação do Serviço de Aplicativo do Azure.

Captura de tela que mostra a guia Application Insights com Habilitar selecionado.

Dica

Neste artigo, não fornecemos especificações de autoinstrumentação para todos os idiomas e plataformas. Para obter informações detalhadas, selecione o link correspondente na Tabela de ambientes, idiomas e provedores de recursos com suporte. Em muitos casos, a instrumentação automática é habilitada por padrão.

Quais são as vantagens da instrumentação automática?

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

Ambientes, linguagens e provedores de recursos com suporte

A tabela a seguir mostra o estado atual de disponibilidade da instrumentação automática.

Os links são fornecidos para informações adicionais para cada cenário com suporte.

Observação

Se o ambiente de hospedagem ou o provedor de recursos não estiver listado na tabela a seguir, não há suporte para a autoinstrumentação. Nesse caso, recomendamos instrumentar manualmente usando o Azure Monitor OpenTelemetry Distro. Para obter mais informações, confira Noções básicas da Coleta de Dados do Application Insights do Azure Monitor.

Ambiente/Provedor de recursos .NET Framework .NET Core/.NET Java Node.js Python
Serviço de Aplicativo do Azure no Windows - Publicar como código ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹ ❌
Serviço de Aplicativo do Azure no Windows - Publicar como docker ✅ 🔗 ² ✅ 🔗 ² ✅ 🔗 ² ✅ 🔗 ² ❌
Serviço de Aplicativo do Azure no Linux – Publicação como código ❌ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ²
Serviço de Aplicativo do Azure no Linux – Publicação como Docker ❌ ✅ 🔗 ✅ 🔗 ✅ 🔗 ❌
Azure Functions – básico ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹
Funções/dependências do Azure ❌ ❌ ✅ 🔗 ❌ ❌
Azure Spring Apps ❌ ❌ ✅ 🔗 ❌ ❌
AKS (Serviço de Kubernetes do Azure) ❌ ❌ ✅ 🔗 ❌ ❌
VMs do Azure no Windows ✅ 🔗 ² ³ ✅ 🔗 ² ³ ✅ 🔗 ❌ ❌
VMs locais do Windows ✅ 🔗 ³ ✅ 🔗 ² ³ ✅ 🔗 ❌ ❌
Agente autônomo – Qualquer ambiente ❌ ❌ ✅ 🔗 ❌ ❌

Notas de rodapé

Observação

A autoinstrumentação era conhecida como "anexação sem código" antes de outubro de 2021.

Perguntas frequentes

O termo "autoinstrumentação" deve ser hifenizado?

Seguimos o Guia de Estilo da Microsoft para a documentação de produtos publicada na plataforma Microsoft Learn.

Em geral, não incluímos um hífen após o prefixo "auto".

Próximas etapas