diff --git a/docs/platforms/android/enriching-events/breadcrumbs/index.mdx b/docs/platforms/android/enriching-events/breadcrumbs/index.mdx index 8c0e4e7c0e248d..8b14c67b17bd99 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/android/integrations/logcat/index.mdx b/docs/platforms/android/integrations/logcat/index.mdx index aeff37e80d0d66..983f5ba8983939 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 a1e5e41136c6ff..d3ee3137a8511d 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). diff --git a/docs/platforms/apple/common/enriching-events/breadcrumbs/index.mdx b/docs/platforms/apple/common/enriching-events/breadcrumbs/index.mdx index 8e7e926c06d48d..a80f7734516142 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 8c0e4e7c0e248d..8b14c67b17bd99 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 8c0e4e7c0e248d..8b14c67b17bd99 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 909b014f6d0e87..95a268ad88192b 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 e641b9155d5315..b0548bf2edb10f 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 0c31042b9714da..3c8c9791569a6b 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 e641b9155d5315..b0548bf2edb10f 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 e57959c3dddf10..67d9ac4dc5f7f4 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 83e16f00940a6d..d187b87951d8b1 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 693c6f06ab019c..60ab450c8ac1e9 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 afc49942546dae..01f0427a8fa47b 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 0770caef65c398..449a06641b8c21 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/php/common/integrations/monolog.mdx b/docs/platforms/php/common/integrations/monolog.mdx index 78209b823427e8..aa322f0d84cff2 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 9168f7fb71a036..5bcc25f37bfe74 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. diff --git a/docs/platforms/python/enriching-events/breadcrumbs/index.mdx b/docs/platforms/python/enriching-events/breadcrumbs/index.mdx index 9ba63f92786811..3c9cfba72bcf5d 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 b3a0d840fa1683..3027c2b0bf7dbf 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 f0ac1a2f7e29c8..17d6f87b0812a1 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 4b77c8fbd90efb..37152cc309740d 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 452c5e044e0d4a..0bd7ec5ae8b064 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/docs/product/issues/issue-details/breadcrumbs/index.mdx b/docs/product/issues/issue-details/breadcrumbs/index.mdx index 2ffe7bb7eee1f6..28bfae414d7190 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. 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 00000000000000..cd278b74cadfc6 --- /dev/null +++ b/platform-includes/configuration/console-logs-vs-breadcrumbs/_default.mdx @@ -0,0 +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/enriching-events/breadcrumbs-banner/_default.mdx b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx new file mode 100644 index 00000000000000..29364b90248b65 --- /dev/null +++ b/platform-includes/enriching-events/breadcrumbs-banner/_default.mdx @@ -0,0 +1,22 @@ + + + + +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/ruby.delayed_job.mdx b/platform-includes/enriching-events/breadcrumbs-banner/ruby.delayed_job.mdx new file mode 100644 index 00000000000000..a01a897f4c3758 --- /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 00000000000000..a01a897f4c3758 --- /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 00000000000000..a01a897f4c3758 --- /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 00000000000000..a01a897f4c3758 --- /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! + + +