Distribuera Azure Monitor Application Insights-agenten för lokala servrar

Den här fliken innehåller de snabbstartskommandon som förväntas fungera för de flesta miljöer. Instruktionerna beror på PowerShell-galleriet för att distribuera uppdateringar. Dessa kommandon stöder PowerShell-parametern -Proxy .

En förklaring av dessa kommandon, anpassningsinstruktioner och information om felsökning finns i de detaljerade instruktionerna.

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Ladda ned och installera via PowerShell-galleriet

Använd PowerShell-galleriet för nedladdning och installation.

Krav för installation

Om du vill aktivera övervakning måste du ha en anslutningssträng. En anslutningssträng visas i fönstret Översikt för din Application Insights-resurs. Mer information finns i Anslutningssträngar.

Kör PowerShell som administratör.

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

Stäng PowerShell.

Installera Application Insights-agenten

Kör PowerShell som administratör.

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

Aktivera övervakning

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Ladda ned och installera manuellt (offlinealternativ)

Du kan också ladda ned och installera manuellt.

Ladda ned modulen

Ladda ned den senaste versionen av modulen manuellt från PowerShell-galleriet.

Packa upp och installera Application Insights-agenten

$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

Aktivera övervakning

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

På den här fliken beskrivs hur du registrerar till PowerShell-galleriet och laddar ned ApplicationMonitor-modulen. Inkluderade är de vanligaste parametrarna som du behöver för att komma igång. Vi tillhandahåller även manuella nedladdningsinstruktioner om du inte har internetåtkomst.

Skaffa en anslutningssträng

För att komma igång behöver du en anslutningssträng. Mer information finns i Anslutningssträngar.

Kör PowerShell som administratör med en upphöjd körningsprincip

Kör som administratör

PowerShell behöver behörigheter på administratörsnivå för att göra ändringar på datorn.

Körningspolicy

• Beskrivning: Som standard är PowerShell-skript som körs inaktiverade. Vi rekommenderar att du endast tillåter RemoteSigned-skript för aktuellt omfång.
• Referens: Om körningsprinciper och Set-ExecutionPolicy.
• Kommando: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process.
• Valfri parameter:
  • -Force. Kringgår bekräftelseprompten.

Exempelfel

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.

Förutsättningar för PowerShell

Granska din instans av PowerShell genom att $PSVersionTable köra kommandot . Det här kommandot genererar följande utdata:

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

Dessa instruktioner har skrivits och testats på en dator som kör Windows 10 och följande versioner.

Förutsättningar för PowerShell-galleriet

De här stegen förbereder servern för att ladda ned moduler från PowerShell-galleriet.

1. Kör PowerShell som administratör med en upphöjd körningsprincip.

2. Installera NuGet-paketprovidern.

   • Beskrivning: Du behöver den här providern för att interagera med NuGet-baserade lagringsplatser som PowerShell-galleriet.
   • Referens: Install-PackageProvider.
   • Kommando: Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201.
   • Valfria parametrar:
     • -Proxy. Anger en proxyserver för begäran.
     • -Force. Kringgår bekräftelseprompten.

   Du får den här uppmaningen om NuGet inte har konfigurerats:

   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. Konfigurera PowerShell-galleriet som en betrodd lagringsplats.

   • Beskrivning: Som standard är PowerShell-galleriet en obetrodd lagringsplats.
   • Referens: Set-PSRepository.
   • Kommando: Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted.
   • Valfri parameter:
     • -Proxy. Anger en proxyserver för begäran.

   Du får den här uppmaningen om PowerShell-galleriet inte är betrodd:

   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"):
   

   Du kan bekräfta den här ändringen och granska alla PSRepositories genom att Get-PSRepository köra kommandot .

