(skywalking-query-protocol) 01/01: Add mqe query trace protocol

[wankai]

This is an automated email from the ASF dual-hosted git repository.

wankai pushed a commit to branch mqe-trace
in repository https://gitbox.apache.org/repos/asf/skywalking-query-protocol.git

commit 3654791152632b783e7b03ed28db42fa9571a616
Author: wankai123 <wankai...@foxmail.com>
AuthorDate: Tue Jun 18 11:33:40 2024 +0800

    Add mqe query trace protocol
---
 common.graphqls     | 23 +++++++++++++++++++++++
 metrics-v3.graphqls |  4 ++--
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/common.graphqls b/common.graphqls
index cd798c0..98bd655 100644
--- a/common.graphqls
+++ b/common.graphqls
@@ -125,6 +125,29 @@ type HealthStatus {
     details: String
 }
 
+# The Span for OAP internal debugging.
+# All time is in nanoseconds.
+type DebuggingSpan {
+    spanId: Int!
+    parentSpanId: Int!
+    operation: String!
+    startTime: Long!
+    endTime: Long!
+    duration: Long!
+    msg: String!
+    error: String
+}
+
+# The Trace for OAP internal debugging.
+type DebuggingTrace {
+    traceId: String!
+    condition: String!
+    startTime: Long!
+    endTime: Long!
+    duration: Long!
+    spans: [DebuggingSpan!]!
+}
+
 extend type Query {
     # Query Health Checker module for the status of OAP server
     checkHealth: HealthStatus!
diff --git a/metrics-v3.graphqls b/metrics-v3.graphqls
index 627dfdd..173c0b0 100644
--- a/metrics-v3.graphqls
+++ b/metrics-v3.graphqls
@@ -90,14 +90,14 @@ type ExpressionResult {
     # When type == ExpressionResultType.UNKNOWN,
     # the error message includes the expression resolving errors.
     error: String
+    debuggingTrace: DebuggingTrace
 }
 
-
 extend type Query {
     # Metrics definition metadata query. Response the metrics type which 
determines the suitable query methods.
     typeOfMetrics(name: String!): MetricsType!
     # Get the list of all available metrics in the current OAP server.
     # Param, regex, could be used to filter the metrics by name.
     listMetrics(regex: String): [MetricDefinition!]!
-    execExpression(expression: String!, entity: Entity!, duration: Duration!): 
ExpressionResult!
+    execExpression(expression: String!, entity: Entity!, duration: Duration!, 
debug: Boolean, dumpDBRsp: Boolean): ExpressionResult!
 }