thepraandClaude Opus 5.5
6ef7e2891a
Under /clientapi/admin/statistics, admin only (the root JWT's IsAdmin policy, like the domain
blocks; /api tokens are persona tokens):
- GET overview?days: totals per channel, inbound and outbound outcomes, the delivery
success rate, delivery latency p50/p95 from the buckets, active and known servers,
distinct accounts, and the ledger's written/dropped/failed counts;
- GET hosts?days&sort=volume|failures|latency|host&software&page&limit: per server
traffic, refusals, failures, latency, accounts, software and delivery health;
- GET hosts/{host}?days: the server's description, its daily series and its last 100
events;
- GET events?host&channel&outcome&reason&before&limit, and GET server?days for the
ServerDay rows;
- POST rollups/{day} refolds a past day; POST hosts/{host}/describe describes a server
again.
Days not yet rolled up, today included, are folded live from the events, so the numbers are
current. Answers that may carry locations carry the DB-IP attribution.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ELjqpznMFMNrJoJUj6K5p2
73 lines
3.1 KiB
C#
73 lines
3.1 KiB
C#
using Microsoft.AspNetCore.Authorization;
|
|
using Microsoft.AspNetCore.Mvc;
|
|
|
|
using PrivaPub.ClientModels;
|
|
using PrivaPub.Domain.Statistics;
|
|
using PrivaPub.Infrastructure.Jobs;
|
|
using PrivaPub.Infrastructure.Statistics;
|
|
using PrivaPub.Models.Jobs;
|
|
|
|
using System.Globalization;
|
|
|
|
namespace PrivaPub.Controllers.ClientToServer
|
|
{
|
|
[ApiController,
|
|
Route("clientapi/admin/statistics"),
|
|
Authorize(Policy = Policies.IsAdmin)]
|
|
public class StatisticsController : ControllerBase
|
|
{
|
|
readonly StatisticsQueries _queries;
|
|
readonly IJobQueue _queue;
|
|
|
|
public StatisticsController(StatisticsQueries queries, IJobQueue queue)
|
|
{
|
|
_queries = queries;
|
|
_queue = queue;
|
|
}
|
|
|
|
[HttpGet, Route("/clientapi/admin/statistics/overview")]
|
|
public async Task<IActionResult> Overview([FromQuery] int days = 30, CancellationToken token = default) =>
|
|
Ok(await _queries.Overview(days, token));
|
|
|
|
[HttpGet, Route("/clientapi/admin/statistics/hosts")]
|
|
public async Task<IActionResult> Hosts([FromQuery] int days = 30, [FromQuery] string sort = default, [FromQuery] string software = default,
|
|
[FromQuery] int page = 1, [FromQuery] int limit = 50, CancellationToken token = default) =>
|
|
Ok(await _queries.Hosts(days, sort, software, page, limit, token));
|
|
|
|
[HttpGet, Route("/clientapi/admin/statistics/hosts/{host}")]
|
|
public async Task<IActionResult> Host(string host, [FromQuery] int days = 90, CancellationToken token = default) =>
|
|
await _queries.Host(host, days, token) is { } found ? Ok(found) : NotFound();
|
|
|
|
[HttpGet, Route("/clientapi/admin/statistics/events")]
|
|
public async Task<IActionResult> Events([FromQuery] string host = default, [FromQuery] string channel = default, [FromQuery] string outcome = default,
|
|
[FromQuery] string reason = default, [FromQuery] DateTime? before = default, [FromQuery] int limit = 100, CancellationToken token = default) =>
|
|
Ok(await _queries.Events(host, channel, outcome, reason, before, limit, token));
|
|
|
|
[HttpGet, Route("/clientapi/admin/statistics/server")]
|
|
public async Task<IActionResult> Server([FromQuery] int days = 30, CancellationToken token = default) =>
|
|
Ok(await _queries.Server(days, token));
|
|
|
|
[HttpPost, Route("/clientapi/admin/statistics/rollups/{day}")]
|
|
public async Task<IActionResult> Rollup(string day, CancellationToken token)
|
|
{
|
|
if (!DateTime.TryParseExact(day, "yyyy-MM-dd", CultureInfo.InvariantCulture, DateTimeStyles.AdjustToUniversal | DateTimeStyles.AssumeUniversal, out var parsed)
|
|
|| parsed.Date >= DateTime.UtcNow.Date)
|
|
return BadRequest();
|
|
var job = RollupJob.For(parsed.Date, $"rollup|{day}|rerun|{DateTime.UtcNow.Ticks}");
|
|
job.RunAt = DateTime.UtcNow;
|
|
await _queue.EnqueueMany(new[] { job }, token);
|
|
return Accepted();
|
|
}
|
|
|
|
[HttpPost, Route("/clientapi/admin/statistics/hosts/{host}/describe")]
|
|
public async Task<IActionResult> Describe(string host, CancellationToken token)
|
|
{
|
|
host = Interactions.Host(host);
|
|
if (host == Interactions.Unknown)
|
|
return BadRequest();
|
|
await _queue.Enqueue(JobKind.DescribeInstance, host, host, $"describe|{host}|admin|{DateTime.UtcNow.Ticks}", token);
|
|
return Accepted();
|
|
}
|
|
}
|
|
}
|