4. Installera den senaste versionen av PowerShellGet.

   • Beskrivning: Den här modulen innehåller de verktyg som används för att hämta andra moduler från PowerShell-galleriet. Version 1.0.0.1 levereras med Windows 10 och Windows Server. Version 1.6.0 eller senare krävs. Kör kommandot för Get-Command -Module PowerShellGet att avgöra vilken version som är installerad.
   • Referens: Installera PowerShellGet.
   • Kommando: Install-Module -Name PowerShellGet.
   • Valfria parametrar:
     • -Proxy. Anger en proxyserver för begäran.
     • -Force. Kringgår varningen "redan installerad" och installerar den senaste versionen.

   Du får det här felet om du inte använder den senaste versionen av PowerShellGet:

   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. Starta om PowerShell. Du kan inte läsa in den nya versionen i den aktuella sessionen. Nya PowerShell-sessioner läser in den senaste versionen av PowerShellGet.

Ladda ned och installera modulen via PowerShell-galleriet

De här stegen hämtar modulen Az.ApplicationMonitor från PowerShell-galleriet.

1. Se till att alla krav för PowerShell-galleriet uppfylls.
2. Kör PowerShell som administratör med en upphöjd körningsprincip.
3. Installera modulen Az.ApplicationMonitor.
   • Referens: Install-Module.
   • Kommando: Install-Module -Name Az.ApplicationMonitor.
   • Valfria parametrar:
     • -Proxy. Anger en proxyserver för begäran.
     • -AllowPrerelease. Tillåter installation av alfa- och betaversioner.
     • -AcceptLicense. Kringgår uppmaningen "Acceptera licens"
     • -Force. Kringgår varningen "Ej betrodd lagringsplats".

Ladda ned och installera modulen manuellt (offlinealternativ)

Om du av någon anledning inte kan ansluta till PowerShell-modulen kan du ladda ned och installera Az.ApplicationMonitor-modulen manuellt.

Ladda ned den senaste nupkg-filen manuellt

1. Gå till https://www.powershellgallery.com/packages/Az.ApplicationMonitor.
2. Välj den senaste versionen av filen i tabellen Versionshistorik .
3. Under Installationsalternativ väljer du Manuell nedladdning.

Alternativ 1: Installera i en PowerShell-modulkatalog

Installera den manuellt nedladdade PowerShell-modulen i en PowerShell-katalog så att den kan identifieras av PowerShell-sessioner. Mer information finns i Installera en PowerShell-modul.

Packa upp nupkg som en zip-fil med hjälp av Expand-Archive (v1.0.1.0)

• Beskrivning: Basversionen av Microsoft.PowerShell.Archive (v1.0.1.0) kan inte packa upp nupkg-filer. Byt namn på filen med tillägget .zip.

• Referens: Expandera arkiv.

• Kommando:

  $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
  

Packa upp nupkg med hjälp av Expand-Archive (v1.1.0.0)

• Beskrivning: Använd en aktuell version av Expand-Archive för att packa upp nupkg-filer utan att ändra tillägget.

• Referens: Expand-Archive och Microsoft.PowerShell.Archive.

• Kommando:

  $pathToNupkg = "C:\az.applicationmonitor.0.2.1-alpha.nupkg"
  $pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\az.applicationmonitor"
  Expand-Archive -LiteralPath $pathToNupkg -DestinationPath $pathInstalledModule
  

Alternativ 2: Packa upp och importera nupkg manuellt

Installera den manuellt nedladdade PowerShell-modulen i en PowerShell-katalog så att den kan identifieras av PowerShell-sessioner. Mer information finns i Installera en PowerShell-modul.

Om du installerar modulen i någon annan katalog importerar du modulen manuellt med hjälp av Import-Module.

1. Ändra tillägget till ".zip" och extrahera innehållet i paketet till den avsedda installationskatalogen.
2. Leta reda på filsökvägen till Az.ApplicationMonitor.psd1.
3. Kör PowerShell som administratör med en upphöjd körningsprincip.
4. Läs in modulen med hjälp Import-Module Az.ApplicationMonitor.psd1 av kommandot .

Dirigera trafik via en proxy

När du övervakar en dator i ditt privata intranät måste du dirigera HTTP-trafik via en proxyserver.

