Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo descreve como ativar e configurar a recolha de dados baseada em OpenTelemetry dentro do Azure Monitor Application Insights. A Distro do Azure Monitor OpenTelemetry:
- Fornece uma distribuição OpenTelemetry, que inclui suporte para funcionalidades específicas de Azure Monitor.
- Permite a telemetria automática ao incluir bibliotecas de instrumentação OpenTelemetry para recolha de rastreios, métricas, logs e exceções.
- Permite coletar telemetria personalizada .
- Suporta Métricas ao Vivo para monitorizar e recolher telemetria de aplicações web em produção ao vivo.
Para mais informações sobre as vantagens de usar a Azure Monitor OpenTelemetry Distro, consulte Porque devo usar a Azure Monitor OpenTelemetry Distro.
Para saber mais sobre a recolha de dados usando o OpenTelemetry, consulte o Collect OpenTelemetry (OTel) para as experiências do Application Insights ou o FAQ do OpenTelemetry.
Status da versão do OpenTelemetry
As ofertas OpenTelemetry estão disponíveis para aplicações .NET, Node.js, Python e Java. Para obter um status de versão recurso por recurso, consulte as Perguntas frequentes.
Nota
Para Aplicações de Funções do Azure, veja Use OpenTelemetry com Funções do Azure.
Habilite o OpenTelemetry com o Application Insights
Siga as etapas nesta seção para instrumentar seu aplicativo com OpenTelemetry. Selecione um separador para obter instruções específicas do idioma.
Nota
O .NET cobre vários cenários, incluindo o clássico ASP.NET, aplicações de consola, Windows Forms (WinForms) e mais.
Pré-requisitos
- Azure subscrição: Crie uma subscrição Azure gratuitamente
- Recurso do Application Insights: Criar um recurso do Application Insights
- ASP.NET Core Application usando uma versão oficialmente suportada de .NET
Gorjeta
Se está a migrar da API Application Insights Classic, consulte a nossa documentação de migração.
Instalar a biblioteca de cliente
Instale o pacote mais recente Azure.Monitor.OpenTelemetry.AspNetCoreNuGet:
dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore
Modificar a sua candidatura
Importa o namespace Azure.Monitor.OpenTelemetry.AspNetCore, adiciona OpenTelemetry e configura-o para usar Azure Monitor na tua classe program.cs:
// Import the Azure.Monitor.OpenTelemetry.AspNetCore namespace.
using Azure.Monitor.OpenTelemetry.AspNetCore;
var builder = WebApplication.CreateBuilder(args);
// Add OpenTelemetry and configure it to use Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor();
var app = builder.Build();
app.Run();
Copie a cadeia de ligação do seu recurso Application Insights
A cadeia de ligação é única e especifica para onde a Azure Monitor OpenTelemetry Distro envia a telemetria que recolhe.
Gorjeta
Se você ainda não tiver um recurso do Application Insights, crie um seguindo este guia. Recomendamos que você crie um novo recurso em vez de usar um existente.
Para copiar a cadeia de conexão:
- Vá para o painel Visão geral do recurso do Application Insights.
- Encontre a sua cadeia de conexão.
- Passe o cursor sobre a cadeia de ligação e selecione o ícone Copiar para a prancheta.
Cole a cadeia de conexão no seu ambiente
Para colar a sua cadeia de ligação, selecione entre as seguintes opções:
Importante
Recomendamos definir a cadeia de ligação através do código apenas em ambientes locais de desenvolvimento e testes.
Para produção, use uma variável de ambiente ou ficheiro de configuração (apenas em Java).
Definir através da variável de ambiente - recomendado
Substitua
<Your cadeia de ligação>no comando seguinte pela sua string de conexão.APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>Definir via ficheiro de configuração - Somente Java
Crie um arquivo de configuração chamado
applicationinsights.json, e coloque-o no mesmo diretório queapplicationinsights-agent-3.7.8.jarcom o seguinte conteúdo:{ "connectionString": "<Your connection string>" }Substitua
<Your cadeia de ligação>no JSON anterior pelo seu cadeia de ligação único.definido via código - ASP.NET Core, Node.js e Python apenas
Veja cadeia de ligação configuration para um exemplo de definição de cadeia de ligação via código.
Nota
Se definir a cadeia de ligação em vários lugares, a variável de ambiente é priorizada na seguinte ordem:
- Código
- Variável de ambiente
- Arquivo de configuração
Confirmar que os dados estão fluindo
Execute a sua aplicação e depois abra o Application Insights no portal Azure. Pode levar alguns minutos para que os dados apareçam.
O Application Insights agora está habilitado para seu aplicativo. As etapas a seguir são opcionais e permitem mais personalização.
Nota
Como parte da utilização da instrumentação Application Insights, recolhemos e enviamos dados de diagnóstico à Microsoft. Esses dados nos ajudam a executar e melhorar o Application Insights. Saiba mais nas Perguntas Frequentes de Insights de Aplicação.
Importante
Se você tiver dois ou mais serviços que emitem telemetria para o mesmo recurso do Application Insights, será necessário definir Nomes de Função na Nuvem para representá-los corretamente no Mapa do Aplicativo.
Resolução de problemas, feedback e suporte
Gorjeta
As secções seguintes estão disponíveis em todos os artigos da OpenTelemetry Distro.
Troubleshooting
Para obter informações sobre a resolução de problemas, consulte Troubleshoot OpenTelemetry issues in .NET e Troubleshoot missing application telemetry in Azure Monitor Application Insights.
Comentários do OpenTelemetry
Para fornecer comentários:
- Preencha a pesquisa de feedback do cliente da comunidade OpenTelemetria.
- Conte à Microsoft sobre si ao juntar-se à Comunidade de Adotantes Precoces OpenTelemetry.
- Interaja com outros utilizadores Azure Monitor na Microsoft Comunidade Tecnológica.
- Faça um pedido de funcionalidade no Fórum de Feedback Azure.
Suporte
Selecione um separador do idioma da sua escolha para descobrir opções de suporte.
- Para questões de suporte do Azure, abra um ticket de suporte do Azure.
- Para questões relacionadas com a OpenTelemetry, contacte diretamente a comunidade .NET OpenTelemetry.
- Para uma lista de questões em aberto relacionadas com Azure Monitor Exporter, consulte a Página de Problemas GitHub.
Próximos passos
- Para rever o código-fonte, consulte o repositório Azure Monitor ASP.NET Core GitHub.
- Para rever uma aplicação de exemplo, consulte Azure Monitor OpenTelemetry para ASP.NET Core.
- Para instalar o pacote NuGet, verifique atualizações ou consulte as notas de lançamento, consulte a página Azure Monitor AspNetCore NuGet Package.
- Para saber mais sobre a OpenTelemetry e a sua comunidade, consulte o repositório .NET GitHub OpenTelemetry.
- Para habilitar experiências de uso, habilite o monitoramento de usuários da Web ou do navegador.