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

  • Artigo

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 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 vê o uso generalizado na observabilidade de software e descreve o processo de adicionar 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 Ativar selecionado.

Gorjeta

Não fornecemos detalhes de autoinstrumentação 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 instrumentar manualmente 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 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 - Publicar como código ❌ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ²
Serviço de Aplicativo do Azure no Linux - Publicar como Docker ❌ ✅ 🔗 ✅ 🔗 ✅ 🔗 ❌
Azure Functions - básico ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹ ✅ 🔗 ¹
Azure Functions - dependências ❌ ❌ ✅ 🔗 ❌ ❌
Azure Spring Apps ❌ ❌ ✅ 🔗 ❌ ❌
Azure Kubernetes Service (AKS) ❌ ❌ ✅ 🔗 ❌ ❌
Azure VMs Windows ✅ 🔗 ² ³ ✅ 🔗 ² ³ ✅ 🔗 ❌ ❌
VMs locais do Windows ✅ 🔗 ³ ✅ 🔗 ² ³ ✅ 🔗 ❌ ❌
Agente independente - qualquer ambiente ❌ ❌ ✅ 🔗 ❌ ❌

Notas de rodapé

Nota

A autoinstrumentação era conhecida como "codeless attach" antes de outubro de 2021.

Perguntas mais frequentes

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

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

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

Próximos passos