PowerShell-kommandona för att ladda ned och installera Az.ApplicationMonitor från PowerShell-galleriet stöder en -Proxy parameter. Läs anvisningarna ovan när du skriver installationsskripten.

Application Insights SDK måste skicka appens telemetri till Microsoft. Vi rekommenderar att du konfigurerar proxyinställningar för din app i web.config-filen. Mer information finns i Hur gör jag för att uppnå proxygenomströmning?.

Aktivera övervakning

Enable-ApplicationInsightsMonitoring Använd kommandot för att aktivera övervakning.

Se API-referensen för en detaljerad beskrivning av hur du använder den här cmdleten.

På den här fliken beskrivs följande cmdletar, som är medlemmar i Az.ApplicationMonitor PowerShell-modulen:

• Enable-InstrumentationEngine
• Aktivera-ApplicationInsightsÖvervakning
• Inaktivera-InstrumentationEngine
• Inaktivera-ApplicationInsightsÖvervakning
• Get-ApplicationInsightsMonitoringConfig
• Get-ApplicationInsightsMonitoringStatus
• Set-ApplicationInsightsMonitoringConfig
• Start-ApplicationInsightsMonitoringTrace

Enable-InstrumentationEngine

Aktiverar instrumentationsmotorn genom att ange vissa registernycklar. Starta om IIS för att ändringarna ska börja gälla.

Instrumentationsmotorn kan komplettera data som samlas in av .NET Software Development Kits (SDK:er). Den samlar in händelser och meddelanden som beskriver körningen av en hanterad process. Dessa händelser och meddelanden omfattar resultatkoder för beroenden, HTTP-verb och SQL-kommandotext.

Aktivera instrumentationsmotorn om:

• Du har redan aktiverat övervakning med cmdleten Enable men inte aktiverat instrumentationsmotorn.
• Du instrumenterade appen manuellt med .NET SDK:er och vill samla in extra telemetri.

Exempel

Enable-InstrumentationEngine

Parametrar

-AccepteraLicens

Valfritt. Använd den här växeln för att acceptera licensen och sekretesspolicyn i huvudlösa installationer.

-Mångordig

Gemensam parameter. Använd den här växeln för att mata ut detaljerade loggar.

Utgång

Exempel på utdata från aktivering av instrumentationsmotorn

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

Enable-ApplicationInsightsMonitoring

Aktiverar kodlös övervakning av IIS-appar på en måldator.

Den här cmdleten ändrar IIS-programmetHost.config och anger vissa registernycklar. Den skapar en applicationinsights.ikey.config-fil som definierar instrumentationsnyckeln som används av varje app. IIS läser in RedfieldModule vid start, vilket matar in Application Insights SDK i program när programmen startas. Starta om IIS för att ändringarna ska börja gälla.

När du har aktiverat övervakning rekommenderar vi att du använder Live Metrics för att snabbt kontrollera om din app skickar telemetri till oss.

Exempel

Exempel med en enda anslutningssträng

I det här exemplet får alla appar på den aktuella datorn en enda anslutningssträng.

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

Exempel med en enda instrumentationsnyckel

I det här exemplet får alla appar på den aktuella datorn en enda instrumentationsnyckel.

Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Exempel med en instrumenteringsnyckelkarta

I det här exemplet:

• MachineFilter matchar den aktuella datorn med hjälp '.*' av jokertecknet.
• AppFilter='WebAppExclude' tillhandahåller en null instrumentationsnyckel. Den angivna appen är inte instrumenterad.
• AppFilter='WebAppOne' tilldelar den angivna appen en unik instrumentationsnyckel.
• AppFilter='WebAppTwo' tilldelar den angivna appen en unik instrumentationsnyckel.
• AppFilter använder jokertecknet '.*' för att matcha alla webbappar som inte redan matchar och tilldelar en standardinstrumentationsnyckel.
• Blanksteg läggs till för läsbarhet.

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

