Az Azure Monitor Application Insights-ügynök üzembe helyezése helyszíni kiszolgálókhoz

Az Application Insights 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.

Feljegyzé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 instrumentálása SDK-val.

Feljegyzés

Az ügyféloldali monitorozás alapértelmezés szerint engedélyezve van ASP.NET Core-alkalmazások esetében. Ha le szeretné tiltani az ügyféloldali monitorozást, definiáljon egy környezeti változót a kiszolgálón az alábbi információkkal:

• Név:APPINSIGHTS_JAVASCRIPT_ENABLED
• Érték:false

PowerShell-galéria

Az Application Insights Agent a PowerShell-galériában 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.

Bevezetés

Ez a lap azokat a gyorsindítási 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ére a PowerShell Galériától függenek. 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.

Töltse le és telepítse a PowerShell Galérián keresztül.

A letöltéshez és a telepítéshez használja a PowerShell Gallery.

Telepítési előfeltételek

A figyelés engedélyezéséhez rendelkeznie kell egy kapcsolati karakterlánccal. Az Application Insights-erőforrás Áttekintés paneljén megjelenik egy összekapcsolási karakterlánc. További információ: Kapcsolati láncok.

Feljegyzés

2020 áprilisától a PowerShell Gallery nem támogatja a TLS 1.1 és 1.0 verziókat.

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.

Az Application Insights-ügynök telepítése

Futtassa a PowerShellt rendszergazdaként.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense

Feljegyzés

A AllowPrerelease kapcsoló a Install-Module parancsmagban 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 Application Insights-ügynök kibontása é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/'

Részletes utasítások

Ez a lap leírja, hogyan lehet csatlakozni a PowerShell-galériához é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 megadunk arra az esetre, ha nem rendelkezik internet-hozzáféréssel.

Kapcsolat karakterlánc lekérése

Első lépésként szüksége lesz egy kapcsolati sztring. További információ: Kapcsolati láncok.

Feljegyzé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. Új képességek kihasználásához történő váltás kapcsolati karakterláncokra.

A PowerShell futtatása rendszergazdaként emelt szintű végrehajtási szabályzattal

Futtatás rendszergazdaként

A PowerShellnek rendszergazdai 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. Megkerüli a megerősítési felszólítást.

Példahibák

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 ellenőrizheti 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.

Feljegyzé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.

1. Futtassa rendszergazdaként a PowerShellt emelt szintű végrehajtási szabályzattal.

2. 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. Megkerüli a megerősítési felszólítá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"):
   

3. Konfigurálja a PowerShell Gallery-t megbízható forráské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 megerősítheti és minden PSRepositories elemet ellenőrizhet a Get-PSRepository parancs futtatásával.

4. Telepítse a PowerShellGet legújabb verzióját.

   • Leírás: Ez a modul tartalmazza az eszközöket, amelyeket más modulok PowerShell Galériából történő lekéréséhez használnak. 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: PowerShellGet telepítése.
   • Parancs: Install-Module -Name PowerShellGet.
   • Választható paraméterek:
     • -Proxy. Proxykiszolgálót ad meg a kéréshez.
     • -Force. Átugorja 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
   

5. 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 a PowerShell Gallery-ből.

1. Győződjön meg arról, hogy a PowerShell-galéria minden előfeltétele teljesül.
2. Futtassa rendszergazdaként a PowerShellt emelt szintű végrehajtási szabályzattal.
3. 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. Kihagyja a "Licenc elfogadása" promptot
     • -Force. Kikerüli 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

1. Lépjen a következőre: https://www.powershellgallery.com/packages/Az.ApplicationMonitor.
2. Válassza ki a fájl legújabb verzióját a Verzióelőzmények táblában.
3. 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 könyvtárba, hogy a PowerShell-munkamenetek megtalálhassá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.

• Parancs:

  $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.

• Parancs:

  $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 könyvtárba, hogy a PowerShell-munkamenetek megtalálhassá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.

1. 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.
2. Keresse meg az Az.ApplicationMonitor.psd1 fájl elérési útját.
3. Futtassa rendszergazdaként a PowerShellt emelt szintű végrehajtási szabályzattal.
4. 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 Application Insights 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óért lásd: Hogyan lehetséges a proxy-átengedés?.

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.

API-referencia

Ez a lap a következő parancsmagokat ismerteti, amelyek az Az.ApplicationMonitor PowerShell-modul tagjai:

• Enable-InstrumentationEngine
• Alkalmazásbetekintések-figyelés engedélyezése
• Disable-InstrumentationEngine
• Az-ApplicationInsightsMonitorozás-Kikapcsolása
• Get-ApplicationInsightsMonitoringConfig
• Get-ApplicationInsightsMonitoringStatus
• Set-ApplicationInsightsMonitoringConfig - alkalmazásfigyelési konfiguráció beállítása
• Start-ApplicationInsightsMonitoringTrace

Feljegyzé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.

