Monitorar assinaturas do Reporting Services
Você pode monitorar assinaturas do Reporting Services da interface do usuário, do Windows PowerShell ou arquivos de log. As opções disponíveis para monitoramento dependem de qual modo de servidor de relatório está em execução.
Aplica-se a:
Modo nativo do Reporting Services
Modo do SharePoint do Reporting Services
Neste artigo:
Interface do usuário de modo nativo
Usuários individuais do Reporting Services podem monitorar o status de uma assinatura usando a página Minhas assinaturas ou a guia Assinaturas no portal da Web. As páginas de assinatura incluem colunas que indicam quando a assinatura foi executada pela última vez e seu status. As mensagens de status são atualizadas quando a assinatura é agendada para ser processada. Se o gatilho nunca ocorrer (por exemplo, um instantâneo de execução de relatório nunca for atualizado ou um agendamento nunca ocorrer), a mensagem de status não será atualizada.
A tabela a seguir descreve os possíveis valores para a coluna Status .
| Status | Descrição |
|---|---|
| Nova assinatura | Aparece quando você cria a assinatura. |
| Inativo | Aparece quando uma assinatura não pode ser processada. Para saber mais, confira "Gerenciar assinaturas inativas" posteriormente neste artigo. |
| Concluído: <number> processados de um total de <number>; <number> erros. | Mostra o status de uma execução de assinatura controlada por dados; essa mensagem é proveniente do Processador de Agendamento e Entrega. |
| <number> processados | O número de notificações que o Processador de Agendamento e Entrega entregou com êxito ou que não está mais tentando entregar. Quando uma entrega controlada por dados for concluída, o número de notificações processadas deve ser igual ao número total de notificações geradas. |
| <number> total | O número total de notificações geradas para a última entrega para a assinatura. |
| <number> erro | O número de notificações que o Processador de Agendamento e Entrega não pôde entregar ou que não está mais tentando entregar. |
| Falha ao enviar mensagem: falha no transporte ao se conectar ao servidor. | Indica que o servidor de relatório não se conectou ao servidor de email; essa mensagem é emitida pela extensão de entrega de email. |
| O arquivo <filename> foi gravado em <path>. | Indica que a entrega no local de compartilhamento de arquivos teve êxito; esta mensagem é emitida pela extensão de entrega do compartilhamento de arquivos. |
| Erro desconhecido ao gravar o arquivo. | Indica que a entrega no local de compartilhamento de arquivos não teve êxito; esta mensagem é emitida pela extensão de entrega do compartilhamento de arquivos. |
| Falha ao conectar-se à pasta de destino, <path>. Verifique se a pasta de destino ou o compartilhamento de arquivos existe. | Indica que a pasta especificada não foi localizada; esta mensagem é emitida pela extensão de entrega do compartilhamento de arquivos. |
| O arquivo <filename> não pôde ser gravado em <path>. Tentando repetir. | Indica que o arquivo não pôde ser atualizado com uma versão mais recente; esta mensagem é emitida pela extensão de entrega do compartilhamento de arquivos. |
| Falha ao gravar o arquivo <filename>: <message> | Indica que a entrega no local de compartilhamento de arquivos não teve êxito; esta mensagem é emitida pela extensão de entrega do compartilhamento de arquivos. |
| <mensagens de status personalizadas> | Mensagens de status sobre êxito e falha de entrega, fornecidas pelas extensões de entrega. Se você usar uma extensão de entrega personalizada ou de terceiros, outras mensagens de status poderão ser fornecidas. |
Os administradores de servidor de relatório também podem monitorar assinaturas padrão que estão sendo processadas no momento. As assinaturas controladas por dados não podem ser monitoradas. Para obter mais informações, consulte Gerenciar um processo em execução.
Se uma assinatura não puder ser entregue (por exemplo, se o servidor de email não estiver disponível), a extensão de entrega repete a entrega. Uma configuração especifica o número de tentativas que serão feitas. O valor padrão é nenhuma tentativa. Em alguns casos, o relatório pode ter sido processado sem dados (por exemplo, se a fonte de dados estiver offline). Nesse caso, o texto sobre isso é fornecido no corpo da mensagem.
Arquivos de log de modo nativo
Se ocorrer um erro durante a entrega, será inserida uma entrada no log de rastreamento do servidor de relatório.
Os administradores do servidor de relatório podem examinar os arquivos ReportServerService_*.log para determinar o status da entrega da assinatura. Para entrega de email, os arquivos de log do servidor de relatórios incluem um registro do processamento e das entregas para contas de email específicas. Este caminho é o local padrão dos arquivos de log:
C:\Program Files\Microsoft SQL Server Reporting Services\SSRS\LogFiles
O seguinte exemplo é um nome de arquivo de log:
ReportServerService__05_21_2019_00_05_07.log
O seguinte exemplo é uma mensagem de erro do arquivo de log de rastreamento relacionada a assinaturas:
- library!WindowsService_7!b60!05/20/2019-22:34:36 i INFO: Inicializando EnableExecutionLogging como “True” conforme especificado no sistema do Servidor properties.emailextension!WindowsService_7!b60!05/20/2019-22:34:41 ERROR: Erro ao enviar email. Exceção: System.Net.Mail.SmtpException: o servidor SMTP exige uma conexão segura ou o cliente não foi autenticado. A resposta do servidor foi: o cliente 5.7.1 não foi autenticado em System.Net.Mail.MailCommand.CheckResponse(SmtpStatusCode statusCode, String response)
O arquivo de log não informa se o relatório foi aberto ou se a entrega teve êxito. Entrega bem-sucedida significa que não houve erros gerados pelo Processador de Agendamento e Entrega e que o servidor de relatório se conectou ao servidor de email. Se o email resultou em um erro de mensagem que não pode ser entregue na caixa de correio do usuário, essa informação não é incluída no arquivo de log. Para obter mais informações sobre arquivos de log, consulte Fontes e arquivos de log do Reporting Services.
SharePoint
Para monitorar uma assinatura no modo do SharePoint: o status da assinatura pode ser monitorado na página Gerenciar Assinaturas .
Navegue até a biblioteca de documentos que contém o relatório.
Abra o menu de contexto do relatório ( ... ).
Selecione a opção de menu ampliado ( ... ).
Selecione Gerenciar assinaturas.
Arquivos de log do SharePoint ULS
As informações relacionadas a assinaturas são gravadas no log do SharePoint ULS. Para obter mais informações sobre como configurar eventos do Reporting Services para o log do ULS, confira Ativar eventos do Reporting Services para o log de rastreamento do SharePoint (ULS). A seguir está um exemplo de entrada de log ULS relacionado a assinaturas do Reporting Services.
| Data | Processo | Área | Categoria | Nível | Correlation | Mensagem |
|---|---|---|---|---|---|---|
| 5/21/2019 14:34:06:15 | Pool de Aplicativos: a0ba039332294f40bc4a81544afde01d | SQL Server Reporting Services | Extensão de email do servidor de relatório | Inesperado | (vazio) | Erro ao enviar email. Exceção: System.Net.Mail.SmtpException: Caixa de correio não disponível. A resposta do servidor foi: o cliente 5.7.1 não tem permissões para enviar como esse remetente no System.Net.Mail.DataStopCommand.CheckResponse(SmtpStatusCode statusCode, String serverResponse) em System.Net.Mail.DataStopCommand.Send(SmtpConnection conn) em System.Net.Mail.SmtpClient.Send(MailMessage message) em Microsoft.ReportingServices.EmailDeliveryProvider.EmailProvider.Deliver(Notification notification) |
Use o PowerShell para monitorar assinaturas
Por exemplo, scripts do PowerShell que você pode usar para verificar o status do modo nativo ou assinaturas de modo do SharePoint, confira Gerenciar Proprietários de Assinatura e Executar Assinatura – PowerShell.
Gerenciar assinaturas inativas
Se uma assinatura se tornar inativa, você deverá excluí-la ou reativá-la resolvendo as condições subjacentes que impedem que ela seja processada. As assinaturas podem se tornar inativas se ocorrerem condições que impeçam o processamento. Essas condições incluem:
Remoção ou desinstalação da extensão de entrega especificada na assinatura.
As configurações de credenciais mudam de valores armazenados para valores integrados ou solicitados.
Uma alteração no nome do parâmetro ou no tipo de dados na definição do relatório e republicação de um relatório. Se uma assinatura incluir um parâmetro que não seja mais válido, ela se tornará inativa.
O modo de execução de um relatório muda (por exemplo, modificar um relatório sob demanda para que ele seja executado como um instantâneo de execução de relatório). Para obter mais informações, consulte Definir as propriedades do processamento de relatórios.
Uma mensagem na própria assinatura indica uma assinatura inativa. A mensagem inclui informações sobre a causa e quais etapas você deveria executar para reativar a assinatura.
Quando as condições fazem com que a assinatura se torne inativa, a assinatura reflete esse fato quando o servidor de relatório executa a assinatura. Por exemplo, uma assinatura está agendada para entregar um relatório toda sexta-feira às 2h e a extensão de entrega usada foi desinstalada na segunda-feira às 9h. Nesse caso, a assinatura não reflete seu estado inativo até sexta-feira às 2h.