• MachineFilter är en obligatorisk C#-regex av datorns eller den virtuella datorns (VM) namn.
  • '.*' matchar alla
  • "ComputerName" matchar endast datorer med det exakta namnet som angetts.
• AppFilter är en obligatorisk C#-regex av IIS-webbplatsnamnet. Du kan hämta en lista över platser på servern genom att köra kommandot get-iissite.
  • '.*' matchar alla
  • "SiteName" matchar endast IIS-webbplatsen med det exakta namnet som angetts.
• InstrumentationKey krävs för att aktivera övervakning av appar som matchar de föregående två filtren.
  • Lämna värdet null om du vill definiera regler för att undanta övervakning.

-EnableInstrumentationEngine

Valfritt. Använd den här växeln för att göra det möjligt för instrumentationsmotorn att samla in händelser och meddelanden om vad som händer under körningen av en hanterad process. Dessa händelser och meddelanden omfattar resultatkoder för beroenden, HTTP-verb och SQL-kommandotext.

Instrumentationsmotorn lägger till omkostnader och är avstängd som standard.

-AccepteraLicens

Valfritt. Använd den här växeln för att acceptera licensen och sekretesspolicyn i huvudlösa installationer.

-IgnoreSharedConfig

När du har ett kluster med webbservrar kanske du använder en delad konfiguration. Det går inte att mata in HttpModule i den här delade konfigurationen. Det här skriptet misslyckas med meddelandet att extra installationssteg krävs. Använd den här växeln om du vill ignorera den här kontrollen och fortsätta att installera krav. Mer information finns i kända konflikt-med-iis-shared-configuration

-Mångordig

Gemensam parameter. Använd den här växeln om du vill visa detaljerade loggar.

-WhatIf

Gemensam parameter. Använd den här växeln för att testa och verifiera dina indataparametrar utan att aktivera övervakning.

Utgång

Exempel på utdata från en lyckad aktivering

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

Inaktiverar instrumentationsmotorn genom att ta bort vissa registernycklar. Starta om IIS för att ändringarna ska börja gälla.

Exempel

Disable-InstrumentationEngine

Parametrar

-Mångordig

Gemensam parameter. Använd den här växeln för att mata ut detaljerade loggar.

Utgång

Exempel på utdata från att instrumentationsmotorn har inaktiverats

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

Disable-ApplicationInsightsMonitoring

Inaktiverar övervakning på måldatorn. Den här cmdleten tar bort ändringar i IIS-programmetHost.config och tar bort registernycklar.

Exempel

Disable-ApplicationInsightsMonitoring

Parametrar

-Mångordig

Gemensam parameter. Använd den här växeln om du vill visa detaljerade loggar.

Utgång

Exempel på utdata från att inaktivera övervakning

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

Hämtar konfigurationsfilen och skriver ut värdena till konsolen.

Exempel

Get-ApplicationInsightsMonitoringConfig

Parametrar

Inga parametrar krävs.

Utgång

Exempel på utdata från läsning av konfigurationsfilen

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

Den här cmdleten innehåller felsökningsinformation om Application Insights Agent. Använd den här cmdleten för att undersöka övervakningsstatus, version av PowerShell-modulen och för att inspektera körningsprocessen. Den här cmdleten rapporterar versionsinformation och information om viktiga filer som krävs för övervakning.

Exempel

Exempel: Programstatus

Kör kommandot Get-ApplicationInsightsMonitoringStatus för att visa övervakningsstatusen för webbplatser.

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

I det här exemplet:

• Datoridentifierare är ett anonymt ID som används för att unikt identifiera servern. Om du skapar en supportbegäran behöver vi det här ID:t för att hitta loggar för servern.

• Standardwebbplatsen stoppas i IIS

• IIS visar DemoWebApp111 som startat, men appen tar inte emot några begäranden. Rapporten visar ingen process som körs (ProcessId: hittades inte).

• DemoWebApp222 körs och övervakas (Instrumented: true). Instrumentationsnyckeln xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx123 matchades för den här webbplatsen baserat på användarkonfigurationen.

