Mimir integration

.github/workflows/ci-main.yml

@@ -142,6 +142,7 @@ jobs:
             context: proxy
           - component: mimir
             context: services/mimir
+            image_description: Mimir alertmanager backend for My Nethesis
 
     steps:
     - uses: actions/checkout@v4
@@ -175,7 +176,9 @@ jobs:
         platforms: linux/amd64
         push: ${{ github.event_name != 'pull_request' }}
         tags: ${{ steps.meta.outputs.tags }}
-        labels: ${{ steps.meta.outputs.labels }}
+        labels: |
+          ${{ steps.meta.outputs.labels }}
+          ${{ matrix.image_description != '' && format('org.opencontainers.image.description={0}', matrix.image_description) || '' }}
         cache-from: type=gha,scope=${{ matrix.component }}
         cache-to: type=gha,mode=max,scope=${{ matrix.component }}
         build-args: |

AGENTS.md

@@ -100,7 +100,7 @@ Source of truth for routes: `backend/main.go`. Source of truth for the API contr
 
 ### 3.2 Collect (`collect/`)
 
-Inventory ingestion + Mimir proxy + HostDown cron.
+Inventory ingestion + Mimir proxy + LinkFailed cron.
 
 ```
 main.go
@@ -111,7 +111,7 @@ main.go
   --> workers/ (InventoryWorker, DiffWorker, NotificationWorker, CleanupWorker,
                 QueueMonitorWorker, DelayedMessageWorker — all started by manager.go)
   --> differ/ (YAML-configured JSON diff engine, severity/significance)
-  --> cron/ (heartbeat_monitor.go — alive/dead/zombie + HostDown alert poster)
+  --> cron/ (heartbeat_monitor.go — alive/dead/zombie + LinkFailed alert poster)
 ```
 
 Key properties:

backend/.env.example

@@ -78,6 +78,15 @@ REDIS_URL=redis://localhost:6379
 # System configuration
 #SYSTEM_TYPES=ns8,nsec
 
+# ===========================================
+# MIMIR CONFIGURATION (Optional)
+# ===========================================
+#MIMIR_URL=http://localhost:9009
+
+# Built-in history webhook: when set, Alertmanager always fires this webhook
+# for every alert (non-bypassable). Leave unset to disable.
+#ALERTING_HISTORY_WEBHOOK_URL=
+
 # ===========================================
 # AUTO-DERIVED URLS (DO NOT SET MANUALLY)
 # ===========================================

backend/.render-build-trigger

@@ -2,9 +2,9 @@
 # This file is used to force Docker service rebuilds in PR previews
 # Modify LAST_UPDATE to trigger rebuilds
 
-LAST_UPDATE=2026-03-09T09:01:19Z
+LAST_UPDATE=2026-04-07T13:40:58Z
 
 # Instructions:
 # 1. To force rebuild of Docker services in a PR, update LAST_UPDATE
-# 2. Run: perl -i -pe "s/LAST_UPDATE=2026-03-09T09:01:19Z
-# 2. Commit and push changes to trigger Docker rebuilds
+# 2. Run: perl -i -pe "s/LAST_UPDATE=2026-04-07T13:40:58Z/LAST_UPDATE=$(date -u +%Y-%m-%dT%H:%M:%SZ)/" $f/.render-build-trigger
+# 2. Commit and push changes to trigger Docker rebuilds

backend/configuration/configuration.go

@@ -67,6 +67,11 @@ type Configuration struct {
 	SMTPFrom     string `json:"smtp_from"`
 	SMTPFromName string `json:"smtp_from_name"`
 	SMTPTLS      bool   `json:"smtp_tls"`
+	// Mimir configuration
+	MimirURL string `json:"mimir_url"`
+	// Alerting configuration
+	AlertingHistoryWebhookURL   string `json:"alerting_history_webhook_url"`
+	AlertingHistoryWebhookToken string `json:"alerting_history_webhook_token"`
 }
 
 var Config = Configuration{}
@@ -204,6 +209,18 @@ func Init() {
 	}
 	Config.SMTPTLS = parseBoolWithDefault("SMTP_TLS", true)
 
+	// Mimir configuration
+	if mimirURL := os.Getenv("MIMIR_URL"); mimirURL != "" {
+		Config.MimirURL = mimirURL
+	} else {
+		Config.MimirURL = "http://localhost:9009"
+		logger.LogConfigLoad("env", "MIMIR_URL", true, fmt.Errorf("MIMIR_URL variable is empty, using default http://localhost:9009"))
+	}
+
+	// Alerting configuration — optional, empty means no built-in history webhook
+	Config.AlertingHistoryWebhookURL = os.Getenv("ALERTING_HISTORY_WEBHOOK_URL")
+	Config.AlertingHistoryWebhookToken = os.Getenv("ALERTING_HISTORY_WEBHOOK_TOKEN")
+
 	// Log successful configuration load
 	logger.LogConfigLoad("env", "configuration", true, nil)
 }

