Konfigurowanie usługi Application Insights dla witryny sieci Web ASP.NET.Set up Application Insights for your ASP.NET website

Niniejsza procedura umożliwia skonfigurowanie aplikacji internetowej w technologii ASP.NET do wysyłania danych telemetrii do usługi Azure Application Insights.This procedure configures your ASP.NET web app to send telemetry to the Azure Application Insights service. Działa to w przypadku aplikacji w technologii ASP.NET, które są hostowane na serwerze usług IIS lokalnie albo w chmurze.It works for ASP.NET apps that are hosted either in your own IIS server on-premises or in the Cloud. Uzyskasz wykresy i zaawansowany język zapytań, które pomogą Ci zrozumieć wydajność aplikacji i sposób korzystania z niej przez użytkowników oraz dodatkowo automatyczne alerty w razie błędów lub problemów z wydajnością.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. Wielu programistów uważa, że te funkcje są doskonałe takie, jakie są, ale możesz również w razie potrzeby rozszerzyć i dostosować dane telemetryczne.Many developers find these features great as they are, but you can also extend and customize the telemetry if you need to.

Konfiguracja wymaga tylko kilku kliknięć w programie Visual Studio.Setup takes just a few clicks in Visual Studio. Masz możliwość uniknąć naliczania opłat, ograniczając ilość danych telemetrii.You have the option to avoid charges by limiting the volume of telemetry. Umożliwia to wypróbowanie i debugowanie lub monitorowanie witryny, która nie ma wielu użytkowników.This allows you to experiment and debug, or to monitor a site with not many users. Gdy zdecydujesz, że chcesz kontynuować i monitorować witrynę produkcyjną, późniejsze zwiększenie limitu jest łatwe.When you decide you want to go ahead and monitor your production site, it's easy to raise the limit later.

Wymagania wstępnePrerequisites

Aby dodać usługę Application Insights do witryny internetowej:To add Application Insights to your ASP.NET website, you need to:

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.If you don't have an Azure subscription, create a free account before you begin.

Krok 1. Dodawanie zestawu SDK usługi Application InsightsStep 1: Add the Application Insights SDK

Ważne

Proces dodawania usługi Application Insights różni się w zależności od typu szablonu platformy ASP.NET.The process to add Application Insights varies by ASP.NET template type. Jeśli używasz szablonu Pusty lub Aplikacja mobilna platformy Azure, wybierz pozycję Projekt > Dodaj Telemetrię usługi Application Insights.If you are using the Empty or Azure Mobile App template select Project > Add Application Insights Telemetry. W przypadku wszystkich pozostałych szablonów platformy ASP.NET zapoznaj się z poniższymi instrukcjami.For all other ASP.NET templates consult the instructions below.

Kliknij prawym przyciskiem myszy nazwę aplikacji internetowej w Eksploratorze rozwiązań i wybierz pozycję Konfiguruj usługę Application Insights.Right-click your web app name in the Solution Explorer, and choose Configure Application Insights

Zrzut ekranu Eksploratora rozwiązań z wyróżnioną opcją Konfiguruj usługę Application Insights

(W zależności od używanej wersji zestawu SDK usługi Application Insights może pojawić się monit o przeprowadzenie uaktualnienia do najnowszej wersji zestawu SDK.(Depending on your Application Insights SDK version you may be prompted to upgrade to the latest SDK release. Po wyświetleniu takiego monitu wybierz pozycję Zaktualizuj zestaw SDK).If prompted, select Update SDK.)

Zrzut ekranu: dostępna jest nowa wersja zestawu SDK usługi Microsoft Application Insights.

Ekran konfiguracji usługi Application Insights:Application Insights Configuration screen:

Wybierz pozycję Rozpocznij bezpłatnie.Select Start Free.

Zrzut ekranu strony Zarejestruj swoją aplikację w usłudze Application Insights

Jeśli chcesz ustawić grupę zasobów lub lokalizację, w której dane są przechowywane, kliknij pozycję Konfiguruj ustawienia.If you want to set the resource group or the location where your data is stored, click Configure settings. Grupy zasobów są używane do kontrolowania dostępu do danych.Resource groups are used to control access to data. Jeśli na przykład masz kilka aplikacji, które stanowią część tego samego systemu, możesz umieścić ich dane usługi Application Insights w tej samej grupie zasobów.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.

Wybierz pozycję Zarejestruj.Select Register.

Zrzut ekranu strony Zarejestruj swoją aplikację w usłudze Application Insights

