Compartir a través de

Configuración del seguimiento

  • Artículo

En este tema se describe cómo se pueden usar los cmdlets de AppFabric para configurar el seguimiento de una aplicación o servicio. Los cmdlets que puede usar para configurar el seguimiento son Import-ASAppServiceTrackingProfile, Get-ASAppServiceTracking, Remove-ASAppServiceTrackingProfile y Get-ASAppServiceTrackingProfile.

Para ejecutar un cmdlet de AppFabric de manera interactiva, abra la consola de Windows PowerShell para AppFabric, escriba el cmdlet y presione ENTRAR. Para obtener más información sobre la ejecución de cmdlets, vea Ejecución de cmdlets de Windows Server AppFabric.

Procedimiento para importar información de seguimiento de una aplicación

En la consola de Windows PowerShell, ejecute el cmdlet Import-ASAppServiceTrackingProfile para configurar el seguimiento, lo que permite realizar un seguimiento de las operaciones de servicio. Este cmdlet importa un perfil de seguimiento desde el archivo especificado al archivo de configuración de destino del nivel especificado. El destino (ámbito) de esta operación puede ser el archivo Machine.config del equipo; el archivo Web.config raíz o el archivo Web.config con la ruta de acceso especificada por sitio, aplicación, directorio virtual a la aplicación, servicio o instancia de servicio. Si se especifica un servicio, debe ser un servicio .svc, .xamlx o .xoml.

Opciones de sintaxis para Import-ASAppServiceTrackingProfile:

Sintaxis 1

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

Sintaxis 2

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

Sintaxis 3

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

Sintaxis 4

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

Sintaxis 5

Import-ASAppServiceTrackingProfile [-FilePath] <String> [-Overwrite] [-ProfileName <String>] -Root
Parámetro Descripción

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

Ámbito operativo para el cmdlet

[-FilePath] <String>

Especifica el nombre del archivo (incluida la ruta de acceso) desde el que se va a importar el perfil de seguimiento. Este parámetro es obligatorio. El archivo debe contener un solo perfil.

[-Overwrite]

Opcional. Si se especifica este parámetro, se sobrescribe cualquier configuración de perfil de seguimiento existente. El comportamiento es equivalente a llamar a Remove-TrackingProfile seguido de Import-TrackingParticipant sin el indicador –overwrite. El cmdlet generará un error si el perfil de seguimiento no se puede quitar.

[-ProfileName <String>]

Especifica el nombre que se va a asignar al perfil de seguimiento importado. Especifica el atributo de nombre del elemento de perfil. Este parámetro es opcional. Si se especifica, este parámetro invalida el nombre especificado en el archivo.

Procedimiento para obtener información de seguimiento de una aplicación

En la consola de Windows PowerShell, ejecute el cmdlet Get-ASAppServiceTracking para obtener los parámetros de seguimiento actuales de un servicio mediante un objeto ServiceTrackingInfo que describa los parámetros de seguimiento actuales del servicio. El objeto contiene una lista de componentes de seguimiento habilitados para el servicio y un indicador de si el seguimiento está habilitado en el servicio. El destino (ámbito) de esta operación es el archivo Web.config asociado a este servicio (o instancia de servicio).

Opciones de sintaxis para Get-ASAppServiceTracking:

Sintaxis 1

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

Sintaxis 2

Get-ASAppServiceTracking [-Uri] <Uri>

Sintaxis 3

Get-ASAppServiceTracking -ApplicationObject <ApplicationInfo>

Sintaxis 4

Get-ASAppServiceTracking -ServiceObject <ServiceInfo>

Sintaxis 5

Get-ASAppServiceTracking -Root
Parámetro Descripción

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

Ámbito operativo para el cmdlet

Procedimiento para establecer información de seguimiento de una aplicación

En la consola de Windows PowerShell, ejecute el cmdlet Set-AsAppServiceTracking para establecer la información de seguimiento de la aplicación web en el ámbito especificado.

Opciones de sintaxis para Set-AsAppServiceTracking:

Sintaxis 1

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

Sintaxis 2

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

Sintaxis 3

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

Sintaxis 4

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

Sintaxis 5

Set-ASAppServiceTracking -ProfileName <String> -Root
Parámetro Descripción

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

Ámbito operativo para el cmdlet

-ProfileName

Nombre del perfil que contiene la información de seguimiento que se va a establecer.

Procedimiento para quitar información de seguimiento de una aplicación

En la consola de Windows PowerShell, ejecute el cmdlet Remove-ASAppServiceTrackingProfile para quitar un perfil de seguimiento del nivel especificado de la configuración. Este cmdlet se usa para configurar el seguimiento, que permite supervisar las operaciones de servicio.

Opciones de sintaxis para Remove-ASAppServiceTrackingProfile:

Sintaxis 1

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

Sintaxis 2

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

Sintaxis 3

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

Sintaxis 4

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

Sintaxis 5

Remove-ASAppServiceTrackingProfile -ProfileName <String> -Root
Parámetro Descripción

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

Ámbito operativo para el cmdlet

-ProfileName <String>

Especifica el nombre del perfil de seguimiento que se va a quitar. El perfil debe definirse localmente en el archivo de configuración de destino. Este parámetro es obligatorio.

Procedimiento para obtener un perfil de seguimiento de una aplicación

En la consola de Windows PowerShell, ejecute el cmdlet Get-ASAppServiceTrackingProfile para devolver los perfiles de seguimiento visibles para un servicio (incluye perfiles definidos en todos los ámbitos) en una clase TrackingProfileInfo. Todos los parámetros de la jerarquía de configuración del archivo de configuración de destino están en el ámbito para esta operación. Esto significa que puede devolver los parámetros locales (definidos en el archivo de destino) y heredados (definidos en el archivo Machine.config o el archivo Web.config raíz).

Opciones de sintaxis para Get-ASAppServiceTrackingProfile:

Sintaxis 1

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

Sintaxis 2

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

Sintaxis 3

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

Sintaxis 4

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

Sintaxis 5

Get-ASAppServiceTrackingProfile [-ProfileName <String>] -Root
Parámetro Descripción

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

Ámbito operativo para el cmdlet

-ProfileName <String>

Especifica el nombre del perfil de seguimiento que se va a devolver. El perfil puede definirse localmente en el archivo de configuración de destino o heredarse de la jerarquía de archivo de configuración. Este parámetro es opcional. Si el parámetro ProfileName no se especifica, se devuelven todos los perfiles de seguimiento (locales y heredados) asociados al archivo de configuración de destino.

  2011-12-05