Přidání Azure Application Insights pomocí připojených služeb sady Visual Studio
Pomocí sady Visual Studio můžete k Azure Application Insights připojit některou z následujících možností pomocí funkce Connected Services:
- Konzolová aplikace .NET Framework
- ASP.NET Model –View-Controller (MVC) (.NET Framework)
- ASP.NET Core
- .NET Core (včetně konzolové aplikace, WPF, Windows Forms, knihovny tříd)
- Role pracovního procesu .NET Core
- Azure Functions
- Aplikace pro univerzální platformu Windows
- Xamarin
- Cordova
Funkce připojené služby přidá do projektu všechny potřebné odkazy a kód připojení a odpovídajícím způsobem upraví konfigurační soubory.
Požadavky
- Visual Studio s nainstalovanou úlohou Azure
- Projekt jednoho z podporovaných typů
- Účet Azure. Pokud nemáte účet Azure, aktivujte si výhody Azure pro předplatitele sady Visual Studio nebo si zaregistrujte bezplatnou zkušební verzi.
Připojení k Azure Application Insights pomocí připojených služeb
Otevřete svůj projekt v sadě Visual Studio.
V Průzkumníku řešeníklikněte pravým tlačítkem na uzel Připojené služby a v místní nabídce vyberte Přidat připojenou službu.
Na kartě Připojené služby vyberte ikonu + pro Závislosti služby.
Pokud uzel Připojené služby nevidíte, zvolte Project>Connected Services>Přidat.
Na stránce Přidat závislost vyberte Azure Application Insights.
Pokud ještě nejste přihlášení, přihlaste se ke svému účtu Azure. Pokud nemáte účet Azure, můžete si zaregistrovat bezplatnou zkušební verzi.
Na obrazovce Konfigurace služby Azure Application Insights vyberte existující komponentu Azure Application Insights a vyberte Další.
Pokud potřebujete vytvořit novou komponentu, přejděte k dalšímu kroku. V opačném případě přejděte ke kroku 7.
Vytvoření komponenty Application Insights:
Vyberte Vytvořit novou komponentu Application Insights v dolní části obrazovky.
Vyplňte Application Insights: vytvořte novou obrazovku a vyberte Vytvořit.
Když se zobrazí obrazovka Konfigurace služby Azure Application Insights, zobrazí se v seznamu nová komponenta. V seznamu vyberte novou komponentu a vyberte Další.
Zadejte název instrumentačního klíče nebo zvolte výchozí hodnotu a zvolte, jestli chcete připojovací řetězec uložit v místním souboru tajných kódů, nebo v azure Key Vault.
Na obrazovce Souhrn změn se zobrazí všechny změny, které budou provedeny v projektu, pokud proces dokončíte. Pokud změny vypadají v pořádku, vyberte Dokončit.
Připojení se zobrazí v části Závislosti služby na kartě Připojené služby.
Připojení k Azure Application Insights pomocí připojených služeb
Poznámka
U projektů rozhraní .NET Framework se uživatelské rozhraní Připojených služeb mírně liší. Pokud chcete zobrazit rozdíly, porovnejte tuto stránku s verzí sady Visual Studio 2019.
Otevřete projekt v prostředí Visual Studio.
V Průzkumníku řešeníklikněte pravým tlačítkem myši na uzel Připojené služby a v místní nabídce vyberte Přidat, čímž otevřete nabídku dostupných služeb.
Pokud uzel Připojené služby nevidíte, zvolte Projekt>Připojené služby>Přidat.
Zvolte Azure Application Insights. Zobrazí se stránka Připojit k závislosti. Měli byste vidět dvě možnosti, jednu pro místní emulátor, Application Insights Sdk (místní)a jednu pro připojení k živé službě Azure Application Insights. Můžete snížit náklady a zjednodušit počáteční vývoj tím, že začnete s místním emulátorem. Později můžete migrovat do živé služby opakováním těchto kroků a zvolením jiné možnosti.
Pokud se rozhodnete používat sadu Application Insights SDK místně, kliknutím na Další zobrazíte obrazovku Souhrn změn, která ukazuje, jak se projekt upravuje. Do projektu se přidá odkaz na balíček NuGet a do projektu se přidá kód připojení místního emulátoru.
Pokud se chcete připojit ke službě Azure, pokračujte dalším krokem nebo pokud ještě nejste přihlášení, před pokračováním se přihlaste ke svému účtu Azure. Pokud nemáte účet Azure, můžete si zaregistrovat bezplatnou zkušební verzi.
Na obrazovce Konfigurace služby Azure Application Insights vyberte existující komponentu Azure Application Insights a vyberte Další.
Pokud potřebujete vytvořit novou komponentu, přejděte k dalšímu kroku. V opačném případě přejděte ke kroku 7.
Vytvoření komponenty Application Insights:
Vyberte Vytvořit novou komponentu Application Insights v dolní části obrazovky.
Vyplňte obrazovku Application Insights: Vytvořte novou obrazovku a vyberte Vytvořit.
Když se zobrazí obrazovka Konfigurace služby Azure Application Insights, zobrazí se v seznamu nová komponenta. V seznamu vyberte novou komponentu a vyberte Další.
Zadejte název nastavení připojení a název instrumentačního klíče nebo přijměte výchozí hodnoty.
Poznámka
Pro lepší zabezpečení ve verzi Visual Studio 17.12 a novější tento krok vytvoří název nastavení připojení; starší verze vytvoří připojovací řetězec. Připojovací řetězce uložené v místním systému souborů můžou vést k bezpečnostnímu riziku, pokud jsou neúmyslně vystaveny.
Klikněte na Další nastavenía zvolte, jestli chcete připojovací řetězec uložit v místním souboru tajných kódů, nebo v azure Key Vault.
Na obrazovce Souhrn změn se zobrazí všechny změny, které budou provedeny v projektu, pokud proces dokončíte. Pokud změny vypadají v pořádku, zvolte Dokončit.
V Průzkumníku řešení poklikejte na uzel Připojené služby a otevřete kartu Připojené služby. Připojení se zobrazí v části Závislosti služby:
Pokud kliknete na tři tečky vedle přidané závislosti, zobrazí se různé možnosti, jako je Connect znovu otevřít průvodce a změnit připojení. Můžete také kliknout na tři tečky v pravém horním rohu okna a zobrazit možnosti spuštění místních závislostí, změnit nastavení a další.
Otevřete spouštěcí soubor kódu (Program.cs v šablonách) a všimněte si, že se přidal řádek, který se podobá následujícímu:
builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
Další kroky
U projektů ASP.NET Core se dozvíte, jak můžete povolit monitorování pro vaši aplikaci pomocí Application Insights pro ASP.NET Core aplikace.
Pro projekty ASP.NET, viz Konfigurace Application Insights pro váš web ASP.NET.
Odkazy vás navedou na část článků po počátečních krocích nastavení, které jste již provedli.