Dela via

Lägga till Application Insights med Visual Studio Connected Services

Med Visual Studio kan du ansluta olika typer av tjänster och program till Application Insights med hjälp av funktionen Anslutna tjänster . Funktionen lägger till alla nödvändiga referenser och anslutningskod till projektet och ändrar konfigurationsfilerna på rätt sätt. Du kan välja att ansluta till den aktiva Application Insights-tjänsten som körs i Azure eller använda en lokal emulator.

Den här artikeln beskriver hur du ansluter Application Insights till ditt program med hjälp av Anslutna tjänster.

Förutsättningar

För att slutföra procedurerna i den här artikeln måste följande krav uppfyllas:

Ansluta till Application Insights med anslutna tjänster

Lägg till Application Insights som en ansluten tjänst i ditt program genom att följa dessa steg:

  1. Öppna ett projekt i Visual Studio som stöder en anslutning till Application Insights. För projektexempel, se Förutsättningar.

  2. Lägg till den Application Insights-anslutna tjänsten. Det finns flera sätt att starta processen på, till exempel:

    • Välj Projekthantera>anslutna tjänster>Lägg till ett tjänstberoende>Azure Application Insights.

    • Högerklicka på noden Anslutna tjänster för projektet i Solution Explorer och välj Lägg till>Azure Application Insights.

  3. I avsnittet Beroenden för anslutna tjänster> väljer du Lägg till (plussymbol):

    Skärmbild som visar skärmen Lägg till tjänstberoende.

  4. Skärmen Lägg till beroende öppnas. Du har två alternativ för anslutningen: använd en lokal emulator eller få åtkomst till livetjänsten i Azure. För att minska kostnaderna och förenkla den tidiga utvecklingen kan du börja med den lokala emulatorn. Senare kan du migrera till livetjänsten genom att upprepa stegen i den här proceduren.

    Skärmbild som visar skärmen Lägg till Azure Application Insights.

    1. I den här övningen väljer du Azure Application Insights för att få åtkomst till livetjänsten i Azure.

    2. Logga in på ditt Azure-konto efter behov. Om du inte har något Azure-konto kan du registrera dig för en kostnadsfri utvärderingsversion.

  5. På skärmen Konfigurera Azure Application Insights - Välj ett tjänstberoende väljer du om du vill använda en befintlig eller ny komponent för anslutningen:

    Skärmbild som visar skärmen Anslut till befintlig Application Insights-komponent.

    • Befintlig komponent: Om du vill använda en befintlig Application Insights-komponent väljer du komponenten i listan och väljer Nästa. Fortsätt till Steg 6 och konfigurera anslutningsinställningarna.

    • Ny komponent: Så här skapar du en ny komponent för anslutningen:

      Skärmbild som visar skärmen Ny Azure App Insights-komponent med markeringar för listan över befintliga komponenter och alternativet att skapa en ny komponent.

      1. Välj Skapa en ny Application Insights-komponent.

      2. På skärmen Application Insights – Skapa ny bekräftar du fältvärdena, justerar efter behov och väljer sedan Skapa.

      3. Skärmen Konfigurera Azure Application Insights - Välj ett tjänstberoende uppdateras och den nya komponenten visas i listan. Välj den nya komponenten och välj Nästa.

  6. I skärmen Konfigurera Azure Application Insights - Ange namn på anslutningssträng kontrollerar du anslutningsinställningarna:

    Skärmbild som visar skärmen Ange namn på anslutningssträng.

    1. Acceptera standardanslutningsvärdena eller ange önskad anslutningssträng och instrumentationsnyckelnamn.

    2. Välj om du vill lagra anslutningssträngen i en lokal hemlighetsfil och välj Nästa.

    Försiktighet

    För förbättrad säkerhet skapar Visual Studio endast ett namn för anslutningsinställningen i Visual Studio 2022 17.12 och senare. I tidigare versioner skapar Visual Studio anslutningssträngen. Anslutningssträngar som lagras i det lokala filsystemet kan leda till en säkerhetsrisk om de oavsiktligt exponeras.

  7. Skärmen Sammanfattning av ändringar visar de planerade ändringarna för projektet. Ändringarna omfattar uppdateringar av projektkoden och egenskaperna, NuGet-paketreferenser, programhemligheter och filenappsettings.json .

    Skärmbild som visar skärmen Sammanfattning av ändringar för att skapa anslutningen för programmet i tidigare versioner av Visual Studio.

    Verifiera projektändringarna och välj Slutför för att slutföra processen.

    Ett meddelande visas som anger en lyckad anslutning. Välj Stäng för att stänga fönstret.

  8. Dubbelklicka på noden Anslutna tjänster för projektet i Solution Explorer för att öppna fliken Anslutna tjänster . Den nya anslutningen visas under avsnittet Tjänstberoenden :

    Skärmbild som visar den nya anslutningen i avsnittet Tjänstberoenden för projektet i tidigare versioner av Visual Studio.

Ansluta till Application Insights med anslutna tjänster

