Log de rastreamento do serviço Servidor de Relatório
O log de rastreamento do servidor de relatório contém informações detalhadas sobre as operações do serviço Servidor de Relatório, incluindo as operações executadas pelo serviço Web do servidor de relatório, pelo Gerenciador de Relatórios e pelo processamento em segundo plano. O arquivo de log de rastreamento inclui informações redundantes que estão registradas em outros arquivos de log, além de informações adicionais que, de outro modo, não seriam disponibilizadas. As informações do log de rastreamento podem ser úteis se você estiver depurando um aplicativo que inclui um servidor de relatório ou investigando um problema específico que foi gravado no log de evento ou de execução.
.gif "Observação") Observação |
|---|
Em versões anteriores, havia vários arquivos de log de rastreamento, um para cada aplicativo. Esta versão consolida todos os dados de log em um único arquivo. O arquivos a seguir estão obsoletos e não são mais criados no SQL Server 2008 e em versões posteriores: ReportServerWebApp_<timestamp>.log, ReportServer_<timestamp>.log e ReportServerService_main_<timestamp>.log. |
Exibindo as informações do log
O arquivo de log de rastreamento é ReportServerService_<timestamp>.log. O log de rastreamento é um arquivo de texto ASCII. Você pode usar qualquer editor de texto para exibir o arquivo. Esse arquivo está localizado em \Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles. O log de rastreamento é criado diariamente, começando na primeira entrada que ocorre após a meia-noite (horário local), e sempre que o serviço é reiniciado. O carimbo de data e hora é baseado em UTC (Tempo Universal Coordenado). O arquivo está em formato pt-BR. Por padrão, os logs de rastreamento são limitados a 32 megabytes e excluídos depois de 14 dias.
Configurações do arquivo de log ReportServerService
Os níveis de rastreamento são especificados pelas configurações DefaultTraceSwitch e RSTrace. Todas as configurações no nível de rastreamento são armazenadas no arquivo ReportingServicesrService.exe.config.
O arquivo de configuração está localizado no caminho da pasta \Arquivos de Programas\Microsoft SQL Server\MSRS11.<nome da instância>\Reporting Services\ReportServer\bin.
O arquivo de log ReportServerService é habilitado por padrão.
Para desabilitá-lo, defina o nível de rastreamento como 0 na seção RStrace do arquivo ReportingServicesService.exe.config.
Para limitar o número de dias de preservação dos arquivos, especifique a configuração KeepFilesForDays na seção RStrace. Por padrão, esse valor é definido como 14.
Para limitar o tamanho do arquivo, especifique a configuração FileSizeLimitMb na seção RStrace. Por padrão, esse valor é definido como 32 megabytes. Você pode controlar o tamanho do arquivo definindo níveis de rastreamento (de 0 a 4) para controlar a quantidade de conteúdo registrado. Você também pode especificar quais componentes devem ser rastreados. Se o limite máximo do arquivo de log for atingido antes da data de validade de 14 dias, as entradas mais antigas serão substituídas pelas mais novas.
Campos do arquivo de log
Os campos a seguir podem ser localizados em um log de rastreamento:
Informações de sistema, incluindo o sistema operacional, a versão, o número de processadores e a memória.
Componente do Reporting Services e informações de versão.
Eventos registrados no log de aplicativo.
Exceções geradas pelo servidor de relatório.
Avisos sobre poucos recursos registrados por um servidor de relatório.
Envelopes SOAP de entrada e envelopes SOAP de saída resumidos.
Cabeçalho HTTP, rastreamento de pilha e informações de rastreamento de depuração.
Você pode revisar as informações do log de rastreamento para determinar se uma entrega de relatório ocorreu, quem recebeu o relatório e quantas tentativas de entrega foram feitas. Os logs de rastreamento também registram atividades de execução de relatório e as variáveis de ambiente que estão habilitadas durante o processamento do relatório. Erros e exceções também são incluídos em logs de rastreamento. Por exemplo, você pode localizar erros de tempo limite de relatório (indicados como uma entrada ThreadAbortExceptions).
Configurações de exemplo
O exemplo a seguir ilustra a estrutura XML das configurações RStrace. O valor de DefaultTraceSwitch determina o tipo de informações que são adicionadas ao log. Exceto para o atributo Components, os valores de RStrace são iguais em todos os arquivos de configuração.
<system.diagnostics>
<switches>
<add name="DefaultTraceSwitch" value="3" />
</switches>
</system.diagnostics>
<RStrace>
<add name="FileName" value="ReportServerService_" />
<add name="FileSizeLimitMb" value="32" />
<add name="KeepFilesForDays" value="14" />
<add name="Prefix" value="tid, time" />
<add name="TraceListeners" value="file" />
<add name="TraceFileMode" value="unique" />
<add name="Components" value="all" />
</RStrace>
A tabela a seguir fornece informações sobre cada configuração.
Configuração |
Descrição |
|---|---|
RStrace |
Especifica os namespaces usados para erros e rastreamento. |
DefaultTraceSwitch |
Especifica o nível de informações que é relatado no log de rastreamento ReportServerService. Cada nível inclui as informações relatadas por todos os níveis de baixa numeração. A desabilitação do rastreamento não é recomendada. Os valores válidos são: 0 = Desabilita o rastreamento 1 = Exceções e reinicializações 2 = Exceções, reinicializações, avisos 3 = Exceções, reinicializações, avisos, mensagens de status (padrão) 4 = Modo detalhado |
FileName |
Especifica a primeira parte do nome de arquivo de log. O valor especificado por Prefix completa o resto do nome. |
FileSizeLimitMb |
Especifica o limite superior do tamanho do log de rastreamento. O arquivo é medido em megabytes. Os valores válidos são de 0 a um inteiro máximo. O valor padrão é 32. Se você especificar 0 ou um número negativo, o servidor de relatório tratará o valor como 1. |
KeepFilesForDays |
Especifica o número de dias depois dos quais um arquivo de log de rastreamento será excluído. Os valores válidos são de 0 a um inteiro máximo. O valor padrão é 14. Se você especificar 0 ou um número negativo, o servidor de relatório tratará o valor como 1. |
Prefix |
Especifica um valor gerado que diferencia uma instância de log de outra. Por padrão, os valores do carimbo de data e hora são adicionados aos nomes de arquivo de log de rastreamento. Esse valor é definido como " tid, time ". Não modifique esta configuração. |
TraceListeners |
Especifica um destino para a saída do conteúdo do log de rastreamento. Você pode especificar vários destinos usando uma vírgula para separar cada um. Os valores válidos são: DebugWindow File (padrão) StdOut |
TraceFileMode |
Especifica se os logs de rastreamento contêm dados para um período de 24 horas. Um log de rastreamento exclusivo deve existir para cada componente em cada dia. Esse valor é definido como "Unique (default)". Não modifique esse valor. |
Components |
Especifica os componentes para os quais as informações do log de rastreamento são geradas e o nível de rastreamento neste formato: <categoria de componente>:<tracelevel> As categorias de componente podem ser definidas como:
Os valores válidos de nível de rastreamento são: 0 = Desabilita o rastreamento 1 = Exceções e reinicializações 2 = Exceções, reinicializações, avisos 3 = Exceções, reinicializações, avisos, mensagens de status (padrão) 4 = Modo detalhado O valor padrão do servidor de relatório é: "all:3". Você pode especificar todos ou alguns componentes (all, RunningJobs, SemanticQueryEngine, SemanticModelGenerator). Se não desejar gerar informações para um componente específico, desabilite o rastreamento desse componente (por exemplo, "SemanticModelGenerator:0"). Não desabilite o rastreamento para all. Se você não adicionar um nível de rastreamento ao componente, o valor especificado para DefaultTraceSwitch será usado. Por exemplo, se você especificar "all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator", todos os componentes utilizarão o nível de rastreamento padrão. Defina "SemanticQueryEngine:4" se desejar exibir as instruções Transact-SQL geradas para cada consulta semântica. As instruções Transact-SQL são registradas no log de rastreamento. O exemplo a seguir ilustra a configuração que adiciona instruções Transact-SQL ao log: <add name="Components" value="all,SemanticQueryEngine:4" /> |
Adicionando configurações personalizadas para especificar um local de arquivo de despejo
Você pode adicionar uma configuração personalizada para definir o local usado pela ferramenta Dr. Watson para Windows usa para armazenar arquivos de despejo. A configuração personalizada é Directory. O exemplo a seguir fornece uma ilustração de como esta configuração é especificada na seção RStrace:
<add name="Directory" value="U:\logs\" />
Para obter mais informações, consulte o Artigo 913046 da Base de Dados de Conhecimento no site do Microsoft.