Přehled monitorování aplikací pro službu Aplikace Azure Service

  • Článek

Teď je jednodušší než kdy jindy povolit monitorování webových aplikací na základě ASP.NET, ASP.NET Core, Javy a Node.js spuštěných ve službě Aplikace Azure Service. Dříve jste potřebovali aplikaci instrumentovat ručně, ale nejnovější rozšíření nebo agent je teď ve výchozím nastavení integrované do image služby App Service.

Povolit Application Insights

Monitorování aplikací hostovaných ve službě App Service můžete povolit dvěma způsoby:

  • Automatické monitorování aplikací (Application Přehledy Agent).

    Tato metoda je nejjednodušší povolit a nevyžaduje se žádná změna kódu ani pokročilá konfigurace. Často se označuje jako monitorování za běhu. Pro službu App Service doporučujeme povolit alespoň tuto úroveň monitorování. Na základě konkrétního scénáře můžete vyhodnotit, jestli je potřeba pokročilejší monitorování prostřednictvím ruční instrumentace.

    Když povolíte automatickou instrumentaci, povolíte aplikaci Přehledy s výchozím nastavením (zahrnuje i vzorkování). I když nastavíte v Aplikace Azure Přehledy: Vzorkování: 100 % všech dat bude toto nastavení ignorováno.

    Úplný seznam podporovanýchscénářůch

    Monitorování automatické instalace se podporuje na následujících platformách:

  • Ruční instrumentace aplikace prostřednictvím kódu instalací sady Application Přehledy SDK.

    Tento přístup je mnohem přizpůsobitelnější, ale vyžaduje následující přístupy: SDK pro .NET Core, .NET, Node.js, Python a samostatný agent pro Javu. Tato metoda také znamená, že musíte spravovat aktualizace nejnovější verze balíčků sami.

    Pokud potřebujete provádět vlastní volání rozhraní API ke sledování událostí nebo závislostí, které se ve výchozím nastavení nezachytí pomocí automatického monitorování, musíte tuto metodu použít. Další informace najdete v tématu Rozhraní API Přehledy aplikací pro vlastní události a metriky.

Pokud se zjistí monitorování automatické infrastruktury i ruční instrumentace založené na sadě SDK, v .NET se dodržují pouze nastavení ruční instrumentace, zatímco v Javě generuje telemetrii pouze autoinstrumentace. Tímto postupem zabráníte odesílání duplicitních dat.

Poznámka:

Snapshot Debugger a Profiler jsou k dispozici pouze v .NET a .NET Core.

Poznámky k verzi

Tato část obsahuje poznámky k verzi pro rozšíření Azure Web Apps pro instrumentaci modulu runtime pomocí Přehledy aplikace.

Pokud chcete zjistit, jakou verzi rozšíření aktuálně používáte, přejděte na https://<yoursitename>.scm.azurewebsites.net/ApplicationInsightsstránku .

Poznámky k verzi

2.8.44

2.8.43

  • Oddělte balíček .NET/.NET Core, Java a Node.js do jiného rozšíření webu služby App Service pro Windows.

2.8.42

  • Rozšíření JAVA: Upgradováno na agenta Java 3.2.0 z verze 2.5.1.
  • rozšíření Node.js: Aktualizace sady AI SDK na verzi 2.1.8 z verze 2.1.7 Přidání podpory pro spravované identity Microsoft Entra přiřazené uživatelem a systémem
  • .NET Core: Přidali jsme samostatná nasazení a podporu .NET 6.0 pomocí spouštěcího háku .NET.

2.8.41

  • rozšíření Node.js: Aktualizace sady AI SDK na verzi 2.1.7 z verze 2.1.3
  • .NET Core: Odebrali jsme podporu verze (2.1). Podporované verze jsou 3.1 a 5.0.

2.8.40

2.8.39

  • .NET Core: Přidání podpory .NET Core 5.0

2.8.38

  • Rozšíření JAVA: Upgradováno na agenta Java 3.0.2 (GA) z verze 2.5.1.
  • rozšíření Node.js: Aktualizace sady AI SDK na verzi 1.8.8 z verze 1.8.7.
  • .NET Core: Odebrané verze podpory (2.0, 2.2, 3.0). Podporované verze jsou 2.1 a 3.1.

2.8.37

  • Rozšíření AppSvc pro Windows: Fungovalo .NET Core s libovolnou verzí System.Diagnostics.DiagnosticSource.dll.

2.8.36

  • Rozšíření AppSvc pro Windows: Povolené vzájemné operace se sadou AI SDK v .NET Core.

2.8.35

  • Rozšíření AppSvc pro Windows: Přidání podpory .NET Core 3.1

2.8.33

  • Agenti .NET, .NET Core, Java a Node.js a rozšíření Windows: Podpora suverénních cloudů řetězce Připojení se dají použít k odesílání dat do suverénních cloudů.

