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 sieci Web 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 albo w chmurze.It works for ASP.NET apps that are hosted either in your own IIS server 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.

Przed rozpoczęciemBefore you start

Potrzebne są:You need:

  • Program Visual Studio 2013 Update 3 lub nowszyVisual Studio 2013 update 3 or later. (im nowszy, tym lepiej).Later is better.
  • Subskrypcja platformy Microsoft Azure.A subscription to Microsoft Azure. Jeśli Twój zespół lub organizacja mają subskrypcję platformy Azure, właściciel subskrypcji może Cię do niej dodać, korzystając z Twojego konta Microsoft.If your team or organization has an Azure subscription, the owner can add you to it, by using your Microsoft account.

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:

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

Kliknij prawym przyciskiem myszy projekt aplikacji sieci Web w Eksploratorze rozwiązań, a następnie wybierz polecenie Dodaj > Telemetria usługi Application Insights... lub Konfiguruj usługę Application Insights.Right-click your web app project in Solution Explorer, and choose Add > Application Insights Telemetry... or Configure Application Insights.

Zrzut ekranu Eksploratora rozwiązań z wyróżnioną opcją Dodaj telemetrię usługi Application Insights

(W programie Visual Studio 2015 istnieje również opcja dodania usługi Application Insights w oknie dialogowym Nowy projekt).(In Visual Studio 2015, there's also an option to add Application Insights in the New Project dialog.)

Przejdź do strony konfiguracji usługi Application Insights:Continue to the Application Insights configuration page:

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

a.a. Wybierz konto i subskrypcję używane do uzyskiwania dostępu do platformy Azure.Select the account and subscription that you use to access Azure.

b.b. Wybierz zasób na platformie Azure, w którym mają być wyświetlane dane z aplikacji.Select the resource in Azure where you want to see the data from your app. Zazwyczaj:Usually:

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.

c.c. Ustaw ograniczenie limitu bezpłatnej ilości danych, aby uniknąć naliczania opłat.Set a cap at the free data volume limit, to avoid charges. Usługa Application Insights jest bezpłatna do pewnej ilości danych telemetrycznych.Application Insights is free up to a certain volume of telemetry. Po utworzeniu zasobu możesz zmienić wybór w portalu, wybierając pozycję Funkcje i cennik > Zarządzanie ilością danych > Dzienny limit ilości.After the resource is created, you can change your selection in the portal by opening Features + pricing > Data volume management > Daily volume cap.

d.d. Kliknij przycisk Zarejestruj, aby skonfigurować usługę Application Insights dla aplikacji sieci Web.Click Register to go ahead and configure Application Insights for your web app. 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.

e.e. 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 będzie można wyświetlać w programie Visual Studio podczas debugowania.You will be 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 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

W programie Visual Studio otwórz okno usługi Application Insights.In Visual Studio, open the Application Insights window. Kliknij przycisk Application Insights albo kliknij prawym przyciskiem myszy projekt w Eksploratorze rozwiązań, wybierz pozycję Application Insights, a następnie kliknij pozycję Wyszukaj telemetrię na żywo.Either click the Application Insights button, or right-click your project in Solution Explorer, select Application Insights, and then click Search Live Telemetry.

W oknie wyszukiwania usługi Visual Studio Application Insights wyświetl widok Dane z sesji debugowania dla telemetrii wygenerowanej po stronie serwera aplikacji.In the Visual Studio Application Insights Search window, see the Data from Debug session view 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.

Uwaga

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 go tam znajdź lub kliknij prawym przyciskiem myszy projekt w programie Visual Studio i przejdź do niego.Either sign in to the Azure portal and find it there, or right-click the project in Visual Studio, and let it take you there.

Zrzut ekranu programu Visual Studio przedstawiający sposób otwierania portalu Application Insights

Uwaga

Jeśli wystąpi błąd dostępu: czy masz więcej niż jeden zestaw poświadczeń firmy Microsoft i czy logowanie nastąpiło za pomocą nieprawidłowego zestawu?If you get an access error: Do you have more than one set of Microsoft credentials, and are you signed in with the wrong set? W portalu wyloguj się i zaloguj się ponownie.In the portal, sign out and sign in again.

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 ponownie menedżera pakietów NuGet i przefiltruj zainstalowane pakiety.To upgrade to a new release of the SDK, open the NuGet package manager again, 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

Następne krokiNext steps

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