Lägg till Application Insights som en ansluten tjänst i ditt program genom att följa dessa steg:

  1. Öppna ett projekt i Visual Studio som stöder en anslutning till Application Insights. För projektexempel, se Förutsättningar.

    Not

    För .NET Framework-projekt skiljer sig gränssnittet för anslutna tjänster i Visual Studio mellan olika versioner. Om du vill se skillnaderna kan du jämföra din aktuella vy av den här sidan med Visual Studio 2019-versionen av samma sida.

  2. Lägg till den Application Insights-anslutna tjänsten. Det finns flera sätt att starta processen på, till exempel:

    • VäljProjektanslutna> tjänster >Lägg till>Azure Application Insights.

    • Välj Project>Application Insights>Konfigurera Application Insights.

    • Högerklicka på noden Anslutna tjänster för projektet i Solution Explorer och välj Lägg till>Azure Application Insights.

  3. Anslut till beroende-skärmen öppnas. Du har två alternativ för anslutningen: använd en lokal emulator eller få åtkomst till livetjänsten i Azure. För att minska kostnaderna och förenkla den tidiga utvecklingen kan du börja med den lokala emulatorn. Senare kan du migrera till livetjänsten genom att upprepa stegen i den här proceduren. Välj din anslutningsinställning och lägg till anslutningen genom att följa stegen i listan.

    Anslutningstyp Beskrivning Anslutningsprocedur
    Application Insights SDK (Lokal) Använd en lokal emulator i stället för att ansluta till en instans som körs i Azure.
    1. Välj alternativet och välj sedan Nästa.
    2. Fortsätt till steg 6 och granska sammanfattningen av planerade ändringar.
    Blått Application Insights Anslut till den aktiva Application Insights-tjänsten som körs i Azure.
    1. Logga in på ditt Azure-konto efter behov. Om du inte har något Azure-konto kan du registrera dig för en kostnadsfri utvärderingsversion.
    2. Fortsätt till nästa steg i den här proceduren.

    Skärmbild som visar de två alternativen för att ansluta ditt program till Application Insights.

  4. På skärmen Anslut till Azure Application Insights - Välj ett tjänstberoende väljer du om du vill använda en befintlig eller ny komponent för anslutningen:

    Skärmbild som visar komponentskärmen Anslut till Azure Application Insights, där du väljer ett tjänstberoende som ska läggas till i ditt program.

    • Befintlig komponent: Om du vill använda en befintlig Application Insights-komponent väljer du komponenten i listan och väljer Nästa. Fortsätt till Steg 5 och konfigurera anslutningsinställningarna.

    • Ny komponent: Så här skapar du en ny komponent för anslutningen:

      1. Välj + Skapa ny.

      2. På skärmen Application Insights – Skapa ny bekräftar du fältvärdena, justerar efter behov och väljer sedan Skapa.

        Skärmbild som visar skärmen Application Insights – Skapa ny komponent.

      3. Skärmen Anslut till Azure Application Insights - Välj ett tjänstberoende uppdateras och den nya komponenten visas i listan. Välj den nya komponenten och välj Nästa.

      4. På skärmen Anslut till Azure Application Insights - Ange inställningar för anslutningskonfiguration kontrollerar du anslutningsinställningarna. Acceptera standardvärdena eller ange önskat namn på anslutningsinställningen och instrumenteringsnyckeln.

        Skärmbild som visar skärmen Anslut till Azure Application Insights – Ange inställningar för anslutningskonfiguration.

      Not

      För förbättrad säkerhet skapar Visual Studio endast ett namn för anslutningsinställningen i Visual Studio 2022 17.12 och senare. I tidigare versioner skapar Visual Studio anslutningssträngen. Anslutningssträngar som lagras i det lokala filsystemet kan leda till en säkerhetsrisk om de oavsiktligt exponeras.

  5. På skärmen Ange inställningar för anslutningskonfiguration väljer du Ytterligare inställningar längst ned till vänster.

    Skärmen Anslut till Azure Application Insights - Anpassa hur anslutningsinformation lagras öppnas. Välj om du vill lagra anslutningssträngen i en lokal hemlighetsfil och välj Nästa:

    Skärmbild som visar skärmen Anslut till Application Insights – Anpassa hur anslutningsinformation lagras.

  6. Skärmen Sammanfattning av ändringar visar de planerade ändringarna för projektet.

    • För en Azure Application Insights-anslutning omfattar ändringarna uppdateringar av projektkoden och egenskaperna, NuGet-paketreferenser, programhemligheter och filenappsettings.json .

    • För en Application Insights SDK-anslutning (lokal) innehåller projektändringarna en tillagd NuGet-paketreferens och anslutningskod för den lokala emulatorn.

    Skärmbild som visar skärmen Sammanfattning av ändringar för att skapa anslutningen för programmet.

    Verifiera projektändringarna och välj Slutför för att slutföra processen.

    Ett meddelande visas som anger en lyckad anslutning. Välj Stäng för att stänga fönstret.

  7. Dubbelklicka på noden Anslutna tjänster för projektet i Solution Explorer för att öppna fliken Anslutna tjänster . Den nya anslutningen visas under avsnittet Tjänstberoenden :

    Skärmbild som visar den nya anslutningen i avsnittet Tjänstberoenden för projektet.

    • Om du vill se tillgängliga åtgärder för ett beroende väljer du Fler alternativ (...) för objektet. När beroendet inte är anslutet visas alternativet Anslut . När du kan välja det här alternativet öppnas skärmen Anslut till beroende igen där du kan ändra beroendekonfigurationen och återupprätta anslutningen.

    • Du kan också välja Fler alternativ (...) överst på fliken Anslutna tjänster för alternativ för att starta lokala beroenden, ändra inställningar med mera.

  8. Leta upp och öppna filen Program.cs som innehåller startkoden för projektet i Solution Explorer. Observera följande instruktion, som läggs till för att stödja beroendeanslutningen:

    // Add services to the container
builder.Services.AddApplicationInsightsTelemetry();

Relaterat innehåll