using System.Globalization; using System.Net.Http.Json; using System.Text.Json; namespace Ghostnet.Dashboard.Services; /// /// Minimal PromQL client for the VictoriaMetrics instant-query API /// (GNMON-001 section 4: /api/v1/query, Prometheus-compatible). /// public sealed class VictoriaMetricsClient { private readonly HttpClient _http; public VictoriaMetricsClient(HttpClient http) => _http = http; /// /// Runs an instant query and returns the scalar value of the first /// result series, or null when the query returns no series. /// public async Task QueryAsync(string promql, CancellationToken ct) { using var response = await _http.GetAsync( $"/api/v1/query?query={Uri.EscapeDataString(promql)}", ct); response.EnsureSuccessStatusCode(); using var doc = await response.Content.ReadFromJsonAsync(ct); if (doc is null) { return null; } var result = doc.RootElement .GetProperty("data") .GetProperty("result"); if (result.ValueKind != JsonValueKind.Array || result.GetArrayLength() == 0) { return null; } var value = result[0].GetProperty("value")[1].GetString(); // PromQL values are dot-decimal JSON strings; parsing must never // depend on the host culture (de-DE would read "." as a group // separator and turn 9.71 into 9713020833333342). return double.TryParse(value, NumberStyles.Float, CultureInfo.InvariantCulture, out var parsed) ? parsed : null; } /// /// Runs several instant queries in parallel (cadence-friendly). /// public Task QueryAllAsync(IEnumerable queries, CancellationToken ct) => Task.WhenAll(queries.Select(q => QueryAsync(q, ct))); /// /// One result series with its labels (e.g. card, gpu). /// public sealed record SeriesResult(IReadOnlyDictionary Labels, double Value); /// /// One range series with its labels (e.g. per-GPU histories). /// public sealed record SeriesRange( IReadOnlyDictionary Labels, IReadOnlyList Points); /// /// Runs a range query over every result series (label-aware). /// public async Task> QueryRangeSeriesAsync( string promql, DateTimeOffset start, DateTimeOffset end, TimeSpan step, CancellationToken ct) { var url = string.Create(CultureInfo.InvariantCulture, $"/api/v1/query_range?query={Uri.EscapeDataString(promql)}" + $"&start={start.ToUnixTimeSeconds()}&end={end.ToUnixTimeSeconds()}" + $"&step={(int)step.TotalSeconds}"); using var response = await _http.GetAsync(url, ct); response.EnsureSuccessStatusCode(); using var doc = await response.Content.ReadFromJsonAsync(ct); var series = new List(); if (doc is null) { return series; } var result = doc.RootElement .GetProperty("data") .GetProperty("result"); if (result.ValueKind != JsonValueKind.Array) { return series; } foreach (var item in result.EnumerateArray()) { var labels = new Dictionary(); foreach (var label in item.GetProperty("metric").EnumerateObject()) { labels[label.Name] = label.Value.GetString() ?? ""; } var points = new List(); foreach (var point in item.GetProperty("values").EnumerateArray()) { var raw = point[1].GetString(); if (!double.TryParse(raw, NumberStyles.Float, CultureInfo.InvariantCulture, out var value)) { continue; } points.Add(new RangePoint( DateTimeOffset.FromUnixTimeSeconds(point[0].GetInt64()), value)); } series.Add(new SeriesRange(labels, points)); } return series; } /// /// One point of a query_range result. /// public sealed record RangePoint(DateTimeOffset Timestamp, double Value); /// /// Runs a range query (Prometheus query_range API) over the first /// result series. /// public async Task> QueryRangeAsync( string promql, DateTimeOffset start, DateTimeOffset end, TimeSpan step, CancellationToken ct) { var url = string.Create(CultureInfo.InvariantCulture, $"/api/v1/query_range?query={Uri.EscapeDataString(promql)}" + $"&start={start.ToUnixTimeSeconds()}&end={end.ToUnixTimeSeconds()}" + $"&step={(int)step.TotalSeconds}"); using var response = await _http.GetAsync(url, ct); response.EnsureSuccessStatusCode(); using var doc = await response.Content.ReadFromJsonAsync(ct); var points = new List(); if (doc is null) { return points; } var result = doc.RootElement .GetProperty("data") .GetProperty("result"); if (result.ValueKind != JsonValueKind.Array || result.GetArrayLength() == 0) { return points; } foreach (var point in result[0].GetProperty("values").EnumerateArray()) { var raw = point[1].GetString(); if (!double.TryParse(raw, NumberStyles.Float, CultureInfo.InvariantCulture, out var value)) { continue; } points.Add(new RangePoint( DateTimeOffset.FromUnixTimeSeconds(point[0].GetInt64()), value)); } return points; } /// /// Runs an instant query and returns every result series with its /// label set (multi-card GPU metrics). /// public async Task> QuerySeriesAsync( string promql, CancellationToken ct) { using var response = await _http.GetAsync( $"/api/v1/query?query={Uri.EscapeDataString(promql)}", ct); response.EnsureSuccessStatusCode(); using var doc = await response.Content.ReadFromJsonAsync(ct); var results = new List(); if (doc is null) { return results; } var result = doc.RootElement .GetProperty("data") .GetProperty("result"); if (result.ValueKind != JsonValueKind.Array) { return results; } foreach (var item in result.EnumerateArray()) { var raw = item.GetProperty("value")[1].GetString(); if (!double.TryParse(raw, NumberStyles.Float, CultureInfo.InvariantCulture, out var value)) { continue; } var labels = new Dictionary(); foreach (var label in item.GetProperty("metric").EnumerateObject()) { labels[label.Name] = label.Value.GetString() ?? ""; } results.Add(new SeriesResult(labels, value)); } return results; } }