Adding logs callout in relevant breadcrumbs docs. (#15432)

codyde · web-flow · commit 31703a1f0a7e · 2025-11-08T10:20:26.000-08:00
This change is not typically how we would want to move forward with
changes - being that we would normallly focus on making these changes on
each SDK.

Breadcrumbs are relatively low impact changes - and the content being
added is informational only. 

Making this change wider as an exception with the understanding we can revert specific areas if needed.
diff --git a/docs/platforms/android/enriching-events/breadcrumbs/index.mdx b/docs/platforms/android/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/android/integrations/logcat/index.mdx b/docs/platforms/android/integrations/logcat/index.mdx
@@ -8,6 +8,12 @@ categories:
 og_image: /og-images/platforms-android-integrations-logcat.png
 ---
 
+<Alert level="warning" title="Did you mean logs instead?">
+
+This integration captures Logcat logs as breadcrumbs (great for error context!). But if you need to search and query your logs across your entire application, use <PlatformLink to="/logs/">Sentry Logs</PlatformLink> instead. Logcat logs at or above the `minLevel` are automatically sent as Sentry Logs when enabled. See the <PlatformLink to="/integrations/logcat/#support-with-sentry-logs">Support With Sentry Logs</PlatformLink> section below.
+
+</Alert>
+
 <Alert>
 
 Supported in Sentry's Android SDK version `6.17.0` and above.
diff --git a/docs/platforms/android/integrations/timber/index.mdx b/docs/platforms/android/integrations/timber/index.mdx
@@ -6,7 +6,13 @@ sdk: sentry.java.android.timber
 description: "Learn more about the Sentry Timber integration for the Android SDK."
 ---
 
-The `sentry-android-timber` library provides [Timber](https://github.com/JakeWharton/timber) support for Sentry via [Timber Tree](https://github.com/JakeWharton/timber/blob/10f0adce3921ad2929ddf2f3b7fecda2cf3148a5/timber/src/main/java/timber/log/Timber.kt#L20) that sends events and breadcrumbs to Sentry. Once this integration is configured you can use Timber’s static API.
+<Alert level="warning" title="Did you mean logs instead?">
+
+This integration captures Timber logs as breadcrumbs and error events (great for error context!). But if you need to search and query your logs across your entire application, use <PlatformLink to="/logs/">Sentry Logs</PlatformLink> instead. Timber logs at or above the `minLogsLevel` are automatically sent as Sentry Logs when enabled. See the <PlatformLink to="/integrations/timber/#support-with-sentry-logs">Support With Sentry Logs</PlatformLink> section below.
+
+</Alert>
+
+The `sentry-android-timber` library provides [Timber](https://github.com/JakeWharton/timber) support for Sentry via [Timber Tree](https://github.com/JakeWharton/timber/blob/10f0adce3921ad2929ddf2f3b7fecda2cf3148a5/timber/src/main/java/timber/log/Timber.kt#L20) that sends events and breadcrumbs to Sentry. Once this integration is configured you can use Timber's static API.
 
 The source can be found [on GitHub](https://github.com/getsentry/sentry-java/tree/master/sentry-android-timber/src/main/java/io/sentry/android/timber).
 
diff --git a/docs/platforms/apple/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/apple/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/dart/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/dart/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/dart/guides/flutter/enriching-events/breadcrumbs/index.mdx b/docs/platforms/dart/guides/flutter/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/dotnet/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/dotnet/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/go/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/go/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/godot/enriching-events/breadcrumbs/index.mdx b/docs/platforms/godot/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/java/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/java/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/javascript/common/configuration/integrations/breadcrumbs.mdx b/docs/platforms/javascript/common/configuration/integrations/breadcrumbs.mdx
@@ -18,6 +18,8 @@ notSupported:
   - javascript.bun
 ---
 
+<PlatformContent includePath="configuration/console-logs-vs-breadcrumbs" />
+
 <Alert>
 
 This integration only works inside a browser environment.
diff --git a/docs/platforms/javascript/common/configuration/integrations/console.mdx b/docs/platforms/javascript/common/configuration/integrations/console.mdx
@@ -28,6 +28,8 @@ supported:
   - javascript.tanstackstart-react
 ---
 
+<PlatformContent includePath="configuration/console-logs-vs-breadcrumbs" />
+
 _Import name: `Sentry.consoleIntegration`_
 
 This integration is enabled by default. If you'd like to modify your default integrations, read [this](./../#modifying-default-integrations).
diff --git a/docs/platforms/javascript/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/javascript/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/native/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/native/common/enriching-events/breadcrumbs/index.mdx
@@ -8,6 +8,8 @@ notSupported:
   - native.wasm
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/php/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/php/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/php/common/integrations/monolog.mdx b/docs/platforms/php/common/integrations/monolog.mdx
@@ -41,3 +41,18 @@ try {
     $log->error('Some exception happened', ['exception' => $exception]);
 }
 ```
+
+## Support With Sentry Logs
+
+Monolog logs can also be captured as <PlatformLink to="/logs/">Sentry Logs</PlatformLink> for better searchability and querying.
+
+To enable this, set `enable_logs` to `true` when initializing the SDK:
+
+```php
+\Sentry\init([
+    'dsn' => '___PUBLIC_DSN___',
+    'enable_logs' => true,
+]);
+```
+
+You can control which log levels are sent to Sentry Logs by configuring the Monolog handler's minimum level.
diff --git a/docs/platforms/php/guides/symfony/integrations/monolog.mdx b/docs/platforms/php/guides/symfony/integrations/monolog.mdx
@@ -33,3 +33,27 @@ monolog:
             fill_extra_context: true # Enables sending monolog context to Sentry
             process_psr_3_messages: false # Disables the resolution of PSR-3 placeholders in reported messages
 ```
+
+## Support With Sentry Logs
+
+Monolog logs can also be captured as <PlatformLink to="/logs/">Sentry Logs</PlatformLink> for better searchability and querying.
+
+To enable this, set `enable_logs` to `true` in your Sentry configuration:
+
+```yaml {filename:config/packages/sentry.yaml}
+sentry:
+    options:
+        enable_logs: true
+```
+
+Then configure the Monolog handler for logs:
+
+```yaml {filename:config/packages/monolog.yaml}
+monolog:
+    handlers:
+        sentry_logs:
+            type: service
+            id: Sentry\SentryBundle\Monolog\LogsHandler
+```
+
+You can control which log levels are sent to Sentry Logs by configuring the handler's minimum level in your services configuration.
diff --git a/docs/platforms/python/enriching-events/breadcrumbs/index.mdx b/docs/platforms/python/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/react-native/enriching-events/breadcrumbs/index.mdx b/docs/platforms/react-native/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/ruby/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/ruby/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/rust/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/rust/common/enriching-events/breadcrumbs/index.mdx
@@ -3,6 +3,8 @@ title: Breadcrumbs
 description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/platforms/unreal/enriching-events/breadcrumbs/index.mdx b/docs/platforms/unreal/enriching-events/breadcrumbs/index.mdx
@@ -6,6 +6,8 @@ description: >-
 og_image: /og-images/platforms-unreal-enriching-events-breadcrumbs.png
 ---
 
+<PlatformContent includePath="enriching-events/breadcrumbs-banner" />
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
diff --git a/docs/product/issues/issue-details/breadcrumbs/index.mdx b/docs/product/issues/issue-details/breadcrumbs/index.mdx
@@ -5,6 +5,12 @@ sidebar_order: 60
 og_image: /og-images/product-issues-issue-details-breadcrumbs.png
 ---
 
+<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">
+
+Manual breadcrumbs had a good run, but [Sentry's got logs](/product/explore/logs/). Structured, searchable, and way easier to alert or query on. Check them out!
+
+</Alert>
+
 Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
 
 SDKs automatically start recording breadcrumbs by enabling integrations. To learn how to do this for your platform, select it from the dropdown at the top of the left hand nav. You'll be taken to the breadcrumb documentation specific to the platform you use.
diff --git a/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx b/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx
@@ -0,0 +1,13 @@
+<PlatformSection notSupported={[
+  'javascript.deno',
+  'javascript.cordova'
+]}>
+
+<Alert level="warning" title="Did you mean logs instead?">
+
+This integration captures console logs as breadcrumbs (great for error context!). But if you need to search and query your logs across your entire application, use <PlatformLink to="/logs/">Sentry Logs</PlatformLink> instead. Set `enableLogs: true`, and add the <PlatformLink to="/logs/#integrations">Sentry console logging integration</PlatformLink> in your SDK config.
+
+</Alert>
+
+</PlatformSection>
+
diff --git a/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx
@@ -0,0 +1,22 @@
+<PlatformSection notSupported={[
+  'javascript.deno',
+  'javascript.cordova',
+  'dotnet.log4net',
+  'dotnet.nlog',
+  'dotnet.xamarin',
+  'dotnet.google-cloud-functions',
+  'native.qt',
+  'unity',
+  'kotlin.kotlin-multiplatform',
+  'elixir',
+  'powershell'
+]}>
+
+<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">
+
+Manual breadcrumbs had a good run, but <PlatformLink to="/logs/">Sentry's got logs</PlatformLink>. Structured, searchable, and way easier to alert or query on. Check them out!
+
+</Alert>
+
+</PlatformSection>
+
diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx
@@ -0,0 +1,6 @@
+<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">
+
+Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/ruby/logs/). Structured, searchable, and way easier to alert or query on. Check them out!
+
+</Alert>
+
diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx
@@ -0,0 +1,6 @@
+<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">
+
+Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/ruby/logs/). Structured, searchable, and way easier to alert or query on. Check them out!
+
+</Alert>
+
diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx
@@ -0,0 +1,6 @@
+<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">
+
+Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/ruby/logs/). Structured, searchable, and way easier to alert or query on. Check them out!
+
+</Alert>
+
diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx
@@ -0,0 +1,6 @@
+<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">
+
+Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/ruby/logs/). Structured, searchable, and way easier to alert or query on. Check them out!
+
+</Alert>
+
