{"id":24629488,"url":"https://github.com/sharpjs/subatomix.logging","last_synced_at":"2026-05-20T10:43:42.790Z","repository":{"id":38682115,"uuid":"492322506","full_name":"sharpjs/Subatomix.Logging","owner":"sharpjs","description":"Additions to Microsoft.Extensions.Logging","archived":false,"fork":false,"pushed_at":"2024-11-16T16:47:21.000Z","size":1039,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-25T06:13:02.823Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sharpjs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-14T20:50:12.000Z","updated_at":"2024-11-16T16:32:05.000Z","dependencies_parsed_at":"2024-11-06T05:29:14.304Z","dependency_job_id":null,"html_url":"https://github.com/sharpjs/Subatomix.Logging","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpjs%2FSubatomix.Logging","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpjs%2FSubatomix.Logging/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpjs%2FSubatomix.Logging/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpjs%2FSubatomix.Logging/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sharpjs","download_url":"https://codeload.github.com/sharpjs/Subatomix.Logging/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244554042,"owners_count":20471172,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-25T06:13:05.097Z","updated_at":"2026-05-20T10:43:37.746Z","avatar_url":"https://github.com/sharpjs.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutputFileName: index.html\n---\n\n# Subatomix.Logging\n\nAdditions to [Microsoft.Extensions.Logging](https://www.nuget.org/packages/Microsoft.Extensions.Logging)\nin three NuGet packages:\n\n- [**Subatomix.Logging**](https://www.nuget.org/packages/Subatomix.Logging)\n  - [`PrettyConsoleFormatter`](https://sharpjs.github.io/Subatomix.Logging/api/Subatomix.Logging/Subatomix.Logging.Console.html)\n    – A terse, colorful formatter for Microsoft's\n      [console logger](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/logging/?view=aspnetcore-6.0#console).\n  - [`DebuggerLogger`](https://sharpjs.github.io/Subatomix.Logging/api/Subatomix.Logging/Subatomix.Logging.Debugger.html)\n    – A logger that sends messages to an attached debugger. In Visual Studio,\n      logged messages will appear in the debug output window.\n  - [`OperationScope`](https://sharpjs.github.io/Subatomix.Logging/api/Subatomix.Logging/Subatomix.Logging.OperationScope.html)\n    – A scope representing a logical operation.  Automatically logs the start,\n      end, duration, and (optionally) the exception thrown from an operation.\n  - [`ActivityScope`](https://sharpjs.github.io/Subatomix.Logging/api/Subatomix.Logging/Subatomix.Logging.ActivityScope.html)\n    – An operation scope that also starts and stops an\n      [`Activity`](https://docs.microsoft.com/en-us/dotnet/core/diagnostics/distributed-tracing-instrumentation-walkthroughs).\n      The activity carries tags understood by\n      [Application Insights](https://docs.microsoft.com/en-us/azure/azure-monitor/app/app-insights-overview),\n      which can present the activity as a dependency telemetry item.\n- [**Subatomix.Logging.Legacy**](https://www.nuget.org/packages/Subatomix.Logging.Legacy)\n  - [`LoggingTraceListener`](https://sharpjs.github.io/Subatomix.Logging/api/Subatomix.Logging.Legacy/Subatomix.Logging.Legacy.LoggingTraceListener.html)\n    – A trace listener plugin for the legacy\n      [`TraceSource`](https://docs.microsoft.com/en-us/dotnet/api/system.diagnostics.tracesource)\n      API.  This listener forwards trace events to\n      [`ILogger`](https://docs.microsoft.com/en-us/dotnet/api/microsoft.extensions.logging.ilogger)\n      loggers.\n  - [`CorrelationManagerActivityListener`](https://sharpjs.github.io/Subatomix.Logging/api/Subatomix.Logging.Legacy/Subatomix.Logging.Legacy.CorrelationManagerActivityListener.html)\n    – A listener that flows\n      [`Activity`](https://docs.microsoft.com/en-us/dotnet/core/diagnostics/distributed-tracing-instrumentation-walkthroughs)\n      start and stop events to the legacy\n      [`CorrelationManager`](https://docs.microsoft.com/en-us/dotnet/api/system.diagnostics.correlationmanager)\n      facility.\n  - [Types to assist migration](https://sharpjs.github.io/Subatomix.Logging/api/Subatomix.Logging.Legacy/Sharp.Diagnostics.Logging.html)\n    from the [Sharp.Diagnostics.Logging](https://github.com/sharpjs/Sharp.Diagnostics.Logging)\n    package.\n- [**Subatomix.Logging.Sql**](https://www.nuget.org/packages/Subatomix.Logging.Sql)\n  - [`SqlLogger`](https://sharpjs.github.io/Subatomix.Logging/api/Subatomix.Logging.Sql/Subatomix.Logging.Sql.html)\n    – A logger that writes to a table in SQL Server or Azure SQL Database.\n\n## Status\n\n[![Build](https://github.com/sharpjs/Subatomix.Logging/workflows/Build/badge.svg)](https://github.com/sharpjs/Subatomix.Logging/actions)\n\nNearing release.\n\n- **New-ish:** New implementation, but based on code with extensive private use in production.\n- **Tested:**  100% coverage by automated tests.\n- **Documented**\u003csup\u003eish\u003c/sup\u003e**:**\n  - :white_check_mark: IntelliSense on everything.\n  - :white_check_mark: [External reference documentation](https://sharpjs.github.io/Subatomix.Logging/).\n  - :x:                No tutorial content yet.\n\n## Installation\n\nNuGet packages are available.\n\nPackage | Status\n--------|-------\n[Subatomix.Logging](https://www.nuget.org/packages/Subatomix.Logging)               | [![NuGet](https://img.shields.io/nuget/v/Subatomix.Logging.svg)](https://www.nuget.org/packages/Subatomix.Logging) [![NuGet](https://img.shields.io/nuget/dt/Subatomix.Logging.svg)](https://www.nuget.org/packages/Subatomix.Logging)\n[Subatomix.Logging.Legacy](https://www.nuget.org/packages/Subatomix.Logging.Legacy) | [![NuGet](https://img.shields.io/nuget/v/Subatomix.Logging.Legacy.svg)](https://www.nuget.org/packages/Subatomix.Logging.Legacy) [![NuGet](https://img.shields.io/nuget/dt/Subatomix.Logging.Legacy.svg)](https://www.nuget.org/packages/Subatomix.Logging.Legacy)\n[Subatomix.Logging.Sql](https://www.nuget.org/packages/Subatomix.Logging.Sql)       | [![NuGet](https://img.shields.io/nuget/v/Subatomix.Logging.Sql.svg)](https://www.nuget.org/packages/Subatomix.Logging.Sql) [![NuGet](https://img.shields.io/nuget/dt/Subatomix.Logging.Sql.svg)](https://www.nuget.org/packages/Subatomix.Logging.Sql)\n\n## Building From Source\n\nRequirements:\n- Appropriate .NET SDKs — see the target framework(s) specified in each `.csproj` file.\n  - Download [.NET SDKs](https://dotnet.microsoft.com/download/dotnet)\n  - Download [.NET Framework Developer Packs](https://dotnet.microsoft.com/download/dotnet-framework)\n- Visual Studio 2022 or later (if using Visual Studio).\n\n```powershell\n# The default: build and run tests\n.\\Make.ps1 [-Test] [-Configuration \u003cString\u003e]\n\n# Just build; don't run tests\n.\\Make.ps1 -Build [-Configuration \u003cString\u003e]\n\n# Build and run tests w/coverage\n.\\Make.ps1 -Coverage [-Configuration \u003cString\u003e]\n```\n\n\u003c!--\n  Copyright Subatomix Research Inc.\n  SPDX-License-Identifier: ISC\n--\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsharpjs%2Fsubatomix.logging","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsharpjs%2Fsubatomix.logging","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsharpjs%2Fsubatomix.logging/lists"}