Alkalmazásfigyelés Azure-alkalmazás szolgáltatáshoz – áttekintés
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
- .NET/.NET Core: Alkalmazásra frissítve Elemzések .NET SDK 2.20.1-re.
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.dll
tö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ítaniukSystem.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ássalApplicationInsightsAgent_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ölteni
AiHostingStartup
, 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ójaDiagnosticSource
be van töltve. Ez például akkor fordulhat elő, haSystem.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.
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: