VOOZH about

URL: https://www.nuget.org/packages/MMP.Herald.Sinks.OtlpGrpc/

⇱ NuGet Gallery | MMP.Herald.Sinks.OtlpGrpc 0.2.1




MMP.Herald.Sinks.OtlpGrpc 0.2.1

dotnet add package MMP.Herald.Sinks.OtlpGrpc --version 0.2.1
 
 
NuGet\Install-Package MMP.Herald.Sinks.OtlpGrpc -Version 0.2.1
 
 
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="MMP.Herald.Sinks.OtlpGrpc" Version="0.2.1" />
 
 
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="MMP.Herald.Sinks.OtlpGrpc" Version="0.2.1" />
 
Directory.Packages.props
<PackageReference Include="MMP.Herald.Sinks.OtlpGrpc" />
 
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 MMP.Herald.Sinks.OtlpGrpc --version 0.2.1
 
 
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: MMP.Herald.Sinks.OtlpGrpc, 0.2.1"
 
 
#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 MMP.Herald.Sinks.OtlpGrpc@0.2.1
 
 
#: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=MMP.Herald.Sinks.OtlpGrpc&version=0.2.1
 
Install as a Cake Addin
#tool nuget:?package=MMP.Herald.Sinks.OtlpGrpc&version=0.2.1
 
Install as a Cake Tool
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Herald.Sinks.OtlpGrpc

Exports Herald log events to an OpenTelemetry collector over OTLP/gRPC. Calls opentelemetry.proto.collector.logs.v1.LogsService/Export with the standard ExportLogsServiceRequest payload. Reuses the hand-rolled protobuf writer from Herald.Sinks.Otlp so payload shape stays identical across HTTP and gRPC transports — no proto codegen, no generated message types.

Part of Herald — high-performance structured logging for .NET 8, 9, and 10.

Install

dotnet add package Herald.Sinks.OtlpGrpc

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: otlp_grpc (the identifier the Dashboard form and JSON config use to reference this sink).

Capabilities

  • OTLP/gRPC log export to any compliant collector (OpenTelemetry Collector, Tempo, Honeycomb, Grafana Agent, etc.)
  • Reuses OtlpProtobufLogSerializer from Herald.Sinks.Otlp — identical wire payload to the HTTP-OTLP sibling sink
  • Raw byte marshallers on the gRPC method descriptor — no proto-codegen step, no generated IMessage types, AOT-clean
  • Batched delivery via IBatchedLogSink
  • Configurable per-call deadline (default 30s)

Limitations

  • No compression on the request body (matches the HTTP-OTLP sibling)
  • No mTLS / custom credentials configurable through runtime-definition today — construct OtlpGrpcLogSink directly with a configured GrpcChannel for advanced auth scenarios
  • Resource attributes configurable at construction only

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 — GrpcChannel is shared across calls and is itself thread-safe per gRPC contract.

Vendor

OpenTelemetry — https://opentelemetry.io/docs/specs/otlp/

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 net8.0 is compatible.  net8.0-android net8.0-android was computed.  net8.0-browser net8.0-browser was computed.  net8.0-ios net8.0-ios was computed.  net8.0-maccatalyst net8.0-maccatalyst was computed.  net8.0-macos net8.0-macos was computed.  net8.0-tvos net8.0-tvos was computed.  net8.0-windows net8.0-windows was computed.  net9.0 net9.0 is compatible.  net9.0-android net9.0-android was computed.  net9.0-browser net9.0-browser was computed.  net9.0-ios net9.0-ios was computed.  net9.0-maccatalyst net9.0-maccatalyst was computed.  net9.0-macos net9.0-macos was computed.  net9.0-tvos net9.0-tvos was computed.  net9.0-windows net9.0-windows was computed.  net10.0 net10.0 is compatible.  net10.0-android net10.0-android was computed.  net10.0-browser net10.0-browser was computed.  net10.0-ios net10.0-ios was computed.  net10.0-maccatalyst net10.0-maccatalyst was computed.  net10.0-macos net10.0-macos was computed.  net10.0-tvos net10.0-tvos was computed.  net10.0-windows 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
0.2.1 89 5/30/2026
0.2.0 102 5/26/2026
0.2.0-alpha.3 67 5/13/2026
0.2.0-alpha.2 49 5/13/2026
0.2.0-alpha.1 49 5/13/2026