2.8.31

  • Agent ASP.NET Core opravil problém se sadou Application Přehledy SDK. Pokud modul runtime načetl nesprávnou verzi System.Diagnostics.DiagnosticSource.dll, rozšíření bez kódu neshromádí aplikaci a znovu se vypne. Pokud chcete tento problém vyřešit, měli by zákazníci odebrat System.Diagnostics.DiagnosticSource.dll ze složky přihrádky nebo použít starší verzi rozšíření nastavením ApplicationInsightsAgent_EXTENSIONVERSION=2.8.24. Pokud ne, monitorování aplikací není povolené.

2.8.26

  • ASP.NET core agent: Opravili jsme problém související s aktualizovanou sadou Application Přehledy SDK. Agent se nepokouší načístAiHostingStartup, pokud aplikace Přehledy.dll už je ve složce bin. Řeší problémy související s reflexí prostřednictvím sestavení<AiHostingStartup>. GetTypes().
  • Známé problémy: Výjimka System.IO.FileLoadException: Could not load file or assembly 'System.Diagnostics.DiagnosticSource, Version=4.0.4.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' může být vyvolán, pokud je načtena jiná verze DiagnosticSource knihovny DLL. Může k tomu dojít například v případě, že System.Diagnostics.DiagnosticSource.dll je ve složce pro publikování. Jako omezení rizik použijte předchozí verzi rozšíření nastavením nastavení aplikace ve službách App Services: Application Přehledy Agent_EXTENSIONVERSION=2.8.24.

2.8.24

  • Znovu zabalit verzi 2.8.21.

2.8.23

  • Přidání podpory monitorování bez kódu ASP.NET Core 3.0
  • Aktualizace sady ASP.NET Core SDK na verzi 2.8.0 pro modul runtime verze 2.1, 2.2 a 3.0. Aplikace cílené na .NET Core 2.0 nadále používají sadu SDK 2.1.1.

2.8.14

  • Aktualizace sady ASP.NET Core SDK z verze 2.3.0 na nejnovější verzi (2.6.1) pro aplikace, které cílí na .NET Core 2.1, 2.2. Aplikace cílené na .NET Core 2.0 nadále používají sadu SDK 2.1.1.

2.8.12

  • Podpora aplikací ASP.NET Core 2.2

  • Opravili jsme chybu v rozšíření ASP.NET Core, která způsobovala injektáž sady SDK i v případě, že aplikace je už instrumentovaná se sadou SDK. U aplikací verze 2.1 a 2.2 teď přítomnost aplikace Přehledy.dll ve složce aplikace způsobí, že se rozšíření zase vypne. U aplikací 2.0 se rozšíření vypne jenom v případě, že aplikace Přehledy je povolená UseApplicationInsights() při volání.

  • Trvalá oprava neúplné odpovědi HTML pro aplikace ASP.NET Core Tato oprava je teď rozšířená tak, aby fungovala pro aplikace .NET Core 2.2.

  • Přidání podpory pro vypnutí injektáže JavaScriptu pro aplikace ASP.NET Core (APPINSIGHTS_JAVASCRIPT_ENABLED=false appsetting). Pro ASP.NET jádro je injektáž JavaScriptu ve výchozím nastavení v režimu Odhlásit se, pokud není explicitně vypnutá. (Výchozí nastavení se provádí pro zachování aktuálního chování.)

  • Opravili jsme chybu rozšíření ASP.NET Core, která způsobovala injektáž i v případě, že klíč nebyl k dispozici.

  • Opravili jsme chybu v logice předpony verze sady SDK, která způsobovala nesprávnou verzi sady SDK v telemetrii.

  • Přidání předpony verze sady SDK pro aplikace ASP.NET Core pro identifikaci způsobu shromažďování telemetrie

  • Opravili jsme stránku SCM- Application Přehledy pro správné zobrazení verze předinstalovaného rozšíření.

2.8.10

  • Oprava neúplné odpovědi HTML pro aplikace ASP.NET Core

Nejčastější dotazy

Tato část obsahuje odpovědi na běžné otázky.

Co aplikace Přehledy upravovat v projektu?

Podrobnosti závisí na typu projektu. Pro webovou aplikaci:

  • Přidá do projektu tyto soubory:
    • ApplicationInsights.config
    • ai.js
  • Nainstaluje tyto balíčky NuGet:
    • Rozhraní API Přehledy aplikací: Základní rozhraní API
    • Rozhraní API Přehledy aplikací pro webové aplikace: Používá se k odesílání telemetrie ze serveru.
    • Rozhraní API Přehledy aplikací aplikace pro JavaScript: Používá se k odesílání telemetrie z klienta.
  • Balíčky zahrnují tato sestavení:
    • Microsoft.Application Přehledy
    • Microsoft.Application Přehledy. Platforma
  • Vloží položky do:
    • Soubor web.config
    • packages.config
  • (Pouze pro nové projekty přidáte Přehledy aplikace do existujícího projektu ručně.) Vloží fragmenty kódu klienta a serveru a inicializuje je pomocí ID prostředku Přehledy aplikace. Například v aplikaci MVC se kód vloží do hlavní stránky Views/Shared/_Layout.cshtml.

Další kroky

Zjistěte, jak povolit automatické monitorování aplikací pro vaše aplikace .NET Core, .NET, Java, Nodejs nebo Python spuštěné ve službě App Service.