Condividi tramite

File leggimi relativo all'esempio ASTrace Utility

  • Articolo

L'utilità ASTrace permette di acquisire una traccia Analysis Services e registrarla in una tabella SQL Server su cui potrà essere eseguita una query in seguito o che potrà essere letta con SQL Server Profiler. Viene eseguita come servizio di Windows che esegue la connessione a Analysis Services, quindi crea una traccia e registra gli eventi della traccia in una tabella SQL Server nel formato SQL Server Profiler. La traccia viene creata sulla base di un modello di traccia standard modificabile con SQL Server Profiler.

Scenario

Analysis Services non dispone di uno strumento predefinito per l'estrazione di tracce e il loro salvataggio in un file o in una tabella. In questo esempio ASTrace Utility verrà dimostrato come implementare tali funzionalità.

Linguaggi

C#

Prerequisiti

Prima di eseguire questo esempio, verificare che siano installati i prodotti software seguenti:

  • Microsoft SQL Server 2005, con i componenti seguenti:
    • Motore di database
    • Analysis Services
    • SQL Server Management Studio
    • Business Intelligence Development Studio
    • Esempi di Motore di database
  • Microsoft.NET Framework SDK 2.0 o Visual Studio 2005

Generazione dell'esempio

Opzione 1: per generare l'esempio con Visual Studio

  1. Individuare la cartella in cui si trova il file della soluzione ASTrace.sln.

  2. Spostare il file della firma ASTrace.snk nella cartella della soluzione.

  3. Eseguire Visual Studio.

  4. Nella scheda Progetti recenti per Apri scegliere Progetto.

  5. Aprire la cartella in cui è stato salvato il file della soluzione ASTrace.sln, selezionare il file e quindi fare clic su Apri.

  6. Premere F6 per generare il progetto.

Opzione 2: per generare l'esempio con msbuild.exe da .Net Framework SDK

  1. Individuare la cartella in cui si trova il file della soluzione ASTrace.sln.

  2. Spostare il file della firma ASTracer.snk nella cartella della soluzione.

  3. Aprire una finestra del prompt dei comandi e passare alla directory in cui è stato salvato il file della soluzione. Configurare l'ambiente in base alle specifiche contenute nell'argomento Procedura: eseguire la compilazione dal prompt dei comandi della Guida per gli sviluppatori di .NET Framework.

  4. Digitare msbuild.exe ASTrace.sln e quindi premere Invio.

Installazione dell'esempio

Di seguito è descritto come installare l'utilità ASTrace come servizio.

Passaggio 1: per copiare i file eseguibili

  • Copia i file seguenti nella cartella in cui si desidera eseguire il servizio:

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

Passaggio 2: per registrare il servizio

  1. Individuare InstallUtil.exe nella versione installata di Microsoft .NET Framework SDK 2.0.

  2. Aprire la finestra del prompt dei comandi.

  3. Passare alla directory in cui sono stati copiati i file eseguibili nel passaggio precedente.

  4. Aggiungere la cartella contenente InstallUtil.exe al percorso.

  5. Eseguire il comando seguente per installare il servizio:

    InstallUtil.exe ASTrace.exe

  6. In Strumenti di amministrazione aprire Gestione computer, espandere Servizi e applicazioni e quindi selezionare Servizi.

  7. Cercare ASTrace Service nel riquadro a destra e fare doppio clic su di esso. Verificare nella scheda Generale che in Percorso file eseguibile sia visualizzato il percorso corretto in cui sono stati copiati i file. Il servizio è ora registrato e utilizza i file.

    [!NOTA] Non avviare il servizio prima della configurazione che verrà eseguita al passaggio successivo.

Passaggio 3: per configurare il servizio

  1. Aprire il file ASTrace.exe.config in Blocco note o in un altro editor di testo che non inserisca caratteri di controllo.

  2. Aggiungere contenuto ai campi seguenti in base alla loro definizione:

    • AnalysisServerName: nome dell'istanza di Analysis Services di cui eseguire la traccia.
    • SQLServer: nome dell'istanza di SQL Server in cui verrà registrata la traccia.
    • SQLServerDatabase: nome del database di SQL Server che conterrà le tabelle di traccia.
    • TraceTableName: nome della tabella in cui registrare la traccia.
    • TraceDefinition: nome del file contenente il modello di traccia utilizzato per creare la traccia di Analysis Services. Se è necessario modificare il modello ASTrace, utilizzare SQL Server Profiler.

Esecuzione dell'esempio

Le procedure seguenti illustrano come avviare il servizio e configurare la protezione.

Passaggio 1: per avviare il servizio

  • Aprire Gestione controllo servizi di Windows, passare all'utilità ASTrace e avviare il servizio.

    Il corretto avvio del servizio indica che il servizio è in grado di connettersi a un'istanza di Analysis Services per creare una traccia e che è stato in grado di connettersi a SQL Server per creare una tabella di traccia e avviare la registrazione.

    In caso di problemi all'avvio, l'errore verrà registrato nel file ASTraceService.log creato nella directory di installazione locale. Controllare nuovamente i nomi per assicurarsi che tutti i nomi di server siano stati specificati correttamente e che il servizio ASTrace disponga delle autorizzazioni di protezione appropriate. L'utilità ASTrace viene installata con l'account LocalSystem per consentire di testarne la funzionalità.

Passaggio 2: per configurare la protezione

  1. Modificare l'account del servizio ASTrace in un account utente di dominio o locale appropriato per ridurre al minimo la superficie di attacco.

  2. Per eseguire l'applicazione del servizio ASTrace, è necessario verificare che l'account di servizio che esegue il servizio disponga dei diritti seguenti:

    • Autorizzazione di amministratore di Analysis Services
    • Diritti dell'amministratore del database di SQL Server per creare una tabella nel database specificato e registrare eventi.

Rimozione dell'esempio

Attenersi alla procedura seguente per disinstallare il servizio.

Per disinstallare il servizio ASTrace

  • Aprire una finestra del prompt dei comandi ed eseguire il comando seguente:

    InstallUtil.exe ASTrace.exe