EverTask 3.3.0

Overview

EverTask is a high-performance .NET library for background task execution. It handles everything from simple fire-and-forget operations to complex recurring schedules, with persistence that survives application restarts.

Supports CPU-intensive, I/O-bound, long-running and short-running tasks. No external schedulers or Windows Services required — everything runs in-process with your application.

If you've used MediatR, you'll feel right at home with the request/handler pattern — but with built-in persistence, multi-queue isolation, and the ability to scale to high load.

Works great with ASP.NET Core, Windows Services, or any .NET project that needs reliable background processing.

Key Features

Core Execution

• Background Execution — Fire-and-forget, scheduled, and recurring tasks with elegant API
• Smart Persistence — Tasks resume after application restarts (SQL Server, SQLite, In-Memory)
• Fluent Scheduling API — Intuitive recurring task configuration (every minute, hour, day, week, month, cron)
• Idempotent Task Registration — Prevent duplicate recurring tasks with unique keys

Performance & Scalability

• Multi-Queue Support — Isolate workloads by priority, resource type, or business domain
• High-Performance Scheduler — Minimal lock contention and zero CPU when idle
• High Load Support — Optional sharded scheduler for high-loading scheduling scenarios
• Optimized Performance — Reflection caching, lazy serialization, optimized database operations

Monitoring & Observability

• Web Dashboard + REST API — Embedded React UI for monitoring, analytics, and observability
• Real-Time Updates — SignalR live monitoring with event-driven cache invalidation
• Task Execution Log Capture — Proxy logger with optional database persistence for audit trails
• Configurable Audit Levels — Control database bloat with granular audit trail settings

Resilience & Error Handling

• Powerful Retry Policies — Built-in linear retry, custom policies, Polly integration, exception filtering
• Timeout Management — Global and per-task timeout configuration

Developer Experience

• Extensible Architecture — Custom storage, retry policies, and schedulers
• Serilog Integration — Detailed structured logging
• Async All The Way — Fully asynchronous for maximum scalability

<img src="assets/screenshots/4.png" style="width:100%;max-width:900px;display: block; margin:20px auto;" alt="Task Details" />

Quick Start

Installation

dotnet add package EverTask
dotnet add package EverTask.Storage.SqlServer  # Or EverTask.Storage.Sqlite

Configuration

// Register EverTask with SQL Server storage
builder.Services.AddEverTask(opt =>
{
    opt.RegisterTasksFromAssembly(typeof(Program).Assembly);
})
.AddSqlServerStorage(builder.Configuration.GetConnectionString("EverTaskDb"));

Create Your First Task

Define a task request:

public record SendWelcomeEmailTask(string UserEmail, string UserName) : IEverTask;

Create a handler:

public class SendWelcomeEmailHandler : EverTaskHandler<SendWelcomeEmailTask>
{
    private readonly IEmailService _emailService;

    public SendWelcomeEmailHandler(IEmailService emailService)
    {
        _emailService = emailService;
    }

    public override async Task Handle(SendWelcomeEmailTask task, CancellationToken cancellationToken)
    {
        Logger.LogInformation("Sending welcome email to {Email}", task.UserEmail);

        await _emailService.SendWelcomeEmailAsync(
            task.UserEmail,
            task.UserName,
            cancellationToken);
    }
}

Dispatch the task:

// Send welcome email in background
await _dispatcher.Dispatch(new SendWelcomeEmailTask(dto.Email, dto.Name));

Documentation

📚 Full Documentation - Complete guides, tutorials, and API reference

Quick Links

• Getting Started - Installation, configuration, and your first task
• Task Creation - Requests, handlers, lifecycle hooks, and best practices
• Task Dispatching - Fire-and-forget, delayed, and scheduled tasks
• Recurring Tasks - Fluent scheduling API, cron expressions, idempotent registration
• Resilience & Error Handling - Retry policies, timeouts, CancellationToken usage
• Monitoring - Complete monitoring guide (Dashboard, Events, and Logs)
• Scalability - Multi-queue support and sharded scheduler for high-load scenarios
• Task Orchestration - Chain tasks, build workflows, and coordinate complex processes
• Storage Configuration - SQL Server, SQLite, In-Memory, custom implementations
• Configuration - Configure EverTask (Reference + Cheatsheet)
• Architecture & Internals - How EverTask works under the hood

Showcase: Powerful Features

Fluent Recurring Scheduler

Schedule recurring tasks with an intuitive, type-safe API:

// Run every day at 3 AM
await dispatcher.Dispatch(
    new DailyCleanupTask(),
    builder => builder.Schedule().EveryDay().AtTime(new TimeOnly(3, 0)));

