Alertas de dados do Reporting Services

Aplica-se a: SQL Server Reporting Services (2016) SQL Server Reporting Services (2017) SharePoint Servidor de Relatórios do Power BI

Para obter conteúdo relacionado a versões anteriores do SSRS (SQL Server Reporting Services), confira SQL Server 2014 Reporting Services.

Os alertas de dados do SQL Server Reporting Services são uma solução de alerta controlada por dados que ajuda você a se manter informado sobre os dados de relatório interessantes ou importantes, na hora certa. Usando dados de alerta você não precisa mais procurar informações, elas vêm até você.

As mensagens de alerta de dados são enviadas por email. Dependendo da importância das informações, você pode optar por enviar mensagens com maior ou menor frequência e somente quando os resultados forem alterados. Você pode especificar vários destinatários de email e, assim, manter os outros informados e aprimorar a eficiência e a colaboração.

Arquitetura de alertas de dados e fluxo de trabalho

A lista a seguir resume as áreas principais dos alertas de dados do Reporting Services:

• Definir e salvar definições de alerta de dados – você executa um relatório, cria regras que identificam valores de dados interessantes, define um padrão de recorrência para enviar a mensagem de alerta de dados e especifica os destinatários da mensagem de alerta.

• Executar definições de alerta de dados – o serviço de alerta processa as definições de alerta em um horário agendado, recupera dados de relatório e cria instâncias de alerta de dados com base nas regras da definição de alerta.

• Entregar mensagens de alerta de dados a destinatários – o serviço de alerta cria uma instância de alerta e envia uma mensagem de alerta aos destinatários por email.

Além disso, como proprietário do alerta de dados, você pode exibir informações sobre seus alertas de dados e excluir e editar suas definições de alerta de dados. Um alerta tem apenas um proprietário, a pessoa que o criou.

Administradores de alertas, usuários com permissão para Gerenciar Alertas do SharePoint podem gerenciar alertas de dados no nível do site. Eles podem exibir listas de alertas de cada usuário de site e excluir alertas.

Os alertas de dados do Reporting Services são diferentes dos alertas do SharePoint. Você pode definir alertas do SharePoint em qualquer tipo de documento, inclusive em relatórios. Os alertas do SharePoint são enviados quando o documento é alterado. Por exemplo, você adiciona uma coluna a uma tabela em um relatório. Em comparação, os alertas de dados são enviados quando os dados mostrados em um relatório atenderam as regras nas definições do alerta. Normalmente, as regras fazem referência a dados que são exibidos em um relatório.

Ao criar alertas de dados em relatórios, você pode monitorar as alterações nos dados de relatórios e enviar mensagens de alertas de dados por email quando os dados de relatório seguem regras que definem dados de interesse para você e outros usuários e em intervalos que atendem suas necessidades comerciais. Você também pode executar dados de alertas sob demanda. Se você tiver permissão de Criar Alerta do SharePoint, poderá criar alertas em qualquer relatório no qual tenha permissões de exibição. É possível criar vários alertas em um relatório, e vários usuários podem criar os mesmos ou alertas diferentes em um relatório. Para colaborar com outros usuários, você pode especificá-los como destinatários de mensagens de alerta nas definições de alertas de dados que você cria.

O diagrama a seguir mostra o fluxo de trabalho de criação e salvamento de uma definição de alerta de dados, da criação de um trabalho do SQL Agent para começar o processamento de uma instância do alerta de dados e do envio de mensagens de alertas de dados que contêm os dados de relatório que dispararam o alerta para um ou mais destinatários por email.

Relatórios com suporte de alertas de dados

Você pode criar alertas de dados em todos os tipos de relatórios profissionais que são escritos no idioma de definição de relatório (RDL) e criados no Designer de Relatórios ou no Construtor de Relatórios. Relatórios que incluem regiões de dados, como tabelas e gráficos, relatórios com sub-relatórios e relatórios complexos com vários grupos de colunas paralelos e regiões de dados aninhadas. Os únicos requisitos são o relatório incluir pelo menos uma região de dados de qualquer tipo e a fonte de dados de relatório ser configurada para usar credenciais armazenadas ou nenhuma credencial. Você não pode criar um alerta em um relatório que não tenha nenhuma região de dados.

