Merge branch 'hsnir1-master-patch-2709' into 'master'

Adding graphQL example query to DORA docs

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/144389



Merged-by: Adam Hegyi <ahegyi@gitlab.com>
Approved-by: Lorena Ciutacu <lciutacu@gitlab.com>
Approved-by: Adam Hegyi <ahegyi@gitlab.com>
Reviewed-by: Lorena Ciutacu <lciutacu@gitlab.com>
Co-authored-by: Lorena Ciutacu <lciutacu@gitlab.com>
Co-authored-by: Haim Snir <hsnir@gitlab.com>

doc/user/analytics/dora_metrics.md

@@ -170,6 +170,28 @@ Dora::Configuration.create!(project: my_project, ltfc_target_branches: \['master
 
 To retrieve DORA data, use the [GraphQL](../../api/graphql/reference/index.md) or the [REST](../../api/dora/metrics.md) APIs.
 
+The following example uses the GraphQL API to retrieve the monthly deployment frequency for a given time period:
+
+```graphql
+{
+  project(fullPath: "gitlab-org/gitlab") {
+    dora {
+      metrics(
+        metric: DEPLOYMENT_FREQUENCY
+        startDate: "2023-12-01"
+        endDate: "2024-02-01"
+        interval: MONTHLY
+      ) {
+        date
+        value
+      }
+    }
+  }
+}
+```
+
+You can explore the GraphQL API resources with the interactive [GraphQL explorer](../../api/graphql/index.md#interactive-graphql-explorer).
+
 ## Measure DORA metrics
 
 ### Measure DORA metrics without using GitLab CI/CD pipelines