Skip to main content
App Events gives you a chronological timeline of everything that happens to your application — who deployed, when runners started or failed, and what configuration changed. Use it to debug incidents, audit team activity, and understand your app’s lifecycle.

​
What You Can Track

Navigate to Dashboard > Apps > [your-app] > Events to see the timeline. You can search, filter by event category (runner, deployment, config), and set a date range. App Events tracks three categories of activity: Runner events show the lifecycle of individual runners: when they were scheduled, when they started pulling your image, when setup() ran, and when they became ready or failed. Failure events include the stage that failed (SETUP, DOCKER_PULL, etc.), so you can quickly tell whether the problem is your image, your setup code, or infrastructure. Deployment events track when deployments start, succeed, or fail. Use these to correlate performance changes with deploys. If latency spiked right after a deploy, you know where to look. Config change events record who changed what, with a diff of old vs new values. This is the audit trail for scaling parameter changes, machine type updates, and auth mode switches.

​
API Access

Query events programmatically: 
curl "https://rest.fal.ai/applications/your-username/your-app/events?since=2026-02-17T00:00:00Z" \
  -H "Authorization: Key $FAL_KEY"

​
Parameters

ParameterDescription
sinceStart time (ISO 8601)
untilEnd time (ISO 8601)
categoriesFilter by event type (e.g., runner_started, config_changed)
pagePage number
sizeEvents per page

Error Analytics

Analyze error patterns across your apps

Slack Notifications

Get notified when runners fail