Alkalmazásfigyelés Azure-alkalmazás szolgáltatáshoz – áttekintés

  • Cikk

Mostantól minden eddiginél egyszerűbben engedélyezheti a ASP.NET, ASP.NET Core, Java és Node.js alapuló monitorozást a webalkalmazásokon a Azure-alkalmazás szolgáltatásban. Korábban manuálisan kellett beállítania az alkalmazást, de a legújabb bővítmény/ügynök alapértelmezés szerint be van építve az App Service-rendszerképbe.

Az Application Insights engedélyezése

Az App Service-ben üzemeltetett alkalmazások monitorozásának kétféle módja van:

  • Autoinstrumentation application monitoring (Application Elemzések Agent).

    Ez a módszer a legegyszerűbben engedélyezve, és nincs szükség kódmódosításra vagy speciális konfigurációkra. Ezt gyakran "futtatókörnyezet" monitorozásnak is nevezik. Az App Service esetében azt javasoljuk, hogy legalább engedélyezze ezt a monitorozási szintet. Az adott forgatókönyv alapján kiértékelheti, hogy szükség van-e speciálisabb monitorozásra manuális rendszerezéssel.

    Ha engedélyezi az automatikus rendszerezést, az alapértelmezett beállítással engedélyezi az alkalmazás Elemzések (beleértve a mintavételezést is). Még akkor is, ha a Azure-alkalmazás Elemzések: Mintavételezés: Minden adat 100%-ban ezt a beállítást figyelmen kívül hagyja.

    A támogatott autoinstrumentációs forgatókönyvek teljes listájáért tekintse meg a támogatott környezeteket, nyelveket és erőforrás-szolgáltatókat.

    Az autoinstrumentáció monitorozása a következő platformokat támogatja:

  • Az alkalmazás manuális rendszerezése kódon keresztül az Alkalmazás Elemzések SDK telepítésével.

    Ez a megközelítés sokkal testreszabhatóbb, de a következő módszereket igényli: SDK for .NET Core, .NET, Node.js, Python, és egy különálló ügynök Java-hoz. Ez a módszer azt is jelenti, hogy a csomagok legújabb verziójának frissítéseit saját maga kell kezelnie.

    Ha egyéni API-hívásokat kell indítania az alapértelmezés szerint nem rögzített események/függőségek nyomon követéséhez az automatikus beléptetés monitorozásával, ezt a módszert kell használnia. További információ: Application Elemzések API egyéni eseményekhez és metrikákhoz.

Ha az autoinstrumentáció monitorozása és a manuális SDK-alapú rendszerállapot is észlelhető, a .NET-ben csak a manuális rendszerállapot-beállítások teljesülnek, míg a Java-ban csak az autoinstrumentáció bocsátja ki a telemetriát. Ez a gyakorlat megakadályozza a duplikált adatok küldését.

Feljegyzés

A Pillanatkép-hibakereső és a Profiler csak a .NET-ben és a .NET Core-ban érhető el.

Kibocsátási megjegyzések

Ez a szakasz az Azure Web Apps-bővítmény kiadási megjegyzéseit tartalmazza az Application Elemzések futtatókörnyezeti rendszerállapotához.

A jelenleg használt bővítmény verziójának megkereséséhez nyissa meg a következőt https://<yoursitename>.scm.azurewebsites.net/ApplicationInsights: .

Kibocsátási megjegyzések

2.8.44

2.8.43

  • A .NET/.NET Core, a Java és a Node.js csomagot külön App Service Windows-webhelybővítménybe kell elválasztania.

2.8.42

  • JAVA-bővítmény: Frissítve a Java Agent 3.2.0-ra a 2.5.1-ről.
  • Node.js bővítmény: Az AI SDK 2.1.8-ra frissült a 2.1.7-ről. A felhasználó és a rendszer által hozzárendelt Microsoft Entra felügyelt identitások támogatása hozzáadva.
  • .NET Core: Önkiszolgáló üzembe helyezéseket és .NET 6.0-támogatást adott hozzá a .NET Startup Hook használatával.