backend/database/migrations/019_add_alert_history.sql

@@ -0,0 +1,41 @@
+-- Migration 019: Add alert_history table
+-- Stores resolved/inactive alerts received from Alertmanager webhooks
+
+CREATE TABLE IF NOT EXISTS alert_history (
+    id             BIGSERIAL PRIMARY KEY,
+
+    -- System identification
+    system_key     VARCHAR(255) NOT NULL,
+
+    -- Alert identity
+    alertname      VARCHAR(255) NOT NULL,
+    severity       VARCHAR(50),
+    status         VARCHAR(50)  NOT NULL,  -- resolved
+    fingerprint    VARCHAR(255) NOT NULL,
+
+    -- Timing
+    starts_at      TIMESTAMP WITH TIME ZONE NOT NULL,
+    ends_at        TIMESTAMP WITH TIME ZONE,
+
+    -- Human-readable summary (from annotations.summary)
+    summary        TEXT,
+
+    -- Raw labels and annotations from the alert
+    labels         JSONB NOT NULL DEFAULT '{}',
+    annotations    JSONB NOT NULL DEFAULT '{}',
+
+    -- Alertmanager receiver that handled the alert
+    receiver       VARCHAR(255),
+
+    -- Timestamps
+    created_at     TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW()
+);
+
+COMMENT ON TABLE alert_history IS 'Resolved and inactive alerts received from Alertmanager webhooks';
+COMMENT ON COLUMN alert_history.system_key IS 'System key extracted from alert labels.system_key';
+COMMENT ON COLUMN alert_history.fingerprint IS 'Alert fingerprint from Alertmanager (hash of labels)';
+COMMENT ON COLUMN alert_history.status IS 'Alert status at time of receipt: resolved';
+COMMENT ON COLUMN alert_history.ends_at IS 'NULL when end time is the zero time (0001-01-01)';
+
+CREATE INDEX IF NOT EXISTS idx_alert_history_system_key_created_at ON alert_history(system_key, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_alert_history_starts_at ON alert_history(starts_at DESC);

backend/database/migrations/019_add_alert_history_rollback.sql

@@ -0,0 +1,3 @@
+-- Rollback migration 018: Drop alert_history table
+
+DROP TABLE IF EXISTS alert_history;

backend/database/schema.sql

@@ -703,6 +703,52 @@ CREATE INDEX IF NOT EXISTS idx_inventory_alerts_system_id_created_at ON inventor
 CREATE INDEX IF NOT EXISTS idx_inventory_alerts_severity ON inventory_alerts(severity);
 CREATE INDEX IF NOT EXISTS idx_inventory_alerts_resolved ON inventory_alerts(is_resolved) WHERE is_resolved = FALSE;
 
+-- =============================================================================
+-- ALERT HISTORY TABLE
+-- =============================================================================
+-- Resolved and inactive alerts received from Alertmanager webhooks
+
+CREATE TABLE IF NOT EXISTS alert_history (
+    id             BIGSERIAL PRIMARY KEY,
+
+    -- System identification
+    system_key     VARCHAR(255) NOT NULL,
+
+    -- Alert identity
+    alertname      VARCHAR(255) NOT NULL,
+    severity       VARCHAR(50),
+    status         VARCHAR(50)  NOT NULL,  -- resolved
+    fingerprint    VARCHAR(255) NOT NULL,
+
+    -- Timing
+    starts_at      TIMESTAMP WITH TIME ZONE NOT NULL,
+    ends_at        TIMESTAMP WITH TIME ZONE,
+
+    -- Human-readable summary (from annotations.summary)
+    summary        TEXT,
+
+    -- Raw labels and annotations from the alert
+    labels         JSONB NOT NULL DEFAULT '{}',
+    annotations    JSONB NOT NULL DEFAULT '{}',
+
+    -- Alertmanager receiver that handled the alert
+    receiver       VARCHAR(255),
+
+    -- Timestamps
+    created_at     TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW()
+);
+
+-- Table documentation
+COMMENT ON TABLE alert_history IS 'Resolved and inactive alerts received from Alertmanager webhooks';
+COMMENT ON COLUMN alert_history.system_key IS 'System key extracted from alert labels.system_key';
+COMMENT ON COLUMN alert_history.fingerprint IS 'Alert fingerprint from Alertmanager (hash of labels)';
+COMMENT ON COLUMN alert_history.status IS 'Alert status at time of receipt: resolved';
+COMMENT ON COLUMN alert_history.ends_at IS 'NULL when end time is the zero time (0001-01-01)';
+
+-- Performance indexes
+CREATE INDEX IF NOT EXISTS idx_alert_history_system_key_created_at ON alert_history(system_key, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_alert_history_starts_at ON alert_history(starts_at DESC);
+
 -- =============================================================================
 -- SCHEMA MIGRATIONS TABLE
 -- =============================================================================