Uma notificação de falha com um único código ilegível, ao lado de um painel que continua mostrando o número antigo

É noite do dia 5, véspera do pagamento de comissões. A analista de departamento pessoal precisa do ranking de vendedores fechado para conferir a folha às 8h.

O fluxo de dados que alimenta o modelo falhou às 22h, depois de seis minutos rodando. O histórico de atualização mostra a palavra Error, um Request ID e um Activity ID. Nenhuma linha diz qual tabela, qual origem ou o que deu errado.

O analista de BI que publicou o modelo recebe o e-mail de falha, como manda o padrão do Power BI. Só que o aviso não diz o que fazer, e o painel continua aberto com o número de ontem, sem dizer que é de ontem.

Neste artigo, explicamos o que o Power BI avisa, por que o erro chega opaco, o que um aviso de falha precisa trazer e quando vale parar de tentar.

Como o Power BI avisa a falha de atualização

O Power BI avisa, e avisa por padrão. Pela documentação da Microsoft, a falha de atualização agendada gera um e-mail para o dono do modelo semântico, e um alerta no app do celular se ele usa o app.

  • Contatos adicionais. O campo Email these contacts when the refresh fails aceita outros endereços, inclusive o alias de um time. Alias de grupo recebe e-mail, mas não recebe alerta no celular.
  • Desligamento por falhas seguidas. Depois de quatro falhas consecutivas, o serviço desliga o agendamento e manda um e-mail avisando. Esse limite não é configurável.
  • Erro que não se resolve sozinho. Credencial vencida ou inválida desliga o agendamento na hora, sem esperar a quarta falha.
  • Atualização manual não avisa. A atualização sob demanda e a disparada pelo Power Automate não geram e-mail de falha.

O desenho é razoável. O problema está em dois pontos que ele não cobre: quem é o dono do modelo hoje, e o que a mensagem diz.

O aviso chega. O que falta é o conteúdo dele.

Por que o erro chega como um Request ID

No fórum do Power BI, em 30 de setembro, um usuário relatou exatamente a cena da abertura. O fluxo de dados parou depois de seis minutos, com a mensagem de erro composta só por um Request ID e um Activity ID. O fluxo funcionava havia meses e, naquela manhã, simplesmente parou.

O Request ID não é uma explicação. É o número que o suporte da Microsoft usa para achar a execução nos registros do serviço. Para quem abre o histórico, ele diz que algo falhou, mas não diz se foi a origem, o gateway, a credencial ou a capacidade.

E quando a falha some sozinha, o diagnóstico some junto. O analista não sabe se precisa mexer em algo ou só esperar, e a próxima falha começa do mesmo lugar. A mensagem não ajuda nem a decidir se vale abrir um chamado.

Um identificador ajuda o suporte. Não ajuda quem está de plantão.

Cinco coisas que um aviso de falha precisa trazer

O aviso existe para alguém agir antes de outra pessoa abrir o painel. Para isso, ele precisa responder às perguntas que o analista faria primeiro.

  • Onde falhou. Qual tabela, qual etapa, qual origem. "O modelo de vendas falhou" obriga a abrir cinco telas.
  • O erro da origem em texto. A mensagem que o banco ou a API devolveu, e não só o código interno do serviço que chamou.
  • Um link direto para a execução. O caminho mais curto entre o e-mail e o detalhe técnico vale mais que qualquer parágrafo explicativo.
  • Desde quando o dado está velho. A última execução que deu certo diz quanto do painel ainda vale.
  • O que acontece a seguir. Se haverá nova tentativa, quando, e quantas faltam até o agendamento ser desligado.

Nenhum desses itens exige ferramenta nova. Eles exigem que a falha seja registrada no lugar onde ela acontece, e não só onde ela é percebida.

Falha bem descrita é meio caminho resolvido.

Repetir ou parar: o que custa cada escolha

Falha passageira e falha de configuração pedem respostas opostas. A passageira — rede, gateway reiniciando, origem ocupada — costuma passar na tentativa seguinte. A de configuração, como senha trocada, vai falhar todas as vezes.

Tentar de novo sem limite tem custo. Cada tentativa ocupa a origem, a capacidade e, em ferramenta cobrada por uso, a franquia. Parar cedo demais também custa: o painel fica velho por uma falha que se resolveria sozinha.

Exemplo prático

No Power BI Pro, que roda em capacidade compartilhada, o modelo pode ter até oito horários de atualização por dia. Com atualização a cada três horas, a quarta falha seguida chega nove horas depois da primeira. Se a primeira é às 22h do dia 5, o agendamento só é desligado às 7h do dia 6, uma hora antes da conferência da folha.

A regra de parar não resolve nada sozinha. Ela só é útil se o aviso de desligamento chegar a quem consegue agir naquela noite.

Parar é bom. Parar sem ninguém saber, não.

Quem deve receber o aviso de falha

O dono do modelo é quem publicou ou assumiu o modelo por último. Em time de uma ou duas pessoas, isso muda nas férias, na troca de emprego e no dia em que alguém republica o arquivo da própria máquina.

Por isso o campo de contatos adicionais importa. Um alias do time garante que o e-mail chega mesmo quando o dono está fora. O celular de plantão precisa estar na lista individualmente, porque o alerta no app não vai para alias.

Vale também avisar quem depende do número. A analista de departamento pessoal não vai consertar o fluxo de dados, mas pode decidir esperar em vez de conferir a folha com o ranking de ontem.

Aviso que chega à pessoa errada é silêncio.

Onde o Januss entra

No Januss, a falha é registrada no pipeline, onde ela acontece. O e-mail de falha traz o erro em texto e diz qual falha seguida é aquela, e quando o pipeline volta a dar certo chega outro e-mail, de recuperação. Se o Runner instalado na sua rede para de responder, também há aviso.

Os e-mails vão para todos os usuários da conta, e não só para quem criou o pipeline. É a resposta do Januss à pergunta da seção anterior, com o custo de não haver escolha por pessoa.

Na tela inicial, o painel "Precisa de atenção" lista as pipelines cuja última execução falhou, com o caminho para os detalhes técnicos. O histórico mostra, por execução, status, gatilho, duração, etapas que falharam e linhas.

Depois de três falhas agendadas seguidas, o pipeline se desliga sozinho, e o e-mail avisa que isso aconteceu. Como no Power BI, a execução manual não gera aviso. Os avisos do Januss são por e-mail.

O Januss avisa sobre o pipeline, não sobre o refresh do Power BI. Se o dado chegou ao destino e o gateway falhou depois, quem avisa continua sendo o Power BI.

Quer ver como chega o aviso de uma falha de verdade? O teste de 14 dias não pede cartão. Crie seu ambiente de teste no Januss.

Fontes

O comportamento das notificações vem da documentação da Microsoft e do fórum oficial do Power BI:

Crie seu workspace em minutos.

Aponte para a sua origem e veja o dado chegando ao banco no mesmo dia.

Criar workspace 14 dias · sem cartão de crédito