upright 0.1.0

data/lib/generators/upright/install/templates/deploy.yml

@@ -0,0 +1,118 @@
+# Upright Kamal Configuration
+# Deploy with: bin/kamal deploy
+
+service: <%= app_name %>
+image: <%= app_name %>/<%= app_name %>
+
+servers:
+  web:
+    hosts:
+      - <%= app_domain %>: [london]
+      # Add more sites:
+      # - nyc.<%= app_domain %>: [new_york]
+      # - sfo.<%= app_domain %>: [san_francisco]
+  jobs:
+    hosts:
+      - <%= app_domain %>: [london]
+      # Add more sites:
+      # - nyc.<%= app_domain %>: [new_york]
+      # - sfo.<%= app_domain %>: [san_francisco]
+    cmd: bin/jobs
+
+ssh:
+  user: app
+
+registry:
+  server: ghcr.io
+  username:
+    - KAMAL_REGISTRY_USERNAME
+  password:
+    - KAMAL_REGISTRY_PASSWORD
+
+builder:
+  arch: amd64
+  secrets:
+    - GITHUB_TOKEN
+
+proxy:
+  app_port: 3000
+  ssl: true
+  hosts:
+    - "*.<%= app_domain %>"
+
+env:
+  clear:
+    OTEL_EXPORTER_OTLP_ENDPOINT: http://<%= app_name %>-otel_collector:4318/v1/traces
+    PROMETHEUS_URL: http://<%= app_name %>-prometheus:9090
+    ALERTMANAGER_URL: http://<%= app_name %>-alertmanager:9093
+  secret:
+    - RAILS_MASTER_KEY
+    - PROMETHEUS_OTLP_TOKEN
+  tags:
+    london:
+      SITE_SUBDOMAIN: lon
+    # Add more sites:
+    # new_york:
+    #   SITE_SUBDOMAIN: nyc
+    # san_francisco:
+    #   SITE_SUBDOMAIN: sfo
+
+volumes:
+  - "<%= app_name %>_storage:/rails/storage"
+
+accessories:
+  otel_collector:
+    image: otel/opentelemetry-collector-contrib:0.126.0
+    env:
+      secret:
+        - OTEL_GATEWAY_USERNAME
+        - OTEL_GATEWAY_PASSWORD
+        - OTEL_GATEWAY_AUTH
+        - PROMETHEUS_OTLP_TOKEN
+    files:
+      - config/otel_collector.yml:/etc/otelcol-contrib/config.yaml
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+      - /var/lib/docker/containers:/var/lib/docker/containers
+    options:
+      user: 0
+    roles:
+      - jobs
+
+  playwright:
+    image: jacoblincool/playwright:chromium-server-1.55.0
+    port: "127.0.0.1:53333:53333"
+    roles:
+      - jobs
+
+  prometheus:
+    image: prom/prometheus:v3.2.1
+    hosts:
+      - <%= app_domain %>
+    cmd: >-
+      --config.file=/etc/prometheus/prometheus.yml
+      --storage.tsdb.path=/prometheus
+      --storage.tsdb.retention.time=30d
+      --web.enable-otlp-receiver
+      --web.enable-lifecycle
+    files:
+      - config/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml
+      - config/prometheus/rules/upright.rules.yml:/etc/prometheus/rules/upright.rules.yml
+    volumes:
+      - prometheus_data:/prometheus
+
+  alertmanager:
+    image: prom/alertmanager:v0.28.1
+    hosts:
+      - <%= app_domain %>
+    cmd: --config.file=/etc/alertmanager/alertmanager.yml
+    files:
+      - config/alertmanager/alertmanager.yml:/etc/alertmanager/alertmanager.yml
+    volumes:
+      - alertmanager_data:/alertmanager
+
+aliases:
+  console: app exec -i "bin/rails console"
+  logs: app logs -f
+
+retain_containers: 3

data/lib/generators/upright/install/templates/development_alertmanager.yml

@@ -0,0 +1,11 @@
+global:
+  resolve_timeout: 5m
+
+route:
+  receiver: default
+  group_wait: 30s
+  group_interval: 5m
+  repeat_interval: 4h
+
+receivers:
+  - name: default