Você não pode criar alertas de dados em relatórios criados com o Power View.

Ao instalar o Reporting Services no modo nativo ou no modo do SharePoint ou ao usar a versão autônoma do Construtor de Relatórios, você pode salvar relatórios em um servidor de relatório, em seu computador ou em uma biblioteca do SharePoint. Para criar alertas de dados em relatórios, os relatórios devem ser salvos ou carregados em uma biblioteca do SharePoint. Isso significa que você não pode criar alertas em relatórios salvos em um servidor de relatório no modo nativo ou em seu computador. Além disso, você não pode criar alertas inseridos em aplicativos personalizados.

O Reporting Services dá suporte a vários tipos de credenciais em relatórios. É possível criar alertas de dados em relatórios com fontes de dados configuradas para usar credenciais armazenadas ou nenhuma credencial. Você não pode criar alertas em relatórios configurados para usar credenciais de segurança integrada ou para solicitar credenciais. O relatório é executado como parte do processamento da definição de alerta e o processamento falha sem credenciais. Para saber mais, consulte os recursos a seguir:

• Especificar informações de credenciais e de conexão para fontes de dados de relatório

• Funções e permissões (Reporting Services)

• Autenticação com o servidor de relatório

Executar relatórios

A primeira etapa na criação de uma definição de alerta de dados é localizar o relatório desejado na biblioteca do SharePoint e depois executar o relatório. Não é possível criar um alerta em um relatório não contenha nenhum dado no momento.

Se o relatório for parametrizado, especifique os valores de parâmetros a serem usados quando você executar o relatório. Os valores de parâmetros são salvos nas definições de alertas de dados que você cria em um relatório. Os valores são usados quando o relatório é executado novamente como uma etapa no processamento da definição de alertas de dados. Se você quiser alterar os valores de parâmetros necessários para executar novamente o relatório com esses valores de parâmetros e criar uma definição de alerta nessa versão do relatório.

Criar definições de alertas de dados

O recurso de alertas de dados do Reporting Services inclui o Designer de Alertas de Dados, que você usa para criar definições de alertas de dados.

Para criar uma definição de alerta de dados, você executa o relatório e abre o Designer de Alertas de Dados do Visualizador de Relatórios do SharePoint no menu Ações . Os feeds de dados do relatório são gerados e as primeiras 100 linhas do feed de dados são exibidas em uma tabela de visualização de dados no Designer de Alertas de Dados. Todos os feeds de dados de um relatório são armazenados em cache enquanto você está trabalhando na definição de alerta no Designer de Alertas de Dados. O cache permite alternar rapidamente entre feeds de dados. Quando você reabre uma definição de alerta no Designer de Alertas de Dados, os feeds de dados são atualizados.

Definições de alertas de dados consistem em regras e cláusulas que os dados de relatório devem satisfazer para disparar uma mensagem de alerta de dados, um agendamento que define a frequência de envio da mensagem de alerta e, opcionalmente, as datas para iniciar e parar o envio da mensagem de alerta, informações como a linha de Assunto e uma descrição a ser incluída na mensagem de alerta e os destinatários da mensagem. Depois de criar uma definição de alerta, você a salva no banco de dados de alertas do SQL Server.

Salvar definições de alertas de dados e metadados de alerta

Quando você instala o Reporting Services no modo integrado do SharePoint, o banco de dados de alertas do SQL Server é criado automaticamente.

As definições de alertas de dados e os metadados de alerta são salvos no banco de dados de alertas. Por padrão, esse banco de dados é chamado ReportingServices<GUID>_Alerting.

Quando você salva a definição de alerta de dados, o alerta cria um trabalho do SQL Server Agent para a definição do alerta. O trabalho inclui um agendamento de trabalho. O agendamento se baseia no padrão de recorrência que você define na definição de alerta. A execução do trabalho inicia o processamento da definição de alerta de dados.

Processar definições de alerta de dados

Quando o agendamento do trabalho do SQL Server Agent inicia o processamento da definição de alerta, o relatório é executado para atualizar os feeds de dados de relatório. O serviço de alerta lê os feeds de dados e aplica as regras que as definições de alertas de dados especificam para os valores dos dados. Se um ou mais valores de dados satisfizerem as regras, uma instância de alerta de dados é criada e uma mensagem de alerta de dados com os resultados de alertas é enviada a todos os destinatários por email. Os resultados são linhas de dados de relatório que satisfizeram todas as regras no momento de criação da a instância de alerta. Para impedir várias mensagens de alerta com os mesmos resultados, você pode especificar que as mensagens somente sejam enviadas quando os resultados forem alterados. Nesse caso, uma instância alerta é criada e salva no banco de dados de alertas, mas nenhuma mensagem de alerta é gerada. Se um erro ocorrer, a instância de alerta também será salva no banco de dados de alertas e uma mensagem de alerta com os detalhes sobre o erro é enviada aos destinatários. A seção Diagnóstico e log têm posteriormente neste artigo tem mais informações sobre como registrar em log e solucionar problemas.

Enviar mensagens de alerta de dados

As mensagens de alerta de dados são enviadas por email.

A linha De contém um valor fornecido pela configuração de entrega de email do Reporting Services. A linha Para lista os destinatários que você especificou ao criar o alerta no Designer de Alertas de Dados.

Além da linha de Assunto de email, que você especifica no Designer de Alertas de Dados, a mensagem de alerta de dados inclui as seguintes informações:

• O nome da pessoa que criou a definição do alerta de dados.

• Se você forneceu uma descrição na definição de alerta, ela será exibida na parte superior do texto de email.

• Os resultados de alertas, consistindo nas linhas no feed de dados de relatório que satisfazem as regras especificadas na definição de alerta.

• Um link para o relatório no qual a definição de alerta se baseia.

• As regras na definição de alerta.

• Os parâmetros e valores que você usou para executar o relatório.

• Os valores contextuais de itens de relatório que estão fora das regiões de dados de relatório.

Se não for possível criar uma instância de alerta de dados ou mensagem de alerta de dados, uma mensagem de erro será enviada para todos os destinatários. Em vez dos resultados de alertas, a mensagem inclui uma descrição de erro.

Para obter mais informações, consulte Messagens de alerta de dados.

Instalar os alertas de dados

O recurso de alertas de dados está disponível apenas quando o Reporting Services está instalado no modo integrado do SharePoint. Quando você instala o Reporting Services no modo do SharePoint, a instalação cria automaticamente o banco de dados de alertas que armazena definições de alertas de dados e metadados de alertas, e duas páginas do SharePoint para gerenciamento de alertas, e adiciona o Designer de Alertas no site do SharePoint. Não há nenhuma etapa especial para execução, ou opções para definição de alertas durante a instalação.

Se você quiser saber mais sobre como instalar o Reporting Services no modo do SharePoint, inclusive o serviço compartilhado do Reporting Services, que é novo no SQL Server 2012 (11.x) e aplicativo do serviço Reporting Services que você deve criar e configurar para usar recursos do Reporting Services, confira Instalar o Reporting Services no Modo do SharePoint para SharePoint 2010 na biblioteca MSDN.

Como mostra o diagrama anterior deste artigo, os alertas de dados usam trabalhos do SQL Server Agent. Para criar os trabalhos, o SQL Server Agent deve estar em execução. Talvez você tenha configurado o SQL Server Agent para iniciar automaticamente quando instalou o Reporting Services. Se não, você pode iniciar o SQL Server Agent manualmente. Para obter mais informações, confira Configurar o SQL Server Agent e Iniciar, parar, pausar, retomar e reiniciar os serviços Mecanismo de Banco de Dados, SQL Server Agent ou SQL Server Browser.

Você pode usar a página Provisionar Assinaturas e Alertas na Administração Central do SharePoint para descobrir se o SQL Server Agent está sendo executado e criar e baixar scripts Transact-SQL personalizados que executa para conceder permissões ao SQL Server Agent. Se possível, gere também os scripts Transact-SQL usando o PowerShell. Para obter mais informações, consulte Provisionar assinaturas e alertas para aplicativos de serviço do SSRS.

