Partilhar via


Configurar acompanhamento

Este tópico descreve como usar os cmdlets de AppFabric para configurar o rastreamento para um aplicativo ou serviço. Os cmdlets que você pode usar para configurar o rastreamento são Import-ASAppServiceTrackingProfile, Get-ASAppServiceTracking, Remove-ASAppServiceTrackingProfile e Get-ASAppServiceTrackingProfile.

Para executar interativamente um cmdlet de AppFabric, abra o console do Windows PowerShell para AppFabric, insira o cmdlet adequado e pressione ENTER. Para obter mais informações sobre a execução de cmdlets, consulte Executando cmdlets do Windows Server AppFabric.

Para importar informações de rastreamento para um aplicativo

No console do Windows PowerShell, execute o cmdlet Import-ASAppServiceTrackingProfile para configurar o rastreamento que é usado para monitorar operações de serviço. Esse cmdlet importa um perfil de rastreamento do arquivo especificado no arquivo de configuração de destino no nível especificado. O destino (escopo) dessa operação pode ser o arquivo Machine.config da máquina; o arquivo raiz Web.config ou um arquivo Web.config com um caminho especificado pelo site, aplicativo, diretório virtual de aplicativo, serviço ou instância de serviço. Se um arquivo estiver especificado, ele deverá ser um serviço .svc, .xamlx ou .xoml.

Opções de sintaxe de Import-ASAppServiceTrackingProfile:

Sintaxe 1

Import-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-FilePath] <String> [-Overwrite] [-ProfileName <String>]

Sintaxe 2

Import-ASAppServiceTrackingProfile [-Uri] <Uri> [-FilePath] <String> [-Overwrite] [-ProfileName <String>]

Sintaxe 3

Import-ASAppServiceTrackingProfile [-FilePath] <String> -ApplicationObject <ApplicationInfo> [-Overwrite] [-ProfileName <String>]

Sintaxe 4

Import-ASAppServiceTrackingProfile [-FilePath] <String> -ServiceObject <ServiceInfo> [-Overwrite] [-ProfileName <String>]

Sintaxe 5

Import-ASAppServiceTrackingProfile [-FilePath] <String> [-Overwrite] [-ProfileName <String>] -Root
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo> ou -Root

Escopo operacional do cmdlet

[-FilePath] <String>

Especifica o nome do arquivo (incluindo o caminho) do qual importar o perfil de rastreamento. Esse parâmetro é obrigatório. O arquivo deve conter exatamente um perfil.

[-Overwrite]

Opcional. Se esse parâmetro for especificado, qualquer configuração existente do perfil de rastreamento será substituída. O comportamento é equivalente a chamar Remove-TrackingProfile seguido de Import-TrackingParticipant sem o sinalizador –overwrite. O cmdlet falhará se o perfil de rastreamento não puder se removido.

[-ProfileName <String>]

Especifica o nome que será designado ao perfil de rastreamento importado. Especifica o atributo de nome do elemento de perfil. Esse parâmetro é opcional. Se especificado, esse parâmetro substituirá o nome especificado no arquivo.

Para obter informações de rastreamento de um aplicativo

No console do Windows PowerShel, execute o cmdlet Get-ASAppServiceTracking para obter as configurações atuais de rastreamento de um serviço usando um objeto ServiceTrackingInfo que descreva essas configurações atuais de rastreamento do serviço. O objeto contém uma lista de componentes de rastreamento que estão habilitados para o serviço e um sinalizador que indica se o rastreamento está habilitado no serviço. O destino (escopo) dessa operação é o arquivo Web.config associado a um serviço (ou instância de serviço).

Opções de sintaxe de Get-ASAppServiceTracking:

Sintaxe 1

Get-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>]

Sintaxe 2

Get-ASAppServiceTracking [-Uri] <Uri>

Sintaxe 3

Get-ASAppServiceTracking -ApplicationObject <ApplicationInfo>

Sintaxe 4

Get-ASAppServiceTracking -ServiceObject <ServiceInfo>

Sintaxe 5

Get-ASAppServiceTracking -Root
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo> ou -Root

