Nastavení Application Insights pro web ASP.NETSet up Application Insights for your ASP.NET website

Tímto postupem je možné konfigurovat webovou aplikaci ASP.NET tak, aby odesílala telemetrická data do služby Azure Application Insights.This procedure configures your ASP.NET web app to send telemetry to the Azure Application Insights service. Funguje pro aplikace ASP.NET, které jsou hostované buď na vašem vlastním serveru služby IIS v místním prostředí, nebo v cloudu.It works for ASP.NET apps that are hosted either in your own IIS server on-premises or in the Cloud. Můžete získat grafy a výkonný dotazovací jazyk, který vám pomůže porozumět výkonu vaší aplikace a způsobu, jakým ji uživatelé používají, a také automatické výstrahy v případě selhání nebo problémů s výkonem.You get charts and a powerful query language that help you understand the performance of your app and how people are using it, plus automatic alerts on failures or performance issues. Celá řada vývojářů považuje tyto funkce za skvělé (a ony jsou), v případě potřeby ale můžete telemetrická data také rozšířit a přizpůsobit.Many developers find these features great as they are, but you can also extend and customize the telemetry if you need to.

Nastavení je otázkou několika kliknutí v sadě Visual Studio.Setup takes just a few clicks in Visual Studio. Máte možnost vyhnout se placení poplatků, pokud objem telemetrických dat omezíte.You have the option to avoid charges by limiting the volume of telemetry. Tato funkce umožňuje experimentovat a ladit nebo monitorovat lokalitu, která nemá mnoho uživatelů.This functionality allows you to experiment and debug, or to monitor a site with not many users. Pokud se později rozhodnete, že chcete pokračovat a monitorovat svůj provozní server, můžete limit snadno zvýšit.When you decide you want to go ahead and monitor your production site, it's easy to raise the limit later.

PředpokladyPrerequisites

Pro přidání Application Insights na web ASP.NET potřebujete:To add Application Insights to your ASP.NET website, you need to:

  • Nainstalujte Visual Studio 2019 pro Windows s následujícími úlohami:Install Visual Studio 2019 for Windows with the following workloads:
    • Vývoj pro ASP.NET a web (zrušení kontroly volitelných součástí)ASP.NET and web development (Do not uncheck the optional components)
    • Vývoj pro AzureAzure development

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.If you don't have an Azure subscription, create a free account before you begin.

Krok 1: Přidání sady Application Insights SDKStep 1: Add the Application Insights SDK

Důležité

Snímky obrazovky v tomto příkladu vycházejí ze sady Visual Studio 2017 verze 15.9.9 a novější.The screenshots in this example are based on Visual Studio 2017 version 15.9.9 and later. Prostředí pro přidání Application Insights se liší ve verzích sady Visual Studio i typu šablony ASP.NET.The experience to add Application Insights varies across versions of Visual Studio as well as by ASP.NET template type. Starší verze můžou mít alternativní text, například "konfigurace Application Insights".Older versions may have alternate text such as "Configure Application Insights".

V Průzkumník řešení klikněte pravým tlačítkem myši na název vaší webové aplikace a vyberte Přidat > telemetrie Application InsightsRight-click your web app name in the Solution Explorer, and choose Add > Application Insights Telemetry

Snímek obrazovky Průzkumníka řešení se zvýrazněnou možností Konfigurovat Application Insights

(V závislosti na verzi Application Insights SDK se může zobrazit výzva k upgradu na nejnovější verzi SDK.(Depending on your Application Insights SDK version you may be prompted to upgrade to the latest SDK release. Pokud se tato výzva zobrazí, vyberte Aktualizovat sadu SDK.)If prompted, select Update SDK.)

Snímek obrazovky: Je dostupná nová verze sady Microsoft Application Insights SDK.

Obrazovka Konfigurace Application Insights:Application Insights Configuration screen:

Vyberte Začínáme.Select Get Started.

Snímek obrazovky stránky registrace vaší aplikace v Application Insights

Pokud chcete nastavit skupinu prostředků nebo umístění, kde jsou vaše data uložená, klikněte na Konfigurovat nastavení.If you want to set the resource group or the location where your data is stored, click Configure settings. Skupiny prostředků slouží k řízení přístupu k datům.Resource groups are used to control access to data. Pokud například máte několik aplikací, které tvoří součást stejného systému, můžete jejich data Application Insights ukládat do stejné skupiny prostředků.For example, if you have several apps that form part of the same system, you might put their Application Insights data in the same resource group.

