Anarchy.Toolkit.Hosting.Workers 2.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Anarchy.Toolkit.Hosting.Workers --version 2.0.0
                    
NuGet\Install-Package Anarchy.Toolkit.Hosting.Workers -Version 2.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Anarchy.Toolkit.Hosting.Workers" Version="2.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Anarchy.Toolkit.Hosting.Workers" Version="2.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Anarchy.Toolkit.Hosting.Workers" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Anarchy.Toolkit.Hosting.Workers --version 2.0.0
                    
#r "nuget: Anarchy.Toolkit.Hosting.Workers, 2.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Anarchy.Toolkit.Hosting.Workers@2.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Anarchy.Toolkit.Hosting.Workers&version=2.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Anarchy.Toolkit.Hosting.Workers&version=2.0.0
                    
Install as a Cake Tool

Anarchy.Toolkit.Hosting.Workers

Part of Anarchy I/O Toolkit, a .NET developer platform · Pillar: Infrastructure · Layer: Hosting · Package catalog

Background-worker primitives and a self-hosted health API for worker processes.

dotnet add package Anarchy.Toolkit.Hosting.Workers
  • Derive from WorkerBase, MonitoredWorkerBase or ResilientWorkerBase; HeartbeatWorker provides a heartbeat.
  • ResilientWorkerBase gives every iteration a new correlation id and every attempt a new attempt id, through CorrelationContext.BeginScope: they reach every logging provider as scope properties and the current activity as tags. Work that carries its own ids (a consumed message) opens BeginCorrelationScope(correlationId, attemptId) around its processing.
  • Register the health worker with AddServiceHealthCheckWorker(assembly) to serve /health/instance, /health/services and /health/status.
  • Supply an IReadOnlyCollection<IHealthCheck> for service checks; the services endpoint returns HTTP 500 when a check fails.

When to use it

Choose this package for a long-running process that needs hosted workers, operational heartbeat or HTTP health endpoints without building a full REST API. It complements Hosting, which provides the application host and entry-point conventions.

How to use it

  1. Implement a worker using the base that matches the required monitoring or resilience behavior, and register it with the host's IServiceCollection as a hosted service. Instrumented workers take the registered AppTelemetry (see ModuleTelemetry or AddCoreTelemetry()).
  2. If health endpoints are required, call services.AddServiceHealthCheckWorker(typeof(YourWorker).Assembly) from startup. Register settings implementing IWorkerHealthCheckAppSettings, including the health service port, and make the listener reachable only as appropriate for your deployment.
  3. Supply the IReadOnlyCollection<IHealthCheck> used by the endpoint, or use a provider's health-report registration. Without reports, the package installs an empty collection. Embed build metadata in the supplied assembly if it should appear in status output.

The sample worker startup demonstrates registering a heartbeat and a custom hosted worker.

See the worker sample and toolkit overview.

Releases

2.0.0

  • feat(automation): establish onboarding and layering conventions
  • feat(telemetry)!: introduce provider-neutral application telemetry
  • refactor(packages)!: restructure persistence and automation packages
  • refactor(infrastructure.correlationid)!: decouple correlation scopes from Serilog
  • refactor(core)!: reshape telemetry, event and health contracts
  • refactor(telemetry)!: remove legacy APIs and simplify namespaces
  • refactor(telemetry)!: update consumers and samples

1.2.0

  • fix(Hosting.Workers): let the health API listen on a port the OS chooses

1.1.1

  • docs(packages): identify each package's pillar and layer
  • build(packages): attribute the copyright to Leandro Melão Medeiros
  • build: relicense under Apache-2.0 and update the package metadata

1.1.0

  • build(deps): upgrade Swashbuckle.AspNetCore to 11.0.1 and Microsoft.OpenApi to 3.11.1

1.0.7

  • docs: expand XML docblocks across all projects for the DocFX API reference

1.0.6

  • refactor(src): clean up code style across library packages
  • chore(deps): update AWS SDK, Lambda ASP.NET Core server and MySqlConnector packages

1.0.5

  • chore(deps): update AWS SDK packages

1.0.3

  • build: migrate local automation to build tooling

1.0.2

  • docs: expand package guides and release histories
  • chore(deps): update AWS, Polly, and xUnit packages

1.0.1

  • Added a package-specific NuGet README.

1.0.0

  • Introduced monitored and resilient worker bases, heartbeat and health checks, a self-hosted health API and build metadata readers.
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.1 0 11/21/2026
2.0.0 0 11/20/2026
1.2.0 76 11/18/2026
1.1.1 83 11/17/2026
1.1.0 75 11/17/2026
1.0.7 87 11/16/2026
1.0.6 86 11/14/2026
1.0.5 89 11/13/2026
1.0.4 84 11/9/2026
1.0.3 79 11/9/2026
1.0.1 96 11/6/2026
1.0.0 106 11/5/2026

Initial release.