• DemoWebApp333 instrumenteras manuellt med Application Insights SDK. Application Insights-agenten identifierar SDK:t och övervakar inte den här webbplatsen.

• Förekomsten av AppAlreadyInstrumented : true betyder att Application Insights-agenten identifierade en dll som är i konflikt som lästs in i webbprogrammet, förutsätter att webbappen är manuellt instrumenterad och att agenten har säkerhetskopierat och inte instrumenterar den här processen.

• Instrumented : true anger att Application Insights-agenten har instrumenterat webbappen som körs i den angivna w3wp.exe processen.

Exempel: Information om PowerShell-modulen

Kör kommandot Get-ApplicationInsightsMonitoringStatus -PowerShellModule för att visa information om den aktuella modulen:

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

Exempel: Körningsstatus

Du kan kontrollera processen på den instrumenterade datorn för att se om alla DLL:er har lästs in. Om övervakningen fungerar bör minst 12 DLL:er läsas in.

Kör kommandot Get-ApplicationInsightsMonitoringStatus -InspectProcess:

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

Parametrar

(Inga parametrar)

Som standard rapporterar den här cmdleten övervakningsstatus för webbprogram. Använd det här alternativet om du vill granska om programmet har instrumenterats. Du kan också granska vilken instrumenteringsnyckel som matchades med din webbplats.

-PowerShellModule

Valfritt. Använd den här växeln för att rapportera versionsnummer och sökvägar för DLL:er som krävs för övervakning. Använd det här alternativet om du behöver identifiera versionen av en DLL, inklusive Application Insights SDK.

-InspectProcess

Valfritt. Använd den här växeln för att rapportera om IIS körs. Den laddar ned externa verktyg för att avgöra om nödvändiga DLL:er läses in i IIS-körningen.

Om den här processen misslyckas av någon anledning kan du köra dessa kommandon manuellt:

• iisreset.exe /status
• [handle64.exe](/sysinternals/downloads/handle) -p w3wp | findstr /I "InstrumentationEngine AI. ApplicationInsights"
• [listdlls64.exe](/sysinternals/downloads/listdlls) w3wp | findstr /I "InstrumentationEngine AI ApplicationInsights"

-Kraft

Valfritt. Används endast med InspectProcess. Använd den här växeln om du vill hoppa över användarprompten som visas innan fler verktyg laddas ned.

Set-ApplicationInsightsMonitoringConfig

Anger konfigurationsfilen utan att göra en fullständig ominstallation. Starta om IIS för att ändringarna ska börja gälla.

Exempel

Exempel med en enda instrumentationsnyckel

I det här exemplet får alla appar på den aktuella datorn en enda instrumentationsnyckel.

Enable-ApplicationInsightsMonitoring -InstrumentationKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Exempel med en instrumenteringsnyckelkarta

I det här exemplet:

• MachineFilter matchar den aktuella datorn med hjälp '.*' av jokertecknet.
• AppFilter='WebAppExclude' tillhandahåller en null instrumentationsnyckel. Den angivna appen är inte instrumenterad.
• AppFilter='WebAppOne' tilldelar den angivna appen en unik instrumentationsnyckel.
• AppFilter='WebAppTwo' tilldelar den angivna appen en unik instrumentationsnyckel.
• AppFilter '.*' använder jokertecknet för att matcha webbappar som inte redan matchar och tilldelar en standardinstrumentationsnyckel.
• Blanksteg läggs till för läsbarhet.

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

Parametrar

-InstrumentationKey

Obligatoriskt. Använd den här parametern för att ange en enda instrumentationsnyckel för användning av alla appar på måldatorn.

-InstrumenteringsNyckelKarta

Obligatoriskt. Använd den här parametern för att ange flera instrumentationsnycklar och en mappning av instrumentationsnycklarna som används av varje app. Du kan skapa ett enda installationsskript för flera datorer genom att ange MachineFilter.

Så här fungerar matchning

