EmberTrace.Export 0.1.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package EmberTrace.Export --version 0.1.1
                    


                    

                
NuGet\Install-Package EmberTrace.Export -Version 0.1.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="EmberTrace.Export" Version="0.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="EmberTrace.Export" Version="0.1.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="EmberTrace.Export" />
                    


                            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 EmberTrace.Export --version 0.1.1
                    


                    

                
#r "nuget: EmberTrace.Export, 0.1.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 EmberTrace.Export@0.1.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=EmberTrace.Export&version=0.1.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=EmberTrace.Export&version=0.1.1
                    


                            Install as a Cake Tool

EmberTrace

EmberTrace — быстрый in-process tracer/profiler для .NET с минимальной нагрузкой на горячем пути:

  • Begin/End без аллокаций и без глобальных lock (thread-local буферы)
  • Flows для связей между потоками и async/await
  • Offline-анализ после остановки сессии (агрегации + отчёты)
  • Экспорт в Chrome Trace (для chrome://tracing / Perfetto)

Установка

Самый простой вариант — метапакет:

dotnet add package EmberTrace.All

Если подключаешь выборочно:

  • EmberTrace — runtime API (Tracer.*)
  • EmberTrace.Abstractions — атрибуты ([assembly: TraceId(...)])
  • EmberTrace.Generator — source generator (автоматически регистрирует метаданные)
  • EmberTrace.Analysis — обработка сессии (session.Process())
  • EmberTrace.ReportText — текстовый отчёт (TraceText.Write(...))
  • EmberTrace.Export — Chrome Trace export (TraceExport.*)

Быстрый старт

  1. Опиши id и метаданные (в любом файле проекта, на уровне assembly):
using EmberTrace.Abstractions.Attributes;

[assembly: TraceId(1000, "App", "App")]
[assembly: TraceId(2000, "Worker", "Workers")]
  1. Оберни нужные участки в scopes:
using EmberTrace;

Tracer.Start();

using (Tracer.Scope(1000))
{
    // работа
}

var session = Tracer.Stop();
  1. Сними отчёт и/или экспорт:
var processed = session.Process();
var meta = Tracer.CreateMetadata(); // если подключён generator — метаданные будут зарегистрированы автоматически

Console.WriteLine(TraceText.Write(processed, meta: meta, topHotspots: 20, maxDepth: 8));

using var fs = File.Create("out/trace.json");
TraceExport.WriteChromeComplete(session, fs, meta: meta);
  1. Открой out/trace.json:
  • chrome://tracing (Chrome)
  • Perfetto (веб-UI) — удобно для больших трасс

Пример из репозитория

Самый полный пример — samples/EmberTrace.Demo3 (scopes + flows + async + экспорт + текстовый отчёт):

dotnet run --project samples/EmberTrace.Demo3 -c Release
# файлы появятся в samples/EmberTrace.Demo3/out

Документация

Сборка и тесты

Требуется SDK, указанный в global.json.

dotnet build -c Release
dotnet test -c Release

Скриншоты

Пример простой трассы в Perfetto

Perfetto timeline

Полезные ссылки

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 (2)

Showing the top 2 NuGet packages that depend on EmberTrace.Export:

Package Downloads
EmberTrace.All

Meta package that pulls EmberTrace runtime, generator, analysis, export, and text reporting.
EmberTrace.Extensions.Hosting

Hosting integration for EmberTrace: AddEmberTrace, ASP.NET Core request tracing middleware, appsettings.json configuration, session lifetime as a hosted service, and a guarded flight recorder dump endpoint.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.3.0 141 9/2/2026
0.2.3 165 8/20/2026
0.2.2 143 5/19/2026
0.2.1 187 2/7/2026
0.2.0 146 2/2/2026
0.1.1 161 1/26/2026
0.1.0 148 1/24/2026