data/lib/generators/upright/install/templates/development_prometheus.yml

@@ -0,0 +1,12 @@
+global:
+  scrape_interval: 15s
+  evaluation_interval: 15s
+
+rule_files:
+  - rules/*.yml
+
+scrape_configs:
+  - job_name: "upright"
+    scrape_interval: 5s
+    static_configs:
+      - targets: ["localhost:9394"]

data/lib/generators/upright/install/templates/docker-compose.yml

@@ -0,0 +1,38 @@
+services:
+  prometheus:
+    image: prom/prometheus:v3.4.1
+    container_name: <%= app_name %>-prometheus
+    network_mode: host
+    volumes:
+      - ./config/prometheus/development/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+      - ./config/prometheus/rules:/etc/prometheus/rules:ro
+      - prometheus_data:/prometheus
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--web.enable-lifecycle'
+      - '--web.enable-remote-write-receiver'
+
+  alertmanager:
+    image: prom/alertmanager:v0.28.1
+    container_name: <%= app_name %>-alertmanager
+    ports:
+      - "9093:9093"
+    volumes:
+      - ./config/alertmanager/development/alertmanager.yml:/etc/alertmanager/alertmanager.yml:ro
+      - alertmanager_data:/alertmanager
+    command:
+      - '--config.file=/etc/alertmanager/alertmanager.yml'
+      - '--storage.path=/alertmanager'
+
+  playwright:
+    image: jacoblincool/playwright:chromium-server-1.56.1
+    container_name: <%= app_name %>-playwright
+    ports:
+      - "53333:53333"
+    environment:
+      - DEBUG=true
+
+volumes:
+  prometheus_data:
+  alertmanager_data:

data/lib/generators/upright/install/templates/http_probes.yml

@@ -0,0 +1,14 @@
+# HTTP Probe Definitions
+# Add your HTTP health check probes here
+#
+# Required fields:
+#   - name: Unique identifier for the probe
+#   - url: The URL to check
+#
+# Optional fields:
+#   - expected_status: HTTP status code to expect (default: 200-399)
+#   - basic_auth_credentials: Key in Rails credentials for basic auth
+#   - proxy: Key in Rails credentials for proxy settings
+
+- name: Example Health Check
+  url: https://example.com

data/lib/generators/upright/install/templates/omniauth.rb

@@ -0,0 +1,8 @@
+# WARNING: Change the default password before deploying to production!
+# Set the ADMIN_PASSWORD environment variable or update the credentials below.
+
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :static_credentials,
+    title: "Sign In",
+    credentials: { "admin" => ENV.fetch("ADMIN_PASSWORD", "upright") }
+end

data/lib/generators/upright/install/templates/otel_collector.yml

@@ -0,0 +1,24 @@
+receivers:
+  otlp:
+    protocols:
+      http:
+        endpoint: 0.0.0.0:4318
+
+processors:
+  batch:
+    timeout: 2s
+
+exporters:
+  debug:
+    verbosity: detailed
+
+service:
+  pipelines:
+    traces:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug]
+    metrics:
+      receivers: [otlp]
+      processors: [batch]
+      exporters: [debug]

data/lib/generators/upright/install/templates/prometheus.yml

@@ -0,0 +1,10 @@
+global:
+  evaluation_interval: 15s
+
+alerting:
+  alertmanagers:
+    - static_configs:
+        - targets: ['localhost:9093']
+
+rule_files:
+  - rules/*.yml

data/lib/generators/upright/install/templates/puma.rb

@@ -0,0 +1,40 @@
+# This configuration file will be evaluated by Puma. The top-level methods that
+# are invoked here are part of Puma's configuration DSL. For more information
+# about methods provided by the DSL, see https://puma.io/puma/Puma/DSL.html.
+
+# Puma starts a configurable number of processes (workers) and each process
+# serves each request in a thread from an internal thread pool.
+#
+# The ideal number of threads per worker depends both on how much time the
+# application spends waiting for IO operations and on how much you wish to
+# to prioritize throughput over latency.
+#
+# As a rule of thumb, increasing the number of threads will increase how much
+# traffic a given process can handle (throughput), but due to CRuby's
+# Global VM Lock (GVL) it has diminishing returns and will degrade the
+# response time (latency) of the application.
+#
+# The default is set to 3 threads as it's deemed a decent compromise between
+# throughput and latency for the average Rails application.
+#
+# Any libraries that use a connection pool or another resource pool should
+# be configured to provide at least as many connections as the number of
+# threads. This includes Active Record's `pool` parameter in `database.yml`.
+threads_count = ENV.fetch("RAILS_MAX_THREADS", 3)
+threads threads_count, threads_count
+
+# Specifies the `port` that Puma will listen on to receive requests; default is 3000.
+port ENV.fetch("PORT", 3000)
+
+# Allow puma to be restarted by `bin/rails restart` command.
+plugin :tmp_restart
+
+# Expose Prometheus metrics at http://0.0.0.0:9394/metrics
+activate_control_app "auto", no_token: true
+plugin :yabeda
+plugin :yabeda_prometheus
+prometheus_silence_logger true
+
+# Specify the PID file. Defaults to tmp/pids/server.pid in development.
+# In other environments, only set the PID file if requested.
+pidfile ENV["PIDFILE"] if ENV["PIDFILE"]

data/lib/generators/upright/install/templates/sites.yml

@@ -0,0 +1,26 @@
+# Upright Site Configuration
+# Define the geographic locations where probes run
+# Domain is automatically inferred as {code}.{hostname}
+
+shared:
+  sites:
+    - code: lon
+      city: London
+      country: GB
+      geohash: gcpvj0
+
+# Multi-site example:
+#
+# shared:
+#   sites:
+#     - code: ams
+#       city: Amsterdam
+#       country: NL
+#       geohash: u17982
+#       provider: digitalocean
+#
+#     - code: nyc
+#       city: New York City
+#       country: US
+#       geohash: dr5reg
+#       provider: digitalocean

data/lib/generators/upright/install/templates/smtp_probes.yml

@@ -0,0 +1,9 @@
+# SMTP Probe Definitions
+# Add your SMTP health check probes here
+#
+# Required fields:
+#   - name: Unique identifier for the probe
+#   - host: SMTP server hostname
+
+# - name: Example Mail Server
+#   host: mail.example.com

data/lib/generators/upright/install/templates/upright.rb

@@ -0,0 +1,21 @@
+# See: https://github.com/basecamp/upright
+
+Upright.configure do |config|
+  config.service_name = "<%= Rails.application.class.module_parent_name.underscore %>"
+  config.user_agent   = "<%= Rails.application.class.module_parent_name.underscore %>/1.0"
+  config.hostname     = Rails.env.local? ? "<%= Rails.application.class.module_parent_name.downcase %>.localhost" : "<%= Rails.application.class.module_parent_name.downcase %>.com"
+
+  # Playwright browser server URL
+  # config.playwright_server_url = ENV["PLAYWRIGHT_SERVER_URL"]
+
+  # OpenTelemetry endpoint
+  # config.otel_endpoint = ENV["OTEL_EXPORTER_OTLP_ENDPOINT"]
+
+  # Authentication via OpenID Connect (Logto, Keycloak, Duo, Okta, etc.)
+  # config.auth_provider = :openid_connect
+  # config.auth_options = {
+  #   issuer: ENV["OIDC_ISSUER"],
+  #   client_id: ENV["OIDC_CLIENT_ID"],
+  #   client_secret: ENV["OIDC_CLIENT_SECRET"]
+  # }
+end

data/lib/generators/upright/install/templates/upright.rules.yml

@@ -0,0 +1,256 @@
+# Upright Prometheus Alert Rules
+# Generated by: rails generate upright:install
+
+groups:
+  - name: upright_recording
+    interval: 30s
+    rules:
+      # Fraction of regions reporting DOWN (0.0 to 1.0)
+      - record: upright:probe_down_fraction
+        expr: |
+          count by (name, type, probe_target) (upright_probe_up == 0)
+          /
+          count by (name, type, probe_target) (upright_probe_up)
+
+      # Daily uptime percentage (0.0 to 1.0)
+      # Uptime = percentage of time in past day when majority of sites reported UP
+      - record: upright:probe_uptime_daily
+        expr: |
+          avg_over_time((
+            sum by (name, type, probe_target) (upright_probe_up)
+            /
+            count by (name, type, probe_target) (upright_probe_up)
+            > bool 0.5
+          )[1d:])
+
+  - name: upright_alerts
+    rules:
+      # Mass failure alert - fires when >20% of all probes are failing
+      # When this fires, individual probe alerts are suppressed via inhibition rules
+      - alert: UprightMassFailure
+        annotations:
+          summary: "Mass failure - {{ $value | humanizePercentage }} of probes down"
+          description: "Many probes failing simultaneously, likely an Upright or network issue"
+          upright: "https://app.<%= app_domain %>/?status=fail"
+        expr: |
+          count(upright:probe_down_fraction > 0.5)
+          /
+          count(count by (name, type, probe_target) (upright_probe_up))
+          > 0.2
+        labels:
+          severity: critical
+          group: upright
+
+      # Pool has fewer active sites than peak in last hour
+      - alert: UprightPoolDegraded
+        annotations:
+          summary: "Upright pool degraded - {{ $value }} site(s) missing"
+          description: "Upright pool degraded - {{ $value }} site(s) missing"
+          upright: "https://app.<%= app_domain %>/"
+        expr: |
+          max_over_time(count(count by (site_code) (upright_probe_up))[1h:1m])
+          -
+          count(count by (site_code) (upright_probe_up))
+          > 0
+        for: 5m
+        labels:
+          severity: critical
+          group: upright
+
+      # No HTTP metrics at all - probes completely stopped
+      - alert: UprightHTTPProbesMissing
+        annotations:
+          summary: "HTTP probes missing - no metrics received"
+          description: "No HTTP probe metrics are being reported. Upright may be down or probes are stuck."
+          upright: "https://app.<%= app_domain %>/?probe_type=http"
+        expr: absent(upright_probe_up{type="http"})
+        for: 5m
+        labels:
+          severity: critical
+          group: upright
+
+      # No SMTP metrics at all - probes completely stopped
+      - alert: UprightSMTPProbesMissing
+        annotations:
+          summary: "SMTP probes missing - no metrics received"
+          description: "No SMTP probe metrics are being reported. Upright may be down or probes are stuck."
+          upright: "https://app.<%= app_domain %>/?probe_type=smtp"
+        expr: absent(upright_probe_up{type="smtp"})
+        for: 5m
+        labels:
+          severity: critical
+          group: upright
+
+      # No Playwright metrics at all - probes completely stopped
+      - alert: UprightPlaywrightProbesMissing
+        annotations:
+          summary: "Playwright probes missing - no metrics received"
+          description: "No Playwright probe metrics are being reported. Browser probes may be stuck or Upright is down."
+          upright: "https://app.<%= app_domain %>/?probe_type=playwright"
+        expr: absent(upright_probe_up{type="playwright"})
+        for: 30m
+        labels:
+          severity: critical
+          group: upright
+
+      # Site stopped reporting HTTP probes (was reporting in last hour, not now)
+      - alert: UprightHTTPSiteMissing
+        annotations:
+          summary: "HTTP probes missing from {{ $labels.site_city }}"
+          description: "{{ $labels.site_city }} ({{ $labels.site_code }}) stopped reporting HTTP probe metrics."
+          upright: "https://{{ $labels.site_code }}.<%= app_domain %>/?probe_type=http"
+        expr: |
+          count by (site_code, site_city) (max_over_time(upright_probe_up{type="http"}[1h]))
+          unless
+          count by (site_code, site_city) (upright_probe_up{type="http"})
+        for: 5m
+        labels:
+          severity: warning
+          group: upright
+
+      # Site stopped reporting SMTP probes (was reporting in last hour, not now)
+      - alert: UprightSMTPSiteMissing
+        annotations:
+          summary: "SMTP probes missing from {{ $labels.site_city }}"
+          description: "{{ $labels.site_city }} ({{ $labels.site_code }}) stopped reporting SMTP probe metrics."
+          upright: "https://{{ $labels.site_code }}.<%= app_domain %>/?probe_type=smtp"
+        expr: |
+          count by (site_code, site_city) (max_over_time(upright_probe_up{type="smtp"}[1h]))
+          unless
+          count by (site_code, site_city) (upright_probe_up{type="smtp"})
+        for: 5m
+        labels:
+          severity: warning
+          group: upright
+
+      # Site stopped reporting Playwright probes (was reporting in last hour, not now)
+      - alert: UprightPlaywrightSiteMissing
+        annotations:
+          summary: "Playwright probes missing from {{ $labels.site_city }}"
+          description: "{{ $labels.site_city }} ({{ $labels.site_code }}) stopped reporting Playwright probe metrics. Probes may be stuck."
+          upright: "https://{{ $labels.site_code }}.<%= app_domain %>/?probe_type=playwright"
+        expr: |
+          count by (site_code, site_city) (max_over_time(upright_probe_up{type="playwright"}[1h]))
+          unless
+          count by (site_code, site_city) (upright_probe_up{type="playwright"})
+        for: 30m
+        labels:
+          severity: warning
+          group: upright
+
+  # HTTP probe alerts (simple endpoint monitoring)
+  - name: upright_http_alerts
+    rules:
+      - alert: UprightHTTPProbeDown
+        annotations:
+          summary: "HTTP: {{ $labels.name }} is DOWN"
+          description: "{{ $value | humanizePercentage }} of regions report failure on {{ $labels.probe_target }}"
+          upright: "https://app.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        expr: upright:probe_down_fraction{type="http"} > 0.5
+        labels:
+          severity: page
+          group: upright
+
+      - alert: UprightHTTPProbeDegraded
+        annotations:
+          summary: "HTTP: {{ $labels.name }} degraded - {{ $value | humanizePercentage }} of regions down"
+          description: "{{ $value | humanizePercentage }} of regions report failure on {{ $labels.probe_target }}"
+          upright: "https://app.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        expr: upright:probe_down_fraction{type="http"} > 0.25 and upright:probe_down_fraction{type="http"} <= 0.5
+        for: 5m
+        labels:
+          severity: warning
+          group: upright
+
+      - alert: UprightHTTPRegionalFailure
+        annotations:
+          summary: "HTTP: {{ $labels.name }} failing from {{ $labels.site_city }}"
+          description: "HTTP: {{ $labels.probe_target }} failing from {{ $labels.site_city }}"
+          upright: "https://{{ $labels.site_code }}.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        # Only fire when exactly 1 site is down (isolated regional issue)
+        expr: |
+          upright_probe_up{type="http"} == 0
+          and on (name, type, probe_target)
+          count by (name, type, probe_target) (upright_probe_up == 0) == 1
+        for: 2m
+        labels:
+          severity: warning
+          group: upright
+
+  # SMTP probe alerts (mail server monitoring)
+  - name: upright_smtp_alerts
+    rules:
+      - alert: UprightSMTPProbeDown
+        annotations:
+          summary: "SMTP: {{ $labels.name }} is DOWN"
+          description: "{{ $value | humanizePercentage }} of regions report failure on {{ $labels.probe_target }}"
+          upright: "https://app.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        expr: upright:probe_down_fraction{type="smtp"} > 0.5
+        labels:
+          severity: page
+          group: upright
+
+      - alert: UprightSMTPProbeDegraded
+        annotations:
+          summary: "SMTP: {{ $labels.name }} degraded - {{ $value | humanizePercentage }} of regions down"
+          description: "{{ $value | humanizePercentage }} of regions report failure on {{ $labels.probe_target }}"
+          upright: "https://app.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        expr: upright:probe_down_fraction{type="smtp"} > 0.25 and upright:probe_down_fraction{type="smtp"} <= 0.5
+        for: 5m
+        labels:
+          severity: warning
+          group: upright
+
+      - alert: UprightSMTPRegionalFailure
+        annotations:
+          summary: "SMTP: {{ $labels.name }} failing from {{ $labels.site_city }}"
+          description: "SMTP: {{ $labels.probe_target }} failing from {{ $labels.site_city }}"
+          upright: "https://{{ $labels.site_code }}.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        # Only fire when exactly 1 site is down (isolated regional issue)
+        expr: |
+          upright_probe_up{type="smtp"} == 0
+          and on (name, type, probe_target)
+          count by (name, type, probe_target) (upright_probe_up == 0) == 1
+        for: 2m
+        labels:
+          severity: warning
+          group: upright
+
+  # Playwright probe alerts (browser-based login flows)
+  - name: upright_playwright_alerts
+    rules:
+      - alert: UprightPlaywrightProbeFailed
+        annotations:
+          summary: "Browser: {{ $labels.name }} probe FAILED"
+          description: "{{ $value | humanizePercentage }} of regions report failure for browser-based probe on {{ $labels.name }}"
+          upright: "https://app.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        expr: upright:probe_down_fraction{type="playwright"} > 0.5
+        labels:
+          severity: page
+          group: upright
+
+      - alert: UprightPlaywrightProbeDegraded
+        annotations:
+          summary: "Browser: {{ $labels.name }} degraded - {{ $value | humanizePercentage }} of regions down"
+          description: "Not all regions report success for browser-based probe {{ $labels.name }}"
+          upright: "https://app.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        expr: upright:probe_down_fraction{type="playwright"} > 0.25 and upright:probe_down_fraction{type="playwright"} <= 0.5
+        for: 20m
+        labels:
+          severity: warning
+          group: upright
+
+      - alert: UprightPlaywrightRegionalFailure
+        annotations:
+          summary: "Browser: {{ $labels.name }} failing from {{ $labels.site_city }}"
+          description: "Browser: {{ $labels.name }} failing from {{ $labels.site_city }}"
+          upright: "https://{{ $labels.site_code }}.<%= app_domain %>/?probe_type={{ $labels.type }}&status=fail&probe_name={{ $labels.name | urlquery }}"
+        # Only fire when exactly 1 site is down (isolated regional issue)
+        expr: |
+          upright_probe_up{type="playwright"} == 0
+          and on (name, type, probe_target)
+          count by (name, type, probe_target) (upright_probe_up == 0) == 1
+        for: 20m
+        labels:
+          severity: warning
+          group: upright

data/lib/generators/upright/playwright_probe/playwright_probe_generator.rb

@@ -0,0 +1,30 @@
+module Upright
+  module Generators
+    class PlaywrightProbeGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :with_authenticator, type: :boolean, default: false,
+        desc: "Generate an authenticator class for this probe"
+
+      def create_probe_file
+        template "probe.rb.tt", File.join("probes", "#{file_name}_probe.rb")
+      end
+
+      def create_authenticator_file
+        if options[:with_authenticator]
+          template "authenticator.rb.tt", File.join("probes/authenticators", "#{file_name}.rb")
+        end
+      end
+
+      private
+
+      def probe_class_name
+        "#{class_name}Probe"
+      end
+
+      def authenticator_name
+        file_name.underscore.to_sym
+      end
+    end
+  end
+end

data/lib/generators/upright/playwright_probe/templates/authenticator.rb.tt

@@ -0,0 +1,14 @@
+class Playwright::Authenticator::<%= class_name %> < Upright::Playwright::Authenticator::Base
+  def signin_redirect_url = "https://example.com/dashboard"
+  def signin_path = "/login"
+  def service_name = :<%= file_name %>
+
+  def authenticate
+    # Your authentication logic here
+    # page.goto("https://example.com/login")
+    # page.get_by_label("Email").fill(credentials.<%= file_name %>.email)
+    # page.get_by_label("Password").fill(credentials.<%= file_name %>.password)
+    # page.get_by_role("button", name: "Sign in").click
+    raise NotImplementedError, "Implement the authenticate method for <%= class_name %>"
+  end
+end

data/lib/generators/upright/playwright_probe/templates/probe.rb.tt

@@ -0,0 +1,14 @@
+class Probes::Playwright::<%= probe_class_name %> < Upright::Probes::Playwright::Base
+<% if options[:with_authenticator] -%>
+  authenticate_with_form :<%= authenticator_name %>
+
+<% end -%>
+  def check
+    # Your probe logic here
+    # page.goto("https://example.com")
+    # page.fill('[name="email"]', "user@example.com")
+    # page.click('button[type="submit"]')
+    # page.wait_for_selector(".success")
+    raise NotImplementedError, "Implement the check method for <%= probe_class_name %>"
+  end
+end