Definir configurações avançadas para arquivos de log do DQS

Este tópico descreve como definir configurações avançadas para os arquivos de log do Data Quality Server e do Cliente Data Quality, como definir o limite de tamanho de arquivo de rolagem dos arquivos de log, definir o padrão de carimbo de data/hora dos eventos etc.

Observação
Essas atividades não podem ser executadas por meio do Cliente Data Quality, e destinam-se apenas a usuários avançados.

Neste tópico

• Antes de começar:

  Segurança

• Definir configurações de log do servidor do Data Quality

• Definir configurações de log do cliente do Data Quality

Antes de começar

Segurança

Permissões

• A conta de usuário do Windows deve ser um membro da função de servidor fixa sysadmin na instância do SQL Server para modificar as configurações na tabela A_CONFIGURATION do banco de dados DQS_MAIN.

• Você deve estar conectado como membro do grupo Administradores no computador onde está modificando o arquivo DQLog.Client.xml para definir as configurações de log do Cliente Data Quality.

[Início]

Definir configurações de log do servidor do Data Quality

As configurações de log do Data Quality Server estão presentes em um formato XML na coluna VALUE da linha ServerLogging na tabela A_CONFIGURATION no banco de dados DQS_MAIN. Você pode executar a seguinte consulta SQL para exibir informações de configuração:

select * from DQS_MAIN.dbo.A_CONFIGURATION where NAME='ServerLogging'

Você deve atualizar as informações apropriadas na coluna VALUE da linha ServerLogging para alterar as configurações de log do Data Quality Server. Neste exemplo, atualizaremos as configurações de log do Data Quality Server para definir o limite de tamanho do arquivo de rolagem como 25000 KB (o padrão é 20000 KB).

1. Inicie o Microsoft SQL Server Management Studio e conecte-se à instância apropriada do SQL Server.

2. No Pesquisador de Objetos, clique com o botão direito do mouse no servidor e, depois, clique em Nova Consulta.

3. Na janela Editor de Consultas, copie as seguintes instruções SQL:

   -- Begin the transaction.
   BEGIN TRAN
   GO
   -- set the XML value field for the row with name=ServerLogging
   update DQS_MAIN.dbo.A_CONFIGURATION 
   set VALUE='<configuration>
     <configSections>
       <section name="loggingConfiguration" type="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.LoggingSettings, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" />
     </configSections>
     <loggingConfiguration name="Logging Application Block" tracingEnabled="true" defaultCategory="" logWarningsWhenNoCategoriesMatch="true">
       <listeners>
         <add fileName="###REPLACE_THIS_WITH_SQL_SERVER_INSTANCE_LOG_FOLDER_NAME###DQServerLog.###REPLACE_THIS_WITH_SQL_CATALOG_NAME###.log" footer="" formatter="Custom Text Formatter" header="" rollFileExistsBehavior="Increment" rollInterval="None" rollSizeKB="25000" timeStampPattern="yyyy-MM-dd" listenerDataType="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.RollingFlatFileTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" traceOutputOptions="None" filter="All" type="Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.RollingFlatFileTraceListener, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" name="Rolling Flat File Trace Listener" />
       </listeners>
       <formatters>
         <add template="{timestamp(local)}|[{threadName}]|{dictionary({value}|)}{message}" type="Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.TextFormatter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" name="Custom Text Formatter" />
       </formatters>
       <logFilters>
         <add enabled="true" type="Microsoft.Practices.EnterpriseLibrary.Logging.Filters.LogEnabledFilter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=e44a2bc38ed2c13c" name="LogEnabled Filter" />
       </logFilters>
       <categorySources />
       <specialSources>
         <allEvents switchValue="All" name="All Events" />
         <notProcessed switchValue="All" name="Unprocessed Category" />
         <errors switchValue="All" name="Logging Errors &amp; Warnings">
           <listeners>
             <add name="Rolling Flat File Trace Listener" />
           </listeners>
         </errors>
       </specialSources>
     </loggingConfiguration>
   </configuration>'
   WHERE NAME='ServerLogging'
   GO
   -- check the result
   select * from DQS_MAIN.dbo.A_CONFIGURATION where NAME='ServerLogging'
   
   -- Commit the transaction.
   COMMIT TRAN
   

4. Pressione F5 para executar as instruções. Consulte o painel Resultados para verificar se as instruções foram executadas com êxito.

5. Para aplicar as alterações feitas na configuração de log do Data Quality Server, execute as seguintes instruções Transact-SQL. Abra uma nova janela Editor de Consultas e cole as seguintes instruções Transact-SQL:

   USE [DQS_MAIN]
   GO
   DECLARE @return_value int
   EXEC @return_value = [internal_core].[RefreshLogSettings]
   SELECT 'Return Value' = @return_value
   GO
   

6. Pressione F5 para executar as instruções. Consulte o painel Resultados para verificar se as instruções foram executadas com êxito.

Observação

As configurações de log do Data Quality Server são geradas e armazenadas dinamicamente no arquivo DQS_MAIN.Log, que geralmente estará disponível em C:\Arquivos de Programas\Microsoft SQL Server\MSSQL11.MSS QLSERVER\MSSQL\Log caso você tenha instalado a instância padrão do SQL Server. No entanto, as alterações feitas diretamente nesse arquivo não são mantidas, sendo substituídas pelas configurações da tabela A_CONFIGURATION no banco de dados DQS_MAIN.

[Início]

Definir configurações de log do cliente do Data Quality

O arquivo de configuração de log do Cliente Data Quality, DQLog.Client.xml, geralmente está disponível em C:\Arquivos de Programas\Microsoft SQL Server\110\Tools\Binn\DQ\config. O conteúdo do arquivo XML é semelhante ao arquivo XML cujas configurações de log do Data Quality Server você modificou anteriormente. Para configurar as configurações de log do Cliente Data Quality:

1. Execute qualquer ferramenta de edição XML ou bloco de notas como um administrador.

2. Abra o arquivo DQLog.Client.xml na ferramenta ou no bloco de notas.

3. Faça as alterações necessárias e salve o arquivo para aplicar as novas alterações de log.

[Início]

Consulte também

Conceitos

Configurar níveis de severidade para arquivos de log do DQS