Konfigurace sledování
Toto téma popisuje, jak lze konfigurovat sledování aplikace nebo služby pomocí rutin technologie AppFabric. Rutiny, pomocí kterých je možné konfigurovat sledování, jsou tyto: Import-ASAppServiceTrackingProfile, Get-ASAppServiceTracking, Remove-ASAppServiceTrackingProfile a Get-ASAppServiceTrackingProfile.
Abyste interaktivně spustili rutinu technologie AppFabric, je třeba otevřít konzolu prostředí Windows PowerShell pro technologii AppFabric, zadat odpovídající rutinu a stisknout klávesu ENTER. Další informace o spouštění rutin naleznete v tématu Spouštění rutin technologie Windows Server AppFabric.
Import sledovacích informací pro aplikaci
V konzole prostředí Windows PowerShell spusťte rutinu Import-ASAppServiceTrackingProfile, a nakonfigurujte tak sledování určené k monitorování operací služby. Tato rutina importuje sledovací profil ze zadaného souboru do cílového konfiguračního souboru zadané úrovně. Cílem (oborem) této operace může být počítačový soubor Machine.config, kořenový soubor Web.config nebo soubor Web.config s cestou zadanou pomocí webu, aplikace, virtuálního adresáře aplikace, služby nebo instance služby. Pokud je zadána služba, musí to být služba typu SVC, XAMLX nebo XOML.
Možnosti syntaxe u rutiny Import-ASAppServiceTrackingProfile:
Syntaxe 1
Import-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-FilePath] <String> [-Overwrite] [-ProfileName <String>]
Syntaxe 2
Import-ASAppServiceTrackingProfile [-Uri] <Uri> [-FilePath] <String> [-Overwrite] [-ProfileName <String>]
Syntaxe 3
Import-ASAppServiceTrackingProfile [-FilePath] <String> -ApplicationObject <ApplicationInfo> [-Overwrite] [-ProfileName <String>]
Syntaxe 4
Import-ASAppServiceTrackingProfile [-FilePath] <String> -ServiceObject <ServiceInfo> [-Overwrite] [-ProfileName <String>]
Syntaxe 5
Import-ASAppServiceTrackingProfile [-FilePath] <String> [-Overwrite] [-ProfileName <String>] -Root
| Parametr | Popis |
|---|---|
[-SiteName] <Řetězec> [[-VirtualPath] <Řetězec>], [-Uri] <IdentifikátorURI>, -ApplicationObject <InformaceOAplikaci>, -ServiceObject <InformaceOSlužbě> nebo -Root |
Operační obor rutiny |
[-FilePath] <Řetězec> |
Určuje název souboru (včetně cesty), ze kterého má být importován sledovací profil. Tento parametr je povinný. Soubor musí obsahovat přesně jeden profil. |
[-Overwrite] |
Nepovinný parametr. Pokud je tento parametr zadán, bude přepsána jakákoli existující konfigurace sledovacího profilu. Chování je ekvivalentní jako volání rutiny Remove-TrackingProfile a následné volání rutiny Import-TrackingParticipant bez příznaku -overwrite. Pokud nelze sledovací profil odebrat, skončí rutina s chybou. |
[-ProfileName <Řetězec>] |
Určuje název, který má být přiřazen importovanému sledovacímu profilu. Určuje atribut Name elementu Profile. Tento parametr je nepovinný. Pokud je tento parametr zadán, přepíše název určený v souboru. |
Získání sledovacích informací pro aplikaci
V konzole prostředí Windows PowerShell spusťte rutinu Get-ASAppServiceTracking, a získejte tak aktuální nastavení sledování pro službu pomocí objektu ServiceTrackingInfo, který popisuje aktuální nastavení sledování služby. Tento objekt obsahuje seznam sledovacích součástí, které jsou pro službu povoleny, a příznak, který indikuje, zda je u služby povoleno sledování. Cílem (oborem) této operace je soubor Web.config přidružený ke službě (či k instanci služby).
Možnosti syntaxe u rutiny Get-ASAppServiceTracking:
Syntaxe 1
Get-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>]
Syntaxe 2
Get-ASAppServiceTracking [-Uri] <Uri>
Syntaxe 3
Get-ASAppServiceTracking -ApplicationObject <ApplicationInfo>
Syntaxe 4
Get-ASAppServiceTracking -ServiceObject <ServiceInfo>
Syntaxe 5
Get-ASAppServiceTracking -Root
| Parametr | Popis |
|---|---|
[-SiteName] <Řetězec> [[-VirtualPath] <Řetězec>], [-Uri] <IdentifikátorURI>, -ApplicationObject <InformaceOAplikaci>, -ServiceObject <InformaceOSlužbě> nebo -Root |
Operační obor rutiny |
Nastavení sledovacích informací pro aplikaci
V konzole prostředí Windows PowerShell spusťte rutinu Set-AsAppServiceTracking, a nastavte tak sledovací informace pro webovou aplikaci v zadaném oboru.
Možnosti syntaxe u rutiny Set-AsAppServiceTracking:
Syntaxe 1
Set-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>
Syntaxe 2
Set-ASAppServiceTracking [-Uri] <Uri> -ProfileName <String>
Syntaxe 3
Set-ASAppServiceTracking -ApplicationObject <ApplicationInfo> -ProfileName <String>
Syntaxe 4
Set-ASAppServiceTracking -ProfileName <String> -ServiceObject <ServiceInfo>
Syntaxe 5
Set-ASAppServiceTracking -ProfileName <String> -Root
| Parametr | Popis |
|---|---|
[-SiteName] <Řetězec> [[-VirtualPath], [-Uri] <IdentifikátorURI>, -ApplicationObject <InformaceOAplikaci> nebo -Root |
Operační obor rutiny |
-ProfileName |
Název profilu obsahujícího sledovací informace, jež mají být nastaveny |
Odebrání sledovacích informací pro aplikaci
V konzole prostředí Windows PowerShell spusťte rutinu Remove-ASAppServiceTrackingProfile, a odeberte tak sledovací profil ze zadané úrovně konfigurace. Tato rutina slouží ke konfiguraci sledování určeného k monitorování operací služby.
Možnosti syntaxe u rutiny Remove-ASAppServiceTrackingProfile:
Syntaxe 1
Remove-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>
Syntaxe 2
Remove-ASAppServiceTrackingProfile [-Uri] <Uri> -ProfileName <String>
Syntaxe 3
Remove-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> -ProfileName <String>
Syntaxe 4
Remove-ASAppServiceTrackingProfile -ProfileName <String> -ServiceObject <ServiceInfo>
Syntaxe 5
Remove-ASAppServiceTrackingProfile -ProfileName <String> -Root
| Parametr | Popis |
|---|---|
[-SiteName] <Řetězec> [[-VirtualPath] <Řetězec>], [-Uri] <IdentifikátorURI>, -ApplicationObject <InformaceOAplikaci>, -ServiceObject <InformaceOSlužbě> nebo -Root |
Operační obor rutiny |
-ProfileName <Řetězec> |
Určuje název sledovacího profilu, který má být odebrán. Profil musí být definován lokálně v cílovém konfiguračním souboru. Tento parametr je povinný. |
Získání sledovacího profilu pro aplikaci
V konzole prostředí Windows PowerShell spusťte rutinu Get-ASAppServiceTrackingProfile, která vrátí sledovací profily viditelné pro službu (tyto profily mohou být definovány ve všech oborech) ve třídě TrackingProfileInfo. V oboru této operace jsou veškerá nastavení z konfigurační hierarchie cílového konfiguračního souboru. Znamená to, že tato operace může vrátit lokální nastavení (definovaná v cílovém souboru) i zděděná nastavení (definovaná v souboru Machine.config nebo v kořenovém souboru Web.config).
Možnosti syntaxe u rutiny Get-ASAppServiceTrackingProfile:
Syntaxe 1
Get-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-ProfileName <String>]
Syntaxe 2
Get-ASAppServiceTrackingProfile [-Uri] <Uri> [-ProfileName <String>]
Syntaxe 3
Get-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> [-ProfileName <String>]
Syntaxe 4
Get-ASAppServiceTrackingProfile -ServiceObject <ServiceInfo> [-ProfileName <String>]
Syntaxe 5
Get-ASAppServiceTrackingProfile [-ProfileName <String>] -Root
| Parametr | Popis |
|---|---|
[-SiteName] <Řetězec> [[-VirtualPath] <Řetězec>], [-Uri] <IdentifikátorURI>, -ApplicationObject <InformaceOAplikaci>, -ServiceObject <InformaceOSlužbě> nebo -Root |
Operační obor rutiny |
-ProfileName <Řetězec> |
Určuje název sledovacího profilu, který má být vrácen. Profil může být definován lokálně v cílovém konfiguračním souboru nebo zděděn z hierarchie konfiguračních souborů. Tento parametr je nepovinný. Pokud není parametr ProfileName zadán, budou vráceny všechny sledovací profily přidružené k cílovému konfiguračnímu souboru (lokální i zděděné). |
2011-12-05