Knowledge Base

Job Monitoring

You can monitor job execution through multiple methods in the Narrative platform.

Monitoring Methods

Method	Description
Webhooks	Real-time notifications when job states change
REST API	Query job status programmatically
Platform UI	View job status in the Narrative interface

Webhook Monitoring

Set up webhooks to receive notifications when job states change.

Example Webhook Subscription

{
  "name": "job-monitor",
  "url": "https://your-system.com/webhook",
  "job_types": ["materialize-view", "forecast"],
  "states": ["completed", "failed"],
  "active": true
}

This subscription will send notifications when materialize-view or forecast jobs complete or fail.

API Monitoring

Use the REST API to check job status programmatically.

Get Job Status

curl -X GET "https://api.narrative.io/v1/jobs/{job_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

List Jobs

curl -X GET "https://api.narrative.io/v1/jobs?state=running" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Platform UI

The Narrative platform provides a user interface where you can view job status and progress.

What You Can Monitor

Job State Changes

When jobs start (pending → running)
When jobs complete (running → completed)
When jobs fail (running → failed)
When jobs are cancelled

Job Information

Job type and parameters
Execution time
Error messages (for failed jobs)
Results (for completed jobs)

Webhook Configuration

Learn how to set up webhook subscriptions for job monitoring.

Create webhook subscriptions