Vyberte Zaregistrovat.Select Register.

Snímek obrazovky stránky registrace vaší aplikace v Application Insights

Vyberte projekt > Spravovat balíčky balíčků NuGet > Zdroj: NuGet.org > ověřte, že máte nejnovější stabilní verzi sady Application Insights SDK.Select Project > Manage NuGet Packages > Package source: nuget.org > Confirm that you have the latest stable release of the Application Insights SDK.

Telemetrie se bude posílat na web Azure Portal, jak během ladění aplikace, tak po jejím publikování.Telemetry will be sent to the Azure portal, both during debugging and after you have published your app.

Poznámka

Pokud během ladění nechcete na portál odesílat telemetrická data, stačí přidat do aplikace sadu SDK Application Insights, ale nekonfigurovat prostředek na portálu.If you don't want to send telemetry to the portal while you're debugging, just add the Application Insights SDK to your app but don't configure a resource in the portal. Během ladění se telemetrická data zobrazují v sadě Visual Studio.You are able to see telemetry in Visual Studio while you are debugging. Později se můžete na tuto stránku konfigurace vrátit, nebo počkat až po nasazení aplikace a přepnout na telemetrie za běhu.Later, you can return to this configuration page, or you could wait until after you have deployed your app and switch on telemetry at run time.

Krok 2: spuštění aplikaceStep 2: Run your app

Spusťte aplikaci pomocí F5.Run your app with F5. Otevřete různé stránky k vygenerování nějaké telemetrie.Open different pages to generate some telemetry.

V sadě Visual Studio se zobrazí počet zaprotokolovaných událostí.In Visual Studio, you will see a count of the events that have been logged.

Snímek obrazovky sady Visual Studio.

Krok 3: Zobrazení vašich telemetrických datStep 3: See your telemetry

Telemetrii můžete zobrazit v sadě Visual Studio nebo na webovém portálu Application Insights.You can see your telemetry either in Visual Studio or in the Application Insights web portal. Hledáním v rámci telemetrických dat v sadě Visual Studio si můžete usnadnit ladění aplikace.Search telemetry in Visual Studio to help you debug your app. Když bude váš systém v provozu, můžete monitorovat výkon a využití na webovém portálu.Monitor performance and usage in the web portal when your system is live.

Zobrazení telemetrických dat v sadě Visual StudioSee your telemetry in Visual Studio

Pokud chcete v sadě Visual Studio zobrazit data Application Insights:In Visual Studio, to view Application Insights data. Vyberte Průzkumník řešení > připojené služby > klikněte pravým tlačítkem na Application Insightsa pak klikněte na Hledat živou telemetrii.Select Solution Explorer > Connected Services > right-click Application Insights, and then click Search Live Telemetry.

V okně Visual Studio Application Insights Search se zobrazí telemetrie vygenerovaná na straně serveru vaší aplikace.In the Visual Studio Application Insights Search window, you will see the data from your application for telemetry generated in the server side of your app. Experimentujte s filtry a klikněte na události, které chcete zobrazit podrobněji.Experiment with the filters, and click any event to see more detail.

Snímek obrazovky zobrazení Data z relace ladění v okně Application Insights.

Tip

Pokud se žádná data nezobrazí, ujistěte se, že je časový rozsah správný, a klikněte na ikonu Search.If you don't see any data, make sure the time range is correct, and click the Search icon.

Další informace týkající se nástrojů Application Insights v sadě Visual Studio.Learn more about Application Insights tools in Visual Studio.

Zobrazení telemetrických dat na webovém portáluSee telemetry in web portal

Telemetrická data můžete zobrazit také na webovém portálu Application Insights (pokud jste se nerozhodli nainstalovat pouze sadu SDK).You can also see telemetry in the Application Insights web portal (unless you chose to install only the SDK). Portál obsahuje více grafů, analytických nástrojů a zobrazení nad několika součástmi než sada Visual Studio.The portal has more charts, analytic tools, and cross-component views than Visual Studio. Portál poskytuje také výstrahy.The portal also provides alerts.

Otevřete prostředek Application Insights.Open your Application Insights resource. Buď se přihlaste na Azure Portal a najděte ho tady, nebo vyberte Průzkumník řešení > Připojené služby > klikněte pravým tlačítkem na Application Insights > Otevřít portál Application Insights a přejděte na něj.Either sign into the Azure portal and find it there, or select Solution Explorer > Connected Services > right-click Application Insights > Open Application Insights Portal and let it take you there.

