1. Registry
  2. Packages
  3. Oh Dear
Viewing docs for Oh Dear v1.0.0
published on Tuesday, Sep 1, 2026 by Matthias Hamacher
ohdear logo
Viewing docs for Oh Dear v1.0.0
published on Tuesday, Sep 1, 2026 by Matthias Hamacher

    The Oh Dear provider for Pulumi lets you manage Oh Dear website monitoring in code: monitors, status pages, tags and tag groups, and notification destinations.

    It talks to the Oh Dear API directly and is authenticated with a single API token sent as a Bearer token on every request.

    Example

    import * as ohdear from "@matthiashamacher/ohdear";
    
    // Monitor a website with the uptime and certificate checks.
    const site = new ohdear.Monitor("docs", {
        url: "https://example.com",
        teamId: 1,
        type: "http",
        checks: ["uptime", "certificate_health"],
        tags: ["production"],
    });
    
    // Group related tags together.
    const envs = new ohdear.TagGroup("environments", {
        teamId: 1,
        label: "Environments",
        tags: ["production", "staging"],
    });
    
    // A public status page that lists the monitor.
    const status = new ohdear.StatusPage("public", {
        teamId: 1,
        title: "Example Status",
        monitors: [{ id: site.monitorId, clickable: true }],
    });
    
    // Email alerts for the monitor.
    const alerts = new ohdear.NotificationDestination("email", {
        level: "monitor",
        ownerId: site.monitorId,
        channel: "mail",
        destination: { mail: "alerts@example.com" },
        notificationTypes: [
            "HttpUptimeCheckFailedNotification",
            "HttpUptimeCheckRecoveredNotification",
        ],
    });
    

    Resources

    ResourcePurpose
    MonitorA monitored URL or host (http, ping, tcp, ai) and its checks.
    CronCheckA cron job monitor on a Monitor; ping its URL on each successful run.
    RecurringMaintenancePeriodA recurring maintenance schedule (daily, weekly or monthly) for a Monitor.
    TagA tag used to organize monitors. Create-only upstream.
    TagGroupA named group of tags, with wildcard matching.
    StatusPageA public status page and the monitors shown on it.
    NotificationDestinationWhere alerts are delivered, scoped to a team, monitor, tag or tag group.

    See the Installation & Configuration tab for setup and the API Docs tab for the full input and output reference of each resource.

    ohdear logo
    Viewing docs for Oh Dear v1.0.0
    published on Tuesday, Sep 1, 2026 by Matthias Hamacher

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial