Habilitar Azure Monitor OpenTelemetry para aplicativos .NET, Node.js, Python e Java

Este artigo descreve como habilitar e configurar a coleta de dados baseada em OpenTelemetry em Azure Monitor Application Insights. Distribuições do OpenTelemetry do Azure Monitor:

Fornece uma distribuição OpenTelemetry, que inclui suporte para recursos específicos de Azure Monitor.
Habilita telemetria automática, incluindo bibliotecas de instrumentação OpenTelemetry para coletar rastreamentos, métricas, logs e exceções.
Permite coletar telemetria personalizada.
Dá suporte às Métricas em Tempo Real para monitorar e coletar telemetria de aplicativos web em produção.

Para obter mais informações sobre as vantagens de usar o Azure Monitor OpenTelemetry Distro, consulte Por que devo usar o Azure Monitor OpenTelemetry Distro.

Para saber mais sobre como coletar dados usando OpenTelemetry, confira Coletar OpenTelemetry (OTel) para experiências do Application Insights ou as perguntas frequentes sobre o OpenTelemetry.

Status de versão do OpenTelemetry

As ofertas do OpenTelemetry estão disponíveis para aplicativos .NET, Node.js, Python e Java. Para obter um status de versão de recurso por recurso, confira as Perguntas frequentes.

Observação

Para Aplicativos de Função do Azure, consulte Use OpenTelemetry com Azure Functions.

Habilitar o OpenTelemetry com o Application Insights

Siga as etapas nesta seção para instrumentar seu aplicativo com o OpenTelemetry. Selecione uma aba para instruções específicas do idioma.

Observação

.NET abrange vários cenários, incluindo ASP.NET clássicos, aplicativos de console, Windows Forms (WinForms) e muito mais.

Pré-requisitos

Azure assinatura: Criar uma assinatura Azure gratuitamente
Recurso do Application Insights: criar um recurso do Application Insights

ASP.NET Core Application usando uma versão oficialmente compatível do .NET

Dica

Se você estiver migrando da API Clássica do Application Insights, consulte nossa documentação de migração.

Instalar a biblioteca de clientes

Instale o pacote Azure.Monitor.OpenTelemetry.AspNetCoreNuGet mais recente:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

Instale o pacote Azure.Monitor.OpenTelemetry.ExporterNuGet mais recente:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

Instale o pacote mais recente @azure/monitor-opentelemetry :

npm install @azure/monitor-opentelemetry

Os seguintes pacotes também são usados para alguns cenários específicos descritos posteriormente neste artigo:

npm install @opentelemetry/api
npm install @opentelemetry/sdk-metrics
npm install @opentelemetry/resources
npm install @opentelemetry/semantic-conventions
npm install @opentelemetry/sdk-trace-base

Instale a versão mais recente do pacote PyPI azure-monitor-opentelemetry:

pip install azure-monitor-opentelemetry

Modificar o aplicativo

Importe o namespace Azure.Monitor.OpenTelemetry.AspNetCore, adicione OpenTelemetry e configure-o para usar Azure Monitor na 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();

Adicione o exportador de Azure Monitor a cada sinal OpenTelemetry na classe program.cs:

// Create a new tracer provider builder and add an Azure Monitor trace exporter to the tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/trace#tracerprovider-management
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter();

// Add an Azure Monitor metric exporter to the metrics provider builder.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics#meterprovider-management
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddAzureMonitorMetricExporter();

// Create a new logger factory.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/logs#logger-management
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        logging.AddAzureMonitorLogExporter();
    });
});

Observação

Para obter mais informações, consulte o tutorial de início rápido para o OpenTelemetry .NET.

A instrumentação automática é habilitada por meio de alterações de configuração. Nenhuma alteração de código é necessária.

Aponte a Java Virtual Machine (JVM) para o arquivo jar adicionando -javaagent:"path/to/applicationinsights-agent-3.7.5.jar" aos argumentos da JVM do aplicativo.

Observação

A amostragem é habilitada por padrão a uma taxa de cinco solicitações por segundo, auxiliando no gerenciamento de custos. Os dados de telemetria podem estar ausentes em cenários que excedem essa taxa. Para obter mais informações sobre como modificar a configuração da amostragem, consulte substituições de amostragem. Se você estiver vendo encargos inesperados ou custos altos no Application Insights, este guia poderá ajudar. Ele aborda causas comuns, como alto volume de telemetria, picos de ingestão de dados e amostragem configurada incorretamente. É especialmente útil se você estiver solucionando problemas relacionados a picos de custo, volume de telemetria, amostragem não funcionando, limites de dados, ingestão alta ou cobrança inesperada. Para começar, veja Solucionar problemas de alta ingestão de dados no Application Insights.

Dica

Para obter orientações específicas do cenário, consulte Introdução (Suplementar).

Dica

Se você desenvolver um aplicativo Spring Boot, poderá substituir o argumento JVM por uma configuração programática. Para obter mais informações, consulte Usando o Azure Monitor Application Insights com Spring Boot.

// Import the `useAzureMonitor()` function from the `@azure/monitor-opentelemetry` package.
const { useAzureMonitor } = require("@azure/monitor-opentelemetry");

// Call the `useAzureMonitor()` function to configure OpenTelemetry to use Azure Monitor.
useAzureMonitor();

import logging
# Import the `configure_azure_monitor()` function from the
# `azure.monitor.opentelemetry` package.
from azure.monitor.opentelemetry import configure_azure_monitor

# Configure OpenTelemetry to use Azure Monitor with the 
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor(
    logger_name="<your_logger_namespace>",  # Set the namespace for the logger in which you would like to collect telemetry for if you are collecting logging telemetry. This is imperative so you do not collect logging telemetry from the SDK itself.
)
logger = logging.getLogger("<your_logger_namespace>")  # Logging telemetry will be collected from logging calls made with this logger and all of it's children loggers.

