buildbucket: add longest_pending_time API

appengine/cr-buildbucket/api.py

 # Copyright 2014 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 import functools
 import json
 import logging
 
 from google.appengine.ext import ndb
 from protorpc import messages
@@ skipping 633 matching lines @@
       raise acl.current_identity_cannot('access bucket %s', request.bucket)
     bucket = config.Bucket.get_by_id(request.bucket)
     if not bucket:
       raise endpoints.NotFoundException('bucket %s not found' % request.bucket)
     return BucketMessage(
       name=request.bucket,
       project_id=bucket.project_id,
       config_file_content=bucket.config_content,
       config_file_rev=bucket.revision,
       config_file_url=config.get_buildbucket_cfg_url(bucket.project_id),
-    )
+    )
+
+  ###########################  LONGEST_PENDING_TIME ############################
+
+  class LongestPendingTimeResponse(messages.Message):
+    longest_pending_time_sec = messages.FloatField(1)
+    error = messages.MessageField(ErrorMessage, 2)
+
+  @buildbucket_api_method(
+      endpoints.ResourceContainer(
+          message_types.VoidMessage,
+          bucket=messages.StringField(1, required=True),
+          builder=messages.StringField(2, required=True),
+      ),
+      LongestPendingTimeResponse,
+      path='metrics/longest-pending-time', http_method='GET')
+  @auth.public
+  def longest_pending_time(self, request):
+    """Returns longest pending time among all SCHEDULED builds of a builder."""
+    wait_time = service.longest_pending_time(request.bucket, request.builder)
+    return self.LongestPendingTimeResponse(
+      longest_pending_time_sec=wait_time.total_seconds(),
+    )