Alertas e Notificações
Alertas
Gestor de alertas ▸ Alertas lista os alertas gerados pelas suas regras. Abrir no Mirox Por predefinição vê o que está disparado neste momento; dois interruptores alargam a lista:
- Mostrar resolvidos — acrescenta os alertas que terminaram, como histórico.
- Mostrar silenciados — acrescenta os alertas que um silenciamento retém. Os alertas silenciados estão ocultos por predefinição, disparados ou resolvidos, para que a lista mostre o que alguém ainda tem de ver; a Visão geral conta-os à parte dos alertas disparados como + N silenciados.
Cada alerta mostra o seu nível, a regra, a central, o componente (nas regras avaliadas por componente), o valor e desde quando — ou de quando até quando — esteve disparado; as datas e horas seguem as definições de idioma e região do seu navegador. A central e o componente são ligações para as suas páginas. Um alerta de uma regra avaliada sobre o total da central oferece Que componentes?: reproduz a regra por componente no período do alerta e lista quais estiveram por trás. Um alerta que um silenciamento retém fica marcado como Silenciado.
Um alerta resolve-se por si quando a condição deixa de se verificar, quando a regra é desativada, alterada de modo que já não corresponda, ou eliminada. Os alertas resolvidos permanecem na lista como histórico.
Quem foi notificado, quem o viu
Notificados e Visto por nos detalhes do alerta mostram quem a plataforma notificou do alerta e quando, e quem o abriu desde então — abrir os detalhes regista-o aí. Não há nada a confirmar: um alerta termina por si quando a condição deixa de se verificar.
Silenciar um alerta a partir dos seus detalhes
Silenciar este alerta nos detalhes do alerta mantém exatamente este alerta calado sem abrir o separador Silenciamentos. Escolha durante quanto tempo — 1 h, 4 h (a predefinição), 8 h, 24 h, 3 d ou 7 d — e é criado um silenciamento para esta regra, esta central e este componente (o total da central quando o alerta abrange toda a central). O alerta é marcado de imediato como Silenciado e ninguém é notificado enquanto o silenciamento durar. Se o alerta ainda estiver disparado quando o silenciamento termina, é notificado nesse momento — o silenciamento adia, não engole. Um alerta que já tinha sido notificado antes de ser silenciado continua a enviar o seu aviso de resolução. Os detalhes ligam ao silenciamento em Abrir os silenciamentos, onde pode ser prolongado, alargado ou removido.
As alterações a regras e silenciamentos também aparecem na atividade da sua organização.
Quem é notificado
Quando um alerta se abre, todas as pessoas da sua organização que têm acesso à central são notificadas — na app, por push na app móvel e por e-mail, exatamente como cada pessoa escolheu nas suas próprias definições de notificação no grupo Gestor de alertas. Aí cada pessoa escolhe os canais e o nível mínimo a partir do qual quer ser informada sobre estes alertas; por predefinição é Normal.
Quando o alerta se resolve, as pessoas que foram notificadas recebem um aviso de resolução. A notificação liga diretamente ao alerta.
Silenciamentos
Um silenciamento mantém as notificações afastadas durante algum tempo — para manutenção, um problema conhecido ou uma paragem planeada. Os alertas correspondentes continuam a abrir e a fechar e são registados, marcados como Silenciado (e ocultos do separador Alertas até Mostrar silenciados); apenas as notificações e os destinatários ficam calados.
Abra Gestor de alertas ▸ Silenciamentos e clique em Novo silenciamento. Abrir no Mirox Escolha:
- Regra — uma regra ou todas as regras.
- Central — uma central ou todas as centrais.
- Início — agora ou num momento planeado.
- Durante — de 1 hora até 1 ano, ou Até uma data… para uma data de fim livre (no máximo um ano após o início).
- Comentário — o motivo, para que os seus colegas saibam.
Enquanto escolhe, a caixa de diálogo conta em direto quantos alertas abertos correspondem — N alertas abertos seriam silenciados agora — para que veja o que o silenciamento vai reter antes de o criar. Um silenciamento que começa agora retém de imediato os alertas abertos correspondentes.
A tabela mostra para cada silenciamento a sua regra, central, início e fim, comentário e estado — Ativo, Agendado ou Encerrada — e Retém: o número de alertas abertos que o silenciamento retém neste momento.
Um silenciamento pode ser editado a partir da sua linha (Editar): regra, central, início, fim e comentário. A alteração aplica-se de imediato — os alertas que o silenciamento passa a abranger deixam de notificar, os que já não abrange voltam a notificar a partir da próxima avaliação. Um silenciamento criado a partir de um único alerta abrange apenas o componente desse alerta (ou o total da central); em Componente pode ser alargado a Todos os componentes da regra e da central, mas não restringido a outro componente.
Um silenciamento termina por si. Remova-o mais cedo com Remover — os alertas correspondentes voltam a ser notificados a partir da próxima avaliação, incluindo os disparados neste momento. Os silenciamentos são criados, editados e removidos por Administradores, Moderadores e pelas duas funções de Gestor de ativos.
Destinatários
Um destinatário recebe automaticamente cada alerta das regras a que está associado — um sistema de tickets, um canal de equipa ou uma caixa de correio partilhada. As pessoas não precisam de um destinatário; são, de qualquer forma, notificadas através das suas próprias definições. Dois tipos cria-os você mesmo, Webhook e E-mail; um comercializador direto configurado em Organização torna-se destinatário por si só — consulte Comercializador direto.
Abra Gestor de alertas ▸ Destinatários e clique em Novo destinatário Abrir no Mirox, e depois associe-o a regras em Destinatários no separador Notificação do editor de regras. Enviar teste entrega um alerta de exemplo — com uma comunicação de indisponibilidade de exemplo dentro — para que possa verificar a ligação e o seu modelo; um comercializador direto oferece em vez disso Testar início de sessão, que inicia sessão no serviço web do comercializador. Um destinatário pode ser editado depois a partir do menu da sua linha (Editar): o nome, os endereços ou o endereço e o modelo do webhook, e se a resolução também é enviada (Enviar também a resolução); só o seu tipo é fixo. Renovar o segredo de assinatura emite um novo segredo de webhook, mostrado uma única vez como na criação. Um destinatário desativado após falhas de entrega repetidas (etiqueta Desativado) é novamente ligado com Reativar. O destinatário de um comercializador direto é gerido em Organização ▸ Comercializadores diretos; no separador Destinatários oferece apenas Testar início de sessão e o seu interruptor de ativo. Na tabela de regras cada destinatário aparece como um chip; ao passar o rato vê o nome do destinatário e o modelo com que envia (um destinatário de e-mail sem modelo: Texto integrado).
Uma lista de endereços de e-mail. Cada alerta e a sua resolução chegam como um e-mail.
Webhook
Um endereço HTTPS mais um modelo: o endereço recebe um POST por cada alerta e a sua resolução, com a forma que lhe dá o modelo do destinatário — o método, os cabeçalhos e o corpo. O destinatário recebe um dos modelos de webhook da sua organização — o diálogo lista-os, ao criar o destinatário e ao editá-lo; se ainda não existir nenhum, crie primeiro um em Modelos. Os exemplos aí cobrem Microsoft Teams, Slack e Discord, além do seu próprio JSON, XML e CSV: o exemplo JSON genérico (envelope assinado) — o alerta completo em JSON, veja abaixo — é a base para sistemas de tickets e para a sua própria automatização; Cartão do Microsoft Teams, Mensagem do Slack e Embed do Discord são mensagens já prontas para um webhook de entrada desses serviços, cujo endereço é então o endereço do destinatário (Slack hooks.slack.com/services/…, Discord discord.com/api/webhooks/…, Teams Workflows *.environment.api.powerplatform.com ou *.logic.azure.com — consulte Ligar o Microsoft Teams para saber como criar um). Um webhook do Teams Workflows recusa um cabeçalho Authorization — não adicione nenhum a um modelo para o Teams.
Ao criar um destinatário webhook, o seu segredo de assinatura é mostrado uma única vez. Cada pedido é assinado: traz o cabeçalho X-Mirox-Signature: sha256=<hex> — o HMAC-SHA256 do corpo bruto do pedido com esse segredo — mais X-Mirox-Timestamp e um X-Mirox-Delivery-Id único, juntamente com os cabeçalhos próprios do modelo, seja qual for o endereço. Verifique a assinatura antes de confiar num pedido e use o id de entrega para ignorar uma entrega repetida. Os serviços de chat como Teams, Slack e Discord simplesmente ignoram os cabeçalhos X-Mirox-*.
O corpo do modelo já pronto JSON genérico (envelope assinado):
{
"version": "1",
"status": "firing",
"event_id": "1216448682925686786",
"rule_uid": "A1B2C3D4E5F6",
"rule_name": "Inverter without power",
"rule_version": 3,
"priority": "high",
"park_uid": "0A1B2C3D4E5F",
"park_name": "Plant North",
"instance_key": "inverter_id=7",
"labels": { "inverter_id": "7" },
"component": "Inverter 7",
"metric": "AC power per inverter",
"value": 0.0,
"unit": "W",
"op": "lt",
"threshold": 10.0,
"condition_since": 1791200400,
"title": "[FIRING] Inverter without power — Plant North (Inverter 7)",
"body": "Inverter 7 delivers only 0 W (limit 10 W)",
"link": "https://service.mirox.io/#/alertmanager?tab=alerts&alert=1216448682925686786",
"sent_at": "2026-10-06T09:05:12+00:00"
}
status é firing ou resolved; uma resolução repete o alerta com o último valor avaliado. condition_since é um carimbo de data/hora Unix. Podem ser acrescentados campos em versões posteriores — ignore o que não conhecer. event_id é uma cadeia de caracteres — o identificador é mais longo do que um número JavaScript consegue representar com exatidão.
Após repetidas falhas de entrega, um destinatário é desativado e marcado como Desativado; verifique o endereço e, depois, reative-o com Reativar no menu da sua linha.
Que endereços a Mirox chama
A Mirox liga-se a um endereço de webhook apenas por HTTPS na porta 443, e apenas se o endereço corresponder a um endereço IP público. Outras portas (como 8443), http:// sem cifragem e endereços privados ou internos (10.x, 172.16–31.x, 192.168.x, localhost e semelhantes) são recusados. Se o seu endpoint escuta noutra porta ou só é acessível dentro da sua rede, coloque à frente um proxy inverso acessível publicamente na porta 443 — ou contacte o nosso suporte se isso não for possível.
Comercializador direto
Um comercializador direto configura-se uma única vez em Organização ▸ Comercializadores diretos Abrir no Mirox: um nome, o protocolo que fala — hoje a interface BWE de indisponibilidades; Pedir outro protocolo envia-nos o nome da norma que o seu comercializador usa —, os endereços do serviço web e de início de sessão, as credenciais emitidas pelo comercializador e as horas de antecedência com que quer receber uma indisponibilidade (2 por omissão, de 1 a 48). Cada linha termina com um menu …: Editar, Testar início de sessão, Destinatário no Gestor de alertas e Eliminar. Testar início de sessão inicia sessão no comercializador e mostra quantas centrais ele atribuiu à sua conta; nunca comunica uma indisponibilidade. Uma central eólica escolhe o comercializador através do qual vende na sua página Indisponibilidade — consulte Indisponibilidade e Comercializador Direto.
Que endereços a Mirox chama
A Mirox liga-se aos endereços do serviço web e de início de sessão do comercializador apenas por HTTPS na porta 443, e apenas se corresponderem a um endereço IP público. Outras portas (como 8443), http:// sem cifragem e endereços privados ou internos são recusados. Se o serviço do seu comercializador só for acessível noutra porta, peça-lhe um endereço na porta 443 — ou contacte o nosso suporte.
O comercializador torna-se automaticamente um único destinatário no Gestor de alertas, com o seu nome. Não pode ser criado a partir de Novo destinatário (esse diálogo só oferece webhook e e-mail) e nunca existe duas vezes; renomear ou desativar o comercializador reflete-se no destinatário, eliminar o comercializador remove-o, e configurá-lo de novo traz o destinatário de volta. No separador Destinatários a linha é só de leitura — Gerido em Organização ▸ Comercializadores diretos — exceto Testar início de sessão e o seu interruptor de ativo, ambos reservados a Administradores e Moderadores. Não tem modelo: o protocolo dita o que o comercializador recebe.
A regra comunica a indisponibilidade. Numa regra que vigia uma a uma as turbinas de uma central eólica (avaliada em cada componente de uma métrica de turbina), o separador Notificação oferece o interruptor Comunicar indisponibilidades. Com ele ligado, cada alerta de turbina ativo da regra é uma indisponibilidade dessa turbina desde o momento em que abre: um início, comunicado com as horas de antecedência; uma prorrogação cerca de cada metade dessas horas enquanto o alerta continuar ativo; e o fim, encurtado para o fim real, quando se resolve. Junto ao interruptor escolhe o motivo da indisponibilidade — Manutenção, Ordem administrativa, Operador de rede ou Comercializador direto — e a potência restante: Paragem total (0 kW) ou o valor medido, o valor de potência do alerta limitado à potência nominal da turbina, para uma regra sobre uma métrica de potência. Use Operador de rede e Comercializador direto apenas quando a origem da limitação for certa — contam como limitações compensadas na liquidação; os outros dois reduzem a disponibilidade da turbina. As horas de antecedência são as do comercializador da central quando a regra lhe comunica, caso contrário 2. O interruptor fica forçado e mostrado bloqueado enquanto o destinatário do comercializador estiver associado; uma regra avaliada sobre o total da central não o oferece e nunca é comunicada. Também uma central que outra organização partilha consigo por cooperação pode ser comunicada: cada organização comunica com as suas próprias regras e o seu próprio comercializador direto, independentemente do proprietário da central — a regra designa o comercializador pelo seu destinatário.
Cada destinatário da regra recebe os três momentos — início, prorrogação e fim — e nada mais: o seu próprio destinatário de e-mail ou webhook recebe-os renderizados pelo seu modelo com as variáveis outage.* (ou como texto integrado sem modelo), e o destinatário do comercializador recebe-os através do seu protocolo, enviados pelo agente da central. Uma regra que comunica indisponibilidades não envia ainda aos seus destinatários as mensagens habituais de disparo e resolução; as pessoas da sua organização são notificadas como sempre, e um teste de alertas nunca comunica uma indisponibilidade.
É assim que testa primeiro e muda depois: construa a regra com o seu próprio destinatário de e-mail ou webhook e veja início, prorrogação e fim chegarem à sua caixa de correio ou ao seu endpoint — exatamente o que o comercializador receberia. Quando estiver satisfeito, abra o separador Notificação da regra, retire o seu destinatário (ou mantenha-o) e adicione o destinatário do comercializador. Nada mais muda — a regra, o motivo, a potência restante e as horas de antecedência mantêm-se; a partir da passagem seguinte, a central comunica ao comercializador cada indisponibilidade aberta, desde o seu início original.
Que centrais chegam ao comercializador decorre das centrais: uma central comunica através do comercializador associado na sua página Indisponibilidade, pelo que o destinatário do comercializador comunica exatamente as centrais da regra associadas a ele. Para uma central associada a outro comercializador ou a nenhum, a indisponibilidade é registada no registo da central e enviada aos seus próprios destinatários, mas a nenhum comercializador — o editor de regras indica essas centrais no separador Notificação. Também diz quando o agente de uma central ainda precisa de uma atualização para as comunicações de indisponibilidade: até lá os destinatários da regra recebem o próprio alerta, como numa regra normal.
Os modelos do sistema para turbinas vêm com o interruptor ligado e associam o destinatário do seu comercializador quando os adota — consulte Exemplos. Na central, as indisponibilidades aparecem no registo Indisponibilidade como Comunicada por alarme, e o cartão Comunicado em direto por alarme no separador Comercializador direto da central lista cada regra que comunica a central — regra, motivo, potência restante, horas de antecedência e se chega ao comercializador — com a etiqueta Inativa para uma regra desativada.
O que foi entregue
Os detalhes de um alerta listam as suas Entregas: uma linha por destinatário e momento — disparo ou resolução numa regra normal, início, prorrogação ou fim numa comunicação de indisponibilidade — com a hora e se foi enviada, falhou (com o erro) ou foi ignorada, e porquê: um silenciamento, o destinatário desativado, resoluções não desejadas, a comunicação de indisponibilidade no lugar da mensagem de alerta ou — numa resolução — que o próprio alerta nunca chegou ao destinatário. Quando uma regra abre muitos alertas de uma vez (uma regra sobre cada uma de centenas de strings ao anoitecer), as suas notificações e mensagens a destinatários pausam após os quatro primeiros numa hora, durante 30 minutos, e as pessoas recebem em vez disso um resumo; um alerta que nunca foi enviado a um destinatário também não lhe envia uma resolução. No destinatário do comercializador a linha mostra o que a central comunicou e a janela que cobre. Quando um destinatário falha, a sua organização recebe o evento Destinatário com falhas, dirigido aos Admins e Moderadores e aos autores das regras que usam o destinatário; após dez entregas falhadas seguidas o destinatário é desativado (Destinatário desativado), e o evento fecha-se por si só assim que uma entrega volta a ter sucesso — corrija a causa e depois Reative o destinatário a partir do menu da sua linha. O destinatário do comercializador comunica da mesma forma o estado da ligação ao comercializador.
Modelos
Um modelo define exatamente o que um destinatário envia, para que cada sistema receba o formato que espera: num webhook o método (POST, PUT ou PATCH), seus próprios cabeçalhos e o corpo em JSON, XML, CSV, HTML, texto simples ou dados de formulário; num e-mail o assunto e o texto (texto simples ou seu próprio HTML). O destinatário de um comercializador direto não tem modelo — o seu protocolo dita a comunicação; o que uma regra que comunica indisponibilidades envia aos seus destinatários de e-mail e webhook é definido pelos modelos deles, com as variáveis outage.*. Você escreve texto fixo e insere variáveis do alerta, da regra, da usina e do componente. Um modelo é reutilizável: vários destinatários podem usar o mesmo, e uma alteração vale para todos de uma vez.
Abra Gestor de alertas ▸ Destinatários Abrir no Mirox: abaixo dos destinatários estão seus modelos e os exemplos para começar. Usar exemplo copia um para sua organização; Novo modelo começa vazio. Os modelos de webhook já prontos — o JSON genérico (envelope assinado) e as mensagens de chat para Microsoft Teams, Slack e Discord — iniciam-se a partir dos exemplos como qualquer outro; o diálogo do destinatário lista apenas os modelos da sua organização. O modelo abre no editor: à esquerda as configurações, os cabeçalhos e o corpo, no meio a lista de variáveis — um clique insere a variável no cursor — e à direita a pré-visualização ao vivo: a requisição ou o e-mail exatamente como seria enviado, com o alerta de exemplo ou um dos seus alertas recentes, com todos os erros e avisos. Depois escolha o modelo para um destinatário — ao criá-lo ou com o botão de modelo na sua linha. Um destinatário webhook envia sempre com um modelo; um destinatário de e-mail sem modelo envia o texto integrado.
A moldura de e-mail Mirox é uma escolha sua. Um modelo de e-mail de texto tem o interruptor Enviar dentro da moldura de e-mail Mirox (ligado por defeito): ligado, o seu texto é colocado no e-mail Mirox — cabeçalho, um botão para o alerta, rodapé e «mirox |» à frente do assunto; desligado, assunto e texto saem exatamente como gerados, sem nada acrescentado. Um modelo HTML é sempre enviado tal como está. A pré-visualização é sempre o e-mail tal como chega — com a moldura mostra o e-mail emoldurado completo — e oferece, ao lado do alerta de exemplo e dos seus alertas recentes, mais três fontes: uma comunicação de indisponibilidade de exemplo no início, na prorrogação e no fim, para verificar um modelo de uma regra que comunica indisponibilidades com todos os campos preenchidos. Sob a pré-visualização uma nota diz se o grupo de indisponibilidade mostrado foi comunicado pelo gémeo digital ou derivado do alerta, e que campos ficam vazios nesse caso.
Os modelos são criados, duplicados, alterados e eliminados por Administradores, Moderadores e pelas duas funções de Gestor de ativos; todos os membros podem vê-los. Um modelo marcado como Privado só é alterado pelo seu criador, por um Administrador ou por um Moderador — consulte Privado. Um modelo usado por um destinatário não pode ser excluído — escolha antes outro para esse destinatário.
A linguagem dos modelos
| Escreva | Significado |
|---|---|
Variável: {{plant.name}} | o valor, p. ex. o nome da usina |
Filtro: {{alert.since|date:"DD.MM.YYYY HH:mm"}} | o valor, formatado |
Seção: {{#alert.firing}}…{{/alert.firing}} | a parte entre elas só quando o valor existe — numa lista, uma vez por item |
Seção invertida: {{^component.name}}…{{/component.name}} | a parte entre elas só quando o valor está vazio |
Comentário: {{! … }} | nada — uma nota para você |
Chaves literais: \{{ | {{ como texto |
Dentro de uma seção de lista estão disponíveis {{@index}} (a partir de 0), {{@number}} (a partir de 1), {{@first}} e {{@last}} — por exemplo {{^@last}},{{/@last}} coloca uma vírgula entre os itens. Uma variável inexistente fica vazia e a pré-visualização a mostra como aviso. Nada é executado num modelo; ele só produz texto.
Variáveis
| Variável | Significado |
|---|---|
{{alert.id}} | ID do alerta (texto) |
{{alert.status}} | firing (disparado) ou resolved (resolvido) |
{{alert.firing}} | Verdadeiro enquanto o alerta está disparado (use como seção) |
{{alert.resolved}} | Verdadeiro no aviso de resolução |
{{alert.level}} | Nível: very_low, low, normal, high, very_high, critical |
{{alert.title}} | O título pronto de uma linha |
{{alert.text}} | A mensagem pronta de uma linha |
{{alert.summary}} | O resumo da própria regra, se houver |
{{alert.value}} | O valor avaliado (o último na resolução) |
{{alert.value_label}} | O valor com unidade, como no Mirox |
{{alert.value_kw}} | O valor em kW — só para uma métrica de potência (W, kW, MW) |
{{alert.unit}} | A unidade da métrica |
{{alert.threshold}} | O limite da regra |
{{alert.threshold_label}} | O limite com unidade |
{{alert.threshold_kw}} | O limite em kW — só para uma métrica de potência |
{{alert.op}} | Comparação: gt, ge, lt, le, eq, ne |
{{alert.op_symbol}} | A comparação como símbolo |
{{alert.since}} | Desde quando a condição vale |
{{alert.until}} | Quando o alerta foi resolvido (vazio enquanto disparado) |
{{alert.duration_s}} | Segundos do início ao fim (ou até agora) |
{{alert.close_reason}} | Motivo da resolução: condition, rule_disabled, … |
{{alert.silenced}} | Verdadeiro quando um silêncio se aplicou |
{{alert.link}} | Link absoluto para o alerta no Mirox |
{{alert.instance_key}} | A instância do alerta (rótulos) |
{{rule.uid}} | ID da regra |
{{rule.name}} | Nome da regra |
{{rule.description}} | Descrição da regra |
{{rule.version}} | Versão da regra |
{{rule.window_s}} | Janela da regra em segundos |
{{rule.for_s}} | Quanto tempo a condição deve valer, em segundos |
{{rule.metric.name}} | Nome da métrica |
{{rule.metric.unit}} | Unidade da métrica |
{{plant.uid}} | ID da usina |
{{plant.name}} | Nome da usina |
{{plant.type}} | Tipo: solar, wind, battery |
{{plant.timezone}} | Fuso horário da usina (padrão para datas) |
{{plant.peak_power_kw}} | Potência de pico instalada em kWp |
{{plant.grid_limit_kw}} | Limite de conexão à rede em kW, se definido |
{{plant.inverter_limit_kw}} | Limite de potência dos inversores em kW, se definido |
{{plant.latitude}} | Latitude |
{{plant.longitude}} | Longitude |
{{plant.portfolio.uid}} | ID do portfólio |
{{plant.portfolio.name}} | Nome do portfólio |
{{plant.address.street}} | Rua (linha 1) |
{{plant.address.street2}} | Linha 2 do endereço |
{{plant.address.zip}} | CEP |
{{plant.address.city}} | Cidade |
{{plant.address.state}} | Estado / região |
{{plant.address.country}} | País |
{{plant.grid_operator}} | Operador da rede, se informado |
{{plant.project_company}} | Empresa do projeto, se informada |
{{plant.market_zone}} | Zona de mercado, se informada |
{{plant.commissioning_date}} | Data de comissionamento, se informada |
{{component.name}} | Nome do componente (vazio em regras da usina) |
{{component.id}} | ID do componente no Mirox, se conhecido |
{{component.kind}} | Tipo de componente (inverter, string, …) |
{{component.labels}} | Os rótulos do componente como objeto |
{{component.labels_list}} | Os rótulos como lista de {name, value} para uma seção |
{{organization.uid}} | ID da organização |
{{organization.name}} | Nome da organização |
{{delivery.id}} | ID único desta entrega |
{{delivery.receiver}} | Nome do destinatário |
{{delivery.test}} | Verdadeiro num envio de teste |
{{now}} | O momento do envio |
Cada entrega transporta o grupo outage, e ele nunca está vazio. Num alerta normal é derivado do próprio alerta: a unidade é o componente do alerta (uma turbina), begin é o primeiro momento em que a condição se verificou, end a resolução, o motivo e a potência restante vêm das definições de indisponibilidade da regra — e outage.reported é falso. Numa regra que comunica indisponibilidades o gémeo digital da central assume e comunica a indisponibilidade: uma janela antecipada, prorrogada enquanto o alerta continua ativo, terminada na resolução — só então reported, renewed, reported_until, horizon_hours, marketer.name e register_link são preenchidos; num alerta normal ficam vazios ou falsos. {{#outage.reported}}…{{/outage.reported}} distingue os dois casos num só modelo. O número de série, a chave de instalação e a potência nominal são dados mestre da central e ficam vazios onde nada foi registado. O editor de regras avisa quando um modelo dos seus destinatários lê um campo que só uma indisponibilidade comunicada preenche numa regra que não comunica:
| Variável | Significado |
|---|---|
{{outage.reported}} | Verdadeiro quando o gémeo digital da central comunicou este momento como indisponibilidade (regra com comunicação); falso quando o grupo deriva apenas do alerta |
{{outage.moment}} | O que esta entrega anuncia: start (alerta disparado), renewal (janela comunicada prorrogada — só indisponibilidades comunicadas) ou end (alerta resolvido) |
{{outage.started}}, {{outage.renewed}}, {{outage.ended}} | Verdadeiro nesse momento (use como secções) |
{{outage.begin}} | Início da indisponibilidade |
{{outage.end}} | O fim real depois de o alerta ser resolvido (vazio antes) |
{{outage.reported_until}} | Fim da janela comunicada até agora — prorrogada antes de expirar (só indisponibilidades comunicadas; vazio num alerta normal) |
{{outage.horizon_hours}} | Com quantas horas de antecedência a indisponibilidade é comunicada (só indisponibilidades comunicadas; vazio num alerta normal) |
{{outage.reason}} | Código do motivo: ADMINISTRATIVE, MAINTENANCE, GRID, MARKET |
{{outage.reason_label}} | O motivo por palavras (inglês) |
{{outage.available_power_kw}} | Potência restante da turbina em kW (0 = paragem total) |
{{outage.comment}} | O comentário da comunicação (o nome da regra) |
{{outage.marketer.name}} | O comercializador direto a que a regra comunica pelo seu destinatário comercializador (vazio num alerta normal ou num ensaio sem comercializador) |
{{outage.unit.name}}, {{outage.unit.id}} | Nome e ID da turbina |
{{outage.unit.serialnumber}}, {{outage.unit.manufacturer_id}}, {{outage.unit.plant_key}} | Número de série, ID do fabricante e chave de instalação dos dados mestre, se informados |
{{outage.unit.rated_kw}} | Potência nominal da turbina em kW |
{{outage.register_link}} | Link para o registo de indisponibilidades da central no Mirox |
As datas aparecem no fuso horário da usina, salvo se o filtro date indicar outro. A usina não tem campo para um número MaStR nem para uma localização de mercado — escreva esses identificadores como texto fixo no modelo.
Os filtros seguem a variável após | e podem ser encadeados, por exemplo {{alert.value|kw|number:1:de}}:
| Filtro | Significado |
|---|---|
date:"DD.MM.YYYY HH:mm":"Europe/Berlin" | Data e hora: iso (padrão), unix, unix_ms, rfc2822 ou um padrão de YYYY YY MM DD HH mm ss Z ZZ. O fuso é opcional; sem ele vale o da usina. |
number:1:de | Um número como texto com as casas decimais indicadas (padrão 2) e os separadores de en, de, fr, es, it, pt ou plain. |
round:1 | Arredonda e continua um número (em JSON sem aspas). |
kw | Divide por 1.000 ou 1.000.000 (W em kW ou MW). |
upper | Maiúsculas, minúsculas, sem espaços ao redor. |
truncate:120 | No máximo n caracteres. |
default:"—" | Este texto se o valor estiver vazio. |
yesno:"yes":"no" | Um texto se houver valor, outro se estiver vazio. |
json | O valor como texto JSON, incluindo objetos e listas. |
Formatos e escape
O tipo de conteúdo do modelo decide como um valor é inserido, para que um nome de usina com aspas ou um «&» nunca quebre o resultado:
- JSON — dentro de uma string (
"plant": "{{plant.name}}") o valor é escapado como texto; fora dela ("value": {{alert.value}}) vira um valor JSON: um número continua número, texto recebe aspas, um valor vazio viranull, objetos e listas são escritos como JSON. - XML e HTML —
<,>,&e aspas são escapados. - CSV — um campo vai entre aspas quando contém o separador, uma aspa ou uma quebra de linha; num campo que o modelo já coloca entre aspas, as aspas são duplicadas. O separador é o que seu modelo usa (vírgula, ponto e vírgula, tabulação).
- Dados de formulário — os valores são codificados como URL.
- Texto simples — como está.
Valores de cabeçalho e o assunto do e-mail nunca contêm quebra de linha. O modelo é verificado ao salvar: deve estar completo (cada seção fechada, cada filtro conhecido), ter no máximo 64 KiB e, para JSON e XML, o resultado com o alerta de exemplo deve ser válido. Cabeçalhos: no máximo 30, apenas nomes padrão. Content-Type segue o formato; Content-Length, Host e os cabeçalhos X-Mirox-* são definidos pelo Mirox e não podem ser substituídos. Todo pedido webhook continua assinado: X-Mirox-Signature é o HMAC-SHA256 exatamente do corpo que seu modelo produziu.
Exemplos
Cada exemplo é um ponto de partida que você copia e adapta:
- JSON genérico (envelope assinado) — O envelope de alerta documentado do Mirox — base para sistemas de tickets.
- Cartão do Microsoft Teams — Um Adaptive Card para um webhook do Teams Workflows.
- Mensagem do Slack — Mensagem Block Kit para um webhook de entrada do Slack.
- Embed do Discord — Um embed colorido para um webhook de canal do Discord.
- Documento XML — O alerta como documento XML.
- Linha CSV — Um cabeçalho e uma linha por alerta, separados por vírgulas.
- E-mail de texto — Um e-mail de texto compacto com os dados principais, na moldura de e-mail Mirox (desligue a moldura para enviar só o texto).
- E-mail HTML — Seu próprio e-mail HTML com tabela de dados.
- Aviso a um comercializador direto sem a interface BWE (CSV) — Uma linha CSV em alemão por comunicação — início, prorrogação ou fim da indisponibilidade de uma turbina — com a identidade da turbina, a janela, a potência restante e o motivo da regra; para um destinatário webhook, a adaptar à especificação do comercializador.
- Aviso a um comercializador direto sem a interface BWE (e-mail) — A mesma comunicação como e-mail em alemão, para um destinatário de e-mail — adapte-o ao que o comercializador exige.
Inicie os exemplos de webhook como qualquer outro e escolha depois a cópia para um destinatário — o diálogo do destinatário lista apenas os modelos da sua organização.
Os dois avisos de indisponibilidade (em alemão) são modelos para uma regra que comunica indisponibilidades: renderizam o grupo outage — o momento, o nome, ID, número de série e chave de instalação da turbina, início, fim e a janela comunicada até agora, potência nominal e restante, motivo e comentário. Servem um comercializador sem a interface BWE, alcançado por um destinatário webhook ou de e-mail, e a sua própria caixa de correio enquanto ensaia uma regra antes de associar o destinatário do comercializador. Não há formato obrigatório para esse aviso; adapte colunas e texto ao que o seu comercializador direto exige e preencha o número MaStR e a localização de mercado como texto fixo.
Um modelo para um sistema de tickets que espera XML:
<ticket priority="{{alert.level}}">
<title>{{alert.title}}</title>
<site id="{{plant.uid}}">{{plant.name}}</site>
{{#component.name}}<asset>{{component.name}}</asset>{{/component.name}}
<opened>{{alert.since|date:"iso"}}</opened>
<link>{{alert.link}}</link>
</ticket>
Testar os alertas
Um teste mostra todo o percurso de um alerta numa das suas centrais — sem esperar por um problema real e sem tocar nos dados da central. Abra Gestor de alertas ▸ Visão geral e clique em Testar alertas Abrir no Mirox; depois escolha a central, o nível do alerta de teste (até Crítico) e, opcionalmente, destinatários.
A plataforma escreve então um sinal de teste fixo para essa central: calmo durante 5 minutos, acima do limiar durante 15 minutos e calmo de novo. O agente da central avalia-o como qualquer uma das suas regras, por isso:
- cerca de 5–10 minutos após o início abre-se o alerta de teste, no nível escolhido;
- só a pessoa que iniciou o teste é notificada — na app, por push e por e-mail, segundo as suas próprias definições — e os destinatários escolhidos também o recebem; mais ninguém na organização é avisado;
- cerca de 15 minutos depois resolve-se sozinho, com o seu aviso de resolução.
A página acompanha o teste passo a passo e indica quem o iniciou. Um teste termina sozinho após cerca de 30 minutos, ou antes com Parar; o seu alerta fica no histórico. Os testes nunca aparecem entre as suas regras e os dados de teste só são escritos enquanto um teste está ativo. Os testes são iniciados por Admins e Moderadores; podem decorrer até três em simultâneo.