Escopo operacional do cmdlet

Para definir informações de rastreamento de um aplicativo

No console do Windows PowerShell, execute o cmdlet Set-AsAppServiceTracking para definir as informações de rastreamento do aplicativo da Web no escopo especificado.

Opções de sintaxe de Set-AsAppServiceTracking:

Sintaxe 1

Set-ASAppServiceTracking [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>

Sintaxe 2

Set-ASAppServiceTracking [-Uri] <Uri> -ProfileName <String>

Sintaxe 3

Set-ASAppServiceTracking -ApplicationObject <ApplicationInfo> -ProfileName <String>

Sintaxe 4

Set-ASAppServiceTracking -ProfileName <String> -ServiceObject <ServiceInfo>

Sintaxe 5

Set-ASAppServiceTracking -ProfileName <String> -Root
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo> ou -Root

Escopo operacional do cmdlet

-ProfileName

Nome do perfil que contém informações de rastreamento que serão definidas

Para remover informações de rastreamento de um aplicativo

No console do Windows PowerShell, execute o cmdlet Remove-ASAppServiceTrackingProfile para remover um perfil de rastreamento do nível de configuração especificado. Esse cmdlet é usado para configurar o rastreamento que é usado para monitorar operações de serviço.

Opções de sintaxe de Remove-ASAppServiceTrackingProfile:

Sintaxe 1

Remove-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] -ProfileName <String>

Sintaxe 2

Remove-ASAppServiceTrackingProfile [-Uri] <Uri> -ProfileName <String>

Sintaxe 3

Remove-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> -ProfileName <String>

Sintaxe 4

Remove-ASAppServiceTrackingProfile -ProfileName <String> -ServiceObject <ServiceInfo>

Sintaxe 5

Remove-ASAppServiceTrackingProfile -ProfileName <String> -Root
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo> ou -Root

Escopo operacional do cmdlet

-ProfileName <String>

Especifica o nome do perfil de rastreamento que será removido. O perfil deve ser definido localmente no arquivo de configuração de destino. Esse parâmetro é obrigatório.

Para obter um perfil de rastreamento de um aplicativo

No console do Windows PowerShell, execute o cmdlet Get-ASAppServiceTrackingProfile para retornar os perfis de rastreamento visíveis a um serviço (incluindo perfis definidos em todos os escopos) em uma classe TrackingProfileInfo. Todas as configurações na hierarquia de configuração do arquivo de configuração de destino estão no escopo dessa operação. Isso significa que configurações locais (aquelas definidas no arquivo de destino) e herdadas (aquelas definidas no arquivo Machine.config ou no arquivo raiz Web.config) podem ser retornadas.

Opções de sintaxe de Get-ASAppServiceTrackingProfile:

Sintaxe 1

Get-ASAppServiceTrackingProfile [-SiteName] <String> [[-VirtualPath] <String>] [-ProfileName <String>]

Sintaxe 2

Get-ASAppServiceTrackingProfile [-Uri] <Uri> [-ProfileName <String>]

Sintaxe 3

Get-ASAppServiceTrackingProfile -ApplicationObject <ApplicationInfo> [-ProfileName <String>]

Sintaxe 4

Get-ASAppServiceTrackingProfile -ServiceObject <ServiceInfo> [-ProfileName <String>]

Sintaxe 5

Get-ASAppServiceTrackingProfile [-ProfileName <String>] -Root
Parâmetro Descrição

[-SiteName] <String> [[-VirtualPath] <String>], [-Uri] <Uri>, -ApplicationObject <ApplicationInfo>, -ServiceObject <ServiceInfo> ou -Root

Escopo operacional do cmdlet

-ProfileName <String>

Especifica o nome do perfil de rastreamento que será retornado. O perfil pode ser definido localmente no arquivo de configuração de destino ou herdado da hierarquia do arquivo de configuração. Esse parâmetro é opcional. Se o parâmetro ProfileName não estiver especificado, todos os perfis de rastreamento (local e herdado) associados ao arquivo de configuração de destino serão retornados.

  2011-12-05