Copiar o connection string do recurso do Application Insights

O connection string é exclusivo e especifica onde o Azure Monitor OpenTelemetry Distro envia a telemetria coletada.

Dica

Se você ainda não tem um recurso do Application Insights, crie um seguindo este guia. Recomendamos que você crie um novo recurso em vez de usar um recurso existente.

Para copiar a cadeia de conexão:

Acesse o painel Visão geral do recurso Application Insights.
Encontre sua cadeia de conexão.
Passe o mouse sobre a cadeia de conexão e selecione o ícone Copiar para a área de transferência.

Colar a cadeia de conexão em seu ambiente

Para colar seu connection string, selecione entre as seguintes opções:

Importante

É recomendável definir o connection string por meio do código somente em ambientes de desenvolvimento e teste locais.

Para produção, use uma variável de ambiente ou arquivo de configuração (somente Java).

Definir por meio de variável de ambiente - recomendado

Substitua <Your connection string> no comando a seguir por sua cadeia de conexão.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Set via arquivo de configuração - Somente Java

Crie um arquivo de configuração chamado applicationinsights.json e coloque-o no mesmo diretório que applicationinsights-agent-3.7.5.jar com o seguinte conteúdo:
```
{
  "connectionString": "<Your connection string>"
}
```
Substitua <Your connection string> no JSON anterior por sua string de conexão exclusiva.
Set via code - ASP.NET Core, Node.js, e Python apenas

Consulte configuração da string de conexão para obter um exemplo de configuração da string de conexão via código.

Observação

Se você definir o connection string em vários locais, a variável de ambiente será priorizada na seguinte ordem:

Code
Variável de ambiente
Arquivo de configuração

Confirmar se os dados estão fluindo

Execute seu aplicativo e abra o Application Insights no portal Azure. Pode levar alguns minutos para os dados aparecerem.

Captura de tela da guia Visão geral do Application Insights com as solicitações de servidor e o tempo de resposta do servidor realçados.

Agora, o Application Insights está habilitado para seu aplicativo. As etapas a seguir são opcionais e permitem uma personalização adicional.

Observação

Como parte do uso da instrumentação do Application Insights, coletamos e enviamos dados de diagnóstico para a Microsoft. Esses dados nos ajudam a executar e a aprimorar o Application Insights. Saiba mais nas perguntas frequentes do Application Insights.

Importante

Se você tem dois ou mais serviços que emitem telemetria para o mesmo recurso do Application Insights, precisa definir Nomes de Função de Nuvem para representá-los corretamente no Mapa do Aplicativo.

Solução de problemas, comentários e suporte

Dica

As seções a seguir estão disponíveis em todos os artigos do OpenTelemetry Distro.

Solução de problemas

Para obter informações de solução de problemas, consulte Solucionar problemas do OpenTelemetry no .NET e solucionar problemas de telemetria de aplicativo ausente no Azure Monitor Application Insights.

Comentários sobre o OpenTelemetry

Para fornecer comentários:

Preencha a pesquisa de comentários do cliente da Comunidade do OpenTelemetry.
Fale um pouco sobre você para a Microsoft: ingresse na Comunidade de usuário pioneiro do OpenTelemetry.
Entre em contato com outros usuários do Azure Monitor na Comunidade de tecnologia da Microsoft.
Solicite um recurso no Fórum de comentários do Azure.

Suporte

Selecione uma aba do idioma de sua escolha para descobrir as opções de suporte.

Se você tiver problemas com o Suporte do Azure, abra um tíquete de suporte do Azure.
Para problemas de OpenTelemetry, entre em contato diretamente com a comunidade do OpenTelemetry .NET.
Para obter uma lista de problemas abertos relacionados ao Exportador do Azure Monitor, confira a Página de Problemas do GitHub.

Próximas etapas

Para examinar o código-fonte, consulte o repositório do GitHub ASP.NET Core do Azure Monitor.
Para examinar um aplicativo de exemplo, veja Azure Monitor OpenTelemetry para ASP.NET Core.
Para instalar o pacote NuGet, verificar atualizações ou consultar as notas de versão, consulte a página Pacote NuGet do Azure Monitor AspNetCore.
Para saber mais sobre o OpenTelemetry e sua comunidade, consulte o OpenTelemetry .NET GitHub repositório.
Para habilitar experiências de uso, habilite o monitoramento do usuário no navegador ou na Web.

Para examinar o código-fonte, consulte o repositório OpenTelemetry do Azure Monitor para JavaScript.
Para examinar um aplicativo de exemplo, consulte OpenTelemetry do Azure Monitor para Node.js.
Para instalar o pacote npm e verificar se há atualizações, confira a página @azure/monitor-opentelemetry Pacote npm.
Para saber mais sobre o OpenTelemetry e sua comunidade, consulte o OpenTelemetry JavaScript GitHub repositório.
Para habilitar experiências de uso, habilite o monitoramento do usuário no navegador ou na Web.

Comentários

Esta página foi útil?

Last updated on 2026-03-13

Compartilhar via

Habilitar Azure Monitor OpenTelemetry para aplicativos .NET, Node.js, Python e Java

Status de versão do OpenTelemetry

Habilitar o OpenTelemetry com o Application Insights

Pré-requisitos

Instalar a biblioteca de clientes

Modificar o aplicativo

Copiar o connection string do recurso do Application Insights

Colar a cadeia de conexão em seu ambiente

Confirmar se os dados estão fluindo

Solução de problemas, comentários e suporte

Solução de problemas

Comentários sobre o OpenTelemetry

Suporte

Próximas etapas

Comentários

Recursos adicionais