Open-source status page, incident response and uptime monitoring
TypeScript alertingincident-managementmcpmcp-servermonitoringmonitoring-as-codeobservabilityon-callopen-sourcesrestatus-pagestatuspagesynthetic-monitoringterraformtinybirdtursouptimeuptime-checkeruptime-monitor
feat(dashboard): warn when page components link inactive monitors (#2923)
Maximilian Kaskedad9afe8380a
diff --git a/.claude/commands/ship.md b/.claude/commands/ship.mdindex e063ec98e..5dee41b02 100644--- a/.claude/commands/ship.md+++ b/.claude/commands/ship.md@@ -20,7 +20,7 @@ $ARGUMENTS - optional branch name- Confirm there are uncommitted changes (from status above). If none, stop.- Confirm current branch. If not on `main`, ask user before proceeding.- Warn if any .env or credential files would be staged.-- Run `pnpm format:fix` in the root directory to fix formatting issues+- Run `pnpm format` in the root directory to fix formatting issues## 2. Create Branchdiff --git a/apps/dashboard/src/app/(dashboard)/monitors/[id]/nav-actions.tsx b/apps/dashboard/src/app/(dashboard)/monitors/[id]/nav-actions.tsxindex 84ac57a45..cfcdca253 100644--- a/apps/dashboard/src/app/(dashboard)/monitors/[id]/nav-actions.tsx+++ b/apps/dashboard/src/app/(dashboard)/monitors/[id]/nav-actions.tsx@@ -17,6 +17,7 @@ import { useParams, usePathname, useRouter } from "next/navigation";import { useState } from "react";import { toast } from "sonner";+import { MonitorStatusDot } from "@/components/common/monitor-status-dot";import { DataTableSheetTest } from "@/components/data-table/response-logs/data-table-sheet-test";import { QuickActions } from "@/components/dropdowns/quick-actions";import { NavFeedback } from "@/components/nav/nav-feedback";@@ -212,37 +213,7 @@ export function NavActions() {<div className="flex items-center gap-2 text-sm"><NavFeedback /><div className="text-muted-foreground hidden font-medium lg:inline-block">- <Tooltip>- <TooltipTrigger asChild>- {!monitor.active ? (- <span className="relative ml-1.5 inline-flex">- <span className="bg-muted-foreground/70 relative inline-flex h-2.5 w-2.5 rounded-full" />- </span>- ) : monitor.status === "active" ? (- <span className="relative ml-1.5 inline-flex">- <span className="bg-success/80 absolute inline-flex h-full w-full animate-ping rounded-full opacity-75" />- <span className="bg-success relative inline-flex h-2.5 w-2.5 rounded-full" />- </span>- ) : monitor.status === "error" ? (- <span className="relative ml-1.5 inline-flex">- <span className="bg-destructive relative inline-flex h-2.5 w-2.5 rounded-full" />- </span>- ) : (- <span className="relative ml-1.5 inline-flex">- <span className="bg-warning relative inline-flex h-2.5 w-2.5 rounded-full" />- </span>- )}- </TooltipTrigger>- <TooltipContent>- {!monitor.active- ? "Inactive"- : monitor.status === "active"- ? "Normal"- : monitor.status === "error"- ? "Failing"- : "Degraded"}- </TooltipContent>- </Tooltip>+ <MonitorStatusDot monitor={monitor} className="ml-1.5" /></div><TooltipProvider><Tooltip>diff --git a/apps/dashboard/src/components/common/monitor-status-dot.tsx b/apps/dashboard/src/components/common/monitor-status-dot.tsxnew file mode 100644index 000000000..9f8c03099--- /dev/null+++ b/apps/dashboard/src/components/common/monitor-status-dot.tsx@@ -0,0 +1,51 @@+import {+ Tooltip,+ TooltipContent,+ TooltipTrigger,+} from "@openstatus/ui/components/ui/tooltip";+import { cn } from "@openstatus/ui/lib/utils";++export function MonitorStatusDot({+ monitor,+ label,+ className,+}: {+ monitor: { active: boolean | null; status: string };+ /** Overrides the default tooltip text */+ label?: React.ReactNode;+ className?: string;+}) {+ const text =+ label ??+ (!monitor.active+ ? "Inactive"+ : monitor.status === "active"+ ? "Normal"+ : monitor.status === "error"+ ? "Failing"+ : "Degraded");++ return (+ <Tooltip>+ <TooltipTrigger asChild>+ {/* biome-ignore lint/a11y/noNoninteractiveTabindex: focusable so keyboard users can open the tooltip */}+ <span tabIndex={0} className={cn("relative inline-flex", className)}>+ {!monitor.active ? (+ <span className="bg-muted-foreground/70 relative inline-flex h-2.5 w-2.5 rounded-full" />+ ) : monitor.status === "active" ? (+ <>+ <span className="bg-success/80 absolute inline-flex h-full w-full animate-ping rounded-full opacity-75" />+ <span className="bg-success relative inline-flex h-2.5 w-2.5 rounded-full" />+ </>+ ) : monitor.status === "error" ? (+ <span className="bg-destructive relative inline-flex h-2.5 w-2.5 rounded-full" />+ ) : (+ <span className="bg-warning relative inline-flex h-2.5 w-2.5 rounded-full" />+ )}+ <span className="sr-only">{text}</span>+ </span>+ </TooltipTrigger>+ <TooltipContent>{text}</TooltipContent>+ </Tooltip>+ );+}diff --git a/apps/dashboard/src/components/forms/components/form-components.tsx b/apps/dashboard/src/components/forms/components/form-components.tsxindex 50a09d4f4..1246f95ff 100644--- a/apps/dashboard/src/components/forms/components/form-components.tsx+++ b/apps/dashboard/src/components/forms/components/form-components.tsx@@ -12,6 +12,7 @@ import {Unlinked,Plug,Delete,+ Info,} from "@openstatus/icons";import {AlertDialog,@@ -66,6 +67,8 @@ import { toast } from "sonner";import { z } from "zod";import { Link } from "@/components/common/link";+import { MonitorStatusDot } from "@/components/common/monitor-status-dot";+import { Note } from "@/components/common/note";import {EmptyStateContainer,EmptyStateTitle,@@ -81,7 +84,6 @@ import {FormCardSeparator,FormCardTitle,} from "@/components/forms/form-card";-import { STATUS } from "@/components/nav/nav-monitors";import {Sortable,SortableContent,@@ -289,6 +291,14 @@ export function FormComponents({const watchComponents = form.watch("components");const watchGroups = form.watch("groups");const [openUpgradeDialog, setOpenUpgradeDialog] = useState(false);+ const linkedMonitorIds = new Set(+ [...watchComponents, ...watchGroups.flatMap((g) => g.components)].map(+ (c) => c.monitorId,+ ),+ );+ const hasInactiveMonitors = monitors.some(+ (m) => !m.active && linkedMonitorIds.has(m.id),+ );const [data, setData] = useState<(PageComponent | ComponentGroup)[]>(getSortedItems(allPageComponents,@@ -629,7 +639,15 @@ export function FormComponents({/></FormCardContent><FormCardSeparator />- <FormCardContent>+ <FormCardContent className="grid gap-4">+ {hasInactiveMonitors ? (+ <Note color="warning">+ <Info />+ You have inactive monitors linked. They don't collect data, so+ activate them, use static components, or set the status source+ to Reports only.+ </Note>+ ) : null}<Sortablevalue={data}onValueChange={onValueChange}@@ -840,16 +858,12 @@ function ComponentRow({</div>) : null}{component.monitor && component.type === "monitor" ? (- <div- className={cn(- "size-2 rounded-full",- STATUS[- component.monitor.active- ? component.monitor.status- : "inactive"- ],- )}- />+ <TooltipProvider delayDuration={0}>+ <MonitorStatusDot+ monitor={component.monitor}+ label={component.monitor.active ? "Active" : "Inactive"}+ />+ </TooltipProvider>) : null}</div><AlertDialog>diff --git a/apps/web/src/content/pages/docs/reference/page-components.mdx b/apps/web/src/content/pages/docs/reference/page-components.mdxindex 9ad99ecb3..fedf2cd52 100644--- a/apps/web/src/content/pages/docs/reference/page-components.mdx+++ b/apps/web/src/content/pages/docs/reference/page-components.mdx@@ -23,9 +23,9 @@ Page components come in two distinct types, each serving different purposes on y**Type:** `monitor`-Monitor components are linked to an active monitor in your workspace. They automatically inherit the monitor's status and display real-time health information.+Monitor components are linked to a monitor in your workspace. While the monitor is active, they automatically inherit its status and display real-time health information.-**Characteristics:**+**Characteristics (while the linked monitor is active):**- Display live monitor status (up, degraded, down).- Show active incidents from the linked monitor.- Include historical uptime data.@@ -38,6 +38,10 @@ Monitor components are linked to an active monitor in your workspace. They autom- Tracking critical service dependencies.- Monitoring infrastructure components.+<Aside type="caution">+A monitor component only shares data while its monitor is active. Inactive monitors don't run checks, so the component shows no monitor-check history and no incidents. Status reports and maintenances still apply, and still populate the bars in **Reports only** mode. To keep a service on your status page without monitoring it, use a [static component](#static-components) or set the status source to [**Reports only**](/docs/guides/how-to-configure-status-page#1-components-configuration).+</Aside>+#### Configuring monitor componentsWhen you create a monitor component, you link it to an existing monitor in your workspace. This connection provides several benefits:@@ -63,7 +67,7 @@ Monitor components calculate uptime percentages based on:**Monitor selection:**When adding a monitor component, the dashboard shows you available monitors with indicators for:- **Public/Private status**: Whether the monitor is already public.-- **Active status**: Only active monitors can be linked.+- **Active status**: Inactive monitors can be linked, but don't share data until they're activated again. The dashboard warns you when a linked monitor is inactive.- **Already linked**: Monitors already used on this status page are unavailable.<Aside type="tip">@@ -258,7 +262,6 @@ You can add components to your status page in two ways:2. **Components within groups:** Add a component directly into a new or existing group.When adding a monitor component, you can only select from monitors that:-- Are currently active.- Have not been deleted.- Are not already linked to another component on this status page.