Configurar alertas de dados

Desde o SQL Server 2012 (11.x), as configurações para recursos do Reporting Services, inclusive alertas de dados, são distribuídas entre o arquivo de configuração de servidor de relatório (rsreportserver.config) e um banco de dados de configuração do SharePoint sempre que você instala o Reporting Services no modo do SharePoint. Quando você cria o aplicativo de serviço como uma etapa na instalação e configuração do Reporting Services, o banco de dados de configuração do SharePoint é criado automaticamente. Para obter mais informações, consulte Arquivo de configuração RsReportServer.config e Arquivos de configuração do Reporting Services.

As configurações para alertas de dados do Reporting Services incluem os intervalos para limpar dados e metadados de alertas e o número de repetições ao enviar mensagens de alerta de dados por email. Você pode atualizar o arquivo de configuração e o banco de dados de configuração para usarem valores diferentes para configurações de alertas de dados

Você atualiza o arquivo de configuração do servidor de relatório diretamente. Você atualiza o banco de dados de configuração do SharePoint usando cmdlets do Windows PowerShell.

A tabela a seguir lista os elementos da configuração para alertas de dados e seus valores padrão, descrições e locais.

Por padrão, as configurações MaxRetries e SecondsBeforeRetry se aplicam a todos os eventos que os alertas de dados disparam. Se você quiser mais controle granular das repetições e de atrasos de repetições, poderá adicionar elementos a qualquer manipulador de eventos que especificar valores de MaxRetries e SecondsBeforeRetry diferentes.

Manipuladores de Eventos e Repetir

Os manipuladores de eventos são:

A tabela a seguir resume os manipuladores de eventos e quando a repetição é acionada:

(*) Erros de SMTP que disparam uma repetição:

• SmtpStatusCode.ServiceNotAvailable

• SmtpStatusCode.MailboxBusy

• SmtpStatusCode.MailboxUnavailable

Desabilitar alertas de dados

Para desabilitar o recurso de alerta de dados, atualize a seção Serviço do arquivo de configuração. O código a seguir mostra a seção Serviço do arquivo de configuração.

<Service>

<IsSchedulingService>True</IsSchedulingService>

<IsNotificationService>True</IsNotificationService>

<IsEventService>True</IsEventService>

<IsAlertingService>True</IsAlertingService>

...

</Service>

Para desabilitar o alerta, altere True para False em <IsAlertingService>True</IsAlertingService>.

Permissões para alertas de dados

Para poder criar alertas de dados em relatórios, você deve ter permissão para executar o relatório e para criar alertas no site do SharePoint. Para obter mais informações sobre permissões de relatório, consulte os seguintes artigos.

• Gerar feeds de dados de relatórios (Construtor de Relatórios e SSRS)

• Definir permissões para itens de servidor de relatório em um site do SharePoint (Reporting Services no modo integrado do SharePoint)

Os alertas de dados do Reporting Services oferecem suporte a dois níveis de permissão: operador de informações e administrador de alerta. A tabela a seguir lista as permissões e as tarefas do SharePoint relacionadas.

Diagnóstico e registro em log

Os alertas de dados fornecem muitas maneiras para ajudar os operadores de informações e administradores a manter o controle de alertas e a compreender porque houve falha de alertas e para ajudar os administradores a usar os logs de execução para saber quais mensagens de alerta foram enviadas para quem, o número de instâncias de alertas e assim por diante.

Gerenciador de Alertas de Dados

O Gerenciador de Alertas de Dados lista definições de alertas e informações de erro que ajudam os operadores de informações e os administradores de alertas a compreenderem porque ocorreu uma falha. Algumas razões comuns de falha incluem:

• O feed de dados do relatório foi alterado e as colunas que eram usadas nas regras da definição de alertas de dados não estão mais incluídas no feed de dados.

• A permissão para exibir o relatório foi revocada.

• O tipo de dados da fonte de dados subjacente foi alterado e a definição de alerta não é mais válida.

Logs

