. * * @link https://www.librenms.org * * @copyright 2019 Tony Murray * @author Tony Murray */ namespace LibreNMS\Tests; use LibreNMS\Config; use LibreNMS\Data\Source\Fping; use LibreNMS\Data\Source\FpingResponse; use Symfony\Component\Process\Process; class FpingTest extends TestCase { public function testUpPing(): void { $output = "192.168.1.3 : xmt/rcv/%loss = 3/3/0%, min/avg/max = 0.62/0.71/0.93\n"; $this->mockFpingProcess($output, 0); $expected = [ 'xmt' => 3, 'rcv' => 3, 'loss' => 0, 'min' => 0.62, 'max' => 0.93, 'avg' => 0.71, 'dup' => 0, 'exitcode' => 0, ]; $actual = app()->make(Fping::class)->ping('192.168.1.3'); $this->assertTrue($actual->success()); $this->assertEquals('192.168.1.3', $actual->host); $this->assertEquals(3, $actual->transmitted); $this->assertEquals(3, $actual->received); $this->assertEquals(0, $actual->loss); $this->assertEquals(0.62, $actual->min_latency); $this->assertEquals(0.93, $actual->max_latency); $this->assertEquals(0.71, $actual->avg_latency); $this->assertEquals(0, $actual->duplicates); $this->assertEquals(0, $actual->exit_code); } public function testPartialDownPing(): void { $output = "192.168.1.7 : xmt/rcv/%loss = 5/3/40%, min/avg/max = 0.13/0.23/0.32\n"; $this->mockFpingProcess($output, 0); $actual = app()->make(Fping::class)->ping('192.168.1.7'); $this->assertTrue($actual->success()); $this->assertEquals('192.168.1.7', $actual->host); $this->assertEquals(5, $actual->transmitted); $this->assertEquals(3, $actual->received); $this->assertEquals(40, $actual->loss); $this->assertEquals(0.13, $actual->min_latency); $this->assertEquals(0.32, $actual->max_latency); $this->assertEquals(0.23, $actual->avg_latency); $this->assertEquals(0, $actual->duplicates); $this->assertEquals(0, $actual->exit_code); } public function testDownPing(): void { $output = "192.168.53.1 : xmt/rcv/%loss = 3/0/100%\n"; $this->mockFpingProcess($output, 1); $actual = app()->make(Fping::class)->ping('192.168.53.1'); $this->assertFalse($actual->success()); $this->assertEquals('192.168.53.1', $actual->host); $this->assertEquals(3, $actual->transmitted); $this->assertEquals(0, $actual->received); $this->assertEquals(100, $actual->loss); $this->assertEquals(0.0, $actual->min_latency); $this->assertEquals(0.0, $actual->max_latency); $this->assertEquals(0.0, $actual->avg_latency); $this->assertEquals(0, $actual->duplicates); $this->assertEquals(1, $actual->exit_code); } public function testDuplicatePing(): void { $output = <<<'OUT' 192.168.1.2 : duplicate for [0], 84 bytes, 0.91 ms 192.168.1.2 : duplicate for [0], 84 bytes, 0.95 ms 192.168.1.2 : xmt/rcv/%loss = 3/3/0%, min/avg/max = 0.68/0.79/0.91 OUT; $this->mockFpingProcess($output, 1); $actual = app()->make(Fping::class)->ping('192.168.1.2'); $this->assertFalse($actual->success()); $this->assertEquals('192.168.1.2', $actual->host); $this->assertEquals(3, $actual->transmitted); $this->assertEquals(3, $actual->received); $this->assertEquals(0, $actual->loss); $this->assertEquals(0.68, $actual->min_latency); $this->assertEquals(0.91, $actual->max_latency); $this->assertEquals(0.79, $actual->avg_latency); $this->assertEquals(2, $actual->duplicates); $this->assertEquals(1, $actual->exit_code); } private function mockFpingProcess($output, $exitCode) { $process = \Mockery::mock(Process::class); $process->shouldReceive('getCommandLine', 'run'); $process->shouldReceive('getErrorOutput')->andReturn($output); $process->shouldReceive('getExitCode')->andReturn($exitCode); $this->app->bind(Process::class, function ($app, $params) use ($process) { return $process; }); return $process; } public function testBulkPing() { $expected = [ '192.168.1.4' => [3, 3, 0, 0.62, 0.93, 0.71, 0, 0], 'hostname' => [3, 0, 100, 0.0, 0.0, 0.0, 0, 1], 'invalid:characters!' => [0, 0, 0, 0.0, 0.0, 0.0, 0, 2], '1.1.1.1' => [3, 2, 33, 0.024, 0.054, 0.037, 0, 0], ]; $hosts = array_keys($expected); $process = \Mockery::mock(Process::class); $process->shouldReceive('setTimeout')->with(Config::get('rrd.step', 300) * 2); $process->shouldReceive('setInput')->with(implode("\n", $hosts) . "\n"); $process->shouldReceive('getCommandLine'); $process->shouldReceive('run')->withArgs(function ($callback) { // simulate incremental output (not always one full line per callback) call_user_func($callback, Process::ERR, "192.168.1.4 : xmt/rcv/%loss = 3/3/0%, min/avg/max = 0.62/0.71/0.93\nhostname : xmt/rcv/%loss = 3/0/100%"); call_user_func($callback, Process::ERR, "invalid:characters!: Name or service not known\n\n1.1.1.1 : xmt/rcv/%loss = 3/2/33%"); call_user_func($callback, Process::ERR, ", min/avg/max = 0.024/0.037/0.054\n"); return true; }); $this->app->bind(Process::class, function ($app, $params) use ($process) { return $process; }); // make call $calls = 0; app()->make(Fping::class)->bulkPing($hosts, function (FpingResponse $response) use ($expected, &$calls) { $calls++; $this->assertArrayHasKey($response->host, $expected); $current = $expected[$response->host]; $this->assertSame($current[0], $response->transmitted); $this->assertSame($current[1], $response->received); $this->assertSame($current[2], $response->loss); $this->assertSame($current[3], $response->min_latency); $this->assertSame($current[4], $response->max_latency); $this->assertSame($current[5], $response->avg_latency); $this->assertSame($current[6], $response->duplicates); $this->assertSame($current[7], $response->exit_code); $this->assertFalse($response->wasSkipped()); }); $this->assertEquals(count($expected), $calls); } }