diff --git a/ai/rocky-ai.mdx b/ai/rocky-ai.mdx
index 91f8f6d5..a6b44f62 100644
--- a/ai/rocky-ai.mdx
+++ b/ai/rocky-ai.mdx
@@ -4,7 +4,7 @@ description: "Learn about Rocky AI — Checkly's AI agent — and configuring an
sidebarTitle: "Rocky AI"
---
-Rocky AI is Checkly's AI agent. Rocky AI can help you automatically determine user impact and root cause on any failing check using error messages, code, check descriptions, metrics, traces and logs.
+Rocky AI is Checkly's AI agent. Rocky AI can help you automatically determine user impact and root cause on any failing check using error messages, code, metrics, OTeL traces, trace routes, packet captures: essentially all artefact generated by a check or test.
## Rocky AI Capabilities
diff --git a/images/rocky_ai_otel_spans.png b/images/rocky_ai_otel_spans.png
new file mode 100644
index 00000000..21904d72
Binary files /dev/null and b/images/rocky_ai_otel_spans.png differ
diff --git a/resolve/ai-root-cause-analysis/overview.mdx b/resolve/ai-root-cause-analysis/overview.mdx
index 3316ec30..1521d5d2 100644
--- a/resolve/ai-root-cause-analysis/overview.mdx
+++ b/resolve/ai-root-cause-analysis/overview.mdx
@@ -21,14 +21,14 @@ Rocky AI — Checkly's Agent — can automatically analyze, categorize and summa
/>
-Using any available artifacts like error message, user code, check description, logs, metrics, trace routes, packet captures, Playwright traces, screenshots and other evidence, it will quickly assess what the impact is of a failure and what the underlying (possible) root cause is. It will also provide a suggested code fix for any check based on (Playwright) code.
+Using any available artifacts like error message, user code, check description, logs, metrics, trace routes, Open Telemetry traces, packet captures, Playwright traces, screenshots and other evidence, it will quickly assess what the impact is of a failure and what the underlying (possible) root cause is. It will also provide a suggested code fix for any check based on (Playwright) code.
## Getting Started with Rocky AI Root Cause Analysis
To use Rocky AI Root Cause Analysis, make sure [Rocky AI is enabled on its settings page](https://app.checklyhq.com/accounts/rocky-ai).
- Rocky AI Root Cause Analysis is available for all synthetic and monitor check types in both testing and monitoring use cases.
+ Rocky AI Root Cause Analysis is available for all synthetic and monitor check types in both testing and monitoring use cases.
### Automatic analysis
diff --git a/resolve/traces/overview.mdx b/resolve/traces/overview.mdx
index 3b3afc32..19963ece 100644
--- a/resolve/traces/overview.mdx
+++ b/resolve/traces/overview.mdx
@@ -1,11 +1,13 @@
---
-title: Traces
-description: 'Trace and debug requests and data flowing through your application and identify performance bottlenecks and failures.'
-sidebarTitle: 'Overview'
+title: "Traces"
+description: "Trace and debug requests and data flowing through your application and identify performance bottlenecks and failures."
+sidebarTitle: "Overview"
---
-
-
+
## What is Distributed Tracing?
@@ -26,51 +28,58 @@ With telemetry traces configured, you will have access to traces in all the plac
To get started with Checkly Traces using OpenTelemetry, pick the scenario that best fits your needs.
-
-
-Instrument your app and send traces directly to Checkly. No need for a 3rd party OTel backend.
-
-
-
-Send your infrastructure traces to Checkly to get contextualized check failure analysis.
-
+
+
+ Instrument your app and send traces directly to Checkly. No need for a 3rd party OTel backend.
+
-
+
+ Send your infrastructure traces to Checkly to get contextualized check failure analysis.
+
-Export check results as traces to your 3rd party OTel tooling
-
+
+ Export check results as traces to your 3rd party OTel tooling
+
-
See this in action in the video below:
-
+
-## Key Benefits
+## Works hand-in-hand with Rocky AI
-
-
-Only traces generated by Checkly checks are forwarded to third-party tools, significantly reducing data transfer costs while maintaining comprehensive monitoring coverage.
-
+Checkly Traces automatically integrates with Rocky AI, helping you automatically analyze root causes of check failures. [Rocky AI Root Cause Analysis](/resolve/ai-root-cause-analysis/overview) can search, fetch and interpret Open Telemetry (OTeL) traces ingested by Checkly Traces and use it as a piece of "evidence" in determining why and where a check failed.\
+\
+A simple example. Your API or Playwright check fails with a 500 error. Luckily your backend is instrumented with Open Telemetry and sends a trace indicating an issue with a downstream database, 3rd party service, proxy etc. Now, Rocky AI automatically pulls these OTeL traces into its context window and correlates it with your failing check. \
+\
+Here's an actual example from Checkly's own backend.
-
-Combine synthetic monitoring data with application traces in your existing observability platform for a complete picture of system health.
-
+
+ 
+
-
-When checks fail, trace data provides immediate context about what happened in your application stack, accelerating root cause analysis.
-
+1. Our API check that checks if our customer facing Prometheus endpoint works, failed with a 500 error.
+2. The OTeL trace indicates this was actually do to our **Clickhouse** server returning a 500 errors, immediately telling our on-call team where to start looking.
+3. Without the trace, we would have to look at all the various logging, error tracking and other tools that are integrated into the various middleware and infrastructure this request passes through (our load balancer, REST API server, Redis datastore etc.
-
-Works with existing OpenTelemetry instrumentation and popular observability platforms without requiring changes to your application logic.
-
-
+## Key Benefits
+
+
+ Only traces generated by Checkly checks are forwarded to third-party tools, significantly reducing data transfer costs while maintaining comprehensive monitoring coverage.
+
+
+
+ Combine synthetic monitoring data with application traces in your existing observability platform for a complete picture of system health.
+
+
+
+ When checks fail, trace data provides immediate context about what happened in your application stack, accelerating root cause analysis.
+
+
+
+ Works with existing OpenTelemetry instrumentation and popular observability platforms without requiring changes to your application logic.
+
+
\ No newline at end of file