From 6f3c7b64704b4c24e07dfb1a93926f3e6e4c8042 Mon Sep 17 00:00:00 2001
From: Lukas Stracke <lukas.stracke@sentry.io>
Date: Thu, 3 Sep 2026 10:26:59 +0200
Subject: [PATCH 1/2] feat(descriptions): Add `graphql` span description rules

---
 model/description/graphql.json | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 model/description/graphql.json

diff --git a/model/description/graphql.json b/model/description/graphql.json
new file mode 100644
index 00000000..3d72754d
--- /dev/null
+++ b/model/description/graphql.json
@@ -0,0 +1,29 @@
+{
+  "brief": "GraphQL",
+  "operations": [
+    {
+      "name": "GraphQL",
+      "brief": "Any and all operations that fall under GraphQL",
+      "ops": [
+        "http.graphql",
+        "http.graphql.query",
+        "http.graphql.mutation",
+        "http.graphql.subscription",
+        "graphql.execute",
+        "graphql.parse",
+        "graphql.resolve",
+        "graphql.request",
+        "graphql.query",
+        "graphql.mutation",
+        "graphql.subscription",
+        "graphql.validate"
+      ],
+      "templates": [
+        "{{graphql.document}}",
+        "{{graphql.operation.type}} {{graphql.operation.name}}",
+        "{{graphql.operation.type}}"
+      ],
+      "examples": ["query findBookById { bookById(id: ?) { name } }", "query findBookById", "query"]
+    }
+  ]
+}

From 3a0c0dc3a4ae112807dcb2ca771e2f371e65416c Mon Sep 17 00:00:00 2001
From: Lukas Stracke <lukas.stracke@sentry.io>
Date: Thu, 3 Sep 2026 10:49:08 +0200
Subject: [PATCH 2/2] feat(descriptions): Cover base `graphql` op and
 processing spans

Add the base `graphql` op, which is registered in the op model and used by
SDK instrumentation, so those spans get a description like the other
category files do for their base ops.

Also add `{{graphql.processing.type}}` as a final fallback, so
processing-phase spans (parse, validate, resolve) that carry no operation
or document attribute still resolve to a description, matching
`model/name/graphql.json`.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 model/description/graphql.json | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/model/description/graphql.json b/model/description/graphql.json
index 3d72754d..1e543fd4 100644
--- a/model/description/graphql.json
+++ b/model/description/graphql.json
@@ -9,6 +9,7 @@
         "http.graphql.query",
         "http.graphql.mutation",
         "http.graphql.subscription",
+        "graphql",
         "graphql.execute",
         "graphql.parse",
         "graphql.resolve",
@@ -21,9 +22,10 @@
       "templates": [
         "{{graphql.document}}",
         "{{graphql.operation.type}} {{graphql.operation.name}}",
-        "{{graphql.operation.type}}"
+        "{{graphql.operation.type}}",
+        "{{graphql.processing.type}}"
       ],
-      "examples": ["query findBookById { bookById(id: ?) { name } }", "query findBookById", "query"]
+      "examples": ["query findBookById { bookById(id: ?) { name } }", "query findBookById", "query", "parse"]
     }
   ]
 }