Skip to content
2 changes: 2 additions & 0 deletions docs/platforms/android/enriching-events/breadcrumbs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
6 changes: 6 additions & 0 deletions docs/platforms/android/integrations/logcat/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,12 @@ categories:
og_image: /og-images/platforms-android-integrations-logcat.png
---

<Alert level="warning" title="Did you mean logs instead?">

This integration captures Logcat logs as breadcrumbs (great for error context!). But if you need to search and query your logs across your entire application, use <PlatformLink to="/logs/">Sentry Logs</PlatformLink> instead. Logcat logs at or above the `minLevel` are automatically sent as Sentry Logs when enabled. See the <PlatformLink to="/integrations/logcat/#support-with-sentry-logs">Support With Sentry Logs</PlatformLink> section below.

</Alert>

<Alert>

Supported in Sentry's Android SDK version `6.17.0` and above.
Expand Down
8 changes: 7 additions & 1 deletion docs/platforms/android/integrations/timber/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,13 @@ sdk: sentry.java.android.timber
description: "Learn more about the Sentry Timber integration for the Android SDK."
---

The `sentry-android-timber` library provides [Timber](https://github.com/JakeWharton/timber) support for Sentry via [Timber Tree](https://github.com/JakeWharton/timber/blob/10f0adce3921ad2929ddf2f3b7fecda2cf3148a5/timber/src/main/java/timber/log/Timber.kt#L20) that sends events and breadcrumbs to Sentry. Once this integration is configured you can use Timber’s static API.
<Alert level="warning" title="Did you mean logs instead?">

This integration captures Timber logs as breadcrumbs and error events (great for error context!). But if you need to search and query your logs across your entire application, use <PlatformLink to="/logs/">Sentry Logs</PlatformLink> instead. Timber logs at or above the `minLogsLevel` are automatically sent as Sentry Logs when enabled. See the <PlatformLink to="/integrations/timber/#support-with-sentry-logs">Support With Sentry Logs</PlatformLink> section below.

</Alert>

The `sentry-android-timber` library provides [Timber](https://github.com/JakeWharton/timber) support for Sentry via [Timber Tree](https://github.com/JakeWharton/timber/blob/10f0adce3921ad2929ddf2f3b7fecda2cf3148a5/timber/src/main/java/timber/log/Timber.kt#L20) that sends events and breadcrumbs to Sentry. Once this integration is configured you can use Timber's static API.

The source can be found [on GitHub](https://github.com/getsentry/sentry-java/tree/master/sentry-android-timber/src/main/java/io/sentry/android/timber).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/godot/enriching-events/breadcrumbs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ notSupported:
- javascript.bun
---

<PlatformContent includePath="configuration/console-logs-vs-breadcrumbs" />

<Alert>

This integration only works inside a browser environment.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ supported:
- javascript.tanstackstart-react
---

<PlatformContent includePath="configuration/console-logs-vs-breadcrumbs" />

_Import name: `Sentry.consoleIntegration`_

This integration is enabled by default. If you'd like to modify your default integrations, read [this](./../#modifying-default-integrations).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@ notSupported:
- native.wasm
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
15 changes: 15 additions & 0 deletions docs/platforms/php/common/integrations/monolog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,3 +41,18 @@ try {
$log->error('Some exception happened', ['exception' => $exception]);
}
```

## Support With Sentry Logs

Monolog logs can also be captured as <PlatformLink to="/logs/">Sentry Logs</PlatformLink> for better searchability and querying.

To enable this, set `enable_logs` to `true` when initializing the SDK:

```php
\Sentry\init([
'dsn' => '___PUBLIC_DSN___',
'enable_logs' => true,
]);
```

You can control which log levels are sent to Sentry Logs by configuring the Monolog handler's minimum level.
24 changes: 24 additions & 0 deletions docs/platforms/php/guides/symfony/integrations/monolog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,3 +33,27 @@ monolog:
fill_extra_context: true # Enables sending monolog context to Sentry
process_psr_3_messages: false # Disables the resolution of PSR-3 placeholders in reported messages
```

## Support With Sentry Logs

Monolog logs can also be captured as <PlatformLink to="/logs/">Sentry Logs</PlatformLink> for better searchability and querying.

To enable this, set `enable_logs` to `true` in your Sentry configuration:

```yaml {filename:config/packages/sentry.yaml}
sentry:
options:
enable_logs: true
```

Then configure the Monolog handler for logs:

```yaml {filename:config/packages/monolog.yaml}
monolog:
handlers:
sentry_logs:
type: service
id: Sentry\SentryBundle\Monolog\LogsHandler
```

You can control which log levels are sent to Sentry Logs by configuring the handler's minimum level in your services configuration.
2 changes: 2 additions & 0 deletions docs/platforms/python/enriching-events/breadcrumbs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: Breadcrumbs
description: "Learn more about what Sentry uses to create a trail of events (breadcrumbs) that happened prior to an issue."
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/unreal/enriching-events/breadcrumbs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ description: >-
og_image: /og-images/platforms-unreal-enriching-events-breadcrumbs.png
---

<PlatformContent includePath="enriching-events/breadcrumbs-banner" />

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

This page provides an overview of manual breadcrumb recording and customization. Learn more about the information that displays on the **Issue Details** page and how you can filter breadcrumbs to quickly resolve issues in [Using Breadcrumbs](/product/error-monitoring/breadcrumbs).
Expand Down
6 changes: 6 additions & 0 deletions docs/product/issues/issue-details/breadcrumbs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ sidebar_order: 60
og_image: /og-images/product-issues-issue-details-breadcrumbs.png
---

<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">

Manual breadcrumbs had a good run, but [Sentry's got logs](/product/explore/logs/). Structured, searchable, and way easier to alert or query on. Check them out!

</Alert>

Sentry uses _breadcrumbs_ to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.

SDKs automatically start recording breadcrumbs by enabling integrations. To learn how to do this for your platform, select it from the dropdown at the top of the left hand nav. You'll be taken to the breadcrumb documentation specific to the platform you use.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<PlatformSection notSupported={[
'javascript.deno',
'javascript.cordova'
]}>

<Alert level="warning" title="Did you mean logs instead?">

This integration captures console logs as breadcrumbs (great for error context!). But if you need to search and query your logs across your entire application, use <PlatformLink to="/logs/">Sentry Logs</PlatformLink> instead. Set `enableLogs: true`, and add the <PlatformLink to="/logs/#integrations">Sentry console logging integration</PlatformLink> in your SDK config.

</Alert>

</PlatformSection>

22 changes: 22 additions & 0 deletions platform-includes/enriching-events/breadcrumbs-banner/_default.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
<PlatformSection notSupported={[
'javascript.deno',
'javascript.cordova',
'dotnet.log4net',
'dotnet.nlog',
'dotnet.xamarin',
'dotnet.google-cloud-functions',
'native.qt',
'unity',
'kotlin.kotlin-multiplatform',
'elixir',
'powershell'
]}>

<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">

Manual breadcrumbs had a good run, but <PlatformLink to="/logs/">Sentry's got logs</PlatformLink>. Structured, searchable, and way easier to alert or query on. Check them out!

</Alert>

</PlatformSection>

Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">

Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/ruby/logs/). Structured, searchable, and way easier to alert or query on. Check them out!

</Alert>

Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">

Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/ruby/logs/). Structured, searchable, and way easier to alert or query on. Check them out!

</Alert>

Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">

Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/ruby/logs/). Structured, searchable, and way easier to alert or query on. Check them out!

</Alert>

Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
<Alert level="warning" title="Hey... did you mean Logs? Sentry has them now!">

Manual breadcrumbs had a good run, but [Sentry's got logs](/platforms/ruby/logs/). Structured, searchable, and way easier to alert or query on. Check them out!

</Alert>

Loading