Monitoring

Master the core of Apphold — adding monitors, tracking uptime, and managing alerts for your websites and services.

Adding a Monitor

To create a new monitor:

  1. Click the New Monitor button (or use the + icon) in the monitor list panel
  2. Enter the URL or endpoint you want to monitor
  3. Configure the check interval and alert settings
  4. Your monitor begins checking automatically once saved

Configuring Check Intervals

Apphold supports flexible check intervals to suit your monitoring needs:

Available Intervals

Every 1 minute   — Real-time critical services
Every 5 minutes  — Standard production monitoring
Every 15 minutes — Non-critical services
Every 30 minutes — Low-priority endpoints
Every 60 minutes — Periodic health checks

HTTP Settings

Method:  GET, POST, HEAD
Timeout: 5s, 10s, 30s (configurable)
Expected status: 200, 2xx, 3xx (configurable)

Request Options

Custom headers (e.g. Authorization tokens)
Request body for POST monitors
SSL certificate verification toggle

Viewing Uptime History

Apphold provides detailed uptime history for each monitor:

  • Click a monitor from the monitor list to view its detail panel
  • View real-time uptime percentage and response time graphs
  • Browse historical data by day, week, or month
  • See individual check results with timestamps and response codes

Tip: Use the date range filter to zoom into specific time periods when investigating incidents.

Setting Up Alerts

Configure alerts so you are notified immediately when a service goes down:

  • Set the number of consecutive failures before an alert is triggered
  • Choose notification channels (email, webhook)
  • Configure response time thresholds to catch slow services

Deleting a Monitor

To delete a monitor:

  1. Select the monitor from the monitor list
  2. Click the Delete button (trash icon)
  3. Confirm the deletion when prompted

Note: Deleting a monitor also removes all its historical uptime data. Make sure you no longer need this data before deleting.

Keyboard Shortcuts

For power users, Apphold supports common keyboard shortcuts:

  • Ctrl + N — Create a new monitor
  • Ctrl + S — Save current monitor settings
  • Ctrl + F — Focus the search bar
  • Ctrl + R — Refresh dashboard data
  • Ctrl + D — Toggle detail panel

Using the REST API

Apphold provides a REST API with an OpenAPI specification for programmatic access to your monitoring data. You can use the API to:

  • Create and manage monitors programmatically
  • Retrieve uptime and response time data
  • Integrate with external dashboards and reporting tools

API Documentation: The full OpenAPI spec is available at /api/documentation on your Apphold instance.

Tips for Power Users

  • Group related monitors by using consistent naming conventions (e.g. prod-api, prod-web)
  • Set appropriate intervals — critical services should be checked every 1–5 minutes
  • Configure multiple notification channels to ensure alerts are never missed
  • Use the REST API to automate monitor creation as part of your CI/CD pipeline
  • Review uptime reports regularly to identify patterns and potential issues before they become outages