From 6aabdb896a0643af7079abbd0afe8b1d5aaf531f Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Fri, 7 Nov 2025 15:37:28 -0800 Subject: [PATCH 1/9] Adding logs callout in relevant breadcrumbs docs. --- .../android/enriching-events/breadcrumbs/index.mdx | 2 ++ .../apple/common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../dart/common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../guides/flutter/enriching-events/breadcrumbs/index.mdx | 2 ++ .../dotnet/common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../go/common/enriching-events/breadcrumbs/index.mdx | 2 ++ docs/platforms/godot/enriching-events/breadcrumbs/index.mdx | 2 ++ .../java/common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../common/configuration/integrations/breadcrumbs.mdx | 2 ++ .../common/configuration/integrations/console.mdx | 2 ++ .../common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../native/common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../php/common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../platforms/python/enriching-events/breadcrumbs/index.mdx | 2 ++ .../react-native/enriching-events/breadcrumbs/index.mdx | 2 ++ .../ruby/common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../rust/common/enriching-events/breadcrumbs/index.mdx | 2 ++ .../platforms/unreal/enriching-events/breadcrumbs/index.mdx | 2 ++ .../configuration/console-logs-vs-breadcrumbs/_default.mdx | 6 ++++++ .../console-logs-vs-breadcrumbs/javascript.cordova.mdx | 2 ++ .../console-logs-vs-breadcrumbs/javascript.deno.mdx | 2 ++ .../enriching-events/breadcrumbs-banner/_default.mdx | 6 ++++++ 22 files changed, 52 insertions(+) create mode 100644 platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx create mode 100644 platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.cordova.mdx create mode 100644 platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.deno.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/_default.mdx diff --git a/docs/platforms/android/enriching-events/breadcrumbs/index.mdx b/docs/platforms/android/enriching-events/breadcrumbs/index.mdx index 8c0e4e7c0e248..8b14c67b17bd9 100644 --- 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." --- + + 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/apple/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/apple/common/enriching-events/breadcrumbs/index.mdx index 8e7e926c06d48..a80f773451614 100644 --- 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." --- + + 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 index 8c0e4e7c0e248..8b14c67b17bd9 100644 --- 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." --- + + 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 index 8c0e4e7c0e248..8b14c67b17bd9 100644 --- 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." --- + + 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 index 909b014f6d0e8..95a268ad88192 100644 --- 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." --- + + 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 index e641b9155d531..b0548bf2edb10 100644 --- 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." --- + + 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 index 0c31042b9714d..3c8c9791569a6 100644 --- 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." --- + + 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 index e641b9155d531..b0548bf2edb10 100644 --- 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." --- + + 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 index e57959c3dddf1..67d9ac4dc5f7f 100644 --- 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 --- + + 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 index 83e16f00940a6..d187b87951d8b 100644 --- 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 --- + + _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 index 693c6f06ab019..60ab450c8ac1e 100644 --- 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." --- + + 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 index afc49942546da..01f0427a8fa47 100644 --- 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 --- + + 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 index 0770caef65c39..449a06641b8c2 100644 --- 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." --- + + 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/python/enriching-events/breadcrumbs/index.mdx b/docs/platforms/python/enriching-events/breadcrumbs/index.mdx index 9ba63f9278681..3c9cfba72bcf5 100644 --- 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." --- + + 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 index b3a0d840fa168..3027c2b0bf7db 100644 --- 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." --- + + 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 index f0ac1a2f7e29c..17d6f87b0812a 100644 --- 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." --- + + 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 index 4b77c8fbd90ef..37152cc309740 100644 --- 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." --- + + 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 index 452c5e044e0d4..0bd7ec5ae8b06 100644 --- 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 --- + + 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/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx b/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx new file mode 100644 index 0000000000000..a58ca58bbb6e4 --- /dev/null +++ b/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx @@ -0,0 +1,6 @@ + + +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 Sentry Logs instead. Set `enableLogs: true`, and add the Sentry console logging integration in your SDK config. + + + diff --git a/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.cordova.mdx b/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.cordova.mdx new file mode 100644 index 0000000000000..034c9fa09e7f6 --- /dev/null +++ b/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.cordova.mdx @@ -0,0 +1,2 @@ +{/* Cordova does not support logs, so no alert is shown */} + diff --git a/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.deno.mdx b/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.deno.mdx new file mode 100644 index 0000000000000..734e8c80dbbbe --- /dev/null +++ b/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.deno.mdx @@ -0,0 +1,2 @@ +{/* Deno does not support logs, so no alert is shown */} + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx new file mode 100644 index 0000000000000..f562d5c298b01 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx @@ -0,0 +1,6 @@ + + +Manual breadcrumbs had a good run, but Sentry's got logs. Structured, searchable, and way easier to alert or query on. Check them out! + + + From ca0a908b8f1d8b9c5bd0a5f5f6bc48a340485cf8 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Fri, 7 Nov 2025 16:00:58 -0800 Subject: [PATCH 2/9] Adding specific details for android paltforms timber / logcat --- docs/platforms/android/integrations/logcat/index.mdx | 6 ++++++ docs/platforms/android/integrations/timber/index.mdx | 8 +++++++- 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/platforms/android/integrations/logcat/index.mdx b/docs/platforms/android/integrations/logcat/index.mdx index aeff37e80d0d6..983f5ba898393 100644 --- 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 --- + + +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 Sentry Logs instead. Logcat logs at or above the `minLevel` are automatically sent as Sentry Logs when enabled. See the Support With Sentry Logs section below. + + + 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 index a1e5e41136c6f..d3ee3137a8511 100644 --- 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. + + +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 Sentry Logs instead. Timber logs at or above the `minLogsLevel` are automatically sent as Sentry Logs when enabled. See the Support With Sentry Logs section below. + + + +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). From f4da0ee9af39b5bc3e0fb8546d4f6ab83db64c8f Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Fri, 7 Nov 2025 16:01:23 -0800 Subject: [PATCH 3/9] Adding specific log integration details for symphony and php --- .../php/common/integrations/monolog.mdx | 15 ++++++++++++ .../guides/symfony/integrations/monolog.mdx | 24 +++++++++++++++++++ 2 files changed, 39 insertions(+) diff --git a/docs/platforms/php/common/integrations/monolog.mdx b/docs/platforms/php/common/integrations/monolog.mdx index 78209b823427e..aa322f0d84cff 100644 --- 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 Sentry Logs 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 index 9168f7fb71a03..5bcc25f37bfe7 100644 --- 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 Sentry Logs 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. From 600e25b0d8d3027f7e56b2daeb2a086979a94584 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Fri, 7 Nov 2025 16:01:36 -0800 Subject: [PATCH 4/9] Adding logs conten to breadcrumbs for issue-details --- docs/product/issues/issue-details/breadcrumbs/index.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/product/issues/issue-details/breadcrumbs/index.mdx b/docs/product/issues/issue-details/breadcrumbs/index.mdx index 2ffe7bb7eee1f..28bfae414d719 100644 --- 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 --- + + +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! + + + 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. From d3b83caa21f3fc5571188d9660f1cfdda0b1d0cc Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Fri, 7 Nov 2025 16:07:37 -0800 Subject: [PATCH 5/9] Adding ruby specific log banners --- .../breadcrumbs-banner/ruby.delayed_job.mdx | 6 ++++++ .../enriching-events/breadcrumbs-banner/ruby.rack.mdx | 6 ++++++ .../enriching-events/breadcrumbs-banner/ruby.resque.mdx | 6 ++++++ .../enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx | 6 ++++++ 4 files changed, 24 insertions(+) create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx new file mode 100644 index 0000000000000..a01a897f4c375 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx @@ -0,0 +1,6 @@ + + +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! + + + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx new file mode 100644 index 0000000000000..a01a897f4c375 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx @@ -0,0 +1,6 @@ + + +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! + + + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx new file mode 100644 index 0000000000000..a01a897f4c375 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx @@ -0,0 +1,6 @@ + + +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! + + + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx new file mode 100644 index 0000000000000..a01a897f4c375 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx @@ -0,0 +1,6 @@ + + +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! + + + From a698f13f875405446e9cd4a66aef755aaec4c15b Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Fri, 7 Nov 2025 16:07:59 -0800 Subject: [PATCH 6/9] Platform specific banners to force disable and avoid 404 errors --- .../breadcrumbs-banner/dotnet.google-cloud-functions.mdx | 2 ++ .../enriching-events/breadcrumbs-banner/dotnet.log4net.mdx | 2 ++ .../enriching-events/breadcrumbs-banner/dotnet.nlog.mdx | 2 ++ .../enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx | 2 ++ .../enriching-events/breadcrumbs-banner/native.qt.mdx | 6 ++++++ 5 files changed, 14 insertions(+) create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/dotnet.google-cloud-functions.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/dotnet.log4net.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/dotnet.nlog.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/native.qt.mdx diff --git a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.google-cloud-functions.mdx b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.google-cloud-functions.mdx new file mode 100644 index 0000000000000..7c0b92c226ae8 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.google-cloud-functions.mdx @@ -0,0 +1,2 @@ +{/* Google Cloud Functions does not support logs, so no banner is shown */} + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.log4net.mdx b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.log4net.mdx new file mode 100644 index 0000000000000..96a682c3c81e0 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.log4net.mdx @@ -0,0 +1,2 @@ +{/* log4net does not support logs, so no banner is shown */} + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.nlog.mdx b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.nlog.mdx new file mode 100644 index 0000000000000..a9d5c12535da2 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.nlog.mdx @@ -0,0 +1,2 @@ +{/* NLog does not support logs, so no banner is shown */} + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx new file mode 100644 index 0000000000000..2a4a8e619e261 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx @@ -0,0 +1,2 @@ +{/* Xamarin does not support logs, so no banner is shown */} + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/native.qt.mdx b/platform-includes/enriching-events/breadcrumbs-banner/native.qt.mdx new file mode 100644 index 0000000000000..6941cd7c2ae64 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/native.qt.mdx @@ -0,0 +1,6 @@ + + +Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/native/logs/). Structured, searchable, and way easier to alert or query on. Check them out! + + + From 951afa4fcd227a6618e24252de22dd476b0d66c3 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Fri, 7 Nov 2025 23:19:03 -0800 Subject: [PATCH 7/9] Refactoring to use notSupported functionality instead of individual sdk files --- .../console-logs-vs-breadcrumbs/_default.mdx | 7 +++++++ .../javascript.cordova.mdx | 2 -- .../javascript.deno.mdx | 2 -- .../breadcrumbs-banner/_default.mdx | 15 +++++++++++++++ .../dotnet.google-cloud-functions.mdx | 2 -- .../breadcrumbs-banner/dotnet.log4net.mdx | 2 -- .../breadcrumbs-banner/dotnet.nlog.mdx | 2 -- .../breadcrumbs-banner/dotnet.xamarin.mdx | 2 -- .../breadcrumbs-banner/native.qt.mdx | 6 ------ .../breadcrumbs-banner/ruby.delayed_job.mdx | 6 ------ .../breadcrumbs-banner/ruby.rack.mdx | 6 ------ .../breadcrumbs-banner/ruby.resque.mdx | 6 ------ .../breadcrumbs-banner/ruby.sidekiq.mdx | 6 ------ 13 files changed, 22 insertions(+), 42 deletions(-) delete mode 100644 platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.cordova.mdx delete mode 100644 platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.deno.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/dotnet.google-cloud-functions.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/dotnet.log4net.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/dotnet.nlog.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/native.qt.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx delete mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx diff --git a/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx b/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx index a58ca58bbb6e4..cd278b74cadfc 100644 --- a/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx +++ b/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx @@ -1,6 +1,13 @@ + + 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 Sentry Logs instead. Set `enableLogs: true`, and add the Sentry console logging integration in your SDK config. + + diff --git a/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.cordova.mdx b/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.cordova.mdx deleted file mode 100644 index 034c9fa09e7f6..0000000000000 --- a/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.cordova.mdx +++ /dev/null @@ -1,2 +0,0 @@ -{/* Cordova does not support logs, so no alert is shown */} - diff --git a/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.deno.mdx b/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.deno.mdx deleted file mode 100644 index 734e8c80dbbbe..0000000000000 --- a/platform-includes/configuration/console-logs-vs-breadcrumbs/javascript.deno.mdx +++ /dev/null @@ -1,2 +0,0 @@ -{/* Deno does not support logs, so no alert is shown */} - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx index f562d5c298b01..ba782ec1c11e5 100644 --- a/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx +++ b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx @@ -1,6 +1,21 @@ + + Manual breadcrumbs had a good run, but Sentry's got logs. Structured, searchable, and way easier to alert or query on. Check them out! + + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.google-cloud-functions.mdx b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.google-cloud-functions.mdx deleted file mode 100644 index 7c0b92c226ae8..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.google-cloud-functions.mdx +++ /dev/null @@ -1,2 +0,0 @@ -{/* Google Cloud Functions does not support logs, so no banner is shown */} - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.log4net.mdx b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.log4net.mdx deleted file mode 100644 index 96a682c3c81e0..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.log4net.mdx +++ /dev/null @@ -1,2 +0,0 @@ -{/* log4net does not support logs, so no banner is shown */} - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.nlog.mdx b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.nlog.mdx deleted file mode 100644 index a9d5c12535da2..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.nlog.mdx +++ /dev/null @@ -1,2 +0,0 @@ -{/* NLog does not support logs, so no banner is shown */} - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx b/platform-includes/enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx deleted file mode 100644 index 2a4a8e619e261..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/dotnet.xamarin.mdx +++ /dev/null @@ -1,2 +0,0 @@ -{/* Xamarin does not support logs, so no banner is shown */} - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/native.qt.mdx b/platform-includes/enriching-events/breadcrumbs-banner/native.qt.mdx deleted file mode 100644 index 6941cd7c2ae64..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/native.qt.mdx +++ /dev/null @@ -1,6 +0,0 @@ - - -Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/native/logs/). Structured, searchable, and way easier to alert or query on. Check them out! - - - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx deleted file mode 100644 index a01a897f4c375..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx +++ /dev/null @@ -1,6 +0,0 @@ - - -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! - - - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx deleted file mode 100644 index a01a897f4c375..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx +++ /dev/null @@ -1,6 +0,0 @@ - - -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! - - - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx deleted file mode 100644 index a01a897f4c375..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx +++ /dev/null @@ -1,6 +0,0 @@ - - -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! - - - diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx deleted file mode 100644 index a01a897f4c375..0000000000000 --- a/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx +++ /dev/null @@ -1,6 +0,0 @@ - - -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! - - - From c4985b5400698b0daecc8668e9e7860bfd6d6256 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Sat, 8 Nov 2025 00:24:53 -0800 Subject: [PATCH 8/9] Adding native to notSupported list --- .../enriching-events/breadcrumbs-banner/_default.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx index ba782ec1c11e5..29364b90248b6 100644 --- a/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx +++ b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx @@ -5,6 +5,7 @@ 'dotnet.nlog', 'dotnet.xamarin', 'dotnet.google-cloud-functions', + 'native.qt', 'unity', 'kotlin.kotlin-multiplatform', 'elixir', From 7ef811f7e6e4953aa78a65770c68fb922e8450fc Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Sat, 8 Nov 2025 00:47:59 -0800 Subject: [PATCH 9/9] Upating to correct 404s in links --- .../breadcrumbs-banner/ruby.delayed_job.mdx | 6 ++++++ .../enriching-events/breadcrumbs-banner/ruby.rack.mdx | 6 ++++++ .../enriching-events/breadcrumbs-banner/ruby.resque.mdx | 6 ++++++ .../enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx | 6 ++++++ 4 files changed, 24 insertions(+) create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx create mode 100644 platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx new file mode 100644 index 0000000000000..a01a897f4c375 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx @@ -0,0 +1,6 @@ + + +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! + + + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx new file mode 100644 index 0000000000000..a01a897f4c375 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/ruby.rack.mdx @@ -0,0 +1,6 @@ + + +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! + + + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx new file mode 100644 index 0000000000000..a01a897f4c375 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/ruby.resque.mdx @@ -0,0 +1,6 @@ + + +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! + + + diff --git a/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx new file mode 100644 index 0000000000000..a01a897f4c375 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/ruby.sidekiq.mdx @@ -0,0 +1,6 @@ + + +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! + + +