Skip to main content

General Settings

The General tab defines how often a job runs, how noisy it is allowed to be, and how it behaves on failures.

Configuration Fields

FieldDescriptionRequired
NameJob identifier shown in lists and reportsYes
DescriptionNotes about the job's purposeNo
FrequencyHow often to run (simple or CRON)Yes
Max Notify FrequencyMinimum time between notificationsNo
Retry PolicyBehavior on capture failuresNo
HousekeepingAutomatic cleanup of old runs/reportsNo

Scheduling

Simple Frequency

Set how often the job should run using natural intervals.

Advanced (CRON)

Toggle Advanced to use CRON expressions for precise scheduling:

CRON ExpressionDescription
0 9 * * *Every day at 9:00 AM
0 */2 * * *Every 2 hours
0 9 * * 1-5Weekdays at 9:00 AM
0 0 1 * *First day of every month
*/10 * * * *Every 10 minutes
0 9,17 * * *At 9:00 AM and 5:00 PM

Notification Throttling

Max Notify Frequency controls the maximum notification rate regardless of how often the job runs. This is especially important for high-frequency alerting jobs.

Why Throttling Matters

Example Configuration

Job FrequencyThrottlingResult
Every 5 minutes3 hoursMax 8 notifications/day
Every 10 minutes1 hourMax 24 notifications/day
Every hour6 hoursMax 4 notifications/day
DailyNone1 notification/day
Alerting Pattern

High-frequency sampling + throttling creates an alerting-style workflow:

  • Job runs every 5 minutes to detect issues quickly
  • Throttling prevents notification fatigue
  • Recipients get timely alerts without spam

Retry Policy

Enable retries to retry failed runs automatically after failures. When enabled, set how many times the run should be retried before giving up.

Housekeeping (Data Retention)

Enable run expire time to automatically delete old runs and reports after a specified period. This helps manage storage usage over time.

Storage Impact

High-frequency jobs generate more data. Without housekeeping:

  • 10-minute job = 144 runs/day = 4,320 runs/month
  • Each run may include snapshots and reports
  • Storage can grow rapidly without retention limits

Best Practices

For Scheduled Reports

Frequency: Daily at 9 AM (0 9 * * *)
Throttling: None (reports always deliver)
Retry: 3 attempts
Housekeeping: 90 days

For Alerting Jobs

Frequency: Every 5-10 minutes
Throttling: 1-3 hours (balance speed vs. noise)
Retry: Job runs often enough; retries usually not needed
Housekeeping: 14 days (less storage needed)

For Compliance/Archival

Frequency: Weekly or monthly
Throttling: None
Retry: 5 attempts (ensure success)
Housekeeping: Never

Next Steps