Compartir a través de

Archivo Léame del ejemplo de la utilidad ASTrace

La utilidad ASTrace le ofrece la posibilidad de capturar una traza de Analysis Services y registrarla en una tabla de SQL Server. Puede consultar la tabla posteriormente o leerla con el Analizador de SQL Server. La utilidad ASTrace se ejecuta como un servicio de Windows que se conecta a Analysis Services; a continuación, crea una traza y registra los eventos de traza en una tabla de SQL Server con el formato del Analizador de SQL Server. La utilidad ASTrace crea la traza con una plantilla de traza estándar que puede crear mediante el Analizador de SQL Server.

Escenario

Analysis Services no dispone de una herramienta integrada para extraer trazas y guardarlas en un archivo o una tabla. Este ejemplo de la utilidad ASTrace muestra cómo implementar dicha funcionalidad de traza.

Lenguajes

C#

Requisitos previos

Antes de ejecutar este ejemplo, asegúrese de que esté instalado el siguiente software:

  • Microsoft SQL Server 2005, incluidos los siguientes componentes:
    • Database Engine (Motor de base de datos)
    • Analysis Services
    • SQL Server Management Studio
    • Business Intelligence Development Studio
    • Los ejemplos de Database Engine (Motor de base de datos)
  • Microsoft .NET Framework SDK 2.0 o Visual Studio 2005

Generar el ejemplo

Opción 1: para generar el ejemplo con Visual Studio

  1. Busque la carpeta en que está almacenado el archivo de solución ASTrace.sln.

  2. Mueva el archivo de firma ASTrace.snk a la carpeta de soluciones.

  3. Abra Visual Studio.

  4. En la ficha Proyectos recientes, en Abrir, haga clic en Proyecto.

  5. Abra la carpeta donde haya guardado el archivo de solución ASTrace.sln, seleccione el archivo y haga clic en Abrir.

  6. Presione F6 para generar el proyecto.

Opción 2: para generar el ejemplo con msbuild.exe desde .NET Framework SDK

  1. Busque la carpeta en que está almacenado el archivo de solución ASTrace.sln.

  2. Mueva el archivo de firma ASTracer.snk a la carpeta de soluciones.

  3. Abra una ventana de símbolo del sistema y cambie el directorio a la ubicación donde se encuentre guardado el archivo de solución. Configure el entorno de acuerdo con las especificaciones que se indican en el tema del Manual del programador de .NET Framework, How to: Compile at the Command Prompt.

  4. Escriba msbuild.exe ASTrace.sln y, a continuación, presione Entrar.

Instalar el ejemplo

Los siguientes procedimientos describen cómo instalar la utilidad ASTrace como un servicio.

Paso1: copiar los archivos ejecutables

  • Copie los siguientes archivos en la carpeta donde se va a ejecutar el servicio en el equipo.

    • ASTrace.exe
    • ASTrace.exe.config
    • Standard.tdf

Paso 2: para registrar el servicio

  1. Busque el archivo InstallUtil.exe en la versión instalada de Microsoft .NET Framework SDK 2.0.

  2. Abra una ventana del símbolo del sistema.

  3. Cambie el directorio actual por el directorio donde haya copiado los archivos ejecutables en el paso anterior.

  4. Agregue la carpeta que contiene el archivo InstallUtil.exe a la ruta de acceso.

  5. Ejecute el siguiente comando para instalar el servicio:

    InstallUtil.exe ASTrace.exe

  6. En Herramientas administrativas, abra Administración de equipos, expanda Servicios y Aplicaciones y, a continuación, seleccione Servicios.

  7. Busque Servicio ASTrace en el panel derecho y haga doble clic en él. Compruebe en la ficha General que la Ruta al ejecutable muestre la ruta de acceso correcta a la ubicación donde haya copiado los archivos. Ahora, el servicio está registrado y está utilizando sus archivos.

    [!NOTA] No inicie el servicio hasta haberlo configurado en el siguiente paso.

Paso 3: para configurar el servicio

  1. Abra el archivo ASTrace.exe.config en el Bloc de notas o en cualquier otro editor de texto que no incluya caracteres de control.

  2. Agregue contenido a los siguientes campos conforme a su definición:

    • AnalysisServerName: nombre de la instancia de Analysis Services de la que se va a realizar un seguimiento.
    • SQLServer: nombre de la instancia de SQL Server donde se va a registrar la traza.
    • SQLServerDatabase: nombre de la base de datos de SQL Server que va a contener las tablas de traza.
    • TraceTableName: nombre de la tabla en la que se va a registrar la traza.
    • TraceDefinition: nombre del archivo que contiene la plantilla de traza usada para crear la traza de Analysis Services. Si necesita modificar la plantilla ASTrace, utilice Analizador de SQL Server.

Ejecutar el ejemplo

Los siguientes procedimientos muestran cómo iniciar el servicio y configurar la seguridad.

Paso 1: para iniciar el servicio

  • Abra el Administrador de control de servicios de Windows, vaya a la utilidad ASTrace e inicie el servicio.

    Si el servicio se inicia correctamente, significa que pudo conectarse a una instancia de Analysis Services y crear una traza; además, significa que pudo conectarse a SQL Server y crear una tabla de traza e iniciar el registro en ésta.

    Si se produce algún problema durante el inicio, verá el error registrado en el archivo ASTraceService.log, creado en el directorio de instalación local. Compruebe de nuevo los nombres y asegúrese de que se especificaron correctamente todos los nombres de servidor y de que el servicio ASTrace dispone de los permisos de seguridad adecuados. La utilidad ASTrace se instala mediante la cuenta LocalSystem para proporcionarle la capacidad de comprobar la funcionalidad.

Paso 2: para configurar la seguridad

  1. Asegúrese de cambiar la cuenta de servicio ASTrace por una cuenta de usuario local o de dominio adecuada. Esto minimizará el área de ataque de superficie.

  2. Para ejecutar la aplicación de servicio ASTrace, debe asegurarse de que la cuenta de servicio que ejecuta el servicio tenga los siguientes derechos:

    • Permisos de administrador de Analysis Services
    • Derechos de administrador de bases de datos de SQL Server para crear una tabla en la base de datos especificada y registrar los eventos.

Quitar el ejemplo

Use el siguiente procedimiento para desinstalar el servicio.

Para desinstalar el servicio ASTrace

  • Abra una ventana del símbolo del sistema y ejecute el siguiente comando:

    InstallUtil.exe ASTrace.exe

  • Last updated on