Dane telemetryczne będą wysyłane do witryny Azure Portal zarówno podczas debugowania, jak i po opublikowaniu aplikacji.Telemetry will be sent to the Azure portal, both during debugging and after you have published your app.

Uwaga

Jeśli nie chcesz wysłać danych telemetrii do portalu podczas debugowania, wystarczy, że dodasz zestaw SDK usługi Application Insights do aplikacji, ale nie konfiguruj zasobu w portalu.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. Dane telemetryczne możesz wyświetlać w programie Visual Studio podczas debugowania.You are able to see telemetry in Visual Studio while you are debugging. Później możesz powrócić do tej strony konfiguracji lub po wdrożeniu aplikacji włączyć telemetrię w czasie wykonywania.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. Uruchamianie aplikacjiStep 2: Run your app

Uruchom aplikację, naciskając klawisz F5.Run your app with F5. Otwórz różne strony w celu wygenerowania telemetrii.Open different pages to generate some telemetry.

W programie Visual Studio zobaczysz liczbę zarejestrowanych zdarzeń.In Visual Studio, you will see a count of the events that have been logged.

Zrzut ekranu programu Visual Studio.

Krok 3. Wyświetlanie telemetriiStep 3: See your telemetry

Telemetrię można wyświetlić w programie Visual Studio lub w portalu sieci Web usługi Application Insights.You can see your telemetry either in Visual Studio or in the Application Insights web portal. Wyszukaj telemetrię w programie Visual Studio, aby ułatwić debugowanie własnej aplikacji.Search telemetry in Visual Studio to help you debug your app. Monitoruj wydajność i użycie w portalu sieci Web, gdy system działa.Monitor performance and usage in the web portal when your system is live.

Wyświetlanie telemetrii w programie Visual StudioSee your telemetry in Visual Studio

Wyświetlanie danych usługi Application Insights w programie Visual Studio.In Visual Studio, to view Application Insights data. Wybierz pozycje Eksplorator rozwiązań > Usługi połączone, kliknij prawym przyciskiem myszy pozycję Application Insights, a następnie kliknij pozycję Wyszukaj telemetrię na żywo.Select Solution Explorer > Connected Services > right-click Application Insights, and then click Search Live Telemetry.

W oknie wyszukiwania usługi Visual Studio Application Insights zobaczysz dane ze swojej aplikacji dla telemetrii wygenerowanej po stronie serwera aplikacji.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. Poeksperymentuj z filtrami, a następnie kliknij dowolne zdarzenie, aby wyświetlić więcej szczegółów.Experiment with the filters, and click any event to see more detail.

Zrzut ekranu przedstawiający widok Dane z sesji debugowania w oknie Application Insights.

Porada

Jeśli nie są wyświetlane żadne dane, upewnij się, że zakres czasu jest poprawny, a następnie kliknij ikonę wyszukiwania.If you don't see any data, make sure the time range is correct, and click the Search icon.

Dowiedz się więcej o narzędziach usługi Application Insights w programie Visual Studio.Learn more about Application Insights tools in Visual Studio.

Wyświetlanie telemetrii w portalu sieci WebSee telemetry in web portal

Telemetrię można również wyświetlić w portalu sieci Web usługi Application Insights (chyba że wybrano opcję zainstalowania tylko zestawu SDK).You can also see telemetry in the Application Insights web portal (unless you chose to install only the SDK). Portal udostępnia więcej wykresów, narzędzi analitycznych i widoków międzyskładnikowych niż program Visual Studio.The portal has more charts, analytic tools, and cross-component views than Visual Studio. Portal oferuje również alerty.The portal also provides alerts.

Otwórz zasób usługi Application Insights.Open your Application Insights resource. Zaloguj się do witryny Azure Portal i znajdź telemetrię tam albo wybierz pozycję Eksplorator rozwiązań > Usługi połączone, kliknij prawym przyciskiem myszy pozycję Application Insights > Otwórz portal usługi Application Insights i zaczekaj na otworzenie portalu.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.

W portalu zostanie otwarty widok danych telemetrycznych z Twojej aplikacji.The portal opens on a view of the telemetry from your app.

Zrzut ekranu przedstawiający stronę przeglądu usługi Application Insights

W portalu kliknij dowolny kafelek lub wykres, aby wyświetlić więcej szczegółów.In the portal, click any tile or chart to see more detail.

Dowiedz się więcej o korzystaniu z usługi Application Insights w portalu Azure.Learn more about using Application Insights in the Azure portal.

