StatusNamaa 0.6.0

dotnet add package StatusNamaa --version 0.6.0
                    
NuGet\Install-Package StatusNamaa -Version 0.6.0
                    
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="StatusNamaa" Version="0.6.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="StatusNamaa" Version="0.6.0" />
                    
Directory.Packages.props
<PackageReference Include="StatusNamaa" />
                    
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 StatusNamaa --version 0.6.0
                    
#r "nuget: StatusNamaa, 0.6.0"
                    
#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 StatusNamaa@0.6.0
                    
#: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=StatusNamaa&version=0.6.0
                    
Install as a Cake Addin
#tool nuget:?package=StatusNamaa&version=0.6.0
                    
Install as a Cake Tool

StatusNamaa

Build Status StatusNamaa

Easily integrate a lightweight metrics dashboard into your ASP.NET Core application. This package provides a simple yet effective way to monitor application status, accessible at /statusnamaa.svg.

<img src="https://raw.githubusercontent.com/ctyar/StatusNamaa/refs/heads/main/doc/images/dashboard.png" width="50%" > <img src="https://raw.githubusercontent.com/ctyar/StatusNamaa/refs/heads/main/doc/images/fullpage.png" width="50%" >

Usage

  1. In your Program.cs file Add app.AddStatusNamaa() and app.MapStatusNamaa():

    + builder.Services.AddStatusNamaa();
    
      var app = builder.Build();
    
    + app.MapStatusNamaa();
    
  2. Add an image tag with statusnamaa.svg src in your HTML:

    <img src="/statusnamaa.svg" alt="StatusNamaa" />
    

Features

Customizing metrics

You can configure which metrics appear on the status page using StatusNamaaOptions:

builder.Services.AddStatusNamaa(o =>
{
    // Clear default metrics
    o.Metrics.Clear();

    // Add a .NET built-in metric
    o.AddMetric("dotnet.exceptions");

    // Add a .NET built-in metric with custom display name and type
    o.Metrics.Add(new StatusNamaaMetric
    {
        Name = "dotnet.process.memory.working_set",
        DisplayName = "Working Set",
        Type = StatusNamaaValueType.Bytes,
    });

    // Add a custom value
    o.AddMetric("Custom Value", async services =>
    {
        var listenerService = services.GetRequiredService<ListenerService>();

        return await listenerService.GetValue();
    });
});

Authentication

You can secure the status page by chaining RequireAuthorization() to the result of MapStatusNamaa():

app.MapStatusNamaa()
    .RequireAuthorization();

Metrics

Caching

Pre-release builds

Get the package from here.

Build

Install the required .NET SDK and run:

$ dotnet build
Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.6.0 263 7/18/2025
0.5.2 176 7/10/2025
0.5.1 148 7/7/2025
0.5.0 76 7/5/2025
0.4.0 133 6/27/2025
0.3.0 314 6/11/2025
0.2.0 121 6/7/2025
0.1.0 127 6/7/2025