Feljegyzé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. Új képességek kihasználásához történő váltás kapcsolati karakterláncokra.

Fontos

Ehhez a parancsmaghoz rendszergazdai engedélyekkel rendelkező PowerShell-munkamenetre és emelt szintű végrehajtási szabályzatra 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.
• Az instrumentációs motor többletterhelést okoz, és alapértelmezés szerint ki van kapcsolva.

Engedélyezze az InstrumentationEngine-t

Néhány beállításkulcs beállításával engedélyezi az instrumentációs motort. Indítsa újra az IIS-t a módosítások érvénybe lépéséhez.

A műszerfal-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 az instrumentációs motort, ha:

• Már engedélyezte a figyelést a Enable parancsmaggal, de nem engedélyezte az instrumentációs motort.
• Manuálisan instrumentálta az alkalmazását a .NET SDK-kkal, hogy további telemetriát gyűjtsön.

Példák

Enable-InstrumentationEngine

Paraméterek

-Elfogadja a Licencet

Opcionális. Ezzel a kapcsolóval elfogadhatja a licenc- és adatvédelmi nyilatkozatot a fej nélküli telepítésekben.

-Bőbeszédű

Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.

Kimenet

A műszerezési motor sikeres engedélyezésének példakimenete

Configuring IIS Environment for instrumentation engine...
Configuring registry for instrumentation engine...

AlkalmazásElemzések-figyelésének engedélyezése

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 instrumentációs kulcsot, melyet minden alkalmazás használ. Az IIS indításkor betölti a RedfieldModule-t, amely az alkalmazások indításakor az Application Insights 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 karakterláncra

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 instrumentációs 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:

• A(z) MachineFilter a '.*' helyettesítő karakter használatával egyezik az aktuális számítógéppel.
• AppFilter='WebAppExclude' egy null műszerkulcsot biztosít. A megadott alkalmazás nincs elemezhetővé téve.
• AppFilter='WebAppOne' meghatározott alkalmazáshoz egy egyedi instrumentációs kulcsot rendel.
• AppFilter='WebAppTwo' meghatározott alkalmazáshoz egy egyedi instrumentációs kulcsot rendel.
• AppFilter a '.*' helyettesítő karaktert használja, hogy egyezzen minden olyan webalkalmazással, amellyel még nem egyezik, és hozzárendel egy alapértelmezett instrumentációs kulcsot.
• 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'}})

Feljegyzé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>'}})

Paraméterek

-ConnectionString

Szükséges. Ezzel a paraméterrel egyetlen kapcsolati karakterláncot adhatsz meg 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.

-Műszerkulcs Térkép

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 illeszkednek a szabályokhoz. Ezért először a legspecifikusabb szabályokat kell megadnia, a leggenerikusabb szabályokat pedig utolsóként.

Séma

