# dotnet/diagnostics

This repository contains the source code for various .NET Core runtime diagnostic tools and documents.

Repository: https://github.com/dotnet/diagnostics
Canonical: https://ross.abutalabs.com/products/diagnostics
Language: C++
License: MIT
License Family: permissive
Last push: 2026-08-25T23:34:27+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 78, longevity 100
- inputs: {"age_days": 3087, "days_push": 8, "days_rel": 64, "gap_med": 68, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1329, forks 401 (observed 2026-08-28T04:04:23.820648+00:00)

## What it is
A repository of .NET Core runtime diagnostic tools including SOS, the lldb SOS plugin, and global CLI tools like dotnet-dump, dotnet-gcdump, dotnet-trace, and dotnet-counters. It supports dump collection, heap analysis, event tracing, and real-time performance counter monitoring across many OSes and architectures.

## Use cases
- collect and analyze memory dumps of .NET Core processes
- monitor performance counters of a running .NET application in real time
- trace events from a live .NET Core app to a file
- analyze the managed heap of a .NET process
- debug .NET Core crashes with SOS in lldb
- investigate memory leaks in production .NET services

## When to choose
- you need to diagnose crashes, hangs, or memory issues in .NET Core applications
- you want lightweight CLI tools for live performance monitoring and tracing of .NET apps
- you need SOS/lldb-based debugging on Linux, macOS, or Windows

## When to avoid
- you need application-level or APM-style monitoring rather than runtime diagnostics
- you are not working with .NET Core / .NET 5+ runtimes
- you want a GUI-based profiler

## Facets
- artifact type: cli-tool
- maturity: active
- function: monitoring, tracing, developer-tools, cli
- domain: developer-tools, performance
- platform: windows, cross-platform, cli
- tags: dotnet, sos, lldb, memory-dump, profiling, diagnostics, debugging, linux, macos

## Member repositories
- dotnet/diagnostics (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:23.820648+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:45:39.233623+00:00, confidence not recorded.
  - readme: https://github.com/dotnet/diagnostics (fetched 2026-08-28T04:04:23.820648+00:00, sha e64cd875d10b)
- Data as of 2026-08-30T08:39:29.467469+00:00.