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;
}
}