Az Azure Monitor-alkalmazás Elemzések-ügynök üzembe helyezése helyszíni kiszolgálókhoz
- Cikk
Az Application Elemzések Agent (korábbi nevén Status Monitor V2) egy PowerShell-modul, amelyet a PowerShell-galéria tettek közzé. Lecseréli az Állapotfigyelőt. A rendszer telemetriát küld az Azure Portalra, ahol figyelheti az alkalmazást.
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.
Megjegyzés:
A modul jelenleg az IIS-ben üzemeltetett ASP.NET és ASP.NET Core-webalkalmazások kód nélküli rendszerezését támogatja. Java- és Node.js-alkalmazások SDK-val való eszközzé alakításához.
PowerShell-galéria
Az Application Elemzések Agent a PowerShell-galéria található.
Utasítások
- A tömör kódminták használatának megkezdéséhez tekintse meg az Első lépések lapot.
- Az első lépések részletes megismeréséhez tekintse meg a Részletes utasítások lapot.
- A PowerShell API-ra vonatkozó referenciát az API referencia lapján találja.
- A kibocsátási megjegyzések frissítéseit a Kibocsátási megjegyzések lapon találja.
Ez a lap azokat a gyorsútmutató-parancsokat tartalmazza, amelyek a legtöbb környezetben várhatóan működni fognak. Az utasítások a frissítések terjesztéséhez PowerShell-galéria függnek. Ezek a parancsok támogatják a PowerShell-paramétert -Proxy
.
A parancsok, a testreszabási utasítások és a hibaelhárítással kapcsolatos információk magyarázatát a részletes utasításokban találja.
Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.
Letöltés és telepítés PowerShell-galéria
A letöltéshez és a telepítéshez használja a PowerShell-galéria.
Telepítési előfeltételek
A figyelés engedélyezéséhez rendelkeznie kell egy kapcsolati sztring. Egy kapcsolati sztring jelenik meg az alkalmazás Elemzések erőforrás Áttekintés paneljén. További információ: Csatlakozás ion sztringek.
Megjegyzés:
2020 áprilisától PowerShell-galéria elavult TLS 1.1 és 1.0.
További szükséges előfeltételekért tekintse meg PowerShell-galéria TLS-támogatást.
Futtassa a PowerShellt rendszergazdaként.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Install-Module -Name PowerShellGet -Force
Zárja be a PowerShellt.
Application Elemzések Agent telepítése
Futtassa a PowerShellt rendszergazdaként.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense
Megjegyzés:
A AllowPrerelease
parancsmag kapcsolója Install-Module
lehetővé teszi a bétaverzió telepítését.
További információ: Install-Module.
Monitorozás engedélyezése
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'
Manuális letöltés és telepítés (offline lehetőség)
Manuálisan is letöltheti és telepítheti.
A modul letöltése
Töltse le manuálisan a modul legújabb verzióját a PowerShell-galéria.
Az Alkalmazás Elemzések-ügynök kibontás és telepítése
$pathToNupkg = "C:\Users\t\Desktop\Az.ApplicationMonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\Az.ApplicationMonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule
Monitorozás engedélyezése
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'
Ez a lap bemutatja, hogyan lehet előkészíteni a PowerShell-galéria és letölteni az ApplicationMonitor modult. Az első lépésekhez a leggyakrabban használt paramétereket tartalmazza. Manuális letöltési utasításokat is megadtunk arra az esetre, ha nem rendelkezik internet-hozzáféréssel.
Kapcsolati sztring lekérése
Első lépésként szüksége lesz egy kapcsolati sztring. További információ: Csatlakozás ion sztringek.
Megjegyzés:
2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapot-kulcsok betöltése továbbra is működni fog, de a továbbiakban nem biztosítunk frissítéseket vagy támogatást a funkcióhoz. Váltás kapcsolati sztring az új képességek kihasználásához.
A PowerShell futtatása emelt szintű végrehajtási szabályzattal Rendszergazda
Futtatás Rendszergazda
A PowerShellnek Rendszergazda istrator szintű engedélyekre van szüksége a számítógép módosításához.
Végrehajtási irányelv
- Leírás: Alapértelmezés szerint a PowerShell-szkriptek futtatása le van tiltva. Azt javasoljuk, hogy csak az aktuális hatókörhöz engedélyezi a RemoteSigned-szkripteket.
- Referencia: A végrehajtási szabályzatok és a Set-ExecutionPolicy ismertetése.
- Parancs:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
. - Nem kötelező paraméter:
-Force
. Adja át a megerősítési kérést.
Példák a hibákra
Install-Module : The 'Install-Module' command was found in the module 'PowerShellGet', but the module could not be
loaded. For more information, run 'Import-Module PowerShellGet'.
Import-Module : File C:\Program Files\WindowsPowerShell\Modules\PackageManagement\1.3.1\PackageManagement.psm1 cannot
be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https://go.microsoft.com/fwlink/?LinkID=135170.
A PowerShell előfeltételei
A parancs futtatásával naplózhatja a PowerShell-példányt $PSVersionTable
.
Ez a parancs a következő kimenetet hozza létre:
Name Value
---- -----
PSVersion 5.1.17763.316
PSEdition Desktop
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0...}
BuildVersion 10.0.17763.316
CLRVersion 4.0.30319.42000
WSManStackVersion 3.0
PSRemotingProtocolVersion 2.3
SerializationVersion 1.1.0.1
Ezeket az utasításokat Windows 10-et és az alábbi verziókat futtató számítógépen írták és tesztelték.
A PowerShell-galéria előfeltételei
Ezek a lépések felkészítik a kiszolgálót a modulok PowerShell-galéria való letöltésére.
Megjegyzés:
PowerShell-galéria Windows 10, Windows Server 2016 és PowerShell 6+ rendszereken támogatott. A korábbi verziókról további információt a PowerShellGet telepítése című témakörben talál.
Futtassa a PowerShellt Rendszergazda egy emelt szintű végrehajtási szabályzattal.
Telepítse a NuGet-csomagszolgáltatót.
- Leírás: Ehhez a szolgáltatóhoz olyan NuGet-alapú adattárakra van szüksége, mint a PowerShell-galéria.
- Referencia: Install-PackageProvider.
- Parancs:
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201
. - Választható paraméterek:
-Proxy
. Proxykiszolgálót ad meg a kéréshez.-Force
. Adja át a megerősítési kérést.
A következő üzenet jelenik meg, ha a NuGet nincs beállítva:
NuGet provider is required to continue PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based repositories. The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies' or 'C:\Users\t\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the NuGet provider by running 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force'. Do you want PowerShellGet to install and import the NuGet provider now? [Y] Yes [N] No [S] Suspend [?] Help (default is "Y"):
Konfigurálja a PowerShell-galéria megbízható adattárként.
- Leírás: Alapértelmezés szerint a PowerShell-galéria nem megbízható adattár.
- Hivatkozás: Set-PSRepository.
- Parancs:
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
. - Nem kötelező paraméter:
-Proxy
. Proxykiszolgálót ad meg a kéréshez.
A következő üzenet jelenik meg, ha PowerShell-galéria nem megbízható:
Untrusted repository You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from 'PSGallery'? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
A módosítást a parancs futtatásával
Get-PSRepository
ellenőrizheti és naplózhatjaPSRepositories
.Telepítse a PowerShellGet legújabb verzióját.
- Leírás: Ez a modul tartalmazza a más modulok PowerShell-galéria való lekéréséhez használt eszközt. Az 1.0.0.1-es verzió windows 10-es és Windows Server rendszerű. Az 1.6.0-s vagy újabb verzióra van szükség. A telepített verzió meghatározásához futtassa a
Get-Command -Module PowerShellGet
parancsot. - Referencia: A PowerShellGet telepítése.
- Parancs:
Install-Module -Name PowerShellGet
. - Választható paraméterek:
-Proxy
. Proxykiszolgálót ad meg a kéréshez.-Force
. Adja át a "már telepített" figyelmeztetést, és telepíti a legújabb verziót.
Ez a hiba akkor jelenik meg, ha nem a PowerShellGet legújabb verzióját használja:
Install-Module : A parameter cannot be found that matches parameter name 'AllowPrerelease'. At line:1 char:20 Install-Module abc -AllowPrerelease ~~~~~~~~~~~~~~~~ CategoryInfo : InvalidArgument: (:) [Install-Module], ParameterBindingException FullyQualifiedErrorId : NamedParameterNotFound,Install-Module
- Leírás: Ez a modul tartalmazza a más modulok PowerShell-galéria való lekéréséhez használt eszközt. Az 1.0.0.1-es verzió windows 10-es és Windows Server rendszerű. Az 1.6.0-s vagy újabb verzióra van szükség. A telepített verzió meghatározásához futtassa a
Indítsa újra a PowerShellt. Az új verzió nem tölthető be az aktuális munkamenetben. Az új PowerShell-munkamenetek betöltik a PowerShellGet legújabb verzióját.
Töltse le és telepítse a modult PowerShell-galéria
Ezek a lépések letöltik az Az.ApplicationMonitor modult PowerShell-galéria.
- Győződjön meg arról, hogy a PowerShell-galéria minden előfeltétele teljesül.
- Futtassa a PowerShellt Rendszergazda egy emelt szintű végrehajtási szabályzattal.
- Telepítse az Az.ApplicationMonitor modult.
- Referencia: Install-Module.
- Parancs:
Install-Module -Name Az.ApplicationMonitor
. - Választható paraméterek:
-Proxy
. Proxykiszolgálót ad meg a kéréshez.-AllowPrerelease
. Lehetővé teszi az alfa- és bétaverziók telepítését.-AcceptLicense
. Adja át a "Licenc elfogadása" kérést-Force
. Adja át a "Nem megbízható adattár" figyelmeztetést.
Töltse le és telepítse manuálisan a modult (offline lehetőség)
Ha bármilyen okból nem tud csatlakozni a PowerShell-modulhoz, manuálisan letöltheti és telepítheti az Az.ApplicationMonitor modult.
A legújabb nupkg-fájl manuális letöltése
- Odamegy https://www.powershellgallery.com/packages/Az.ApplicationMonitor.
- Válassza ki a fájl legújabb verzióját a Verzióelőzmények táblában.
- A Telepítési beállítások területen válassza a Manuális letöltés lehetőséget.
1. lehetőség: Telepítés PowerShell-modulok könyvtárába
Telepítse a manuálisan letöltött PowerShell-modult egy PowerShell-címtárba, hogy a PowerShell-munkamenetek felfedezhessék. További információ: PowerShell-modul telepítése.
Bontsa ki az nupkg fájlt zip-fájlként az Expand-Archive (1.0.1.0-s verzió) használatával
Leírás: A Microsoft.PowerShell.Archive (1.0.1.0-s verzió) alapverziója nem tudja feloldani az nupkg-fájlokat. Nevezze át a fájlt a .zip kiterjesztéssel.
Hivatkozás: Expand-Archive.
Command:
$pathToNupkg = "C:\az.applicationmonitor.0.3.0-alpha.nupkg" $pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip")) $pathToNupkg | rename-item -newname $pathToZip $pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\az.applicationmonitor" Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule
Bontsa ki az nupkg-ot az Expand-Archive (1.1.0.0-s verzió) használatával
Leírás: Az Expand-Archive aktuális verziójával kibonthatja az nupkg-fájlokat a bővítmény módosítása nélkül.
Hivatkozás: Expand-Archive és Microsoft.PowerShell.Archive.
Command:
$pathToNupkg = "C:\az.applicationmonitor.0.2.1-alpha.nupkg" $pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\az.applicationmonitor" Expand-Archive -LiteralPath $pathToNupkg -DestinationPath $pathInstalledModule
2. lehetőség: Bontsa ki és importálja az nupkg-t manuálisan
Telepítse a manuálisan letöltött PowerShell-modult egy PowerShell-címtárba, hogy a PowerShell-munkamenetek felfedezhessék. További információ: PowerShell-modul telepítése.
Ha a modult bármely más könyvtárba telepíti, manuálisan importálja a modult az Import-Module használatával.
Fontos
A DLL-ek relatív elérési utakon keresztül telepítendők. Tárolja a csomag tartalmát a kívánt futtatókörnyezeti címtárban, és győződjön meg arról, hogy a hozzáférési engedélyek olvasást és írást nem engedélyeznek.
- Módosítsa a bővítményt ".zip" értékre, és bontsa ki a csomag tartalmát a kívánt telepítési könyvtárba.
- Keresse meg az Az.ApplicationMonitor.psd1 fájl elérési útját.
- Futtassa a PowerShellt Rendszergazda egy emelt szintű végrehajtási szabályzattal.
- Töltse be a modult a
Import-Module Az.ApplicationMonitor.psd1
parancs használatával.
Forgalom átirányítása proxyn keresztül
Ha egy számítógépet a privát intraneten figyel, a HTTP-forgalmat proxyn keresztül kell irányítania.
Az Az.ApplicationMonitor PowerShell-galéria letöltéséhez és telepítéséhez szükséges PowerShell-parancsok támogatnak egy paramétert-Proxy
.
A telepítési szkriptek írásakor tekintse át az előző utasításokat.
Az alkalmazás Elemzések SDK-nak el kell küldenie az alkalmazás telemetriáját a Microsoftnak. Javasoljuk, hogy konfigurálja az alkalmazás proxybeállításait a web.config fájlban. További információ: Hogyan proxyátengedés elérése?.
Monitorozás engedélyezése
A parancs használatával engedélyezheti a Enable-ApplicationInsightsMonitoring
figyelést.
A parancsmag használatának részletes leírását az API-referenciában találja.
Ez a lap a következő parancsmagokat ismerteti, amelyek az Az.ApplicationMonitor PowerShell-modul tagjai:
- Enable-InstrumentationEngine
- Enable-Application Elemzések Monitoring
- Disable-InstrumentationEngine
- Alkalmazás letiltása Elemzések Monitoring
- Get-Application Elemzések MonitoringConfig
- Get-Application Elemzések MonitoringStatus
- Set-Application Elemzések MonitoringConfig
- Start-Application Elemzések MonitoringTrace
Megjegyzés:
- Első lépésként szüksége lesz egy kapcsolati sztring. További információ: Erőforrás létrehozása.
- Ehhez a parancsmaghoz át kell tekintenie és el kell fogadnia a licenc- és adatvédelmi nyilatkozatunkat.
Megjegyzés:
2025. március 31-én megszűnik az eszközkulcsalapú betöltés támogatása. A rendszerállapot-kulcsok betöltése továbbra is működni fog, de a továbbiakban nem biztosítunk frissítéseket vagy támogatást a funkcióhoz. Váltás kapcsolati sztring az új képességek kihasználásához.
Fontos
Ehhez a parancsmaghoz Rendszergazda engedélyekkel és emelt szintű végrehajtási szabályzattal rendelkező PowerShell-munkamenetre van szükség. További információ: A PowerShell futtatása rendszergazdaként emelt szintű végrehajtási szabályzattal.
- Ehhez a parancsmaghoz át kell tekintenie és el kell fogadnia a licenc- és adatvédelmi nyilatkozatunkat.
- A rendszerállapot-motor további többletterhelést ad hozzá, és alapértelmezés szerint ki van kapcsolva.
Enable-InstrumentationEngine
Néhány beállításkulcs beállításával engedélyezi a rendszerállapot-kezelő motort. Indítsa újra az IIS-t a módosítások érvénybe lépéséhez.
A rendszerállapot-motor kiegészítheti a .NET SDK-k által gyűjtött adatokat. Olyan eseményeket és üzeneteket gyűjt, amelyek egy felügyelt folyamat végrehajtását írják le. Ezek az események és üzenetek függőségi eredménykódokat, HTTP-parancsokat és SQL-parancsszövegeket tartalmaznak.
Engedélyezze a rendszerállapot-motort, ha:
- Már engedélyezte a figyelést az Enable parancsmaggal, de nem engedélyezte a rendszerállapot-motort.
- Manuálisan rendszerezte az alkalmazást a .NET SDK-kkal, és további telemetriát szeretne gyűjteni.
Példák
Enable-InstrumentationEngine
Parameters
-AcceptLicense
Opcionális. Ezzel a kapcsolóval elfogadhatja a licenc- és adatvédelmi nyilatkozatot a fej nélküli telepítésekben.
-Részletes
Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.
Hozam
Példakimenet a rendszerállapot-motor sikeres engedélyezéséről
Configuring IIS Environment for instrumentation engine...
Configuring registry for instrumentation engine...
Enable-Application Elemzések Monitoring
Lehetővé teszi az IIS-alkalmazások kód nélküli csatolásának figyelését a célszámítógépen.
Ez a parancsmag módosítja az IIS applicationHost.config fájlt, és beállít néhány beállításkulcsot. Létrehoz egy applicationinsights.ikey.config fájlt, amely meghatározza az egyes alkalmazások által használt rendszerállapot-kulcsot. Az IIS indításkor betölti a RedfieldModule-t, amely az alkalmazások indításakor az alkalmazás Elemzések SDK-t injektálja az alkalmazásokba. Indítsa újra az IIS-t a módosítások érvénybe lépéséhez.
A figyelés engedélyezése után javasoljuk, hogy az Élő metrikák használatával gyorsan ellenőrizze, hogy az alkalmazás telemetriát küld-e nekünk.
Példák
Példa egyetlen kapcsolati sztring
Ebben a példában az aktuális számítógépen lévő összes alkalmazás egyetlen kapcsolati sztring van hozzárendelve.
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'
Példa egyetlen rendszerállapot-kulccsal
Ebben a példában az aktuális számítógépen található összes alkalmazáshoz egyetlen rendszerállapot-kulcs van hozzárendelve.
Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Példa eszközkulcs-térképpel
Ebben a példában:
MachineFilter
a helyettesítő karakterrel egyezik az'.*'
aktuális számítógéppel.AppFilter='WebAppExclude'
rendszerállapotkulcsotnull
biztosít. A megadott alkalmazás nincs kialakítva.AppFilter='WebAppOne'
a megadott alkalmazáshoz egy egyedi rendszerállapot-kulcsot rendel.AppFilter='WebAppTwo'
a megadott alkalmazáshoz egy egyedi rendszerállapot-kulcsot rendel.AppFilter
a helyettesítő karakterrel'.*'
egyezik a még nem egyező webalkalmazásokkal, és hozzárendel egy alapértelmezett rendszerállapotkulcsot.- A rendszer szóközöket ad hozzá az olvashatóság érdekében.
Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap `
` @(@{MachineFilter='.*';AppFilter='WebAppExclude'},
` @{MachineFilter='.*';AppFilter='WebAppOne';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx1'}},
` @{MachineFilter='.*';AppFilter='WebAppTwo';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2'}},
` @{MachineFilter='.*';AppFilter='.*';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault'}})
Megjegyzés:
Az AppFilter elnevezése ebben a környezetben zavaró lehet, AppFilter
és beállítja az alkalmazásnév regex szűrőt (HostingEnvironment.SiteName az IIS-en futó .NET esetén). VirtualPathFilter
beállítja a virtuális elérési út regex szűrőt (HostingEnvironment.ApplicationVirtualPath az IIS-en futó .NET esetén). Egyetlen alkalmazás üzembe helyezése a VirtualPathFilterrel történik az alábbiak szerint: Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap @(@{VirtualPathFilter="^/MyAppName$"; InstrumentationSettings=@{InstrumentationKey='<your ikey>'}})
Parameters
-Csatlakozás ionString
Szükséges. Ezzel a paraméterrel egyetlen kapcsolati sztring biztosít a célszámítógépen lévő összes alkalmazás számára.
-InstrumentationKey
Szükséges. Ezzel a paraméterrel egyetlen rendszerállapotkulcsot biztosít a célszámítógépen lévő összes alkalmazás számára.
-InstrumentationKeyMap
Szükséges. Ezzel a paraméterrel több rendszerállapotkulcsot és az egyes alkalmazások által használt rendszerállapot-kulcsokat is leképezheti.
Több számítógéphez is létrehozhat egyetlen telepítési szkriptet a beállítással MachineFilter
.
Fontos
Az alkalmazások a szabályok megadásának sorrendjében egyezik a szabályokkal. Ezért először a legspecifikusabb szabályokat kell megadnia, a leggenerikusabb szabályokat pedig utolsóként.
Schema
@(@{MachineFilter='.*';AppFilter='.*';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'}})
- A MachineFilter a számítógép vagy a virtuális gép nevének kötelező C# regexe.
- '.*' egyezik az összes
- A "ComputerName" csak a megadott pontos névvel rendelkező számítógépekre vonatkozik.
- Az AppFilter az IIS-webhelynév kötelező C# regexe. A get-iissite parancs futtatásával lekérheti a kiszolgálón található webhelyek listáját.
- '.*' egyezik az összes
- A "SiteName" csak az IIS-webhelynek felel meg a megadott pontos névvel.
- A InstrumentationKey az előző két szűrőnek megfelelő alkalmazások monitorozásának engedélyezéséhez szükséges.
- Hagyja ezt az értéket null értéken, ha szabályokat szeretne definiálni a figyelés kizárásához.
-EnableInstrumentationEngine
Opcionális. Ezzel a kapcsolóval engedélyezheti a rendszerállapot-motor számára, hogy eseményeket és üzeneteket gyűjtsön arról, hogy mi történik egy felügyelt folyamat végrehajtása során. Ezek az események és üzenetek függőségi eredménykódokat, HTTP-parancsokat és SQL-parancsszövegeket tartalmaznak.
A rendszerállapot-motor többletterhelést ad hozzá, és alapértelmezés szerint ki van kapcsolva.
-AcceptLicense
Opcionális. Ezzel a kapcsolóval elfogadhatja a licenc- és adatvédelmi nyilatkozatot a fej nélküli telepítésekben.
-IgnoreSharedConfig
Ha webkiszolgálókból álló fürtje van, előfordulhat, hogy megosztott konfigurációt használ. A HttpModule nem injektálható ebbe a megosztott konfigurációba. Ez a szkript meghiúsul azzal az üzenettel, hogy további telepítési lépésekre van szükség. Ezzel a kapcsolóval figyelmen kívül hagyhatja ezt az ellenőrzést, és folytathatja az előfeltételek telepítését. További információ: ismert ütközés az iis-megosztott konfigurációval
-Részletes
Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.
-WhatIf
Gyakori paraméter. Ezzel a kapcsolóval tesztelheti és ellenőrizheti a bemeneti paramétereket anélkül, hogy ténylegesen engedélyezve van a figyelés.
Hozam
Példakimenet egy sikeres engedélyezésből
Initiating Disable Process
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-52z'
in :1,237
No element in the source document matches '/configuration/location[@path='']/system.webServer/modules/add[@name='ManagedHttpModuleHelper']'
Not executing RemoveAll (transform line 1, 546)
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'disable'
GAC Module will not be removed, since this operation might cause IIS instabilities
Configuring IIS Environment for codeless attach...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring IIS Environment for instrumentation engine...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring registry for instrumentation engine...
Successfully disabled Application Insights Agent
Installing GAC module 'C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\0.2.0\content\Runtime\Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.dll'
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
Found GAC module Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.ManagedHttpModuleHelper, Microsoft.AppInsights.IIS.ManagedHttpModuleHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-52z_1'
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'enable'
Configuring IIS Environment for codeless attach...
Configuring IIS Environment for instrumentation engine...
Configuring registry for instrumentation engine...
Updating app pool permissions...
Successfully enabled Application Insights Agent
Disable-InstrumentationEngine
Néhány beállításkulcs eltávolításával letiltja a rendszerállapot-motort. Indítsa újra az IIS-t a módosítások érvénybe lépéséhez.
Példák
Disable-InstrumentationEngine
Parameters
-Részletes
Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.
Hozam
Példakimenet a rendszerállapot-motor sikeres letiltásából
Configuring IIS Environment for instrumentation engine...
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]'
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]'
Registry: removing 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]'
Configuring registry for instrumentation engine...
Alkalmazás letiltása Elemzések Monitoring
Letiltja a figyelést a célszámítógépen. Ez a parancsmag eltávolítja az IIS applicationHost.config szerkesztéseit, és eltávolítja a beállításkulcsokat.
Példák
Disable-ApplicationInsightsMonitoring
Parameters
-Részletes
Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.
Hozam
Példakimenet a figyelés sikeres letiltásából
Initiating Disable Process
Applying transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config'
'C:\Windows\System32\inetsrv\config\applicationHost.config' backed up to 'C:\Windows\System32\inetsrv\config\applicationHost.config.backup-2019-03-26_08-59-00z'
in :1,237
No element in the source document matches '/configuration/location[@path='']/system.webServer/modules/add[@name='ManagedHttpModuleHelper']'
Not executing RemoveAll (transform line 1, 546)
Transformation to 'C:\Windows\System32\inetsrv\config\applicationHost.config' was successfully applied. Operation: 'disable'
GAC Module will not be removed, since this operation might cause IIS instabilities
Configuring IIS Environment for codeless attach...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring IIS Environment for instrumentation engine...
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IISADMIN[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC[Environment]
Registry: skipping non-existent 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WAS[Environment]
Configuring registry for instrumentation engine...
Successfully disabled Application Insights Agent
Get-Application Elemzések MonitoringConfig
Lekéri a konfigurációs fájlt, és kinyomtatja az értékeket a konzolon.
Példák
Get-ApplicationInsightsMonitoringConfig
Parameters
Nincs szükség paraméterekre.
Hozam
Példakimenet a konfigurációs fájl olvasásából
RedfieldConfiguration:
Filters:
0)InstrumentationKey: AppFilter: WebAppExclude MachineFilter: .*
1)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2 AppFilter: WebAppTwo MachineFilter: .*
2)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault AppFilter: .* MachineFilter: .*
Get-Application Elemzések MonitoringStatus
Ez a parancsmag hibaelhárítási információkat nyújt az Alkalmazás Elemzések-ügynökkel kapcsolatban. Ezzel a parancsmaggal megvizsgálhatja a PowerShell-modul monitorozási állapotát, verzióját, és megvizsgálhatja a futó folyamatot. Ez a parancsmag a verzióinformációkat és a monitorozáshoz szükséges kulcsfájlok adatait jelenti.
Példák
Példa: Alkalmazás állapota
Futtassa a parancsot Get-ApplicationInsightsMonitoringStatus
a webhelyek monitorozási állapotának megjelenítéséhez.
Get-ApplicationInsightsMonitoringStatus
IIS Websites:
SiteName : Default Web Site
ApplicationPoolName : DefaultAppPool
SiteId : 1
SiteState : Stopped
SiteName : DemoWebApp111
ApplicationPoolName : DemoWebApp111
SiteId : 2
SiteState : Started
ProcessId : not found
SiteName : DemoWebApp222
ApplicationPoolName : DemoWebApp222
SiteId : 3
SiteState : Started
ProcessId : 2024
Instrumented : true
InstrumentationKey : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx123
SiteName : DemoWebApp333
ApplicationPoolName : DemoWebApp333
SiteId : 4
SiteState : Started
ProcessId : 5184
AppAlreadyInstrumented : true
Ebben a példában;
- A gépazonosító egy névtelen azonosító, amellyel egyedileg azonosíthatja a kiszolgálót. Ha támogatási kérelmet hoz létre, szükségünk van erre az azonosítóra a kiszolgáló naplóinak megkereséséhez.
- Az alapértelmezett webhely le van állítva az IIS-ben
- A DemoWebApp111 az IIS-ben indult, de nem kapott kéréseket. Ez a jelentés azt mutatja, hogy nincs futó folyamat (ProcessId: nem található).
- A DemoWebApp222 fut, és figyelve van (Eszköz: igaz). A felhasználói konfiguráció alapján a xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxx123 instrumentációs kulcs megfelelt a webhelynek.
- A DemoWebApp333 manuálisan lett kialakítva az Alkalmazás Elemzések SDK használatával. Az application Elemzések Agent észlelte az SDK-t, és nem figyeli a webhelyet.
Példa: PowerShell-modul adatai
Futtassa a parancsot Get-ApplicationInsightsMonitoringStatus -PowerShellModule
az aktuális modul adatainak megjelenítéséhez:
Get-ApplicationInsightsMonitoringStatus -PowerShellModule
PowerShell Module version:
0.4.0-alpha
Application Insights SDK version:
2.9.0.3872
Executing PowerShell Module Assembly:
Microsoft.ApplicationInsights.Redfield.Configurator.PowerShell, Version=2.8.14.11432, Culture=neutral, PublicKeyToken=31bf3856ad364e35
PowerShell Module Directory:
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\0.2.2\content\PowerShell
Runtime Paths:
ParentDirectory (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content
ConfigurationPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\applicationInsights.ikey.config
ManagedHttpModuleHelperPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.dll
RedfieldIISModulePath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll
InstrumentationEngine86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\MicrosoftInstrumentationEngine_x86.dll
InstrumentationEngine64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\MicrosoftInstrumentationEngine_x64.dll
InstrumentationEngineExtensionHost86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\Microsoft.ApplicationInsights.ExtensionsHost_x86.dll
InstrumentationEngineExtensionHost64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.ExtensionsHost_x64.dll
InstrumentationEngineExtensionConfig86Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation32\Microsoft.InstrumentationEngine.Extensions.config
InstrumentationEngineExtensionConfig64Path (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.InstrumentationEngine.Extensions.config
ApplicationInsightsSdkPath (Exists: True)
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.dll
Példa: Futtatókörnyezet állapota
A rendszerezett számítógépen megvizsgálhatja a folyamatot, és ellenőrizheti, hogy az összes DLL be van-e töltve. Ha a figyelés működik, legalább 12 DLL-t kell betölteni.
Futtassa a Get-ApplicationInsightsMonitoringStatus -InspectProcess
parancsot:
Get-ApplicationInsightsMonitoringStatus -InspectProcess
iisreset.exe /status
Status for IIS Admin Service ( IISADMIN ) : Running
Status for Windows Process Activation Service ( WAS ) : Running
Status for Net.Msmq Listener Adapter ( NetMsmqActivator ) : Running
Status for Net.Pipe Listener Adapter ( NetPipeActivator ) : Running
Status for Net.Tcp Listener Adapter ( NetTcpActivator ) : Running
Status for World Wide Web Publishing Service ( W3SVC ) : Running
handle64.exe -accepteula -p w3wp
BF0: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.ServerTelemetryChannel.dll
C58: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.AzureAppServices.dll
C68: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.DependencyCollector.dll
C78: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.WindowsServer.dll
C98: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.Web.dll
CBC: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.PerfCounterCollector.dll
DB0: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.AI.Agent.Intercept.dll
B98: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll
BB4: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.Contracts.dll
BCC: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.Redfield.Lightup.dll
BE0: File (R-D) C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.dll
listdlls64.exe -accepteula w3wp
0x0000000019ac0000 0x127000 C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\MicrosoftInstrumentationEngine_x64.dll
0x00000000198b0000 0x4f000 C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.ExtensionsHost_x64.dll
0x000000000c460000 0xb2000 C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.Extensions.Base_x64.dll
0x000000000ad60000 0x108000 C:\Windows\TEMP\2.4.0.0.Microsoft.ApplicationInsights.Extensions.Intercept_x64.dll
Parameters
(Nincsenek paraméterek)
Ez a parancsmag alapértelmezés szerint a webalkalmazások figyelési állapotát jelenti. Ezzel a beállítással áttekintheti, hogy az alkalmazás sikeresen lett-e kialakítva. Azt is áttekintheti, hogy melyik rendszerállapot-kulcs lett megfeleltetve a webhelynek.
-PowerShellModule
Választható. Ezzel a kapcsolóval jelentheti a monitorozáshoz szükséges DLL-ek verziószámait és elérési útját. Ezt a lehetőséget akkor használja, ha azonosítania kell bármely DLL verzióját, beleértve az alkalmazás Elemzések SDK-t is.
-InspectProcess
Választható. Ezzel a kapcsolóval jelentheti, hogy az IIS fut-e. Külső eszközöket tölt le annak megállapításához, hogy a szükséges DLL-ek betöltve vannak-e az IIS-futtatókörnyezetbe.
Ha ez a folyamat bármilyen okból meghiúsul, manuálisan futtathatja ezeket a parancsokat:
- iisreset.exe /status
- handle64.exe -p w3wp | findstr /I "InstrumentationEngine AI. Alkalmazás Elemzések"
- listdlls64.exe w3wp | findstr /I "InstrumentationEngine AI-alkalmazás Elemzések"
-Force
Választható. Csak az InspectProcess-hez használható. Ezzel a kapcsolóval kihagyhatja a további eszközök letöltése előtt megjelenő felhasználói kérést.
Set-Application Elemzések MonitoringConfig
A konfigurációs fájl beállítása teljes újratelepítés nélkül. Indítsa újra az IIS-t a módosítások érvénybe lépéséhez.
Fontos
Ez a parancsmag Rendszergazda engedélyekkel rendelkező PowerShell-munkamenetet igényel.
Példák
Példa egyetlen rendszerállapot-kulccsal
Ebben a példában az aktuális számítógépen található összes alkalmazáshoz egyetlen rendszerállapot-kulcs van hozzárendelve.
Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Példa eszközkulcs-térképpel
Ebben a példában:
MachineFilter
a helyettesítő karakterrel egyezik az'.*'
aktuális számítógéppel.AppFilter='WebAppExclude'
rendszerállapotkulcsotnull
biztosít. A megadott alkalmazás nincs kialakítva.AppFilter='WebAppOne'
a megadott alkalmazáshoz egy egyedi rendszerállapot-kulcsot rendel.AppFilter='WebAppTwo'
a megadott alkalmazáshoz egy egyedi rendszerállapot-kulcsot rendel.AppFilter
a helyettesítő karakterrel'.*'
egyezik a még nem egyező webalkalmazásokkal, és hozzárendel egy alapértelmezett rendszerállapotkulcsot.- A rendszer szóközöket ad hozzá az olvashatóság érdekében.
Enable-ApplicationInsightsMonitoring -InstrumentationKeyMap `
` @(@{MachineFilter='.*';AppFilter='WebAppExclude'},
` @{MachineFilter='.*';AppFilter='WebAppOne';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx1'}},
` @{MachineFilter='.*';AppFilter='WebAppTwo';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2'}},
` @{MachineFilter='.*';AppFilter='.*';InstrumentationSettings=@{InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault'}})
Parameters
-InstrumentationKey
Szükséges. Ezzel a paraméterrel egyetlen rendszerállapotkulcsot biztosít a célszámítógépen lévő összes alkalmazás számára.
-InstrumentationKeyMap
Szükséges. Ezzel a paraméterrel több rendszerállapotkulcsot és az egyes alkalmazások által használt rendszerállapot-kulcsokat is leképezheti.
Több számítógéphez is létrehozhat egyetlen telepítési szkriptet a beállítással MachineFilter
.
Fontos
Az alkalmazások a szabályok megadásának sorrendjében egyezik a szabályokkal. Ezért először a legspecifikusabb szabályokat kell megadnia, a leggenerikusabb szabályokat pedig utolsóként.
Schema
@(@{MachineFilter='.*';AppFilter='.*';InstrumentationKey='xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'})
- A MachineFilter a számítógép vagy a virtuális gép nevének kötelező C# regexe.
- '.*' egyezik az összes
- A "ComputerName" csak a megadott névvel rendelkező számítógépekre vonatkozik.
- Az AppFilter a számítógép vagy a virtuális gép nevének kötelező C# regexe.
- '.*' egyezik az összes
- Az "ApplicationName" csak a megadott névvel rendelkező IIS-alkalmazásokkal egyezik meg.
- A InstrumentationKey az előző két szűrőnek megfelelő alkalmazások monitorozásának engedélyezéséhez szükséges.
- Hagyja ezt az értéket null értéken, ha szabályokat szeretne definiálni a figyelés kizárásához.
-Részletes
Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.
Hozam
Alapértelmezés szerint nincs kimenet.
Példa részletes kimenetre a konfigurációs fájl -InstrumentationKey használatával történő beállításából
VERBOSE: Operation: InstallWithIkey
VERBOSE: InstrumentationKeyMap parsed:
Filters:
0)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx AppFilter: .* MachineFilter: .*
VERBOSE: set config file
VERBOSE: Config File Path:
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\applicationInsights.ikey.config
Példa részletes kimenetre a konfigurációs fájl -InstrumentationKeyMap használatával történő beállításából
VERBOSE: Operation: InstallWithIkeyMap
VERBOSE: InstrumentationKeyMap parsed:
Filters:
0)InstrumentationKey: AppFilter: WebAppExclude MachineFilter: .*
1)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx2 AppFilter: WebAppTwo MachineFilter: .*
2)InstrumentationKey: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxdefault AppFilter: .* MachineFilter: .*
VERBOSE: set config file
VERBOSE: Config File Path:
C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\applicationInsights.ikey.config
Start-Application Elemzések MonitoringTrace
Gyűjti az ETW-eseményeket a kód nélküli csatolási futtatókörnyezetből. Ez a parancsmag a PerfView futtatásának alternatíva.
A rendszer összegyűjti az eseményeket, valós időben kinyomtatja a konzolra, és egy ETL-fájlba menti. A perfView-val megnyithatja a kimeneti ETL-fájlt a további vizsgálathoz.
Ez a parancsmag addig fut, amíg el nem éri az időtúllépési időtartamot (alapértelmezett 5 perc), vagy manuálisan leállítja (Ctrl + C
).
Példák
Események gyűjtése
Általában arra kérjük, hogy gyűjtsön eseményeket annak kivizsgálásához, hogy miért nem működik az alkalmazás.
A kód nélküli csatolási futtatókörnyezet ETW-eseményeket bocsát ki az IIS indításakor és az alkalmazás indításakor.
Az alábbi események összegyűjtése:
- Rendszergazdai jogosultságokkal rendelkező parancskonzolon hajtsa végre
iisreset /stop
az IIS és az összes webalkalmazás leállítását. - A parancsmag végrehajtása
- Rendszergazdai jogosultságokkal rendelkező parancskonzolon hajtsa végre
iisreset /start
az IIS elindítását. - Keresse meg az alkalmazást.
- Az alkalmazás betöltése után manuálisan állíthatja le (
Ctrl + C
) vagy megvárhatja az időtúllépést.
Milyen eseményeket kell összegyűjteni?
Az események gyűjtésekor három lehetőség közül választhat:
- A kapcsolóval
-CollectSdkEvents
gyűjtse össze az Alkalmazás Elemzések SDK-ból kibocsátott eseményeket. - A kapcsolóval
-CollectRedfieldEvents
összegyűjtheti az Application Elemzések Agent és a Redfield Runtime által kibocsátott eseményeket. Ezek a naplók hasznosak az IIS és az alkalmazásindítás diagnosztizálásához. - Mindkét kapcsolóval gyűjtse össze mindkét eseménytípust.
- Ha nincs megadva kapcsoló, a rendszer alapértelmezés szerint mindkét eseménytípust összegyűjti.
Parameters
-MaxDurationInMinutes
Opcionális. Ezzel a paraméter használatával beállíthatja, hogy a szkript mennyi ideig gyűjtsön eseményeket. Az alapértelmezett érték 5 perc.
-LogDirectory
Opcionális. Ezzel a kapcsolóval állíthatja be az ETL-fájl kimeneti könyvtárát. Ez a fájl alapértelmezés szerint a PowerShell-modulok könyvtárában jön létre. A teljes elérési út megjelenik a szkript végrehajtása során.
-CollectSdkEvents
Opcionális. Ezzel a kapcsolóval gyűjthet alkalmazás Elemzések SDK-eseményeket.
-CollectRedfieldEvents
Opcionális. Ezzel a kapcsolóval gyűjthet eseményeket az Application Elemzések Agentből és a Redfield-futtatókörnyezetből.
-Részletes
Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.
Hozam
Példa alkalmazásindítási naplókra
Start-ApplicationInsightsMonitoringTrace -CollectRedfieldEvents
Starting...
Log File: C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\logs\20190627_144217_ApplicationInsights_ETW_Trace.etl
Tracing enabled, waiting for events.
Tracing will timeout in 5 minutes. Press CTRL+C to cancel.
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftAppInsights_ManagedHttpModulePath='C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll', MicrosoftAppInsights_ManagedHttpModuleType='Microsoft.ApplicationInsights.RedfieldIISModule.RedfieldIISModule'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftDiagnosticServices_ManagedHttpModulePath2='', MicrosoftDiagnosticServices_ManagedHttpModuleType2=''
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Environment variable 'MicrosoftDiagnosticServices_ManagedHttpModulePath2' or 'MicrosoftDiagnosticServices_ManagedHttpModuleType2' is null, skipping managed dll loading
2:42:31 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace MulticastHttpModule.constructor, success, 70 ms
2:42:31 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace Current assembly 'Microsoft.ApplicationInsights.RedfieldIISModule, Version=2.8.18.27202, Culture=neutral, PublicKeyToken=f23a46de0be5d6f3' location 'C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace Matched filter '.*'~'STATUSMONITORTE', '.*'~'DemoWithSql'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace Lightup assembly calculated path: 'C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.Redfield.Lightup.dll'
2:42:31 PM EVENT: Microsoft-ApplicationInsights-FrameworkLightup Trace Loaded applicationInsights.config from assembly's resource Microsoft.ApplicationInsights.Redfield.Lightup, Version=2.8.18.27202, Culture=neutral, PublicKeyToken=f23a46de0be5d6f3/Microsoft.ApplicationInsights.Redfield.Lightup.ApplicationInsights-recommended.config
2:42:34 PM EVENT: Microsoft-ApplicationInsights-FrameworkLightup Trace Successfully attached ApplicationInsights SDK
2:42:34 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace RedfieldIISModule.LoadLightupAssemblyAndGetLightupHttpModuleClass, success, 2687 ms
2:42:34 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace RedfieldIISModule.CreateAndInitializeApplicationInsightsHttpModules(lightupHttpModuleClass), success
2:42:34 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace ManagedHttpModuleHelper, multicastHttpModule.Init() success, 3288 ms
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftAppInsights_ManagedHttpModulePath='C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll', MicrosoftAppInsights_ManagedHttpModuleType='Microsoft.ApplicationInsights.RedfieldIISModule.RedfieldIISModule'
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Resolved variables to: MicrosoftDiagnosticServices_ManagedHttpModulePath2='', MicrosoftDiagnosticServices_ManagedHttpModuleType2=''
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace Environment variable 'MicrosoftDiagnosticServices_ManagedHttpModulePath2' or 'MicrosoftDiagnosticServices_ManagedHttpModuleType2' is null, skipping managed dll loading
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace MulticastHttpModule.constructor, success, 0 ms
2:42:35 PM EVENT: Microsoft-ApplicationInsights-RedfieldIISModule Trace RedfieldIISModule.CreateAndInitializeApplicationInsightsHttpModules(lightupHttpModuleClass), success
2:42:35 PM EVENT: Microsoft-ApplicationInsights-IIS-ManagedHttpModuleHelper Trace ManagedHttpModuleHelper, multicastHttpModule.Init() success, 0 ms
Timeout Reached. Stopping...
A kibocsátási megjegyzés frissítéseit itt találja.
2.0.0
- Az alkalmazás Elemzések .NET/.NET Core SDK frissítése a következőre:
2.21.0-redfield
2.0.0-béta3
- Az alkalmazás Elemzések .NET/.NET Core SDK frissítése a következőre:
2.20.1-redfield
- Engedélyezett SQL-lekérdezésgyűjtemény
2.0.0-béta2
Az alkalmazás Elemzések .NET/.NET Core SDK frissítése a következőre:2.18.1-redfield
2.0.0-béta1
Hozzáadta a ASP.NET Core autoinstrumentation funkciót
Gyakori kérdések
Ez a szakasz választ ad a gyakori kérdésekre.
Támogatja az alkalmazás Elemzések ügynök a proxytelepítéseket?
Igen. Az alkalmazás Elemzések ügynök letöltésének több módja is van:
- Ha a számítógép rendelkezik internet-hozzáféréssel, paraméterekkel
-Proxy
léphet be a PowerShell-galéria. - A modult manuálisan is letöltheti, és telepítheti a számítógépre, vagy közvetlenül használhatja.
Ezeket a lehetőségeket a részletes utasítások ismertetik.
Támogatja az Application Elemzések Agent ASP.NET Core-alkalmazásokat?
Igen. Az Application Elemzések Agent 2.0.0-s és újabb verzióiban az IIS-ben üzemeltetett ASP.NET Core-alkalmazások támogatottak.
Hogyan ellenőrizze, hogy az engedélyezés sikeres volt-e?
A Get-Application Elemzések MonitoringStatus parancsmaggal ellenőrizheti, hogy az engedélyezés sikeres volt-e.
Az élő metrikák használatával gyorsan megállapíthatja, hogy az alkalmazás telemetriát küld-e.
A Log Analytics használatával listázhatja az összes jelenleg telemetriát küldő felhőszerepkört:
union * | summarize count() by cloud_RoleName, cloud_RoleInstance
Hogyan elérni a proxyátadást?
A proxyátengedés eléréséhez konfiguráljon egy gépszintű proxyt vagy egy alkalmazásszintű proxyt. Lásd: DefaultProxy.
Web.config példa:
<system.net>
<defaultProxy>
<proxy proxyaddress="http://xx.xx.xx.xx:yyyy" bypassonlocal="true"/>
</defaultProxy>
</system.net>
Hibaelhárítás
Tekintse meg a dedikált hibaelhárítási cikket.
Az alkalmazásgazda és a betöltési szolgáltatás közötti kapcsolat tesztelése
Az alkalmazás Elemzések SDK-k és ügynökök telemetriát küldenek, hogy REST-hívásként betöltse a betöltési végpontokat. A webkiszolgálóról vagy az alkalmazásgazdagépről a betöltési szolgáltatás végpontjaihoz való kapcsolódást a PowerShellből vagy curl parancsokból származó nyers REST-ügyfelek használatával tesztelheti. Tekintse meg az Azure Monitor-alkalmazás Elemzések hiányzó alkalmazástelemetria hibaelhárítását.
További lépések
A telemetriai adatok megtekintése:
- A teljesítmény és a használat monitorozásához megismerheti a metrikákat .
- Események és naplók keresése a problémák diagnosztizálásához.
- A Log Analytics használata speciálisabb lekérdezésekhez.
- Irányítópultok létrehozása.
További telemetriai funkciók hozzáadása:
- Rendelkezésre állás áttekintése
- Webes ügyfél telemetria hozzáadása a weblapkód kivételeinek megtekintéséhez és a nyomkövetési hívások engedélyezéséhez.
- Adja hozzá az alkalmazás Elemzések SDK-t a kódhoz, hogy nyomkövetési és naplóhívásokat szúrjon be.
További műveletek az Alkalmazás Elemzések-ügynökkel: