Skip to content

An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 360+ one-click services on your own servers.

feat(traffic): add team traffic aggregation service

Aditya Tripathi94e5da192a5b
diff --git a/app/Services/TrafficAnalyticsAggregator.php b/app/Services/TrafficAnalyticsAggregator.php
new file mode 100644
index 0000000000..6e057a3816
--- /dev/null
+++ b/app/Services/TrafficAnalyticsAggregator.php
@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Services;
+
+use App\Data\Traffic\TrafficOverviewData;
+
+class TrafficAnalyticsAggregator
+{
+ /**
+ * @param array<int, TrafficOverviewData> $overviews
+ * @return array{overview: TrafficOverviewData, latencyApproximate: bool, uniquesApproximate: bool}
+ */
+ public static function sumOverviews(array $overviews): array
+ {
+ $multi = count($overviews) > 1;
+ $sum = fn (string $prop) => array_sum(array_map(fn ($o) => $o->{$prop}, $overviews));
+ $max = fn (string $prop) => empty($overviews) ? 0.0 : max(array_map(fn ($o) => $o->{$prop}, $overviews));
+
+ $overview = new TrafficOverviewData(
+ requests: $sum('requests'),
+ bytesIn: $sum('bytesIn'),
+ bytesOut: $sum('bytesOut'),
+ s2xx: $sum('s2xx'),
+ s3xx: $sum('s3xx'),
+ s4xx: $sum('s4xx'),
+ s5xx: $sum('s5xx'),
+ latencyP50: (float) $max('latencyP50'),
+ latencyP95: (float) $max('latencyP95'),
+ latencyP99: (float) $max('latencyP99'),
+ uniqueVisitors: $sum('uniqueVisitors'),
+ );
+
+ return [
+ 'overview' => $overview,
+ 'latencyApproximate' => $multi,
+ 'uniquesApproximate' => $multi,
+ ];
+ }
+}
diff --git a/tests/Feature/TrafficAnalytics/TrafficAnalyticsAggregatorTest.php b/tests/Feature/TrafficAnalytics/TrafficAnalyticsAggregatorTest.php
new file mode 100644
index 0000000000..ef9f7325f6
--- /dev/null
+++ b/tests/Feature/TrafficAnalytics/TrafficAnalyticsAggregatorTest.php
@@ -0,0 +1,26 @@
+<?php
+
+use App\Data\Traffic\TrafficOverviewData;
+use App\Services\TrafficAnalyticsAggregator;
+
+it('sums additive fields and flags latency/uniques as approximate', function () {
+ $a = new TrafficOverviewData(10, 1, 2, 8, 1, 1, 0, 5.0, 20.0, 30.0, 4);
+ $b = new TrafficOverviewData(20, 3, 4, 18, 1, 1, 0, 9.0, 50.0, 60.0, 6);
+
+ $result = TrafficAnalyticsAggregator::sumOverviews([$a, $b]);
+ $o = $result['overview'];
+ expect($o->requests)->toBe(30);
+ expect($o->bytesOut)->toBe(6);
+ expect($o->s2xx)->toBe(26);
+ expect($o->uniqueVisitors)->toBe(10); // summed
+ expect($o->latencyP95)->toBe(50.0); // max across servers
+ expect($result['latencyApproximate'])->toBeTrue();
+ expect($result['uniquesApproximate'])->toBeTrue();
+});
+
+it('returns a zeroed, non-approximate result for a single server', function () {
+ $a = new TrafficOverviewData(10, 1, 2, 8, 1, 1, 0, 5.0, 20.0, 30.0, 4);
+ $result = TrafficAnalyticsAggregator::sumOverviews([$a]);
+ expect($result['latencyApproximate'])->toBeFalse();
+ expect($result['uniquesApproximate'])->toBeFalse();
+});