2.28.0

2024-12-20

• Generate XML comment files for NuGet packages
• Retry failed requests in the Admin UI
• Only load queue status counts for visible queues in the Admin UI
• Base Admin UI polling on when the last request ended instead of started to prevent overloading the server when it responds slowly

2.27.2

2024-12-17

• Fix issue with invalid existence check on SQL Server queue column

2.27.1

2024-12-15

• Fix issue with Azure Postgres not always returning all columns in information_schema.columns

2.27.0

2024-12-15

• Add CommerceMind.Nexus.RabbitMQ and make it possible to use RabbitMQ for instance events
• Make it possible to use dynamic job mutexes
• Make it possible to read queue messages by a list of message ids
• Add search/filter to header bar in the Admin UI
• Make it possible to retry messages instead of marking them as Abandoned
• Make it possible to limit which instance a job should run on through code and in the Admin UI
• Fix issue that caused enable/disable buttons for jobs not to be responsive in the Admin UI
• Support top level dictionaries in partial messages
• Allow queue jobs to control the job result message
• Make it possible for a queue job to filter which messages it wants to process
• Make it possible to filter on queue properties

2.26.0

2024-12-05

• Show dates as labels instead of time when showing more than latest 24h in statistics
• Hide sorting controls on queues list until hovered
• Add automatic webhook endpoint for all queues, see docs
• Wrap ActivitySource usage in order to trap exceptions during dispose, fixes issue where Elastic.APM causes jobs to be reported as failed

2.25.2

2024-12-02

• Fix exception caused by queues that no longer exist in code
• Correctly handle status change statistics for idempotent queues

2.25.1

2024-12-02

• Retry TimeoutExceptions that occur in the database layer

2.25.0

2024-12-02

• Make it possible to sort jobs and job categories in the Admin UI
• Don't show processed count in queue stats if processed messages are deleted since it's confusing to see "Processed: 0" when the graph says lots of processed messages
• Only show status counts below graphs of the statuses shown in the graph
• Optimize performance of updating statistics graphs in Admin UI

2.24.1

2024-11-30

• Generate random color for custom statuses in queue statistics graphs
• Fix issue causing queue meta data to be reset when updating meta data

2.24.0

2024-11-30

• Make it possible to control order and items in the Admin UI main menu. See docs.
• Add statistics/graphs over queue message status changes. See docs.
• Allow setting which status a message should get when reaching max retries. See docs.
• Allow updating queue display name, category, max retries, statistics retention, and history retention in the Admin UI/API.
• Make it possible to change the sort order of queues and queue categories in the Admin UI.

2.23.0

2024-11-24

• Make it possible to pause jobs after they fail until the error has been resolved. See more in the docs.
• Reset retry count when updating a single message in the Admin UI.
• Enable editing job category, historical run retention and if a job should be considered degraded when disabled in the Admin UI/API.

2.22.0

2024-11-22

• Make it possible to delete by status in the Admin UI/API
• Reset retry count when changing status of a queue item
• Respect low MaxNumberOfMessagesPerRun values in non-batched queue jobs
• Make it possible to auto cancel jobs after max duration
• Allow setting max duration and auto cancel for a job in the AdminUI/API

2.21.0

2024-11-18

• Only filter on status being Pending when leasing messages to make it slightly faster
• Remove queue message id database index for queues that doesn't have id
• Remove queue database index no longer used
• Fix issue with unclosed db connections in memory queue fallback storage
• Support authorization in the API and Admin UI, see more in the docs
• Add error handling for unexpected errors in admin UI

2.20.1

2024-11-16

• Only wrap JSON string in quotes if not already wrapped

2.20.0

2024-11-16

