updates to url requests

components/schemas/environments/services/lb/telemetry/LoadBalancerTelemetryUrlMetrics.yml

@@ -14,15 +14,62 @@ properties:
           nullable: true
           type: object
           required:
+            - host
+            - method
+            - path
             - total
+            - last_hit
+            - handlers
           properties:
+            host:
+              type: string
+              description: The host name of the URL request.
+              example: abc.cycle.io
+            method:
+              type: string
+              description: The HTTP method of the URL request.
+              example: GET
+            path:
+              type: string
+              description: The path portion of the inbound URL request.
+              example: /pathname
             total:
               type: integer
+              description: The number of requests to a this URL.
+              example: 11
+            last_hit:
+              description: The date of the most recent hit to the URL.
+              $ref: ../../../../DateTime.yml
+            handlers:
+              type: object
+              description: An object describing the relative breakdown of proxy, cache, forward, and redirect URL responses.
+              required:
+                - proxy
+                - cache
+                - forward
+                - redirect
+              properties:
+                proxy:
+                  description: Object containing hit count and timing data for proxy responses.
+                  $ref: ./LoadBalancerTelemetryUrlRequestHandler.yml
+                cache:
+                  description: Object containing hit count and timing data for cache responses.
+                  $ref: ./LoadBalancerTelemetryUrlRequestHandler.yml
+                forward:
+                  description: Object containing hit count and timing data for forward responses.
+                  $ref: ./LoadBalancerTelemetryUrlRequestHandler.yml
+                redirect:
+                  description: Object containing hit count and timing data for redirect responses.
+                  $ref: ./LoadBalancerTelemetryUrlRequestHandler.yml
             responses:
               type: object
+              example: { "http:404": 10 }
+              description: An object where the key is the response type and the value is the number of hits with that response.
               additionalProperties:
                 type: integer
             errors:
               type: object
+              example: { "i/o timeout": 1 }
+              description: An object where the key is the error type and the value is the number of hits with that error.
               additionalProperties:
                 type: integer

components/schemas/environments/services/lb/telemetry/LoadBalancerTelemetryUrlRequestHandler.yml

@@ -0,0 +1,12 @@
+title: LoadBalancerTelemetryUrlRequestHandler
+type: object
+required:
+  - hits
+  - timing_ms
+properties:
+  hits:
+    description: The number of hits to a specific URL handler.
+    type: integer
+  timing_ms:
+    description: The cumulative ms of response time across all hits.
+    type: integer