Files
coolify/tests/Feature/TrafficAnalytics/ToggleTrafficAnalyticsTest.php
T
Andras BacsaiandClaude Opus 5.5 510a2d838b feat(analytics): log Compose resources on Caddy and add service analytics
Traffic analytics now covers every resource on both proxies:

- Caddy: Compose applications and services get access-log labels. The
  log_append key is {uuid}-{service}, the same key Sentinel reads from
  Traefik router names.
- A resource owns the Sentinel key {uuid} and every key that starts
  with {uuid}-. Application pages and the traffic card now merge all
  keys, so Compose applications and previews show data on Traefik too.
- Global analytics: the leaderboard groups the keys of one resource
  into one row, lists services, and never names keys of other teams.
- New service analytics page (project.service.analytics) with the same
  view and authorization as the application page.
- Switching the proxy type restarts Sentinel when analytics is on, so
  it reads the new log path. Sentinel gets no traffic mount when the
  proxy has no analytics support.
- Caddy servers show a note that resources log only after a redeploy.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 01:00:55 +02:00

281 lines
11 KiB
PHP

<?php
use App\Actions\Server\ConfigureTrafficAnalytics;
use App\Enums\ServerRole;
use App\Livewire\Analytics;
use App\Livewire\Server\TrafficAnalyticsSettings;
use App\Models\InstanceSettings;
use App\Models\Server;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Queue;
use Livewire\Livewire;
uses(RefreshDatabase::class);
beforeEach(function () {
InstanceSettings::forceCreate(['id' => 0]);
$this->user = User::factory()->create();
$this->team = $this->user->teams()->first();
$this->actingAs($this->user);
session(['currentTeam' => $this->team]);
});
it('toggles traffic analytics via the sentinel settings component', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->once()->andReturnUsing(function ($server, $enable) {
$server->settings->is_traffic_analytics_enabled = $enable;
$server->settings->save();
return true;
});
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'TRAEFIK');
$server->save();
// New servers default analytics on; start from the disabled state to exercise enabling.
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
expect($server->fresh()->isTrafficAnalyticsEnabled())->toBeFalse();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->call('toggleTrafficAnalytics')
->assertDispatchedTo(Analytics::class, 'trafficAnalyticsStateChanged')
->assertHasNoErrors();
expect($server->fresh()->isTrafficAnalyticsEnabled())->toBeTrue();
});
it('warns about the application interruption before enabling traffic analytics', function () {
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'TRAEFIK');
$server->save();
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->assertSee('Enable traffic analytics?')
->assertDontSeeHtml('wire:confirm')
->assertSeeHtml('wire:loading.flex')
->assertSeeHtml('wire:target="toggleTrafficAnalytics"')
->assertSee('Restarting Sentinel and proxy...')
->assertSee('Enabling traffic analytics will restart Sentinel and the proxy. Your applications will experience a brief interruption.');
});
it('allows the analytics toggle modal to update after the state changes', function () {
$view = file_get_contents(resource_path('views/livewire/server/traffic-analytics-settings.blade.php'));
expect($view)->toContain(':ignoreWire="false"');
});
it('does not enable traffic analytics on a swarm server', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->never();
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'TRAEFIK');
$server->save();
$server->settings->is_swarm_manager = true;
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
expect($server->fresh()->isTrafficAnalyticsEnabled())->toBeFalse();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->call('toggleTrafficAnalytics')
->assertDispatched('error', 'Traffic analytics is not supported on Swarm/Build servers.')
->assertHasNoErrors();
expect($server->fresh()->isTrafficAnalyticsEnabled())->toBeFalse();
});
it('saves traffic analytics settings from the sentinel form', function () {
Queue::fake();
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->settings->is_traffic_analytics_enabled = true;
$server->settings->save();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->set('trafficTopn', 100)
->set('trafficSampleThreshold', 500)
->set('trafficRetention1hDays', 14)
->set('trafficRetention1dDays', 180)
->set('isGeoipEnabled', false)
->set('geoipRefreshDays', 7)
->call('saveTrafficAnalyticsSettings')
->assertHasNoErrors();
$settings = $server->settings->fresh();
expect($settings->traffic_topn)->toBe(100)
->and($settings->traffic_sample_threshold)->toBe(500)
->and($settings->traffic_retention_1h_days)->toBe(14)
->and($settings->traffic_retention_1d_days)->toBe(180)
->and($settings->is_geoip_enabled)->toBeFalse()
->and($settings->geoip_refresh_days)->toBe(7);
});
it('rejects a zero top-n cap', function () {
$server = Server::factory()->create(['team_id' => $this->team->id]);
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->set('trafficTopn', 0)
->call('saveTrafficAnalyticsSettings')
->assertHasErrors(['trafficTopn']);
});
it('does not enable traffic analytics on a build server', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->never();
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'TRAEFIK');
$server->save();
$server->settings->server_role = ServerRole::BUILD;
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
expect($server->fresh()->isTrafficAnalyticsEnabled())->toBeFalse();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->call('toggleTrafficAnalytics')
->assertDispatched('error', 'Traffic analytics is not supported on Swarm/Build servers.')
->assertHasNoErrors();
expect($server->fresh()->isTrafficAnalyticsEnabled())->toBeFalse();
});
it('disables the analytics toggle and explains why when the server has no traefik or caddy proxy', function () {
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'NONE');
$server->save();
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
$html = Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->assertSee('Traffic analytics needs the Traefik or Caddy proxy.')
->assertDontSee('Enable traffic analytics?')
->assertDontSeeHtml('submitAction')
->html();
expect($html)->toMatch('/<button disabled[^>]*>(?:\s|<!--.*?-->)*Enable traffic analytics\s*<\/button>/s');
});
it('rejects enabling analytics from the component when the server has no traefik or caddy proxy', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->never();
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'NONE');
$server->save();
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->call('toggleTrafficAnalytics')
->assertDispatched('error', 'Traffic analytics needs the Traefik or Caddy proxy.')
->assertSet('isTrafficAnalyticsEnabled', false);
expect($server->fresh()->isTrafficAnalyticsEnabled())->toBeFalse();
});
it('lets analytics be disabled on a server whose proxy was removed', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->once()->andReturnUsing(function ($server, $enable) {
$server->settings->is_traffic_analytics_enabled = $enable;
$server->settings->save();
return false;
});
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'NONE');
$server->save();
$server->settings->is_traffic_analytics_enabled = true;
$server->settings->save();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->assertDontSee('Traffic analytics needs the Traefik or Caddy proxy.')
->call('toggleTrafficAnalytics')
->assertDispatched('success', 'Traffic analytics disabled.')
->assertSet('isTrafficAnalyticsEnabled', false);
});
it('tells the user a stopped proxy picks up the change on its next start', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->once()->andReturnUsing(function ($server, $enable) {
$server->settings->is_traffic_analytics_enabled = $enable;
$server->settings->save();
return false;
});
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'TRAEFIK');
$server->proxy->set('status', 'exited');
$server->proxy->set('force_stop', true);
$server->save();
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->call('toggleTrafficAnalytics')
->assertDispatched('success', 'Traffic analytics enabled. The proxy is stopped, so the new configuration applies the next time you start it.');
});
it('does not let a team member toggle traffic analytics', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->never();
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'TRAEFIK');
$server->save();
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
$member = User::factory()->create();
$this->team->members()->attach($member->id, ['role' => 'member']);
$this->actingAs($member);
session(['currentTeam' => $this->team]);
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->assertForbidden();
expect($server->fresh()->isTrafficAnalyticsEnabled())->toBeFalse();
});
it('tells the user that Caddy logs a resource only after a redeploy', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->once()->andReturnUsing(function ($server, $enable) {
$server->settings->is_traffic_analytics_enabled = $enable;
$server->settings->save();
return true;
});
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'CADDY');
$server->save();
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->assertDontSee('Caddy logs a resource only after you redeploy it.')
->call('toggleTrafficAnalytics')
->assertDispatched('success', 'Traffic analytics enabled. Restarting proxy and Sentinel. Caddy logs a resource only after you redeploy it.')
->assertSee('Caddy logs a resource only after you redeploy it.');
});
it('does not show the Caddy redeploy note on a Traefik server', function () {
ConfigureTrafficAnalytics::partialMock()->shouldReceive('handle')->once()->andReturnUsing(function ($server, $enable) {
$server->settings->is_traffic_analytics_enabled = $enable;
$server->settings->save();
return true;
});
$server = Server::factory()->create(['team_id' => $this->team->id]);
$server->proxy->set('type', 'TRAEFIK');
$server->save();
$server->settings->is_traffic_analytics_enabled = false;
$server->settings->save();
Livewire::test(TrafficAnalyticsSettings::class, ['server' => $server])
->call('toggleTrafficAnalytics')
->assertDispatched('success', 'Traffic analytics enabled. Restarting proxy and Sentinel.')
->assertDontSee('Caddy logs a resource only after you redeploy it.');
});