Krok 4. Publikowanie aplikacjiStep 4: Publish your app

Opublikuj aplikacje na serwerze IIS lub na platformie Azure.Publish your app to your IIS server or to Azure. Obejrzyj transmisję strumieniową metryk na żywo, aby upewnić się, że wszystko działa bez problemów.Watch Live Metrics Stream to make sure everything is running smoothly.

Dane telemetryczne są gromadzone w portalu Application Insights, w którym można monitorować metryki, przeszukiwać telemetrię i konfigurować pulpity nawigacyjne.Your telemetry builds up in the Application Insights portal, where you can monitor metrics, search your telemetry, and set up dashboards. Można także użyć zaawansowanego języka zapytań usługi Log Analytics do przeanalizowania użycia i wydajności lub znalezienia określonych zdarzeń.You can also use the powerful Log Analytics query language to analyze usage and performance, or to find specific events.

Można również analizować telemetrię w programie Visual Studio za pomocą narzędzi, takich jak wyszukiwanie diagnostyczne i trendy.You can also continue to analyze your telemetry in Visual Studio, with tools such as diagnostic search and trends.

Uwaga

Jeśli Twoja aplikacja wysyła taką ilość telemetrii, że bliskie jest osiągnięcie limitów ograniczania przepustowości, włączone zostanie próbkowanie automatyczne.If your app sends enough telemetry to approach the throttling limits, automatic sampling switches on. Próbkowania powoduje zmniejszenie ilości telemetrii wysyłanych z aplikacji przy jednoczesnym zachowaniu skorelowanych danych w celach diagnostycznych.Sampling reduces the quantity of telemetry sent from your app, while preserving correlated data for diagnostic purposes.

Wszystko jest gotoweYou're all set

Gratulacje!Congratulations! Udało Ci się zainstalować pakiet usługi Application Insights w swojej aplikacji i skonfigurować go do wysłania danych telemetrii do usługi Application Insights na platformie Azure.You installed the Application Insights package in your app, and configured it to send telemetry to the Application Insights service on Azure.

Diagram przepływu danych telemetrycznych

Zasób platformy Azure, który otrzymuje dane telemetryczne z Twojej aplikacji, jest identyfikowany przez klucz instrumentacji.The Azure resource that receives your app's telemetry is identified by an instrumentation key. Ten klucz znajduje się w pliku ApplicationInsights.config.You'll find this key in the ApplicationInsights.config file.

Uaktualnianie do przyszłych wersji zestawu SDKUpgrade to future SDK versions

Aby przeprowadzić uaktualnienie do nowej wersji zestawu SDK, otwórz menedżera pakietów NuGet i przefiltruj zainstalowane pakiety.To upgrade to a new release of the SDK, open the NuGet package manager, and filter on installed packages. Wybierz Microsoft.ApplicationInsights.Web i kliknij pozycję Uaktualnij.Select Microsoft.ApplicationInsights.Web, and choose Upgrade.

Jeśli plik ApplicationInsights.config został dostosowany, zapisz jego kopię przed uaktualnieniem.If you made any customizations to ApplicationInsights.config, save a copy of it before you upgrade. Następnie scal zmiany w nowej wersji.Then, merge your changes into the new version.

Połączenia wideoVideo

Kolejne krokiNext steps

Istnieją jeszcze inne tematy, które warto przejrzeć, jeśli interesują Cię następujące kwestie:There are alternative topics to look at if you are interested in:

Dalsze funkcje telemetriiMore telemetry

AnalizaAnalysis

AlertyAlerts

  • Testy dostępności: Utwórz testy, aby upewnić się, że Twoja witryna jest widoczna w sieci Web.Availability tests: Create tests to make sure your site is visible on the web.
  • Inteligentne diagnostyki: Te testy są uruchamiane automatycznie, więc nie trzeba wykonywać żadnych czynności, aby je skonfigurować.Smart diagnostics: These tests run automatically, so you don't have to do anything to set them up. Ta funkcja powiadomi Cię, jeśli w aplikacji występuje nietypowa liczba nieudanych żądań.They tell you if your app has an unusual rate of failed requests.
  • Alerty metryki: Ustaw je w celu otrzymania ostrzeżenia, gdy metryka przekroczy próg.Metric alerts: Set these to warn you if a metric crosses a threshold. Możesz je ustawić dla metryk niestandardowych, które zakodujesz w aplikacji.You can set them on custom metrics that you code into your app.

AutomatyzacjaAutomation