O Reporting Services fornece muitos logs que podem ajudá-lo a saber mais sobre os relatórios que são executados durante o processamento de definições de alertas de dados, as instâncias de alertas de dados que são criadas e assim sucessivamente. Três logs são particularmente úteis: o log de execução de alerta, o log de execução do servidor de relatório e o log de rastreamento do servidor de relatório.

Para obter informações sobre outros logs do Reporting Services, confira Fontes e arquivos de log do Reporting Services.

Log de execução de alerta

O serviço de runtime de alerta grava entradas na tabela ExecutionLogView do banco de dados de alertas. Você pode consultar a tabela ou executar os procedimentos armazenados a seguir para obter informações de diagnóstico mais sofisticadas sobre os alertas de dados salvos no banco de dados de alertas.

• ReadAlertData

• ReadAlertHistory

• ReadAlertInstances

• ReadEventHistory

• ReadFeedPollHistory

• ReadFeedPools

• ReadPollData

• ReadSentAlerts

Você pode usar o SQL Agent para executar o procedimento armazenado em uma agenda. Para obter mais informações, consulte SQL Server Agent.

Log de execução de servidor de relatório

Relatórios são executados para gerar os feeds de dados nos quais as definições de alertas de dados se baseiam. A conexão da execução do servidor de relatório com o banco de dados do servidor de relatório captura informações cada vez que o relatório é executado. Você pode consultar a exibição de ExecutionLog2 no banco de dados para obter informações detalhadas. Para obter mais informações, veja ExecutionLog do servidor de relatório e exibição do ExecutionLog3.

Log de rastreamento do 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 Servidor de Relatório, pelo Gerenciador de Relatórios e pelo processamento em segundo plano. 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. Para obter mais informações, consulte Report Server Service Trace Log.

Contadores de desempenho

Os alertas de dados fornecem seus próprios contadores de desempenho. Todos menos um contador de desempenho estão relacionados a um evento que faz parte do serviço de runtime de alerta. O contador de desempenho relacionado à fila de evento informa o comprimento da fila de todos os eventos ativos.

O Reporting Services fornece contadores de desempenho para outros recursos do Reporting Services. Para obter mais informações, consulte Contadores de desempenho para os objetos de desempenho do Serviço ReportServer, Contadores de desempenho para os objetos de desempenho do MSRS 2016 no modo nativo e Contadores de desempenho para os objetos de desempenho do MSRS 2016 no modo do SharePoint.

Suporte a TLS

O Reporting Services pode usar o serviço HTTP SSL para estabelecer conexões criptografadas com um servidor de relatório ou site do SharePoint. O protocolo TLS era anteriormente conhecido como protocolo SSL.

O serviço de runtime de alerta e a interface do usuário de alertas de dados dão suporte a TSL e funcionam de modo semelhante quer você use TSL ou HTTP. No entanto, há algumas diferenças sutis. Quando a definição de alerta de dados é criada usando uma conexão TSL, a URL associada à biblioteca do SharePoint da mensagem de alerta de dados também usa TSL. Você pode identificar a conexão TSL porque ela usa HTTPS, em vez de HTTP em sua URL. De modo semelhante, se a definição de alerta de dados foi criada usando uma conexão HTTP, o link para o site do SharePoint usa HTTP. Se a definição de alerta foi criada usando TSL ou HTTP, a experiência para usuários e administradores de alertas será idêntica ao uso do Designer de Alerta de Dados ou do Gerenciador de Alertas de Dados. Se o protocolo (HTTP ou TSL) for alterado entre a hora em que a definição de alerta foi criada e atualizada e salva novamente, o protocolo original será mantido e usado em URLs de link.

Se você criar um alerta de dados em um site do SharePoint que está configurado para usar o TSL e, em seguida, remover o requisito de TSL, o alerta continuará funcionando no site. Se o site for excluído, o site de zona padrão será usado.

Interface do usuário de alerta de dados

Os alertas de dados fornecem páginas do SharePoint para o gerenciamento de alertas e um designer para criação e edição de definições de alertas de dados.

• Designer de Alertas de Dados no qual você cria ou edita definições de alertas de dados. Para obter mais informações, consulte Designer de Alertas de Dados, Criar um Alerta de Dados no Designer de Alertas de Dados e Editar um Alerta de Dados no Designer de Alertas.

