Vostok.Tracing.Hercules 0.1.10-pre000039

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
.NET 6.0 .NET Standard 2.0
This is a prerelease version of Vostok.Tracing.Hercules.
dotnet add package Vostok.Tracing.Hercules --version 0.1.10-pre000039
NuGet\Install-Package Vostok.Tracing.Hercules -Version 0.1.10-pre000039
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="Vostok.Tracing.Hercules" Version="0.1.10-pre000039" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Vostok.Tracing.Hercules --version 0.1.10-pre000039
#r "nuget: Vostok.Tracing.Hercules, 0.1.10-pre000039"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Vostok.Tracing.Hercules as a Cake Addin
#addin nuget:?package=Vostok.Tracing.Hercules&version=0.1.10-pre000039&prerelease

// Install Vostok.Tracing.Hercules as a Cake Tool
#tool nuget:?package=Vostok.Tracing.Hercules&version=0.1.10-pre000039&prerelease


Build & Test & Publish NuGet

An implementation of trace span sender based on Hercules client. Also provides mapping from Hercules events back to spans.

Here's how ISpan instances are mapped into Hercules events (according to schema):

  • TraceId (mandatory) ---> traceId tag of UUID type.

  • SpanId (mandatory) ---> spanId tag of UUID type.

  • ParentSpanId (optional) ---> parentSpanId tag of UUID type.

  • BeginTimestamp (mandatory) corresponds to 2 tags:

    • beginTimestampUtc — a long tag that contains the UTC timestamp in 100-ns ticks from Unix epoch.
    • beginTimestampUtcOffset — a long tag with offset from UTC expressed in 100-ns ticks.
  • EndTimestamp (optional) also corresponds to 2 tags, both of which can be absent for 'endless' spans:

    • endTimestampUtc — a long tag that contains the UTC timestamp in 100-ns ticks from Unix epoch.
    • endTimestampUtcOffset — a long tag with offset from UTC expressed in 100-ns ticks.
  • Annotations dictionary corresponds to a container with name annotations. This container contains a tag for each pair. Keys are translated as-is, and the values are handled according to following conventions:

    • If the value is a primitive scalar or a vector of primitive scalars natively supported by Hercules (such as int, long, guid, string, etc), it's mapped as-is.
    • Otherwise the value gets converted to string: either stringified directly (if it properly overrides ToString()) or serialized to JSON. No further container-like structure is allowed, all values end up being 'flat'.

Hercules event's built-in timestamp is chosen equal to EndTimestampUtc or BeginTimestampUtc if former is missing.

Unix epoch used as a reference point for timestamp is 1970-01-01 00:00:00.000Z.

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48 net481
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Vostok.Tracing.Hercules:

Package Downloads
Vostok.Hosting The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

The entry point to create and launch Vostok-compatible services.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.1.10-pre000039 1,319 9/28/2022
0.1.10-pre000038 295 9/14/2022
0.1.10-pre000031 293 7/28/2022
0.1.10-pre000030 193 6/2/2022
0.1.10-pre000026 126 12/24/2021
0.1.9 9,591 12/24/2021
0.1.9-pre000024 84 12/24/2021
0.1.8 176 12/24/2021
0.1.8-pre000022 92 12/20/2021
0.1.8-pre000021 342 12/8/2021
0.1.7 2,414 12/8/2021
0.1.7-pre000019 98 12/7/2021
0.1.6 333 12/6/2021
0.1.6-pre000017 102 12/4/2021
0.1.6-pre000016 98 12/3/2021
0.1.6-pre000015 104 12/3/2021
0.1.6-pre000014 100 11/27/2021
0.1.6-pre000013 94 11/27/2021
0.1.6-pre000012 1,465 11/26/2021
0.1.6-pre000011 6,108 11/24/2021
0.1.6-pre000010 5,806 11/23/2021
0.1.6-pre000008 101 11/23/2021
0.1.6-pre000007 132 11/18/2021
0.1.5 4,006 11/18/2021
0.1.5-pre000091 709 5/27/2021
0.1.5-pre000087 376 2/28/2021
0.1.5-pre000084 225 2/28/2021
0.1.5-pre000083 226 2/26/2021
0.1.5-pre000080 273 1/20/2021
0.1.4 41,525 1/20/2021
0.1.4-pre000045 1,793 8/12/2020
0.1.3 72,300 8/12/2020
0.1.3-pre000043 367 6/23/2020
0.1.2 45,003 6/23/2020
0.1.1-pre000028 848 3/20/2020
0.1.0 126,339 3/23/2019
0.0.1-pre000015 472 1/16/2019
0.0.1-pre000014 500 1/16/2019
0.0.1-pre000009 470 12/10/2018
0.0.1-pre000008 465 12/10/2018
0.0.1-pre000007 457 12/8/2018
0.0.1-pre000006 454 12/8/2018
0.0.1-pre000005 494 12/8/2018
0.0.1-pre000004 483 12/8/2018
0.0.1-pre000003 481 12/8/2018
0.0.1-pre000002 475 12/8/2018
0.0.1-pre000001 437 12/8/2018