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/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). 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/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. 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/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. 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..cd278b74cadfc --- /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 0000000000000..29364b90248b6 --- /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 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! + + +