• Gerenciador de Alertas de Dados no qual você exibe listas de alertas de dados, exclui alertas e abre alertas para edição. O Gerenciador de Alertas de Dados é fornecido em duas versões: uma para os usuários gerenciarem os alertas que criam e uma para os administradores gerenciarem os alertas que pertencem aos usuários do site.

  Para obter mais informações sobre como gerenciar alertas de dados que você criou, consulte Gerenciador de Alertas de Dados para Usuários do SharePoint e Gerenciar meus alertas de dados no Gerenciador de Alertas de Dados.

  Para obter mais informações sobre como gerenciar todos os alertas de dados em um site, consulte Gerenciador de Alertas de dados para administradores de alertas e Gerenciar todos os alertas de dados em um site do SharePoint no Gerenciador de Alertas de Dados.

• Provisione assinaturas e alertas de dados nos quais você descobre se os Reporting Services podem usar o SQL Server Agent para alertas de dados e scripts de download que permitem acesso ao SQL Server Agent. Para obter mais informações, consulte Provisionar assinaturas e alertas para aplicativos de serviço do SSRS.

Globalização de alertas de dados

Certos scripts, como Árabe e Hebraico, são escritos da direita para a esquerda. Os dados de alertas oferecem suporte para scripts da direita para a esquerda e da esquerda para a direita. Os dados de alerta detectam a cultura e alteram a aparência e o comportamento da interface do usuário e o layout de mensagens de alertas de dados de acordo. A cultura é derivada da configuração regional do sistema operacional no computador do usuário. A cultura é salva cada vez que você atualiza e salva novamente a definição de alerta de dados.

A cultura na definição de dados pode afetar se os dados atendem às regras na definição de alerta. Comparações de cadeias de caracteres geralmente são afetadas pelas regras específicas de cultura.

A determinação se os dados de relatório satisfazem a definição de alerta pode ser afetada pela cultura na definição de alerta. Esse evento ocorre mais comumente em cadeias de caracteres. Por exemplo, em uma definição de alerta com a cultura alemã, uma regra que compara a letra "o" em inglês e a letra "ö" em alemão não seria satisfeita. Na mesma definição de alerta que usa a cultura inglesa, a regra seria satisfeita.

A formatação de dados também se baseia na cultura da definição de alerta. Por exemplo, se a cultura usar um período como o símbolo decimal, o valor será exibido como 45.67; enquanto uma cultura que usa uma vírgula como o símbolo decimal, exibe 45,67.

Dependendo da interface do usuário de alerta de dados que você usar, o suporte para itens da direita para a esquerda variará. O Designer de Alerta de Dados oferece suporte para o script da direita para a esquerda em caixas de texto, mas o layout do designer não é da direita para a esquerda. Seu layout é da esquerda para a direita, assim como outras ferramentas. Se uma definição de alerta for criada com orientação da direita para a esquerda e editada em um ambiente da esquerda para a direita, a orientação de texto da direita para a esquerda será preservada quando você salvar a definição de alerta. O Gerenciador de Alertas de Dados se comporta da mesma forma que uma página do SharePoint. Seu layout é da direita para esquerda, assim como outras páginas do SharePoint. Mensagens de alertas de dados se baseiam em definições de alerta da direita para a esquerda, exibem texto de mensagem da direita para a esquerda e o layout de mensagem é da esquerda para a direita.

Próximas etapas

• Salvar um relatório em uma biblioteca do SharePoint (Construtor de Relatórios)

• Criar um alerta de dados no Designer de alertas de dados

• Editar um alerta de dados no Designer de alertas

• Gerenciar Meus alertas de dados no Gerenciador de alertas de dados

• Gerenciar todos os alertas de dados em um site do SharePoint no gerenciador de alertas de dados

• Conceder permissões a usuários e administradores de alerta

Conteúdo relacionado

• Designer de Alertas de Dados
• Gerenciador de alertas de dados para os administradores de alerta
• Gerenciador de Alertas de Dados para usuários do SharePoint

Mais perguntas? Experimente perguntar no fórum do Reporting Services.