Xakpc.NetDiag.Client 1.0.0

Xakpc.NetDiag.Client

Official .NET client for the NetDiag API - network diagnostics as a service. Run distributed health checks (DNS, TLS, HTTP, Ping) from multiple geographic regions worldwide.

Install

dotnet add package Xakpc.NetDiag.Client

Quickstart

using Xakpc.NetDiag.Client;

// Create client (anonymous - limited requests/min)
var client = new NetDiagClient();

// Run diagnostics
var result = await client.CheckAsync("example.com");

Console.WriteLine($"Status: {result.Status}");
Console.WriteLine($"Quorum: {result.Quorum}");

foreach (var location in result.Locations)
{
    Console.WriteLine($"  {location.Region}: {location.Status}");
    if (location.Ping != null)
        Console.WriteLine($"    Ping: {location.Ping.LatencyMs}ms");
    if (location.Tls != null)
        Console.WriteLine($"    TLS: {location.Tls.DaysUntilExpiry} days until expiry");
}

With API Key

// Authenticated client
var client = new NetDiagClient("your-api-key");

// Or with full options
var client = new NetDiagClient(new NetDiagClientOptions
{
    ApiKey = "your-api-key",
    Timeout = TimeSpan.FromSeconds(60)
});

Dependency Injection

// In Program.cs or Startup.cs
builder.Services.AddNetDiagClient(options =>
{
    options.ApiKey = builder.Configuration["NetDiag:ApiKey"];
});

// Inject INetDiagClient in your services
public class HealthCheckService(INetDiagClient netDiag)
{
    public async Task<bool> IsServiceHealthy(string target)
    {
        return await netDiag.IsHealthyAsync(target);
    }
}

Advanced Usage

// Check specific regions with custom parameters
var result = await client.CheckAsync(new ChecksRequest
{
    Target = "api.example.com",
    Regions = "us-east,eu-west",
    Port = 8443,
    PingCount = 10
});

// Quick health check
bool healthy = await client.IsHealthyAsync("example.com");

// Get status only
Status status = await client.GetStatusAsync("example.com");

// URLs are automatically normalized to hostnames
await client.CheckAsync("https://example.com/api/v1"); // checks "example.com"

Prometheus Output

// Get metrics in Prometheus text format
string metrics = await client.CheckPrometheusAsync("example.com");

// With custom parameters
string metrics = await client.CheckPrometheusAsync(new ChecksRequest
{
    Target = "api.example.com",
    Regions = "us-east,eu-west"
});

// Returns Prometheus text format:
// netdiag_status{target="example.com",region="us-east"} 1
// netdiag_ping_latency_ms{target="example.com",region="us-east"} 15.2
// ...

Documentation

Full documentation: https://netdiag.dev/docs/dotnet