Compartilhar via


Adicionar o Azure Application Insights usando os Serviços Conectados do Visual Studio

Com o Visual Studio, você pode conectar qualquer um dos seguintes ao Azure Application Insights usando o recurso Serviços Conectados:

  • Aplicativo de console do .NET Framework
  • MVC (Model-View-Controller) do ASP.NET (.NET Framework)
  • ASP.NET Core
  • .NET Core (incluindo aplicativo de console, WPF, Windows Forms, biblioteca de classes)
  • Função de trabalho do .NET Core
  • Azure Functions
  • Aplicativo da Plataforma Universal do Windows
  • Xamarin
  • Cordova

A funcionalidade de serviço conectado adiciona todas as referências necessárias e código de conexão ao seu projeto e modifica os arquivos de configuração adequadamente.

Pré-requisitos

Conectar-se ao Azure Application Insights usando serviços conectados

  1. Abra seu projeto no Visual Studio.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Serviços Conectados e, no menu de contexto, selecione Adicionar Serviço Conectado.

  3. Na guia Serviços Conectados, selecione o ícone + para Dependências de Serviço.

    Captura de tela mostrando a tela

    Se você não vir o nó Serviços Conectados, escolha Projeto>Serviços Conectados>Adicionar.

  4. Na página Adicionar Dependência, selecione Azure Application Insights.

    Captura de tela mostrando a tela

    Se você ainda não estiver conectado, entre em sua conta do Azure. Se você não tiver uma conta do Azure, poderá se inscrever para uma avaliação gratuita .

  5. Na tela Configurar Azure Application Insights, selecione um componente existente do Azure Application Insights e selecione Avançar.

    Se você precisar criar um novo componente, vá para a próxima etapa. Caso contrário, pule para a etapa 7.

    Captura de tela mostrando

  6. Para criar um componente do Application Insights:

    1. Selecione Criar um novo componente do Application Insights na parte inferior da tela.

    2. Preencha a tela Application Insights: Criar e selecione Criar.

      Captura de tela mostrando a tela

    3. Quando a tela Configurar Azure Application Insights for exibida, o novo componente aparecerá na lista. Selecione o novo componente na lista e selecione Próximo.

  7. Insira um nome de chave de instrumentação ou escolha o padrão e escolha se deseja que a cadeia de conexão seja armazenada em um arquivo de segredos local ou em Azure Key Vault.

    Captura de tela mostrando a página

  8. A tela de resumo das alterações mostra todas as modificações que serão feitas no seu projeto se você concluir o processo. Se as alterações parecerem corretas, escolha Concluir.

    Captura de tela mostrando a tela

  9. A conexão aparecerá na seção Dependências de Serviço da guia Serviços Conectados.

    captura de tela mostrando a tela

Conectar-se ao Azure Application Insights usando serviços conectados

Nota

Para projetos do .NET Framework, a interface do usuário dos Serviços Conectados é ligeiramente diferente. Para ver as diferenças, compare com a versão do Visual Studio 2019 desta página.

  1. Abra seu projeto no Visual Studio.

  2. No Solution Explorer, clique com o botão direito do mouse no nó Serviços Conectados e, no menu de contexto, selecione Adicionar para abrir o menu de serviços disponíveis.

    Captura de tela mostrando opções de menu de contexto dos Serviços Conectados.

    Se você não vir o nó Serviços Conectados, escolha Projeto>Serviços Conectados>Adicionar.

  3. Escolha Azure Application Insights. A página Conectar-se à dependência é exibida. Você vai ver duas opções: uma para um emulador local, Application Insights SDK (Local), e outra para se conectar ao serviço ao vivo do Azure Application Insights. Você pode reduzir o custo e simplificar o desenvolvimento antecipado começando com o emulador local. Você pode migrar para o serviço ao vivo mais tarde repetindo essas etapas e escolhendo a outra opção.

    captura de tela mostrando as opções do Application Insights.

    Se você optar por usar o SDK do Application Insights localmente, clique em Próximo para ver a tela Resumo de alterações , que mostra como seu projeto está sendo modificado. Uma referência de pacote NuGet é adicionada ao seu projeto e o código de conexão do emulador local é adicionado ao seu projeto.

    Se você quiser se conectar ao serviço do Azure, continue para a próxima etapa ou, se ainda não estiver conectado, entre em sua conta do Azure antes de continuar. Se você não tiver uma conta do Azure, poderá se inscrever para uma avaliação gratuita .

  4. Na tela Configurar Azure Application Insights, selecione um componente existente do Azure Application Insights e selecione Avançar.

    Se você precisar criar um novo componente, vá para a próxima etapa. Caso contrário, pule para a etapa 7.

    Captura de tela mostrando a tela

  5. Para criar um componente do Application Insights:

    1. Selecione Criar um novo componente do Application Insights na parte inferior da tela.

    2. Preencha a tela Application Insights: Criar e selecione Criar.

      Captura de tela mostrando a tela

    3. Quando a tela Configurar Azure Application Insights for exibida, o novo componente aparecerá na lista. Selecione o novo componente na lista e selecione Próximo.

  6. Insira um nome para a configuração de conexão e um nome de chave de instrumentação ou aceite os padrões.

    Captura de tela mostrando a tela

    Nota

    Para melhorar a segurança, no Visual Studio 17.12 e posterior, essa etapa cria um nome de configuração de conexão; as versões anteriores criam uma cadeia de conexão. As cadeias de conexão armazenadas no sistema de arquivos local podem levar a um risco de segurança, se forem expostas inadvertidamente.

  7. Clique em Configurações adicionaise escolha se deseja que a cadeia de conexão seja armazenada em um arquivo de segredos local ou em do Azure Key Vault.

    Captura de tela mostrando Conectar-se ao Application Insights – tela de configurações adicionais.

  8. A tela de Resumo das alterações mostra todas as modificações que serão feitas ao seu projeto, caso você conclua o processo. Se as alterações parecerem corretas, escolha Concluir.

    Captura de tela mostrando a tela

  9. No Gerenciador de Soluções, clique duas vezes no nó Serviços Conectados para abrir a guia Serviços Conectados. A conexão é exibida na seção Dependências de Serviço.

    Captura de tela mostrando a seção

    Se você clicar nos três pontos ao lado da dependência adicionada, poderá ver várias opções, como Conectar para reabrir o assistente e alterar a conexão. Você também pode clicar nos três pontos no canto superior direito da janela para ver opções para iniciar dependências locais, alterar configurações e muito mais.

  10. Abra o arquivo de código de inicialização (Program.cs em modelos) e observe que uma linha foi adicionada que se assemelha ao seguinte:

    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
    

Próximas etapas

Para projetos do ASP.NET Core, aprenda como habilitar o monitoramento para seu aplicativo em Application Insights para aplicativos ASP.NET Core.

Para projetos de ASP.NET, consulte Configurar o Application Insights para seu site ASP.NET.

Os links levam você para a seção dos artigos após as etapas iniciais de instalação, que você já fez.