[10.x] Add ability to measure a single callable and get result

[timacdonald]

Gives the ability to measure a given callable inline and allow receive the resulting value, e.g.

[$result, $duration] = Benchmark::once(function () {
    sleep(1);

    return 'foo';
});

Useful for providing metrics around different execution paths of your application.

[nunomaduro]

@timacdonald Can you give me a real world use case where you would want to see the result?

[timacdonald]

Sure thing.

Measuring and logging external service interactions for alerting

public function list()
{
    [$response, $duration] = Benchmark::value(fn () => Http::get('https://external-service.com/list.json'));

    if ($duration > 1000) {
      Log::warning('external-service.com is running slow');
    }

    return $response->json();
}

Adding "Server-Timing" headers

public function index()
{
    [$users, $dataDuration] = Benchmark::value(function () {
        $users = DB::where(...)->get();

        return $users->map(...);
    });

    [$response, $responseDuration] = Benchmark::value(fn () => UserResource::collection($users)->response());

    return $response->header('Server-Timing', "db;dur={$dataDuration}, response;dur={$responseDuration}");
}

Monitoring the duration of different execution paths and external service interactions is a common pattern, in my own experience, for application logging, monitoring, and metrics.