Actor Health Monitor

What does Actor Health Monitor do?

Actor Health Monitor checks the health of all your Apify actors by analyzing recent run statuses, calculating success rates, and sending Discord webhook alerts when actors fail or time out. It provides a comprehensive dashboard of your entire actor fleet's reliability, making it easy to identify and fix problems before they impact your workflows.

Why use Actor Health Monitor?

• Fleet-wide monitoring — automatically scans all actors on your Apify account and reports their health status in a single dataset
• Discord alerts — receive instant notifications via Discord webhook when any actor fails or drops below your success rate threshold
• Configurable thresholds — set custom failure thresholds and choose how many recent runs to analyze for each actor
• Scheduled monitoring — run on a schedule (hourly, daily) to continuously monitor your actor fleet and catch failures early
• No coding required — configure your API token and Discord webhook URL in a simple web UI and click Start

How to use Actor Health Monitor

1. Navigate to the Actor Health Monitor page on Apify Store and click Try for free
2. Enter your Apify API token (found in Settings > Integrations on the Apify Console)
3. Optionally add a Discord webhook URL to receive failure alerts
4. Configure the failure threshold percentage and number of runs to check
5. Click Start and wait for the run to complete
6. View results in the Output tab — each row shows one actor's health status

Input configuration

Field	Type	Description	Default
API Token	string	Your personal Apify API token (from Settings > Integrations). Used to fetch run history for all your actors.	-
Discord Webhook URL	string	Discord webhook URL for failure alerts. Leave empty to skip notifications.	-
Failure Threshold Percent	integer	Alert when an actor's success rate over the last N runs falls below this percentage.	80
Runs To Check	integer	Number of recent runs to check per actor for success rate calculation.	5
Only Check Last Run	boolean	If true, only checks if the most recent run succeeded (faster but less thorough).	false

Output data

The actor produces one dataset item per monitored actor. Each item contains the actor's name, recent run statistics, success rate, and alert status. You can view the results in the Output tab's formatted table.

Key output fields include: Actor Name, Status, Success Rate, Total Runs, Failed Runs, Last Run Date, and Alert Triggered.

Example output:

{
  "actorName": "my-web-scraper",
  "actorId": "abc123",
  "status": "healthy",
  "successRate": 95.0,
  "totalRuns": 20,
  "succeededRuns": 19,
  "failedRuns": 1,
  "timedOutRuns": 0,
  "lastRunStatus": "SUCCEEDED",
  "lastRunAt": "2026-01-15T10:30:00Z",
  "alertTriggered": false
}

Cost of usage

Actor Health Monitor uses Pay-Per-Event pricing (High tier). Each monitored actor result costs approximately $0.0010 ($1.00 per 1,000 results).

On a free Apify plan ($5/month platform credit), you can check approximately 5,000 actor health reports per month.

Example: Monitoring 50 actors daily (1,500 checks/month) would cost approximately $1.50.

Tips and advanced usage

• Scheduled monitoring: Set up an Apify Schedule to run this actor every hour or every day. Combined with Discord webhook alerts, you will be notified immediately when any actor in your fleet starts failing.
• Threshold tuning: Start with a 80% success rate threshold and adjust based on your needs. Actors that interact with frequently-changing websites may need a lower threshold to avoid false alerts.
• API integration: Access the health report dataset via the Apify API to build custom dashboards or integrate with your existing monitoring tools like Grafana, Datadog, or PagerDuty.
• Cost efficiency: Use the "Only Check Last Run" option for a faster, cheaper check when you have many actors. The full history check provides more accurate success rates but takes longer.

Useful Links

• Apify Console