@(@{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.
  • '.*' mintázat mindenre illeszkedik
  • 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.
  • '.*' mintázat mindenre illeszkedik
  • 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.

-EngedélyezzeAzInstrumentációsMotort

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.

Az instrumentációs motor többletterhelést okoz, és alapértelmezés szerint ki van kapcsolva.

-Elfogadja a Licencet

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

-Bőbeszédű

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.

Kimenet

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

Az instrumentációs motort néhány beállításkulcs eltávolításával letiltja. Indítsa újra az IIS-t a módosítások érvénybe lépéséhez.

Példák

Disable-InstrumentationEngine

Paraméterek

-Bőbeszédű

Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.

Kimenet

Példakimenet az instrumentációs 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ásInsightsFigyelésKikapcsolása

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

Paraméterek

-Bőbeszédű

Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.

Kimenet

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-ApplicationInsightsMonitoringConfig

Lekéri a konfigurációs fájlt, és kinyomtatja az értékeket a konzolon.

Példák

Get-ApplicationInsightsMonitoringConfig

Paraméterek

Nincs szükség paraméterekre.

Kimenet

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-ApplicationInsightsMonitoringStatus

Ez a parancsmag hibaelhárítási információkat nyújt az Application Insights-ü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 Application Insights SDK használatával. Az Application Insights-ügynök észlelte az SDK-t, és nem figyeli a webhelyet.

• A jelenlét AppAlreadyInstrumented : true azt jelzi, hogy az Application Insights-ügynök egy ütköző dll-t azonosított a webalkalmazásban, feltételezve, hogy a webalkalmazás manuálisan van kialakítva, és az ügynök biztonsági mentést végzett, és nem támogatja ezt a folyamatot.

• Instrumented : true azt jelzi, hogy az Application Insights-ügynök sikeresen elvégezte a megadott w3wp.exe folyamatban futó webalkalmazást.

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

Paraméterek

(Nincsenek paraméterek)

Ez a parancsmag alapértelmezés szerint a webalkalmazások figyelési állapotát jelenti. Ezzel az opciónál ellenőrizheti, hogy az alkalmazás sikeresen lett-e instrumentálva. Azt is áttekintheti, hogy melyik instrumentációs kulcs lett a webhelyéhez megfeleltetve.

-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 Application Insights 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 /állapot
• handle64.exe -p w3wp | findstr /I "InstrumentationEngine AI." ApplicationInsights"
• listdlls64.exe w3wp | findstr /I "InstrumentationEngine AI ApplicationInsights"

-Erő

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-ApplicationInsightsMonitoringConfig

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

Ehhez a parancsmaghoz rendszergazdai engedélyekkel rendelkező PowerShell-munkamenet szükséges.

Példák

Példa egyetlen instrumentációs 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:

• A(z) MachineFilter a '.*' helyettesítő karakter használatával egyezik az aktuális számítógéppel.
• AppFilter='WebAppExclude' egy null műszerkulcsot biztosít. A megadott alkalmazás nincs elemezhetővé téve.
• AppFilter='WebAppOne' meghatározott alkalmazáshoz egy egyedi instrumentációs kulcsot rendel.
• AppFilter='WebAppTwo' meghatározott alkalmazáshoz egy egyedi instrumentációs kulcsot rendel.
• AppFilter a '.*' változó karakterrel egyezik a még nem egyező webalkalmazásokkal, és hozzárendel egy alapértelmezett instrumentációs kulcsot.
• 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'}})

Paraméterek

-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.

-Műszerkulcs Térkép

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 illeszkednek a szabályokhoz. Ezért először a legspecifikusabb szabályokat kell megadnia, a leggenerikusabb szabályokat pedig utolsóként.

Séma

@(@{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.
  • '.*' mintázat mindenre illeszkedik
  • 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.
  • '.*' mintázat mindenre illeszkedik
  • 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.

-Bőbeszédű

Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.

Kimenet

Alapértelmezés szerint nincs kimenet.

Példa részletes kimenetre a konfigurációs fájl beállítására az -InstrumentationKey opcióval.

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

A -InstrumentationKeyMap használatával történő konfigurációs fájl beállításának részletes példája

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-ApplicationInsightsMonitoringTrace

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:

1. Rendszergazdai jogosultságokkal rendelkező parancskonzolon hajtsa végre iisreset /stop az IIS és az összes webalkalmazás leállítását.
2. A parancsmag végrehajtása
3. Rendszergazdai jogosultságokkal rendelkező parancskonzolon hajtsa végre iisreset /start az IIS elindítását.
4. Próbáljon meg navigálni az alkalmazásához.
5. Az alkalmazás betöltése után manuálisan állíthatja le (Ctrl + C) vagy megvárhatja, amíg lejár az idő.

Milyen eseményeket kell összegyűjteni?

Az események gyűjtésekor három lehetőség közül választhat:

1. A kapcsolóval -CollectSdkEvents gyűjtse össze az Application Insights SDK-ból kibocsátott eseményeket.
2. A kapcsolóval -CollectRedfieldEvents összegyűjtheti az Application Insights-ügynök é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.
3. Mindkét kapcsolóval gyűjtse össze mindkét eseménytípust.
4. Ha nincs megadva kapcsoló, a rendszer alapértelmezés szerint mindkét eseménytípust összegyűjti.

Paraméterek

-MaxIdőtartamPercekben

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 Application Insights SDK-eseményeket.

-RedfieldEseményekGyűjtése

Opcionális. Ezzel a kapcsolóval gyűjthet eseményeket az Application Insights-ügynökből és a Redfield-futtatókörnyezetből.

-Bőbeszédű

Gyakori paraméter. Ezzel a kapcsolóval részletes naplókat jeleníthet meg.

Kimenet

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...

Kiadási megjegyzések

A kibocsátási megjegyzés frissítéseit itt találja.

2.0.0

• Frissítette az Application Insights .NET/.NET Core SDK-t a következőre: 2.21.0-redfield

2.0.0-béta3

• Frissítette az Application Insights .NET/.NET Core SDK-t a következőre: 2.20.1-redfield
• Engedélyezett SQL-lekérdezésgyűjtemény

2.0.0-béta2

Frissítette az Application Insights .NET/.NET Core SDK-t a következőre: 2.18.1-redfield

2.0.0-béta1

Hozzáadta a ASP.NET Core autoinstrumentation funkciót

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 Application Insights SDK-k és ügynökök telemetriát küldenek, amely REST-hívásként kerül feldolgozásra a betöltési végpontokhoz. 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 a hiányzó alkalmazástelemetria hibaelhárítását az Azure Monitor Application Insightsban.

Következő lépések

Tekintse át a gyakori kérdéseket (GYIK):

• Application Insights-ügynök üzembe helyezése helyszíni kiszolgálókhoz – gyakori kérdé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 Application Insights SDK-t a kódhoz , hogy nyomkövetési és naplóhívásokat szúrjon be.

További műveletek az Application Insights-ügynökkel:

• Az Application Insights-ügynök hibaelhárítása .