MMP.Herald.Sinks.HttpJson
0.2.1
dotnet add package MMP.Herald.Sinks.HttpJson --version 0.2.1
NuGet\Install-Package MMP.Herald.Sinks.HttpJson -Version 0.2.1
<PackageReference Include="MMP.Herald.Sinks.HttpJson" Version="0.2.1" />
<PackageVersion Include="MMP.Herald.Sinks.HttpJson" Version="0.2.1" />
<PackageReference Include="MMP.Herald.Sinks.HttpJson" />
paket add MMP.Herald.Sinks.HttpJson --version 0.2.1
#r "nuget: MMP.Herald.Sinks.HttpJson, 0.2.1"
#:package MMP.Herald.Sinks.HttpJson@0.2.1
#addin nuget:?package=MMP.Herald.Sinks.HttpJson&version=0.2.1
#tool nuget:?package=MMP.Herald.Sinks.HttpJson&version=0.2.1
Herald.Sinks.HttpJson
Posts Herald log events as newline-delimited JSON (NDJSON) over HTTP. One event per line, batched when the pipeline supplies multiple. Pairs with any HTTP log-intake that accepts NDJSON — Elasticsearch bulk, Loki push, generic aggregators, custom backends.
Part of Herald — high-performance structured logging for .NET 8, 9, and 10.
Install
dotnet add package Herald.Sinks.HttpJson
The sink auto-registers into LogSinkProviderRegistry.Default via a [ModuleInitializer] on assembly load. No manual RegisterAll(...) or With*SinkProviders() call is required — dotnet add package is the whole workflow.
Sink kind: http_json (the identifier the Dashboard form and JSON config use to reference this sink).
Capabilities
- Batched delivery via IBatchedLogSink
- Async path (LogAsync / LogBatchAsync) for the AsyncLogger drain
- Shared HttpClient pool via internal SocketsHttpHandler — reuses TCP connections across requests
- 30-second default timeout on the owned HttpClient
- Caller-supplied HttpClient honored verbatim — timeout, handler, and disposal stay with the caller
Limitations
- No gzip compression on the request body
- No built-in retry — pair with the async decorator for retry policy
- Relies on the remote endpoint accepting NDJSON; no framing negotiation
Tier & runtime
- Edition: Community — works on the free Apache 2.0 Herald.Core. No license key required.
- AOT-compatible: yes
- Targets: .NET 8 / 9 / 10
- Thread safety: Thread-safe — shared HttpClient, both sync Send and async SendAsync paths.
Vendor
Herald — https://github.com/mmpworks/Herald.Sinks
Configuration
Per-sink config form lives in configuration*.mmpform at the package root and inside the assembly as an embedded resource. The Herald Dashboard renders it at runtime; JSON config follows the same shape. See CAPABILITY.yaml shipped at the package root for the full manifest (schema reference: CAPABILITY-SCHEMA.md).
License
Apache 2.0. Copyright (c) 2026 MMPWorks LLC. See LICENSE shipped at the package root.
Generated from CAPABILITY.yaml. Re-run Modules/Herald.Sinks/tools/generate-readmes.cjs after manifest edits to refresh.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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. |
-
net10.0
- Herald.OSS (>= 0.10.4)
-
net8.0
- Herald.OSS (>= 0.10.4)
-
net9.0
- Herald.OSS (>= 0.10.4)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on MMP.Herald.Sinks.HttpJson:
| Package | Downloads |
|---|---|
|
MMP.Herald.Business
Herald observability metapackage for business and enterprise deployments. Pulls in every Herald.Sinks destination — HTTP, TCP, UDP, every Enterprise HTTP sink (Seq, Splunk, Honeycomb, Datadog, Loki, SignalFx, Sentry, PagerDuty), community transports (Elasticsearch, Slack, GenericWebhook), and the OTLP trio. Depend on this one package and pick destinations at registration time. |
|
|
MMP.Herald.Game.Pro
Herald observability metapackage tuned for paid-tier games. Pulls in the network transports (HttpJson / TcpJsonLine / UdpJsonLine), the Enterprise HTTP observability sinks (Seq, Splunk, Honeycomb, Datadog, Loki, SignalFx), Sentry for crash tracking, the generic-webhook sink, and the OTLP trio. PagerDuty, Elasticsearch, and Slack are deliberately excluded — those are business/on-call surfaces rather than game-side. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.2.1 | 33 | 5/30/2026 |
| 0.2.0 | 115 | 5/26/2026 |
| 0.2.0-alpha.3 | 62 | 5/13/2026 |
| 0.2.0-alpha.2 | 59 | 5/13/2026 |
| 0.2.0-alpha.1 | 60 | 5/13/2026 |