Alerting, Notification & Decision Routing Matrix (Entry Form)

{"Title":"Alerting, Notification & Decision Routing Matrix — Entry","IntroductionHtml":"

Use this form to record one alerting matrix row. Submit once per signal and repeat to build a complete matrix. The form captures routing, context, and template details so signals reliably reach an owner with clear next steps. After collecting multiple entries you can export them or combine into site-specific toolkits.

","SubmitLabel":"Save Matrix Entry","SuccessMessage":"Matrix entry saved. Create another entry or view collected entries in your domain.","DataType":"alert-routing-matrix-entry","SchemaVersion":"1.0","Fields":[{"Key":"signal_metric","Label":"Signal / Metric","FieldType":"text","Required":true,"HelpText":"Name the observable event or metric (e.g., 'Line OEE < 60%', 'Order Delay > 48h', 'High CPU')."},{"Key":"short_description","Label":"Short description","FieldType":"textarea","Required":false,"HelpText":"Briefly describe why this signal matters and what it indicates."},{"Key":"severity","Label":"Severity","FieldType":"select","Required":true,"Options":[{"Value":"info","Label":"Info"},{"Value":"warning","Label":"Warning"},{"Value":"critical","Label":"Critical"},{"Value":"emergency","Label":"Emergency"}],"HelpText":"Choose the level of operational impact."},{"Key":"recipient_roles","Label":"Recipient roles","FieldType":"textarea","Required":true,"HelpText":"Specify the roles responsible for action (e.g., 'Line Supervisor; Maintenance Technician; Ops Manager'). Use role names rather than individual people where possible."},{"Key":"delivery_channels","Label":"Delivery channel(s)","FieldType":"checkbox","Required":true,"Options":[{"Value":"email","Label":"Email"},{"Value":"sms","Label":"SMS / Text"},{"Value":"phone_call","Label":"Phone call"},{"Value":"slack","Label":"Slack / Teams"},{"Value":"dashboard","Label":"Dashboard / Console"},{"Value":"webhook","Label":"Webhook / API"},{"Value":"ticket","Label":"Ticketing system (Jira, ServiceNow)"}],"HelpText":"Select all channels to be used for this alert. Prefer channels that match the recipient's workflow to reduce ignored alerts."},{"Key":"expected_action","Label":"Expected action","FieldType":"textarea","Required":true,"HelpText":"Describe the immediate remedial or investigative action expected of the recipient (e.g., 'Acknowledge and investigate within SLA; if confirmed, execute runbook step 1')."},{"Key":"sla_response","Label":"SLA for response","FieldType":"text","Required":true,"HelpText":"Specify response time (e.g., '15 minutes', '4 hours') and whether SLA varies by severity or shift."},{"Key":"escalation_path","Label":"Escalation path","FieldType":"textarea","Required":true,"HelpText":"Who is notified if the initial recipient doesn't respond? Include time windows, next contacts, and automated escalation steps."},{"Key":"suppression_rules","Label":"Suppression / deduplication rules","FieldType":"textarea","Required":false,"HelpText":"Rules to reduce noise (e.g., 'suppress duplicate alerts for same asset within 10 minutes', 'group by incident ID', 'only notify once per incident')."},{"Key":"post_incident_owner","Label":"Post-incident review owner","FieldType":"text","Required":false,"HelpText":"Person or role responsible for root-cause review and follow-up actions (e.g., 'Quality Lead')."},{"Key":"automation_policy","Label":"Automated vs manual","FieldType":"radio","Required":true,"Options":[{"Value":"automated","Label":"Automated (system attempts remediation)"},{"Value":"manual","Label":"Manual (requires human acknowledgement)"}],"HelpText":"Decide whether the system should attempt remediation or require human action to prevent unsafe automation."},{"Key":"oncall_rotation_template","Label":"On-call rotation / contact template","FieldType":"textarea","Required":false,"HelpText":"Provide a template or link to on-call schedule (e.g., 'Weekdays 08:00-17:00: Line Supervisor; Nights: On-call Technician'). Use role + contact rather than personal emails when possible."},{"Key":"alert_message_template","Label":"Alert message template","FieldType":"textarea","Required":false,"HelpText":"Provide a short alert message template including essentials: signal, affected asset, severity, timestamp, short context, and a direct link to dashboard or runbook. Example: 'ALERT: Line A OEE < 60% (critical). Asset: Line A. Time: {{ts}}. See: .'"},{"Key":"runbook_links","Label":"Runbook / dashboard links","FieldType":"textarea","Required":false,"HelpText":"Paste URLs or identifiers for runbooks, dashboard panels, ticket templates, or automation scripts referenced by this alert."},{"Key":"additional_notes","Label":"Additional notes or configuration IDs","FieldType":"textarea","Required":false,"HelpText":"Any other implementation notes, monitoring IDs, or configuration fields (e.g., metric path, environment, cluster)."}]}