98-error-handler.json

{
  "name": "98 - Global Error Handler (dead-letter + Telegram/email)",
  "nodes": [
    {
      "parameters": {},
      "id": "error-trigger",
      "name": "Error Trigger",
      "type": "n8n-nodes-base.errorTrigger",
      "typeVersion": 1,
      "position": [180, 300]
    },
    {
      "parameters": {
        "operation": "executeQuery",
        "query": "INSERT INTO n8n_failure_events\n  (workflow_id, workflow_name, execution_id, last_node, error_message, raw)\nVALUES (\n  '{{ $json.workflow.id || \"\" }}',\n  '{{ $json.workflow.name || \"unknown\" }}',\n  '{{ $json.execution.id || \"\" }}',\n  '{{ $json.execution.lastNodeExecuted || \"\" }}',\n  '{{ ($json.error.message || \"unknown error\").replace(/'/g, \"''\") }}',\n  '{{ JSON.stringify($json).replace(/'/g, \"''\") }}'::jsonb\n)\nRETURNING id, error_signature;",
        "options": {}
      },
      "id": "insert-dead-letter",
      "name": "Insert n8n failure event",
      "type": "n8n-nodes-base.postgres",
      "typeVersion": 2.5,
      "position": [420, 300],
      "onError": "continueRegularOutput",
      "credentials": {
        "postgres": {
          "id": "pwwVNTLBw43PJgey",
          "name": "Sergeant Postgres (sergeant-db)"
        }
      }
    },
    {
      "parameters": {
        "operation": "executeQuery",
        "query": "SELECT COUNT(*) AS prior_alerts\nFROM n8n_failure_events\nWHERE workflow_id = '{{ $('Error Trigger').first().json.workflow.id || \"\" }}'\n  AND error_signature = '{{ $json.error_signature }}'\n  AND created_at > NOW() - INTERVAL '30 minutes'\n  AND id <> {{ $json.id }};",
        "options": {}
      },
      "id": "check-cooldown",
      "name": "Check 30-min cooldown",
      "type": "n8n-nodes-base.postgres",
      "typeVersion": 2.5,
      "position": [620, 300],
      "onError": "continueRegularOutput",
      "credentials": {
        "postgres": {
          "id": "pwwVNTLBw43PJgey",
          "name": "Sergeant Postgres (sergeant-db)"
        }
      }
    },
    {
      "parameters": {
        "conditions": {
          "options": {
            "caseSensitive": true,
            "leftValue": "",
            "typeValidation": "strict"
          },
          "conditions": [
            {
              "id": "prior-alerts-zero",
              "leftValue": "={{ Number($json.prior_alerts ?? 0) }}",
              "rightValue": 0,
              "operator": {
                "type": "number",
                "operation": "equals"
              }
            }
          ],
          "combinator": "and"
        },
        "options": {}
      },
      "id": "if-cooldown-elapsed",
      "name": "IF cooldown elapsed",
      "type": "n8n-nodes-base.if",
      "typeVersion": 2,
      "position": [820, 300]
    },
    {
      "parameters": {
        "jsCode": "// ADR-0038, Wave 3 §3.2 — pre-Telegram step that builds a stable\n// `alertId` keyed on (failed_workflow_id, error_signature) so each\n// failure class produces exactly one ack-row per 30-min cooldown\n// window (WF-98's SQL cooldown already filters at this granularity).\n//\n// WF-98 has no errorWorkflow set, so the chained POST /alerts/post\n// failing cannot loop back here.\nconst err = $('Error Trigger').first()?.json ?? {};\nconst inserted = $('Insert n8n failure event').first()?.json ?? {};\nconst erroredWorkflowId = err.workflow?.id || 'unknown';\nconst erroredWorkflowName = err.workflow?.name || 'unknown';\nconst erroredExecutionId = err.execution?.id || 'unknown';\nconst lastNode = err.execution?.lastNodeExecuted || 'unknown';\nconst errorMessage = err.execution?.error?.message || err.error?.message || 'unknown error';\nconst errorSignature = inserted.error_signature || 'no-signature';\nconst alertId = `wf98:${erroredWorkflowId}:${errorSignature}`;\nconst summary = `n8n workflow failed — ${erroredWorkflowName} @ ${lastNode}: ${errorMessage}`;\nreturn [{\n  json: {\n    alertId,\n    summary,\n    metadata: {\n      workflowId: $workflow.id || 'unknown',\n      executionId: $execution.id || 'unknown',\n      erroredWorkflowId,\n      erroredWorkflowName,\n      erroredExecutionId,\n      lastNode,\n      errorMessage,\n      errorSignature,\n      failureEventId: inserted.id ?? null,\n    },\n  },\n}];"
      },
      "id": "build-alert-payload-98",
      "name": "Build alert payload (n8n-failure)",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [1040, 220]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "={{ $env.PUBLIC_API_BASE_URL || 'https://api.invalid.local' }}/api/internal/alerts/post",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "=Bearer {{ $env.INTERNAL_API_KEY }}"
            },
            {
              "name": "Content-Type",
              "value": "application/json"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={\n  \"alertId\": \"{{ $json.alertId }}\",\n  \"topic\": \"meta\",\n  \"severity\": \"P0\",\n  \"summary\": \"{{ $json.summary }}\",\n  \"metadata\": {{ JSON.stringify($json.metadata) }}\n}",
        "options": {
          "response": {
            "response": {
              "neverError": true,
              "fullResponse": false
            }
          }
        }
      },
      "id": "post-alert-row-98",
      "name": "POST /api/internal/alerts/post (n8n-failure)",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [1240, 220],
      "onError": "continueRegularOutput"
    },
    {
      "parameters": {
        "chatId": "={{ $env.TELEGRAM_ALERT_CHAT_ID }}",
        "text": "=🚨 *n8n workflow failed*\n\nWorkflow: `{{ $('Error Trigger').first().json.workflow.name || 'unknown' }}`\nExecution: `{{ $('Error Trigger').first().json.execution.id || 'unknown' }}`\nNode: `{{ $('Error Trigger').first().json.execution.lastNodeExecuted || 'unknown' }}`\nError: {{ $('Error Trigger').first().json.execution.error.message || 'unknown error' }}",
        "additionalFields": {
          "parse_mode": "Markdown",
          "message_thread_id": "={{ $env.TELEGRAM_TOPIC_META }}",
          "reply_markup": "={\"inline_keyboard\":[[{\"text\":\"✅ Прочитав\",\"callback_data\":\"ack:r:{{ $('Build alert payload (n8n-failure)').item.json.alertId }}\"},{\"text\":\"🔄 Розбираю\",\"callback_data\":\"ack:i:{{ $('Build alert payload (n8n-failure)').item.json.alertId }}\"},{\"text\":\"🔕 Замутити 30хв\",\"callback_data\":\"ack:m:{{ $('Build alert payload (n8n-failure)').item.json.alertId }}\"}]]}"
        }
      },
      "id": "telegram-alert",
      "name": "Telegram failure alert",
      "type": "n8n-nodes-base.telegram",
      "typeVersion": 1.2,
      "position": [1440, 220],
      "credentials": {
        "telegramApi": {
          "id": "ggxeCc1ALZKLuMPV",
          "name": "Telegram (Sergeant_alert_bot)"
        }
      }
    },
    {
      "parameters": {},
      "id": "noop-suppressed",
      "name": "Suppressed (within cooldown)",
      "type": "n8n-nodes-base.noOp",
      "typeVersion": 1,
      "position": [1040, 400],
      "notes": "Alert suppressed: identical (workflow_id, error_signature) was already alerted in the last 30 min. Event is logged in n8n_failure_events but does not page Telegram."
    }
  ],
  "connections": {
    "Error Trigger": {
      "main": [
        [
          {
            "node": "Insert n8n failure event",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Insert n8n failure event": {
      "main": [
        [
          {
            "node": "Check 30-min cooldown",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Check 30-min cooldown": {
      "main": [
        [
          {
            "node": "IF cooldown elapsed",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "IF cooldown elapsed": {
      "main": [
        [
          {
            "node": "Build alert payload (n8n-failure)",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "Suppressed (within cooldown)",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Build alert payload (n8n-failure)": {
      "main": [
        [
          {
            "node": "POST /api/internal/alerts/post (n8n-failure)",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "POST /api/internal/alerts/post (n8n-failure)": {
      "main": [
        [
          {
            "node": "Telegram failure alert",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {
    "executionOrder": "v1",
    "timezone": "Europe/Kyiv"
  },
  "active": false,
  "tags": [
    {
      "name": "ops"
    },
    {
      "name": "dead-letter"
    }
  ]
}