// Run every Monday, Wednesday, Friday at 9 AM
var days = new[] { DayOfWeek.Monday, DayOfWeek.Wednesday, DayOfWeek.Friday };
await dispatcher.Dispatch(
    new BackupTask(),
    builder => builder.Schedule().EveryWeek().OnDays(days).AtTime(new TimeOnly(9, 0)))).RunUntil(DateTimeOffset.UtcNow.AddDays(30)));

Multi-Queue Workload Isolation

Keep critical tasks separate from heavy background work:

// High-priority queue for critical operations
.AddQueue("critical", q => q
    .SetMaxDegreeOfParallelism(20)
    .SetChannelCapacity(500)
    .SetDefaultTimeout(TimeSpan.FromMinutes(2)))

Smart Retry Policies with Exception Filtering

Control which exceptions trigger retries to fail-fast on permanent errors:

// Predefined sets for common scenarios
RetryPolicy => new LinearRetryPolicy(5, TimeSpan.FromSeconds(2)).HandleTransientDatabaseErrors();

// Whitelist: Only retry specific exceptions (you can also use DoNotHandle for blacklist)
RetryPolicy = new LinearRetryPolicy(3, TimeSpan.FromSeconds(1)).Handle<DbException>().Handle<HttpRequestException>();

// Predicate: Custom logic (e.g., HTTP 5xx only)
RetryPolicy = new LinearRetryPolicy(3, TimeSpan.FromSeconds(1)).HandleWhen(ex => ex is HttpRequestException httpEx && httpEx.StatusCode >= 500);

Idempotent Task Registration

Use unique keys to safely register recurring tasks at startup without creating duplicates:

// Register recurring tasks - safe to call on every startup
    await _dispatcher.Dispatch(
        new DailyCleanupTask(),
        r => r.Schedule().EveryDay().AtTime(new TimeOnly(3, 0)),
        taskKey: "daily-cleanup"); // Won't create duplicates

Monitoring Dashboard

Monitor your tasks with a feature-complete web dashboard providing real-time insights, comprehensive analytics, and detailed observability:

Dashboard Preview:

<div align="center"> <table> <tr> <td align="center" width="20%"> <img src="assets/screenshots/1.png" width="100%" alt="Dashboard Overview" /> <br /> <em>Dashboard Overview</em> </td> <td align="center" width="20%"> <img src="assets/screenshots/3.png" width="100%" alt="Task List" /> <br /> <em>Task List with Filters</em> </td> <td align="center" width="20%"> <img src="assets/screenshots/4.png" width="100%" alt="Task Details" /> <br /> <em>Task Details & History</em> </td> <td align="center" width="20%"> <img src="assets/screenshots/6.png" width="100%" alt="Execution Logs" /> <br /> <em>Execution Logs Viewer</em> </td> <td align="center" width="20%"> <img src="assets/screenshots/8.png" width="100%" alt="Execution Logs" /> <br /> <em>Realtime flow</em> </td> </tr> </table>

📸 View all 10 screenshots in the documentation

</div>

Task Execution Log Capture

Capture all logs written during task execution and persist them to the database for debugging and auditing:

<img src="assets/screenshots/4.png" style="width:100%;max-width:900px;display: block; margin:20px auto;" alt="Task Details" /> <br /> <em>View logs in dashboard or retrieve via storage</em>

View Complete Changelog

Quick Links

• 📦 NuGet Packages

  • EverTask - Core library
  • EverTask.Abstractions - Lightweight interfaces package
  • EverTask.Storage.SqlServer - SQL Server storage
  • EverTask.Storage.Sqlite - SQLite storage
  • EverTask.Logging.Serilog - Serilog integration
  • EverTask.Monitor.AspnetCore.SignalR - Real-time monitoring

• 📝 Resources

  • Changelog - Version history and release notes
  • Attribution - Acknowledgements and license information
  • GitHub Repository - Source code and issues
  • Examples - Sample applications (ASP.NET Core, Console)

Roadmap

We have some exciting features in the pipeline:

• Task Management API: REST endpoints for stopping, restarting, and canceling tasks via the dashboard
• Distributed Clustering: Multi-server task distribution with leader election and automatic failover
• Advanced Throttling: Rate limiting and adaptive throttling based on system resources
• Workflow Orchestration: Complex workflow and saga orchestration with fluent API
• Additional Monitoring: Sentry Crons, Application Insights, OpenTelemetry support
• More Storage Options: PostgreSQL, MySQL, Redis, Cosmos DB

Contributing

Contributions are welcome! Bug reports, feature requests, and pull requests all help make EverTask better.

• Report issues: https://github.com/GiampaoloGabba/EverTask/issues
• Contribute code: https://github.com/GiampaoloGabba/EverTask/pulls

License

EverTask is licensed under the Apache License 2.0.

See ATTRIBUTION.md for acknowledgements and attributions.

Developed with ❤️ by Giampaolo Gabba