Partilhar via


Log de rastreamento do serviço Servidor de Relatório

Os logs de rastreamento do servidor de relatório do Reporting Services são um arquivo de texto ASCII que contém informações detalhadas de operações do serviço Servidor de Relatório. As informações nos arquivos incluem operações executadas pelo serviço Web do servidor de relatório, o portal da Web e o 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 de log de rastreamento serão úteis se você estiver depurando um aplicativo que inclui um servidor de relatório. As informações também são úteis se você estiver investigando um problema específico que foi gravado no log de eventos ou no log de execução. Por exemplo, ao solucionar problemas com assinaturas.

Onde estão os arquivos de log do Servidor de Relatório?

Os arquivos de log de rastreamento são ReportServerService_<timestamp>.log e Microsoft.ReportingServices.Portal.WebHost_<timestamp>.log e estão localizados na seguinte pasta:

C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\LogFiles

Os logs de rastreamento são criados 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, por padrão, excluídos depois de 14 dias.

Configurações de rastreamento

O comportamento do log de rastreamento é gerenciado no arquivo de configuração ReportingServicesService.exe.config. O arquivo de configuração está localizado no caminho de pasta a seguir:

\Program Files\Microsoft SQL Server\MSRS13.<instance name>\Reporting Services\ReportServer\bin.

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="appdomain, tid, time" />
    <add name="TraceListeners" value="file" />
    <add name="TraceFileMode" value="unique" />
    <add name="Components" value="all:3" />
  </RStrace>

A tabela a seguir fornece informações sobre cada configuração.

Configuração Descrição Valores
RStrace Especifica os namespaces usados para erros e rastreamento.
DefaultTraceSwitch Especifica o nível de informações relatado ao log de rastreamento ReportServerService. Cada nível inclui as informações relatadas por todos os níveis de baixa numeração. Desativar o rastreamento não é recomendado. Os valores válidos são:



0 = Desabilita o rastreamento. O arquivo de log ReportServerService está habilitado por padrão. Para desativá-lo, defina o nível de rastreamento como 0.

1= Exceptions and restarts

2= Exceptions, restarts, warnings

3= Exceptions, restarts, warnings, status messages (padrão)

4= Verbose mode
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.

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 máximo do arquivo de log for atingido antes da data de expiração de 14 dias, as entradas mais antigas serão substituídas por entradas mais recentes.
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 após os 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/hora são adicionados aos nomes de arquivo de log de rastreamento. Esse valor é configurado para appdomain, 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 é configurado para Unique (default). Não modifique este valor.
Categoria do componente Especifica os componentes para os quais as informações do log de rastreamento são geradas e o nível de rastreamento neste formato:

\<component category>:\<tracelevel>

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 desative o rastreamento para tudo.

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" />
As categorias de componente podem ser definidas como:



Tudo é usado para rastrear a atividade geral do servidor de relatório para todos os processos que não estão divididos em categorias específicas.

RunningJobs é usado para rastrear uma operação de relatório ou de assinatura em andamento.

SemanticQueryEngine é usado para rastrear uma consulta semântica que é processada quando um usuário realiza exploração de dados não planejada em um relatório baseado em modelo.

SemanticModelGenerator é usado para rastrear a geração do modelo.

http é usado para habilitar o arquivo de log HTTP do servidor de relatório. Para obter mais informações, consulte Report Server HTTP Log.
Valor de tracelevel para categorias de componentes <categoria do componente>:<tracelevel>



Se você não anexar um nível de rastreio ao componente, o valor especificado para DefaultTraceSwitch será usado. Por exemplo, se você especificar all,RunningJobs,SemanticQueryEngine,SemanticModelGenerator, todos os componentes usarão o nível de rastreamento padrão.
Os valores válidos de nível de rastreamento são:



0= Disables tracing

1= Exceptions and restarts

2= Exceptions, restarts, warnings

3= Exceptions, restarts, warnings, status messages (padrão)

4= Verbose mode

O valor padrão para Report Server é: all:3.

Adicione uma configuração personalizada 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 .

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.

  • 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 encontrar erros de tempo limite de relatório, indicados como uma entrada ThreadAbortExceptions.

Versões anteriores

Em versões anteriores do Reporting Services, havia vários arquivos de log de rastreamento, um para cada aplicativo. Os seguintes arquivos estão obsoletos e não são mais criados no SQL Server 2008 (10.0.x) e versões posteriores:

+ ReportServerWebApp_\<timestamp>.log
+ ReportServer_\<timestamp>.log
+ ReportServerService_main_\<timestamp>.log