Datadog Dashboard Alert History Badge

WHAT IT DOES

This userscript adds a real-time alert status monitor to your Datadog dashboard. It reads alert history entries from the page—extracting alert status (triggered, recovered, warning, no data), timestamps, and alert names—and displays a compact badge showing the current overall alert status with a color-coded indicator: green for all recovered, yellow for warnings, orange for triggered, and red for critical. A detailed breakdown shows total alerts, triggered count, recovered count, and warning count. The active alerts list displays all currently active alerts with their status and relative timestamps, plus one-click links to the monitor page for each alert. This is invaluable for SREs, DevOps engineers, and developers who need to monitor system health, quickly identify issues, and triage incidents without navigating away from the dashboard.

WHERE IT RUNS

The script runs on all Datadog web application pages at *.datadoghq.com/*, with automatic detection of dashboards, monitor pages, and any page displaying alert history or monitor status. It works across all Datadog interfaces by using multiple selector strategies to find alert entries, status indicators, monitor names, and timestamps. The script detects dynamic content loading and re-renders the badge when the alert list updates. It runs across the entire Datadog domain, ensuring coverage whether you're viewing the main dashboard, a monitor list, or a specific alert history view.

HOW TO USE

Install the script via the BotGentz extension and navigate to any Datadog dashboard or monitor page. The alert history badge will appear in the header automatically, showing the overall status with a color-coded indicator. The detailed breakdown shows total alerts, triggered, warnings, and recovered counts. The active alerts list displays all currently active alerts with their status, relative timestamp, and a one-click ↗ button to open the monitor page. Use the panel controls to customize your experience: toggle the alert badge on or off, show or hide the detailed breakdown, enable or disable the active alerts list, or adjust the number of alerts displayed (1-20). The "Refresh" button manually rescans the page for updated alert data, and the "Copy" button exports the alert summary to your clipboard for reporting.

THE MECHANISM - ALERT EXTRACTION, STATUS CLASSIFICATION, AND ACTIVE ALERT FILTERING

This script identifies alert history entries by scanning the DOM for known Datadog alert elements. It uses a cascading selector strategy that looks for alert entries (.alert-entry, .alert-item, .monitor-alert, .event-row), then extracts alert names from name elements, status from status badges or state indicators, timestamps from date elements, and monitor links from anchor elements. Status is normalized to "triggered," "recovered," "warning," or "no_data" based on text matching and class analysis. Active alerts are filtered as those with status "triggered," "warning," or "no_data." The overall status is determined by the highest severity active alert: triggered is critical, warnings are warning, and recovered is green. The badge is built as a DOM element with inline styles and inserted into the dashboard header. The active alerts list shows alerts sorted by recency with clickable monitor links using GM_openInTab.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the Datadog page. Drag by the header to reposition it, and the position is saved per site using GM_setValue so it stays where you left it across sessions. Release the panel near any edge and it snaps into place, keeping your workspace organized. Click the panel header to collapse it into a small bubble showing only the bell emoji (🔔), minimizing distraction while keeping controls accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes all setting toggles, the alert count control, action buttons, and a legend. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Datadog, with the alert badge updating automatically as you move between views.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Datadog users who need to monitor alert status and system health. The script reads only visible alert data from the DOM—it does not access Datadog's API, your account credentials, or any sensitive information. All settings (badge visibility, breakdown toggle, active list toggle, display count, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your Datadog data—it only reads and visualizes visible alert information. The active alerts list is based on the alerts currently visible on the page; if the list is filtered or paginated, the summary may not include all active alerts. If Datadog updates its website structure, the script may need to be updated to match new selectors. The monitor links open in a new tab; ensure your browser allows pop-ups for this functionality.