• Make it possible to invoke arbitrary Nexus Functions in the Admin UI (see docs

2.19.2

2024-11-11

• Fix issue where CommerceMind.Nexus.Azure package initialization didn't return the fluent Nexus initialization

2.19.1

2024-11-11

• Pass topic/queue name to the connection string and subscription name loaders in Azure Service Bus config

2.19.0

2024-11-11

• Make it possible to automatically retry errors in queues through Admin UI and code
• Fixes issue that reset retry count to 0 when reaching max retry count
• Support fetching from Azure Service Bus Topics as well as Azure Service Bus Queues

2.18.0

2024-11-09

• Make it possible for a queue to be in-memory
• Extract SQL COUNT(*) into separate query since it's faster for large data sets

2.17.0

2024-10-26

• Optimize handling of queue messages without id

2.16.0

2024-10-21

• Set the same data type in queue message import temp table as the source table to avoid bad query plan
• Make it possible to filter to only see jobs with issues in the admin UI
• Group jobs list by category first instead of job type first and category second in admin UI

2.15.0

2024-10-20

• Add more retries to SQL queries for functions
• Don't load job progress when it's not needed
• Handle SQL Server concurrent update for memory optimized tables error
• Delay creating job progress until the first progress is reported
• Make enqueueing of messages without id faster
• Enqueue messages one by one when the batch is small since it's faster

2.14.0

2024-10-12

• Store latest job run details in main jobs table to avoid joins in hot query
• Disable lock escalation in SQL Server to avoid use of rowlock hint
• Add retries when fetching historical job runs

2.13.0

2024-10-02

• Make unbatched queue processing as fast as batched
• Don't use NOLOCK hint for SQL Server when using read committed snapshot

2.12.0

• Support calling private methods in functions
• Prevent long job result text to break the job details UI
• Add support for middlewares for functions
• Wrap creation and population of temp tables during enqueueing in an OTel transaction so the performance of it can be measured

2.11.0

• Add retries to query that runs as part of message enqueueing
• Release batch messages that haven't been processed or failed
• Show in admin UI if any functions failed to load instead of just hiding them

2.10.5

• Rewrite sql query so that an index can be correctly used

2.10.4

• Fix regression that didn't respect the global max retry count for functions

2.10.3

• Fix issue with using messages as records with batch jobs

2.10.2

• Await function batches to avoid getting into a state where new functions are started before existing ones finish

2.10.1

• Add missing database index for deleting processed queue messages
• Ensure that next runs in UI and API are always in the future
• Ensure that parameters passed to JobResults is of the correct type

2.10.0

• Improve the layout of job list when you have many jobs split into many categories

2.9.0

• Fix styling for lists and paragraphs in job markdown description
• Fix health check migrations for SQLite
• Make it possible to mass update queue item priority in admin UI

2.8.6

• Add retries when reading job meta data
• Keep retrying migrations on transient errors to avoid crashing the application
• Lower log levels on warnings that are meant for debugging

2.8.5

• Fix failing migration for health checks

2.8.4

• Changes the category of Nexus log messages for queue jobs to make it easier to filter out

2.8.3

• Fix for supporting queue messages to be records rather than classes

2.8.2

• Separate short description and description of a job and show short description in listings and description on the details page in the admin UI

2.8.1

• Fix issue with Nexus functions with arguments not getting called correctly

2.8.0

• Adds description text for jobs in the admin UI which can be edited in the UI, markdown supported
• Adds cancellation token support for Nexus functions
• Fixes admin UI to not say "Starts in in X seconds" with a duplicate "in"
• Fixes admin UI job start dates to not show dates in past time

2.7.2

• Fix incorrect use of service scope

2.7.1

• Use service provider scope in all places where a scheduled job instance is used

2.7.0

• Changes jobs and functions to use a service provider scope when creating service instances in order to support services registered with a scoped lifetime.

2.6.2

• Fix issue with using enums as arguments to Nexus functions

2.6.1

• Correctly report outcome on Open Telemetry activities/traces

2.6.0

• Expose metrics and telemetry through Open Telemetry

2.5.1

• Fix how casts of Nexus function arguments are handled

2.5.0

• Adds more filtering and sorting to job runs in admin UI
• Fixes bug with serializing GUIDs with System.Text.Json

2.4.0

• Adds filtering of job runs in admin UI
• Adds missing database index for job runs

2.3.0

• Support List.Contains() in IQueueItemUpdater.UpdateStatusWhereAsync()
• The health checks system now has a watch dog that will reset any check that is stuck in a running state. Eg if the process crashed after the check finished but before Nexus was able to update the status.
• Fix issue where enabling queue history for all queues included queues where messages don't have id
• Ensure that the ILoggerProvider for job logs aren't registered multiple times

2.2.4

• Improve error handling with instance events

2.2.3

• Add transient database error retries on all methods on IQueueReader
• No longer assumes that a temp table still exists since it might get deleted when a connection is reopened

2.2.2

• Fix issue with Postgres and SQL Server that caused an error if you called IEnqueuer<TMessage>.EnqueueAsync() with an empty list of messages
• Reset migrations if they're stuck in a running state because of a server crash

2.2.1

• Explicitly drop temp tables instead of relying on connection close to delete them

2.2.0

• Make it possible to change priority on a message when scheduling a future processing
• Improve handling of merging partial messages in SQL Server
• Add retries on transient database errors in more situations

2.1.1

• Fix issue with queue messages that has propertiy types without parameterless constructors

2.1.0

• Fix issue using MaxRetries in [NexusFunction] attributes
• Fix issue causing JSON serialization errors in the Slack healty reporter
• Support enqueueing partial messages, read more here
• Add retries on SQL queries with SQLite that caused "database is locked" errors
• Run retries on transient database errors more granularly and in more places

2.0.0

This release contains a few breaking changes that are described in the upgrade guide. The breaking changes are mostly a code and project reorganization that should be easy to upgrade to.

Besides the reorganization some notable changes are:

• The scheduled jobs system now has a watch dog that will reset any job that is stuck in a running state. Eg if the process crashed after the job finished but before Nexus was able to update the job status.
• All NuGet dependencies have been updated to the latest version as well as .NET.
• Serilog is no longer a dependency to Nexus.
• Newtonsoft.Json is no longer a direct dependency to Nexus, the support for Newtonsoft.Json has been extracted to a separate package.
• It's now possible to register middlewares around job execution.
• It's now possible to set job and log history per job.

1.23.0

• Allows queue jobs to set custom statuses for messages. Read more here.

1.22.0

• Adds message priority for queues. Read more here.

1.21.1

• Adds feature detection for if queue history is enabled to avoid SQL queries running against tables that doesn't exist

1.21.0

• Adds opt-in message history for queues with identity. Read more here.

1.20.3

• Adds retries to the database maintenance job when using Postgres.

1.20.2

• Fixes risks for deadlocks when job progress hasn't finished writing before the job is done. When a job finishes and cleanup attempts to delete job progress before the job progress has finished writing a deadlock could occur because the update and cleanup/delete tries to write the same row.

1.20.1

• Removes a query hint when using SQL Server that required READ COMMITTED isolation level. The recommended isolation level is READ COMMITTED SNAPSHOT, but is not a hard requirement.

1.20.0

• Makes it possible to initiate a soft graceful shutdown which means that all jobs, functions, etc that has already started will run until finished but no new work will be started. See more here.

1.19.0

• Fixes regression around running internal Nexus migrations.

1.19.0

• Makes it possible to pass a transaction to DbConnectionScope.

1.18.0

• Makes it possible to stop queue processing when an error occur, and pause it until no messages in the queue has an Error or AwaitingRetry status any more. See more here.

1.17.0

• Adds IDbConnectionScope which lets you pass an existing db connection object to Nexus. See more here.

1.16.1

• Fixes an issue where extra job runs (such as a retry) disappeared if they needed to aquire a mutex and that mutex was already taken

1.16.0

• IQueueItemUpdater.DeleteAndReturnAllAsync() added as a safe way to read and delete all messages in a queue in a single and safe operation
• IScheduledJobMetaDataRepository.GetJobMetaDataAsync<TJob>() added

1.15.6

• Let outcome descriptions line break in admin UI

1.15.4

• Expire the jobs meta data cache after five seconds to prevent stale cache issues

1.15.3

• Add debug logging to queue processing jobs

1.15.2

• Use long for queue message ids everywhere
• Ensure that changing a job schedule doesn't immediately trigger a new run if the schedule is moved forward in time

1.15.1

• Fix issue causing MaxNumberOfMessagesPerRun not to work on queue jobs

1.15.0

• Make it possible to control how many messages a single queue job run is allowed to process
• Show the Nexus version in the admin UI
• Don't show a Disable button for a health check for a disabled job

1.14.4

• Fix issuing causing some health checks to not show up in admin UI

1.14.3

• Fix issuing making it impossible to resolve a failed job run

1.14.2

• Fix links to job details in health check details
• Add caching for health check statistics to avoid polling the database on the health overview
• Health periods are now not filled out to include the space in time between two periods

1.14.1

• Change job health check to not generate a unique result description every time it's called

1.14.0

• Stores health check results so it's possible to see the history of a health check in the Admin UI

1.13.1

• Fix issue which caused migrations to be run out-of-order

1.13.0

• Make it possible to use Nexus job logs in the admin UI without Serilog.

Previously you needed to use Serilog in order for your job logs to get the correct context/scope values attached to know which job they originated from. Nexus now uses standard .NET logging for this which means that you no longer need to use Serilog for it. See more in the documentation under Jobs / Logs.

1.12.1

• Reset healthchecks when an instance is starting. If an instance crashed or was deployed in the middle of when a healthcheck was running it can still be reported as running after the deploy or restart finishes. This fixes that all healthchecks are reset that claims to be running on the instance that is just starting up.

1.12.0

• Added JobResults.CompletedWithWarnings() which lets a job return a successful status but have the run flagged with a warning sign in the Admin UI and the job health check status become Degraded

1.11.0

• Messages that are Leased will now be transitioned into a new status called Abandoned if the lease expires due to a server crash. See docs about abandoned messages.
• Messages that are scheduled for a retry now has a new status called AwaitingRetry instead of being in the Error status.
• A new max retry limit has been introduced which defaults to 10. If the same message has been retried more times than that the message is transitioned to the Error status and won't be automatically retried again.
• Instance id and correlation id is now set on queue messages when they are leased to be able to find logs for the job that processed a message.

1.10.1

• Minor styling issue fixed in Functions list in Admin UI

1.10.0

• Make it possible to group queues in the Admin UI by category just like what's possible for jobs

1.9.0

• Fix issue where the admin UI could display "0" instead of "No logs found"
• Make it possible to have a new job be initially disabled

1.8.2

• Fix issue which could cause an infinite loop in ScheduledJobExecutorService when using multiple servers and jobs that executes frequently
• Lowered log level from information to debug on some logs that occur frequently

1.8.1

• Includes debug symbols in new snupkg packages, published to the Github NuGet feed

1.8.0

• Removed unnecessary database calls that were made to release job mutexes, even for jobs without any mutexes
• Nexus will now react slightly quicker to the cancellation token that signals that the app is shutting down
• A new way of dealing with exceptions in background services ensures that Nexus is more resilient against intermittent database failures

1.7.0

• Made it possible to customize the example message shown in the admin UI when enqueueing a new message manually.
• IScheduledBatchQueueJob.GetBatchSize() has been deprecated in favor of IScheduledBatchQueueJob.BatchSize. The GetBatchSize() method will be removed in the next major version.

1.6.8

• Add missing indexes to mutex table to avoid deadlocks when attempting to release job mutexes

1.6.7

• Apply less locking when fetching job data from SQL Server to avoid deadlocks

1.6.6

• Fix issue in API usage of Nexus Functions with SQL Server

1.6.5

• Fix concurrency issue with leasing queue messages and marking functions as running when using Postgres.

1.6.4

• Fix issue where instance heartbeat healthchecks reported the time in 12 hour
• Fix text overflow in health check admin UI for long descriptions

1.6.3

• Dispose CancellationTokenSource in ScheduledJobExecutorService after use

1.6.2

• Add horizontal scrollbar for long queue processing log in admin UI

v1.6.1

• Remove testing code in the admin UI that slipped through in 1.6.0

v1.6.0

• Make it possible for jobs to report their progress and display it in the admin UI
• Use Tailwind instead of CSS Modules in admin UI

v1.5.4

• Use higher query timeout for all queries in IDatabaseMaintenanceService
• Show resolved/dismissed state for latest run in job list

v1.5.3

• Fix issue with database polling instance events

v1.5.2

• Fix issue with admin UI not rendering correctly when not having a trailing slash in the url (ie just /admin and not /admin/)

v1.5.1

• Fix issue with duration incorrectly being stored as decimal in SQLite when integer is expected

v1.5.0

• Make it possible to mark a failed job run as resolved or dismissed with an optional markdown comment
• Make it possible to add a comment to queue messages
• Store both latest job run and latest meaningful job run to since some jobs run very frequently but doesn't perform work all the time
• Fix when cancelling a queue job the historical run status becomes should be Cancelled rather than Completed

v1.4.0

• Add RetryLater as a successful job outcome

v1.3.2

• Fix issue with database maintenance on SQL Express

v1.3.1

• Reset any health checks marked as running when an instance is starting

v1.3.0

• Ask for a connection string every time the database is opened to make it possible to use connection strings with updated credentials

v1.2.1

• Add query timeout of 5 minutes for database maintenance queries
• Make it possible to update queue message status by filtering on message JSON properties
• Increase timeout when deleting old job runs and logs

v1.2.0

• Show a health check for a disabled job as disabled
• Implement graceful shutdown which attempts to stop Nexus background processes before the .NET application begins to terminate to ensure that all jobs etc aren't running when the application terminates
• Generate a unique Nexus instance id for Azure App Service where a single VM can run multiple applications

v1.1.0

• Increase query timeout for updating queue messages to correct status
• Make it possible to update all queue items to a certain status
• Make it possible to mark a queue item as processed and schedule another processing of the message in the future
• Only show main menu items in the admin UI if they have been configured
• Add WITH (HOLDLOCK) to all SQL Server MERGE statements to avoid insert conflicts

v1.0.0

Initial stable release.