fix: update the description of the total field in the response of logs, spans and traces

Signed-off-by: Nilushan Costa <nilushan@wso2.com>

Author: nilushancosta

static/api-specs/observability-logs-adapter-api.yaml

@@ -433,7 +433,7 @@ components:
           description: The logs queried successfully
         total:
           type: integer
-          description: The total number of logs queried
+          description: The total number of matching log entries, capped at 1000
         tookMs:
           type: integer
           description: The time taken to query the logs in milliseconds

static/api-specs/observability-tracing-adapter-api.yaml

@@ -316,7 +316,7 @@ components:
                 description: The duration of the trace in nanoseconds
         total:
           type: integer
-          description: The total number of traces
+          description: The total number of matching traces, capped at 1000
         tookMs:
           type: integer
           description: The time taken to query the traces in milliseconds
@@ -357,7 +357,7 @@ components:
                 description: The parent span ID
         total:
           type: integer
-          description: The total number of spans
+          description: The total number of matching spans, capped at 1000
         tookMs:
           type: integer
           description: The time taken to query the spans in milliseconds