2.8.41

  • Node.js bővítmény: Az AI SDK 2.1.7-ről 2.1.3-ra frissült.
  • .NET Core: El lett távolítva a nem támogatott verzió (2.1). A támogatott verziók a 3.1 és az 5.0.

2.8.40

  • JAVA-bővítmény: Java Agent 3.1.1 (GA) verzióra frissítve a 3.0.2-ről.
  • Node.js bővítmény: Az AI SDK 2.1.3-ra frissült az 1.8.8-ról.

2.8.39

  • .NET Core: .NET Core 5.0-támogatás hozzáadva.

2.8.38

  • JAVA-bővítmény: a Java Agent 3.0.2 -re (GA) frissítve a 2.5.1-ről.
  • Node.js bővítmény: Az AI SDK 1.8.8-ra frissült 1.8.7-ről.
  • .NET Core: Nem támogatott verziók (2.0, 2.2, 3.0). A támogatott verziók a 2.1 és a 3.1.

2.8.37

  • AppSvc Windows-bővítmény: A .NET Core a System.Diagnostics.DiagnosticSource.dll bármely verziójával használható.

2.8.36

  • AppSvc Windows-bővítmény: Engedélyezett inter-op az AI SDK-val a .NET Core-ban.

2.8.35

  • AppSvc Windows-bővítmény: .NET Core 3.1-támogatás hozzáadva.

2.8.33

  • .NET, .NET Core, Java és Node.js ügynökök és a Windows-bővítmény: Szuverén felhők támogatása. Csatlakozás ion-sztringek használatával adatokat küldhet szuverén felhőkbe.

2.8.31

  • A ASP.NET Core-ügynök kijavított egy hibát az Alkalmazás Elemzések SDK-val kapcsolatban. Ha a futtatókörnyezet helytelen verzióját System.Diagnostics.DiagnosticSource.dlltöltötte be, a kód nélküli bővítmény nem összeomlik az alkalmazás, és visszaáll. A probléma megoldásához az ügyfeleknek el kell távolítaniuk System.Diagnostics.DiagnosticSource.dll a tárolómappából, vagy a bővítmény régebbi verzióját kell használniuk a beállítással ApplicationInsightsAgent_EXTENSIONVERSION=2.8.24. Ha nem, az alkalmazásfigyelés nincs engedélyezve.

2.8.26

  • ASP.NET Core Agent: Kijavítottuk a frissített alkalmazás Elemzések SDK-val kapcsolatos problémát. Az ügynök nem próbál betölteniAiHostingStartup, ha az alkalmazás Elemzések.dll már megtalálható a tárolómappában. Az Assembly<AiHostingStartup segítségével oldja meg a tükrözéssel kapcsolatos problémákat>. GetTypes().
  • Ismert problémák: Kivételt System.IO.FileLoadException: Could not load file or assembly 'System.Diagnostics.DiagnosticSource, Version=4.0.4.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' okozhat, ha a DLL egy másik verziója DiagnosticSource be van töltve. Ez például akkor fordulhat elő, ha System.Diagnostics.DiagnosticSource.dll a közzétételi mappában van. Megoldásként használja a bővítmény előző verzióját az appszolgáltatások alkalmazásbeállításainak beállításával: Application Elemzések Agent_EXTENSIONVERSION=2.8.24.

2.8.24

  • A 2.8.21 újracsomagolt verziója.

2.8.23

  • Hozzáadott ASP.NET Core 3.0 kód nélküli monitorozási támogatás.
  • Frissítettük ASP.NET Core SDK-t 2.8.0-ra a 2.1-s, 2.2-s és 3.0-s futtatókörnyezeti verziókhoz. A .NET Core 2.0-t célzó alkalmazások továbbra is az SDK 2.1.1-jét használják.