Portál otevře zobrazení telemetrie z vaší aplikace.The portal opens on a view of the telemetry from your app.

Snímek obrazovky stránky s přehledem Application Insights

Po kliknutí na kteroukoli dlaždici nebo graf se zobrazí podrobnější údaje.In the portal, click any tile or chart to see more detail.

Krok 4: Publikování aplikaceStep 4: Publish your app

Publikování aplikace na serveru služby IIS nebo do Azure.Publish your app to your IIS server or to Azure. Sledujte Živé vysílání metrik a ověřte, zda vše běží hladce.Watch Live Metrics Stream to make sure everything is running smoothly.

Vaše telemetrie se vytváří na portálu Application Insights, kde můžete monitorovat metriky, prohledávat telemetrii.Your telemetry builds up in the Application Insights portal, where you can monitor metrics, search your telemetry. Můžete také použít výkonný dotazovací jazyk Kusto k analýze využití a výkonu nebo k hledání konkrétních událostí.You can also use the powerful Kusto query language to analyze usage and performance, or to find specific events.

Můžete také dále analyzovat telemetrii v sadě Visual Studio pomocí nástrojů jako vyhledávání diagnostiky a Trendy.You can also continue to analyze your telemetry in Visual Studio, with tools such as diagnostic search and trends.

Poznámka

Pokud vaše aplikace odesílá dostatek telemetrie k dosažení limitů omezení, zapne se automatické vzorkování.If your app sends enough telemetry to approach the throttling limits, automatic sampling switches on. Vzorkování snižuje množství telemetrie odesílané z vaší aplikace při zachování korelovaných dat k diagnostickým účelům.Sampling reduces the quantity of telemetry sent from your app, while preserving correlated data for diagnostic purposes.

Všechno je nastavené.You're all set

Blahopřejeme!Congratulations! Nainstalovali jste do aplikace balíček Application Insights a nakonfigurovali jste pro ni odesílání telemetrických dat do služby Application Insights v Azure.You installed the Application Insights package in your app, and configured it to send telemetry to the Application Insights service on Azure.

Prostředek Azure, který přijímá telemetrická data aplikace, je určen instrumentačním klíčem.The Azure resource that receives your app's telemetry is identified by an instrumentation key. Tento klíč najdete v souboru ApplicationInsights.config.You'll find this key in the ApplicationInsights.config file.

Upgrade na budoucí verze sady SDKUpgrade to future SDK versions

Chcete-li upgradovat na novou verzi sady SDK, otevřete Správce balíčků NuGeta filtrujte nainstalované balíčky.To upgrade to a new release of the SDK, open the NuGet package manager, and filter on installed packages. Vyberte Microsoft. ApplicationInsights. Weba zvolte upgradovat.Select Microsoft.ApplicationInsights.Web, and choose Upgrade.

Pokud jste provedli jakékoli úpravy souboru ApplicationInsights.config, před upgradem si uložte jeho kopii.If you made any customizations to ApplicationInsights.config, save a copy of it before you upgrade. Potom slučte změny do nové verze.Then, merge your changes into the new version.

Další krokyNext steps

K dispozici jsou i alternativní témata, na která se v případě zájmu můžete podívat:There are alternative topics to look at if you are interested in:

Další telemetrická dataMore telemetry

AnalýzaAnalysis

VýstrahyAlerts

  • Testy dostupnosti: Vytvářejte testy, abyste ověřili viditelnost svého webu na internetu.Availability tests: Create tests to make sure your site is visible on the web.
  • Inteligentní diagnostika: Tyto testy se spouštějí automaticky, takže je nemusíte nijak nastavovat.Smart diagnostics: These tests run automatically, so you don't have to do anything to set them up. Upozorní vás, pokud má aplikace nezvykle velký podíl neúspěšných požadavků.They tell you if your app has an unusual rate of failed requests.
  • Výstrahy metriky: Nastavte výstrahy, které vás upozorní, pokud metrika překračuje prahovou hodnotu.Metric alerts: Set alerts to warn you if a metric crosses a threshold. Upozornění můžete nastavit u vlastních metrik, které v aplikaci naprogramujete.You can set them on custom metrics that you code into your app.

AutomatizaceAutomation