Alertas y notificaciones
Alertas
Gestor de alertas ▸ Alertas lista las alertas que generaron tus reglas. Abrir en Mirox Por defecto ves lo que está activo ahora mismo; dos interruptores amplían la lista:
- Mostrar resueltas — añade las alertas que han terminado, como historial.
- Mostrar silenciadas — añade las alertas que retiene un silencio. Las alertas silenciadas están ocultas por defecto, activas o resueltas, de modo que la lista muestra lo que alguien aún tiene que mirar; el Resumen las cuenta aparte de las alertas activas como + N silenciadas.
Cada alerta muestra su nivel, la regla, la planta, el componente (en las reglas juzgadas por componente), el valor y desde cuándo — o desde cuándo hasta cuándo — estuvo activa; las fechas y horas siguen los ajustes de idioma y región de tu navegador. La planta y el componente son enlaces a sus páginas. Una alerta de una regla juzgada sobre el total de la planta ofrece ¿Qué componentes?: reproduce la regla por componente durante el periodo de la alerta y lista cuáles estaban detrás. Una alerta que retiene un silencio aparece marcada como Silenciada.
Una alerta se resuelve sola cuando la condición deja de cumplirse, cuando la regla se desactiva, se modifica de forma que ya no coincide o se elimina. Las alertas resueltas permanecen en la lista como historial.
Quién fue notificado, quién lo ha visto
Notificados y Visto por en los detalles de la alerta muestran a quién notificó la plataforma la alerta y cuándo, y quién la ha abierto desde entonces — abrir los detalles te registra ahí. No hay nada que confirmar: una alerta termina por sí sola cuando la condición deja de cumplirse.
Silenciar una alerta desde sus detalles
Silenciar esta alerta en los detalles de la alerta mantiene en silencio exactamente esta alerta sin abrir la pestaña Silencios. Elige cuánto tiempo — 1 h, 4 h (por defecto), 8 h, 24 h, 3 d o 7 d — y se crea un silencio para esta regla, esta planta y este componente (el total de la planta cuando la alerta abarca toda la planta). La alerta se marca como Silenciada de inmediato y no se notifica a nadie mientras dura el silencio. Si la alerta sigue activa cuando el silencio termina, se notifica entonces — el silencio aplaza, no se traga la alerta. Una alerta que ya se había notificado antes de silenciarla sigue enviando su aviso de resolución. Los detalles enlazan al silencio en Abrir los silencios, donde se puede prolongar, ampliar o quitar.
Los cambios de reglas y silencios también aparecen en la actividad de tu organización.
A quién se notifica
Cuando se abre una alerta, se notifica a todas las personas de tu organización que tienen acceso a la planta — en la app, por notificación push en la app móvil y por correo, exactamente como cada persona eligió en sus propios ajustes de notificación dentro del grupo Gestor de alertas. Allí cada persona elige los canales y el nivel mínimo desde el que quiere enterarse de estas alertas; por defecto es Normal.
Cuando la alerta se resuelve, las personas notificadas reciben un aviso de resolución. La notificación enlaza directamente a la alerta.
Silencios
Un silencio mantiene alejadas las notificaciones durante un tiempo — por mantenimiento, un problema conocido o una parada planificada. Las alertas coincidentes se siguen abriendo y cerrando y quedan registradas, marcadas como Silenciada (y ocultas en la pestaña Alertas hasta que elijas Mostrar silenciadas); solo las notificaciones y los receptores permanecen en silencio.
Abre Gestor de alertas ▸ Silencios y haz clic en Nuevo silencio. Abrir en Mirox Elige:
- Regla — una regla o todas las reglas.
- Planta — una planta o todas las plantas.
- Empieza — ahora o en un momento planificado.
- Durante — desde 1 hora hasta 1 año, o Hasta una fecha… para una fecha de fin libre (como máximo un año después del inicio).
- Comentario — el motivo, para que tus compañeros lo sepan.
Mientras eliges, el diálogo cuenta en vivo cuántas alertas abiertas coinciden — N alertas abiertas se silenciarían ahora — para que veas qué retendrá el silencio antes de crearlo. Un silencio que empieza ahora retiene de inmediato las alertas abiertas coincidentes.
La tabla muestra de cada silencio su regla, planta, inicio y fin, comentario y estado — Activo, Programado o Finalizada — y Retiene: el número de alertas abiertas que el silencio retiene ahora mismo.
Un silencio se puede editar desde su fila (Editar): regla, planta, inicio, fin y comentario. El cambio se aplica de inmediato — las alertas que el silencio abarca ahora dejan de notificar, las que ya no abarca vuelven a notificar desde la próxima evaluación. Un silencio creado desde una sola alerta abarca solo el componente de esa alerta (o el total de la planta); en Componente se puede ampliar a Todos los componentes de la regla y la planta, pero no limitarse a otro componente.
Un silencio termina solo. Quítalo antes con Quitar — las alertas coincidentes vuelven a notificarse desde la próxima evaluación, incluidas las que están activas ahora mismo. Los silencios los crean, editan y quitan los Administradores, los Moderadores y los dos roles de Gestor de activos.
Receptores
Un receptor recibe automáticamente cada alerta de las reglas a las que está asociado — un sistema de tickets, un canal de equipo o un buzón compartido. Las personas no necesitan un receptor; reciben la notificación igualmente según sus propios ajustes. Dos tipos los creas tú mismo, Webhook y Correo electrónico; un comercializador directo configurado en Organización se convierte por sí solo en receptor — consulta Comercializador directo.
Abre Gestor de alertas ▸ Receptores y haz clic en Nuevo receptor Abrir en Mirox, y luego asócialo a reglas en Receptores de la pestaña Notificación del editor de reglas. Enviar prueba entrega una alerta de ejemplo — con un aviso de indisponibilidad de ejemplo dentro — para que compruebes la conexión y tu plantilla; un comercializador directo ofrece en su lugar Probar inicio de sesión, que inicia sesión en el servicio web del comercializador. Un receptor se puede editar después desde el menú de su fila (Editar): el nombre, las direcciones o la dirección y la plantilla del webhook, y si también se envía la resolución (Enviar también la resolución); solo su tipo es fijo. Renovar el secreto de firma emite un nuevo secreto de webhook, mostrado una sola vez como al crearlo. Un receptor desactivado tras fallos de entrega repetidos (etiqueta Desactivado) se vuelve a activar con Reactivar. El receptor de un comercializador directo se gestiona en Organización ▸ Comercializadores directos; en la pestaña Receptores solo ofrece Probar inicio de sesión y su interruptor de activo. En la tabla de reglas cada receptor aparece como un chip; al pasar el ratón se indica el receptor y la plantilla con la que envía (un receptor de correo sin plantilla: Texto integrado).
Correo electrónico
Una lista de direcciones de correo. Cada alerta y su resolución llegan como un correo.
Webhook
Una dirección HTTPS más una plantilla: la dirección recibe un POST por cada alerta y su resolución, con la forma que le da la plantilla del receptor — el método, las cabeceras y el cuerpo. El receptor toma una de las plantillas de webhook de tu organización — el diálogo las lista, al crear el receptor y al editarlo; si aún no hay ninguna, crea una primero en Plantillas. Los ejemplos de allí cubren Microsoft Teams, Slack y Discord, además de tu propio JSON, XML y CSV: el ejemplo JSON genérico (sobre firmado) — la alerta completa como JSON, véase más abajo — es la base para sistemas de tickets y tu propia automatización; Tarjeta de Microsoft Teams, Mensaje de Slack y Embed de Discord son mensajes ya preparados para un webhook entrante de esos servicios, cuya dirección es entonces la dirección del receptor (Slack hooks.slack.com/services/…, Discord discord.com/api/webhooks/…, Teams Workflows *.environment.api.powerplatform.com o *.logic.azure.com — consulta Conectar Microsoft Teams para saber cómo crear uno). Un webhook de Teams Workflows rechaza una cabecera Authorization — no añadas ninguna a una plantilla para Teams.
Al crear un receptor webhook, su secreto de firma se muestra una sola vez. Cada petición va firmada: lleva la cabecera X-Mirox-Signature: sha256=<hex> — el HMAC-SHA256 del cuerpo bruto de la petición con ese secreto — además de X-Mirox-Timestamp y un X-Mirox-Delivery-Id único, junto con las cabeceras propias de la plantilla, sea cual sea la dirección. Comprueba la firma antes de fiarte de una petición y usa el id de entrega para ignorar una entrega repetida. Los servicios de chat como Teams, Slack y Discord simplemente ignoran las cabeceras X-Mirox-*.
El cuerpo de la plantilla ya preparada JSON genérico (sobre firmado):
{
"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 es firing o resolved; una resolución repite la alerta con el último valor juzgado. condition_since es una marca de tiempo Unix. En versiones posteriores pueden añadirse campos: ignora lo que no conozcas. event_id es una cadena: el identificador es más largo de lo que un número de JavaScript puede representar con exactitud.
Tras repetidos fallos de entrega, un receptor se desactiva y se marca como Desactivado; comprueba la dirección y luego vuelve a activarlo con Reactivar desde el menú de su fila.
Qué direcciones llama Mirox
Mirox se conecta a una dirección de webhook solo por HTTPS en el puerto 443, y solo si la dirección se resuelve a una dirección IP pública. Otros puertos (como 8443), http:// sin cifrar y las direcciones privadas o internas (10.x, 172.16–31.x, 192.168.x, localhost y similares) se rechazan. Si tu endpoint escucha en otro puerto o solo es accesible dentro de tu red, coloca delante un proxy inverso accesible públicamente en el puerto 443, o contacta con nuestro soporte si eso no es posible para ti.
Comercializador directo
Un comercializador directo se configura una sola vez en Organización ▸ Comercializadores directos Abrir en Mirox: un nombre, el protocolo que habla — hoy la interfaz BWE de indisponibilidades; Solicitar otro protocolo nos envía el nombre del estándar que usa tu comercializador —, las direcciones del servicio web y del inicio de sesión, las credenciales que emitió el comercializador y las horas de antelación con las que quiere recibir una indisponibilidad (2 por defecto, de 1 a 48). Cada fila termina con un menú …: Editar, Probar inicio de sesión, Receptor en el Gestor de alertas y Eliminar. Probar inicio de sesión inicia sesión en el comercializador y muestra cuántas plantas ha asignado a tu cuenta; nunca comunica una indisponibilidad. Una planta eólica elige el comercializador a través del que vende en su página Indisponibilidad — consulta Indisponibilidad y comercializador directo.
Qué direcciones llama Mirox
Mirox se conecta a las direcciones del servicio web y de inicio de sesión del comercializador solo por HTTPS en el puerto 443, y solo si se resuelven a una dirección IP pública. Otros puertos (como 8443), http:// sin cifrar y las direcciones privadas o internas se rechazan. Si el servicio de tu comercializador solo es accesible en otro puerto, pídele una dirección en el puerto 443, o contacta con nuestro soporte.
El comercializador se convierte automáticamente en un único receptor del Gestor de alertas, con su nombre. No se puede crear desde Nuevo receptor (ese diálogo solo ofrece webhook y correo) y nunca existe dos veces; renombrar o desactivar el comercializador se refleja en el receptor, eliminar el comercializador lo elimina, y volver a configurarlo lo recupera. En la pestaña Receptores la fila es de solo lectura — Gestionado en Organización ▸ Comercializadores directos — salvo Probar inicio de sesión y su interruptor de activo, ambos reservados a los Administradores y los Moderadores. No tiene plantilla: el protocolo dicta lo que recibe el comercializador.
La regla comunica la indisponibilidad. En una regla que vigila los aerogeneradores de una planta eólica uno a uno (juzgada por cada componente de una métrica de aerogenerador), la pestaña Notificación ofrece el interruptor Comunicar indisponibilidades. Con él activado, cada alerta de aerogenerador activa de la regla es una indisponibilidad de ese aerogenerador desde el momento en que se abre: un inicio, comunicado con las horas de antelación; una prórroga aproximadamente cada mitad de esas horas mientras la alerta siga activa; y el fin, recortado al final real, cuando se resuelve. Junto al interruptor eliges el motivo de la indisponibilidad — Mantenimiento, Orden administrativa, Operador de red o Comercializador directo — y la potencia restante: Parada total (0 kW) o el valor medido, el valor de potencia de la alerta limitado a la potencia nominal del aerogenerador, para una regla sobre una métrica de potencia. Usa Operador de red y Comercializador directo solo cuando el origen de la limitación sea seguro — cuentan como limitaciones compensadas en la liquidación, mientras que los otros dos reducen la disponibilidad del aerogenerador. Las horas de antelación son las del comercializador de la planta cuando la regla le comunica, y 2 en caso contrario. El interruptor queda forzado y bloqueado mientras el receptor del comercializador esté asociado; una regla juzgada sobre el total de la planta no lo ofrece y nunca se comunica. Una planta que otra organización comparte con usted por cooperación también se puede comunicar: cada organización comunica con sus propias reglas y su propio comercializador directo, con independencia del propietario de la planta — la regla designa al comercializador a través de su receptor.
Cada receptor de la regla recibe los tres momentos — inicio, prórroga y fin — y nada más: tu propio receptor de correo o webhook los recibe renderizados con su plantilla y las variables outage.* (o como texto integrado si no tiene plantilla), y el receptor del comercializador los recibe a través de su protocolo, enviados por el agente de la planta. Una regla que comunica indisponibilidades no envía además a sus receptores los mensajes habituales de activación y resolución; las personas de tu organización se notifican como siempre, y una prueba de alertas nunca comunica una indisponibilidad.
Así pruebas primero y cambias después: construye la regla con tu propio receptor de correo o webhook y observa cómo llegan inicio, prórroga y fin a tu buzón o a tu punto de destino — exactamente lo que recibiría el comercializador. Cuando estés satisfecho, abre la pestaña Notificación de la regla, quita tu receptor (o consérvalo) y añade el receptor del comercializador. Nada más cambia — la regla, el motivo, la potencia restante y las horas de antelación se mantienen; desde la siguiente pasada, la planta comunica al comercializador cada indisponibilidad abierta, desde su inicio original.
Qué plantas llegan al comercializador depende de las plantas: una planta comunica a través del comercializador vinculado en su página Indisponibilidad, así que el receptor del comercializador comunica exactamente las plantas de la regla vinculadas a él. Para una planta vinculada a otro comercializador o a ninguno, la indisponibilidad se registra en el registro de la planta y se envía a tus propios receptores, pero no a un comercializador — el editor de reglas nombra esas plantas en la pestaña Notificación. También indica cuándo el agente de una planta aún necesita una actualización para los avisos de indisponibilidad: hasta entonces los receptores de la regla reciben la propia alerta, como en una regla normal.
Las plantillas del sistema para aerogeneradores vienen con el interruptor activado y asocian el receptor de tu comercializador al adoptarlas — consulta Ejemplos. En la planta, las indisponibilidades aparecen en el registro Indisponibilidad como Notificada por alarma, y la tarjeta Notificado en vivo por alarma de la pestaña Comercializador directo de la planta enumera cada regla que comunica la planta — regla, motivo, potencia restante, horas de antelación y si llega al comercializador — con la etiqueta Inactiva para una regla desactivada.
Qué se entregó
Los detalles de una alerta enumeran sus Entregas: una fila por receptor y momento — activación o resolución en una regla normal, inicio, prórroga o fin en un aviso de indisponibilidad — con la hora y si se envió, falló (con el error) o se omitió, y por qué: un silencio, el receptor desactivado, resoluciones no deseadas, el aviso de indisponibilidad en lugar del mensaje de alerta o —en una resolución— que la alerta en sí nunca llegó al receptor. Cuando una regla abre muchas alertas a la vez (una regla sobre cada uno de cientos de strings al anochecer), sus notificaciones y mensajes a receptores se pausan tras las cuatro primeras en una hora, durante 30 minutos, y las personas reciben en su lugar un resumen; una alerta que nunca se envió a un receptor tampoco le envía una resolución. En el receptor del comercializador la fila muestra lo que la planta comunicó y la ventana que cubre. Cuando un receptor falla, tu organización recibe el evento Receptor con fallos, dirigido a los Admins y Moderadores y a los autores de las reglas que usan el receptor; tras diez entregas fallidas seguidas el receptor se desactiva (Receptor desactivado), y el evento se cierra por sí solo en cuanto una entrega vuelve a tener éxito — corrige la causa y luego Reactiva el receptor desde el menú de su fila. El receptor del comercializador informa del estado de la conexión con el comercializador de la misma forma.
Plantillas
Una plantilla define exactamente lo que envía un receptor, para que cada sistema reciba el formato que espera: en un webhook el método (POST, PUT o PATCH), sus propias cabeceras y el cuerpo en JSON, XML, CSV, HTML, texto plano o datos de formulario; en un correo el asunto y el texto (texto plano o su propio HTML). El receptor de un comercializador directo no tiene plantilla — su protocolo dicta el aviso; lo que una regla que comunica indisponibilidades envía a tus receptores de correo y webhook lo dan forma sus plantillas, con las variables outage.*. Escribe texto fijo e inserta variables de la alerta, la regla, la planta y el componente. Una plantilla es reutilizable: varios receptores pueden usar la misma y un cambio se aplica a todos a la vez.
Abra Gestor de alertas ▸ Receptores Abrir en Mirox: debajo de los receptores están sus plantillas y los ejemplos para empezar. Usar ejemplo copia uno a su organización; Nueva plantilla empieza vacía. Las plantillas de webhook ya preparadas — el JSON genérico (sobre firmado) y los mensajes de chat para Microsoft Teams, Slack y Discord — se inician desde los ejemplos como cualquier otra; el diálogo de receptor lista solo las plantillas propias de su organización. La plantilla se abre en el editor: a la izquierda los ajustes, las cabeceras y el cuerpo; en el centro la lista de variables — un clic inserta la variable en el cursor —; y a la derecha la vista previa en vivo: la petición o el correo exactamente como se enviaría, con la alerta de ejemplo o una de sus alertas recientes, y todos los errores y avisos. Después elija la plantilla para un receptor, al crearlo o con el botón de plantilla de su fila. Un receptor webhook siempre envía con una plantilla; un receptor de correo sin plantilla envía el texto integrado.
El marco de correo de Mirox es su elección. Una plantilla de correo de texto tiene el interruptor Enviar dentro del marco de correo de Mirox (activado por defecto): activado, su texto va dentro del correo de Mirox — encabezado, un botón a la alerta, pie y «mirox |» delante del asunto; desactivado, asunto y texto salen exactamente como se generan, sin nada añadido. Una plantilla HTML se envía siempre tal cual. La vista previa es siempre el correo tal como llega — con el marco muestra el correo enmarcado completo — y ofrece, junto a la alerta de ejemplo y sus alertas recientes, tres fuentes más: un aviso de indisponibilidad de ejemplo en su inicio, prórroga y fin, para comprobar una plantilla de una regla que comunica indisponibilidades con todos los campos rellenos. Bajo la vista previa una nota indica si el grupo de indisponibilidad mostrado fue comunicado por el gemelo digital o derivado de la alerta, y qué campos quedan vacíos en ese caso.
Las plantillas las crean, duplican, modifican y eliminan los Administradores, los Moderadores y los dos roles de Gestor de activos; todos los miembros pueden verlas. Una plantilla marcada como Privado solo la cambian su creador, un Administrador o un Moderador; consulta Privado. Una plantilla que usa un receptor no se puede eliminar: elija antes otra para ese receptor.
El lenguaje de las plantillas
| Escriba | Significado |
|---|---|
Variable: {{plant.name}} | el valor, p. ej. el nombre de la planta |
Filtro: {{alert.since|date:"DD.MM.YYYY HH:mm"}} | el valor, formateado |
Sección: {{#alert.firing}}…{{/alert.firing}} | la parte intermedia solo si el valor existe; en una lista, una vez por elemento |
Sección inversa: {{^component.name}}…{{/component.name}} | la parte intermedia solo si el valor está vacío |
Comentario: {{! … }} | nada: una nota para usted |
Llaves literales: \{{ | {{ como texto |
Dentro de una sección de lista están disponibles {{@index}} (desde 0), {{@number}} (desde 1), {{@first}} y {{@last}}; por ejemplo, {{^@last}},{{/@last}} pone una coma entre elementos. Una variable que no existe queda vacía y la vista previa la muestra como aviso. En una plantilla no se ejecuta nada; solo produce texto.
Variables
| Variable | Significado |
|---|---|
{{alert.id}} | ID de la alerta (texto) |
{{alert.status}} | firing (activa) o resolved (resuelta) |
{{alert.firing}} | Verdadero mientras la alerta está activa (úsela como sección) |
{{alert.resolved}} | Verdadero en el aviso de resolución |
{{alert.level}} | Nivel: very_low, low, normal, high, very_high, critical |
{{alert.title}} | El título de una línea |
{{alert.text}} | El mensaje de una línea |
{{alert.summary}} | El resumen propio de la regla, si tiene |
{{alert.value}} | El valor evaluado (el último al resolverse) |
{{alert.value_label}} | El valor con su unidad, como en Mirox |
{{alert.value_kw}} | El valor en kW — solo para una métrica de potencia (W, kW, MW) |
{{alert.unit}} | La unidad de la métrica |
{{alert.threshold}} | El umbral de la regla |
{{alert.threshold_label}} | El umbral con su unidad |
{{alert.threshold_kw}} | El umbral en kW — solo para una métrica de potencia |
{{alert.op}} | Comparación: gt, ge, lt, le, eq, ne |
{{alert.op_symbol}} | La comparación como símbolo |
{{alert.since}} | Desde cuándo se cumple la condición |
{{alert.until}} | Cuándo se resolvió (vacío mientras está activa) |
{{alert.duration_s}} | Segundos desde el inicio hasta el fin (o ahora) |
{{alert.close_reason}} | Motivo de la resolución: condition, rule_disabled, … |
{{alert.silenced}} | Verdadero si un silencio coincidió |
{{alert.link}} | Enlace absoluto a la alerta en Mirox |
{{alert.instance_key}} | La instancia de la alerta (etiquetas) |
{{rule.uid}} | ID de la regla |
{{rule.name}} | Nombre de la regla |
{{rule.description}} | Descripción de la regla |
{{rule.version}} | Versión de la regla |
{{rule.window_s}} | Ventana de la regla en segundos |
{{rule.for_s}} | Cuánto debe durar la condición, en segundos |
{{rule.metric.name}} | Nombre de la métrica |
{{rule.metric.unit}} | Unidad de la métrica |
{{plant.uid}} | ID de la planta |
{{plant.name}} | Nombre de la planta |
{{plant.type}} | Tipo: solar, wind, battery |
{{plant.timezone}} | Zona horaria de la planta (por defecto en fechas) |
{{plant.peak_power_kw}} | Potencia pico instalada en kWp |
{{plant.grid_limit_kw}} | Límite de conexión a red en kW, si existe |
{{plant.inverter_limit_kw}} | Límite de potencia de inversores en kW, si existe |
{{plant.latitude}} | Latitud |
{{plant.longitude}} | Longitud |
{{plant.portfolio.uid}} | ID de la cartera |
{{plant.portfolio.name}} | Nombre de la cartera |
{{plant.address.street}} | Calle (línea 1) |
{{plant.address.street2}} | Línea 2 de la dirección |
{{plant.address.zip}} | Código postal |
{{plant.address.city}} | Ciudad |
{{plant.address.state}} | Provincia / región |
{{plant.address.country}} | País |
{{plant.grid_operator}} | Operador de red, si consta |
{{plant.project_company}} | Sociedad del proyecto, si consta |
{{plant.market_zone}} | Zona de mercado, si consta |
{{plant.commissioning_date}} | Fecha de puesta en marcha, si consta |
{{component.name}} | Nombre del componente (vacío en reglas de planta) |
{{component.id}} | ID del componente en Mirox, si se conoce |
{{component.kind}} | Tipo de componente (inverter, string, …) |
{{component.labels}} | Las etiquetas del componente como objeto |
{{component.labels_list}} | Las etiquetas como lista de {name, value} para una sección |
{{organization.uid}} | ID de la organización |
{{organization.name}} | Nombre de la organización |
{{delivery.id}} | ID único de esta entrega |
{{delivery.receiver}} | Nombre del receptor |
{{delivery.test}} | Verdadero en un envío de prueba |
{{now}} | El momento del envío |
Cada entrega lleva el grupo outage, y nunca está vacío. En una alerta normal se deriva de la propia alerta: la unidad es el componente de la alerta (un aerogenerador), begin es el primer momento en que se cumplió la condición, end la resolución, el motivo y la potencia restante proceden de los ajustes de indisponibilidad de la regla — y outage.reported es falso. En una regla que comunica indisponibilidades el gemelo digital de la planta toma el relevo y comunica la indisponibilidad: una ventana por adelantado, prorrogada mientras la alerta sigue activa, terminada al resolverse — solo entonces se rellenan reported, renewed, reported_until, horizon_hours, marketer.name y register_link; en una alerta normal quedan vacíos o falsos. {{#outage.reported}}…{{/outage.reported}} distingue ambos casos en una plantilla. El número de serie, la clave de instalación y la potencia nominal son datos maestros de la planta y quedan vacíos donde no se hayan introducido. El editor de reglas avisa cuando una plantilla de sus receptores usa un campo que solo rellena una indisponibilidad comunicada en una regla que no comunica:
| Variable | Significado |
|---|---|
{{outage.reported}} | Verdadero cuando el gemelo digital de la planta comunicó este momento como indisponibilidad (regla con aviso); falso cuando el grupo se deriva solo de la alerta |
{{outage.moment}} | Qué anuncia esta entrega: start (alerta activada), renewal (ventana comunicada prorrogada — solo indisponibilidades comunicadas) o end (alerta resuelta) |
{{outage.started}}, {{outage.renewed}}, {{outage.ended}} | Verdadero en ese momento (úsalos como secciones) |
{{outage.begin}} | Inicio de la indisponibilidad |
{{outage.end}} | El fin real una vez resuelta la alerta (vacío antes) |
{{outage.reported_until}} | Fin de la ventana comunicada hasta ahora — se prorroga antes de vencer (solo indisponibilidades comunicadas; vacío en una alerta normal) |
{{outage.horizon_hours}} | Con cuántas horas de antelación se comunica la indisponibilidad (solo indisponibilidades comunicadas; vacío en una alerta normal) |
{{outage.reason}} | Código del motivo: ADMINISTRATIVE, MAINTENANCE, GRID, MARKET |
{{outage.reason_label}} | El motivo en palabras (inglés) |
{{outage.available_power_kw}} | Potencia restante del aerogenerador en kW (0 = parada total) |
{{outage.comment}} | El comentario del aviso (el nombre de la regla) |
{{outage.marketer.name}} | El comercializador directo al que la regla comunica por su receptor (vacío en una alerta normal o un ensayo sin comercializador) |
{{outage.unit.name}}, {{outage.unit.id}} | Nombre e ID del aerogenerador |
{{outage.unit.serialnumber}}, {{outage.unit.manufacturer_id}}, {{outage.unit.plant_key}} | Número de serie, ID de fabricante y clave de instalación de los datos maestros, si constan |
{{outage.unit.rated_kw}} | Potencia nominal del aerogenerador en kW |
{{outage.register_link}} | Enlace al registro de indisponibilidades de la planta en Mirox |
Las fechas se muestran en la zona horaria de la planta, salvo que el filtro date indique otra. La planta no tiene campo para un número MaStR ni una ubicación de mercado: escriba esos identificadores como texto fijo en la plantilla.
Los filtros siguen a la variable tras | y se pueden encadenar, por ejemplo {{alert.value|kw|number:1:de}}:
| Filtro | Significado |
|---|---|
date:"DD.MM.YYYY HH:mm":"Europe/Berlin" | Fecha y hora: iso (por defecto), unix, unix_ms, rfc2822 o un patrón de YYYY YY MM DD HH mm ss Z ZZ. La zona horaria es opcional; sin ella se usa la de la planta. |
number:1:de | Un número como texto con los decimales indicados (2 por defecto) y los separadores de en, de, fr, es, it, pt o plain. |
round:1 | Redondea y sigue siendo un número (en JSON sin comillas). |
kw | Divide entre 1.000 o 1.000.000 (W a kW o MW). |
upper | Mayúsculas, minúsculas, sin espacios alrededor. |
truncate:120 | Como máximo n caracteres. |
default:"—" | Este texto si el valor está vacío. |
yesno:"yes":"no" | Un texto si hay valor, otro si está vacío. |
json | El valor como texto JSON, incluidos objetos y listas. |
Formatos y escapado
El tipo de contenido de la plantilla decide cómo se inserta un valor, para que un nombre de planta con comillas o un «&» nunca rompa el resultado:
- JSON: dentro de una cadena (
"plant": "{{plant.name}}") el valor se escapa como texto; fuera ("value": {{alert.value}}) se convierte en un valor JSON: un número sigue siendo número, el texto lleva comillas, un valor vacío esnull, objetos y listas se escriben como JSON. - XML y HTML: se escapan
<,>,&y las comillas. - CSV: un campo se entrecomilla si contiene el separador, una comilla o un salto de línea; en un campo que la plantilla ya entrecomilla, las comillas se duplican. El separador es el que usa su plantilla (coma, punto y coma, tabulador).
- Datos de formulario: los valores se codifican como URL.
- Texto plano: tal cual.
Los valores de cabecera y el asunto del correo nunca contienen saltos de línea. Al guardar se comprueba la plantilla: debe estar completa (cada sección cerrada, cada filtro conocido), ocupar como máximo 64 KiB y, para JSON y XML, su resultado con la alerta de ejemplo debe ser válido. Cabeceras: como máximo 30, solo nombres estándar. Content-Type sigue el formato; Content-Length, Host y las cabeceras X-Mirox-* las fija Mirox y no se pueden sustituir. Toda petición webhook sigue firmada: X-Mirox-Signature es el HMAC-SHA256 exactamente del cuerpo que produjo su plantilla.
Ejemplos
Cada ejemplo es un punto de partida que copia y adapta:
- JSON genérico (sobre firmado) — El sobre de alerta documentado de Mirox — base para sistemas de tickets.
- Tarjeta de Microsoft Teams — Una Adaptive Card para un webhook de Teams Workflows.
- Mensaje de Slack — Mensaje Block Kit para un webhook entrante de Slack.
- Embed de Discord — Un embed de color para un webhook de canal de Discord.
- Documento XML — La alerta como documento XML.
- Fila CSV — Una cabecera y una fila por alerta, separadas por comas.
- Correo de texto — Un correo de texto compacto con los datos clave, en el marco de correo de Mirox (desactive el marco para enviar solo el texto).
- Correo HTML — Su propio correo HTML con tabla de datos.
- Aviso a un comercializador directo sin la interfaz BWE (CSV) — Una fila CSV en alemán por aviso — inicio, prórroga o fin de la indisponibilidad de un aerogenerador — con la identidad del aerogenerador, la ventana, la potencia restante y el motivo de la regla; para un receptor webhook, adaptada a la especificación del comercializador.
- Aviso a un comercializador directo sin la interfaz BWE (correo) — El mismo aviso como correo en alemán, para un receptor de correo — edítalo para que coincida con lo que exige el comercializador.
Inicia los ejemplos de webhook como cualquier otro y elige después la copia para un receptor — el diálogo de receptor lista solo las plantillas propias de tu organización.
Los dos avisos de indisponibilidad (en alemán) son plantillas para una regla que comunica indisponibilidades: renderizan el grupo outage — el momento, el nombre, ID, número de serie y clave de instalación del aerogenerador, inicio, fin y la ventana comunicada hasta ahora, potencia nominal y restante, motivo y comentario. Sirven para un comercializador sin la interfaz BWE, alcanzado por un receptor webhook o de correo, y para tu propio buzón mientras ensayas una regla antes de asociar el receptor del comercializador. No hay un formato vinculante para este aviso; adapta columnas y redacción a lo que exige tu comercializador directo y escribe el número MaStR y la ubicación de mercado como texto fijo.
Una plantilla para un 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>
Probar las alertas
Una prueba muestra todo el recorrido de una alerta en una de sus plantas, sin esperar a un problema real y sin tocar los datos de la planta. Abra Gestor de alertas ▸ Resumen y haga clic en Probar alertas Abrir en Mirox; elija la planta, el nivel de la alerta de prueba (hasta Crítico) y, opcionalmente, receptores.
La plataforma escribe entonces una señal de prueba fija para esa planta: 5 minutos tranquila, 15 minutos por encima del umbral y de nuevo tranquila. El agente de la planta la evalúa como cualquiera de sus reglas, así que:
- unos 5–10 minutos después del inicio se abre la alerta de prueba, con el nivel elegido;
- solo se avisa a la persona que inició la prueba —en la app, por push y por correo, según su propia configuración— y los receptores elegidos también la reciben; nadie más de la organización recibe aviso;
- unos 15 minutos más tarde se resuelve sola, con su aviso de resolución.
La página sigue la prueba paso a paso e indica quién la inició. Una prueba termina sola tras unos 30 minutos, o antes con Detener; su alerta queda en el historial. Las pruebas nunca aparecen entre sus reglas y los datos de prueba solo se escriben mientras una prueba está activa. Las inician Admins y Moderadores; pueden ejecutarse hasta tres a la vez.