2.8.14

  • Frissítettük ASP.NET Core SDK 2.3.0-s verzióját a legújabbra (2.6.1) a .NET Core 2.1- és 2.2-es verziót célzó alkalmazásokhoz. A .NET Core 2.0-t célzó alkalmazások továbbra is az SDK 2.1.1-jét használják.

2.8.12

  • ASP.NET Core 2.2-alkalmazások támogatása.

  • Kijavítottunk egy hibát ASP.NET Core-bővítményben, amely az SDK injektálását okozta akkor is, ha az alkalmazás már rendelkezik SDK-val. A 2.1- és 2.2-alkalmazások esetében az Alkalmazás Elemzések.dll jelenléte az alkalmazásmappában a bővítmény leállását okozza. A 2.0-s alkalmazások esetében a bővítmény csak akkor áll vissza, ha az Alkalmazás Elemzések engedélyezve van egy UseApplicationInsights() hívással.

  • Az ASP.NET Core-alkalmazások hiányos HTML-válaszának végleges javítása. Ezt a javítást kiterjesztették a .NET Core 2.2-alkalmazások működésére.

  • Támogatás hozzáadva a JavaScript-injektálás kikapcsolásához ASP.NET Core-alkalmazásokhoz (APPINSIGHTS_JAVASCRIPT_ENABLED=false appsetting). ASP.NET mag esetében a JavaScript-injektálás alapértelmezés szerint "Opt-Out" módban van, kivéve, ha explicit módon ki van kapcsolva. (Az alapértelmezett beállítás az aktuális viselkedés megőrzéséhez készült.)

  • Kijavítottuk ASP.NET Core bővítményhibát, amely akkor is injektálást okozott, ha az ikey nem volt jelen.

  • Kijavítottunk egy hibát az SDK verzióelőtag-logikájában, amely helytelen SDK-verziót okozott a telemetriában.

  • Hozzáadta ASP.NET Core-alkalmazások SDK-verzióelőtagját a telemetriai adatok gyűjtésének azonosításához.

  • Rögzített SCM- Alkalmazás Elemzések oldal az előre telepített bővítmény verziójának helyes megjelenítéséhez.

2.8.10

  • Javítás ASP.NET Core-alkalmazások hiányos HTML-válaszához.

Gyakori kérdések

Ez a szakasz választ ad a gyakori kérdésekre.

Mit Elemzések módosítani az alkalmazás a projektemben?

A részletek a projekt típusától függenek. Webalkalmazás esetén:

  • A következő fájlokat adja hozzá a projekthez:
    • ApplicationInsights.config
    • ai.js
  • Telepíti ezeket a NuGet-csomagokat:
    • Application Elemzések API: Az alapvető API
    • Alkalmazás Elemzések API webalkalmazásokhoz: Telemetriai adatok küldésére szolgál a kiszolgálóról
    • Alkalmazás Elemzések API JavaScript-alkalmazásokhoz: Telemetriai adatok küldésére szolgál az ügyféltől
  • A csomagok a következő szerelvényeket tartalmazzák:
    • Microsoft.Application Elemzések
    • Microsoft.Application Elemzések. Platform
  • Elemek beszúrása a következőbe:
    • Web.config
    • packages.config
  • (Csak új projektek esetén manuálisan adja hozzá az Alkalmazás Elemzések egy meglévő projekthez.) Kódrészleteket szúr be az ügyfél- és kiszolgálókódba, hogy inicializálja őket az alkalmazás Elemzések erőforrás-azonosítójával. Egy MVC-alkalmazásban például a rendszer kódot szúr be a Nézetek/Megosztott/_Layout.cshtml főlapra.

Következő lépések

Megtudhatja, hogyan engedélyezheti az autoinstrumentációs alkalmazásfigyelést az App Service-en futó .NET Core-, .NET-, Java-, Nodejs- vagy Python-alkalmazáshoz.