Graftcode.Instrumentation
1.0.5
dotnet add package Graftcode.Instrumentation --version 1.0.5
NuGet\Install-Package Graftcode.Instrumentation -Version 1.0.5
<PackageReference Include="Graftcode.Instrumentation" Version="1.0.5" />
<PackageVersion Include="Graftcode.Instrumentation" Version="1.0.5" />
<PackageReference Include="Graftcode.Instrumentation" />
paket add Graftcode.Instrumentation --version 1.0.5
#r "nuget: Graftcode.Instrumentation, 1.0.5"
#:package Graftcode.Instrumentation@1.0.5
#addin nuget:?package=Graftcode.Instrumentation&version=1.0.5
#tool nuget:?package=Graftcode.Instrumentation&version=1.0.5
Graftcode.Instrumentation
OpenTelemetry spans and ILogger forwarding for Graftcode invocations.
The package references Hypertube.Netcore.Utils and attaches itself to Hypertube's
HypertubeBroker and HypertubeLogger through the abstractions in
Hypertube.Netcore.Utils.Abstractions. Commands are consumed through Hypertube's
ICommand abstraction. Hypertube has no reference to this package; without it, Hypertube
records no spans and forwards no logs.
Usage
using var tracing = Sdk.CreateTracerProviderBuilder()
.AddGraftcodeInstrumentation(loggerFactory.CreateLogger("Hypertube"))
.AddYourExporter()
.Build();
- Spans are emitted from the
Graftcodeactivity source. - When a logger is passed, Hypertube log lines are forwarded to it; otherwise they are recorded as events on the current span.
- Instrumentation is active for the lifetime of the tracer provider. If several providers register it, the last one wins.
Hypertube dependency
By default this package references Hypertube.Netcore.Utils from NuGet (Version="*"),
so CI and other machines do not need a local Hypertube checkout.
For local Hypertube development, build with a project reference instead:
dotnet build -p:UseHypertubeUtilsProject=true -p:HypertubeAssemblyVersion=3.1.18.0
HypertubeUtilsProject overrides the path to the Utils .csproj. If ../../../../NewHT/HYPERTUBE/... exists relative to this folder, Directory.Build.props
sets UseHypertubeUtilsProject automatically.
At runtime, Hypertube loads Utils by exact assembly version, so the Utils version on the host
must match the Utils this library was compiled against. The current Hypertube.Netcore.Utils
on NuGet must be republished with the abstractions and ICommand APIs before remote-only builds
(that rely on Version="*") can compile against it.
Request and response bodies
Body capture is off by default (HYPERTUBE_TELEMETRY_CAPTURE_BODIES,
HYPERTUBE_TELEMETRY_BODY_MAX_CHARS). Enabling it may expose PII or secrets in telemetry; it is
intended only for controlled dev/staging environments or explicitly approved production
diagnostics. Known sensitive keys, headers, tokens and connection strings are redacted with
Hypertube's LogsRedactor before anything is recorded.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. 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 was computed. 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 was computed. 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. |
| .NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.1 is compatible. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- Hypertube.Netcore.Utils (>= 3.2.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.5)
- OpenTelemetry.Api (>= 1.15.3)
- System.Diagnostics.DiagnosticSource (>= 10.0.0)
-
net8.0
- Hypertube.Netcore.Utils (>= 3.2.0)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.5)
- OpenTelemetry.Api (>= 1.15.3)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Graftcode.Instrumentation:
| Package | Downloads |
|---|---|
|
GraftCode.Netcore.Telemetry.AppInsightsConnector
One-line Application Insights telemetry setup for GraftCode applications. |
GitHub repositories
This package is not used by any popular GitHub repositories.