• Kartan definierar en ordnad lista med regler med namnet filters. Den första matchande regeln börjar gälla. Placera specifika regler först och avsluta med en catch-all-regel.
• Varje regel kan tilldela en annan Application Insights-resurs till matchande appar. Föredra anslutningssträngar i scenarier som stöds eftersom instrumentationsnycklar är förlegade.

Tillgängliga filter

• MachineFilter eller machineFilter: C#-reguljärt uttryck som matchar datorns eller den virtuella datorns (VM) namn. .* passar in på alla namn.
• AppFilter eller appFilter: C#-reguljärt uttryck som matchar IIS-webbplatsnamnet (HostingEnvironment.SiteName). Det här filtret krävs när VirtualPathFilter eller virtualPathFilter inte tillhandahålls.
• VirtualPathFilter eller virtualPathFilter: C#-reguljärt uttryck som matchar den virtuella IIS-sökvägen (HostingEnvironment.ApplicationVirtualPath). Använd det här filtret för att rikta en enskild app under en webbplats.

Terminologikartläggning

• PowerShell-cmdletar använder MachineFilter, AppFilteroch VirtualPathFilter.
• Azure VM- och Virtual Machine Scale Sets-tillägget JSON använder machineFilter, appFilteroch virtualPathFilteroch anger resursen med instrumentationSettings.

Den här cmdletens kartform

• Ange -InstrumentationKeyMap som en PowerShell-matris med hashtables.
• För den här cmdleten anger du målresursen per regel med InstrumentationSettings=@{ InstrumentationKey = '<ikey>' }.
• Om du vill ha en enskild resurs för alla appar på datorn, använd -ConnectionString eller -InstrumentationKey i stället.

Start-ApplicationInsightsMonitoringTrace

Samlar in Event Tracing for Windows (ETW)-händelser som genereras av den kodlösa anslutningskörningen. Använd den här cmdleten som ett enklare alternativ till att köra PerfView.

Händelser skrivs ut till konsolen i realtid och skrivs även till en .etl fil. Du kan öppna .etl filen med PerfView för djupare analys.

Den här cmdleten körs tills den når tidsgränsen, standardvärdet är 5 minuter eller tills du stoppar den manuellt med Ctrl + C.

Exempel

Samla in händelser

Använd det här flödet när du behöver undersöka varför en IIS-app inte instrumenteras.

Den kodlösa kopplingskörningen genererar ETW-händelser när IIS startar och när appen startar.

1. I en administrativ kommandotolk kör du iisreset /stop för att stoppa IIS och alla webbappar.
2. Börja spåra genom att köra den här cmdleten.
3. I en administrativ kommandotolk kör du iisreset /start för att starta IIS.
4. Utlös start genom att bläddra till din app.
5. När appen har lästs in trycker du på Ctrl + C för att stoppa eller låter tidsgränsen avsluta sessionen.

Vilka händelser som ska samlas in

Du kan välja vilka händelsekällor som ska inkluderas:

1. -CollectSdkEvents samlar in händelser från Application Insights SDK.
2. -CollectRedfieldEvents samlar in händelser från Application Insights-agenten och Redfield-körningen, vilket är användbart för IIS- och appstartdiagnostik.
3. Samla in båda uppsättningarna genom att ange båda brytarna.
4. Om du inte anger en brytare samlas båda uppsättningarna in som standard.

Parametrar

-MaxDurationInMinutes

Valfritt. Anger hur lång tid det tar att samla in innan tidsgränsen nås. Standardvärdet är 5 minuter.

-LogDirectory

Valfritt. Katalog där .etl filen ska skrivas. Som standard skapas filen under modulens PowerShell-katalog. Den fullständiga sökvägen visas när sessionen startar.

-CollectSdkEvents

Valfritt. Inkludera Application Insights SDK-händelser.

- Samla Redfield-händelser

Valfritt. Inkludera händelser från Application Insights-agenten och Redfield-runtime.

-Mångordig

Gemensam parameter. Ger detaljerade loggar.

Utgång

Exempel på startloggar för program

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