Merge branch 'master' into rework-node-docs

Author: onurtemizkan

src/components/banner.tsx

@@ -5,11 +5,11 @@ import React, { useState, useEffect } from "react";
 // This is a lazy way of doing things but will work until
 // we put a more robust solution in place.
 //
-const SHOW_BANNER = false;
+const SHOW_BANNER = true;
 const BANNER_TEXT =
-  "Learn how to customize performance monitoring in real time with Tonal in a live workshop on Nov. 1 @ 11am PT.";
+  "Join us for our upcoming integration workshop with Cloudflare on 12/8 at 10am PT.";
 const BANNER_LINK_URL =
-  "https://sentry.io/resources/ama-deep-dive-performance-monitoring/?promo_name=docs-banner";
+  "https://sentry.io/resources/cloudflare-built-sentry-client-for-serverless-computing/?promo_name=docs-banner";
 const BANNER_LINK_TEXT = "Register here.";
 const OPTIONAL_BANNER_IMAGE = null;
 

src/docs/product/discover-queries/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Discover Queries"
+title: "Discover"
 sidebar_order: 5
 redirect_from:
   - /product/discover/

src/docs/product/integrations/index.mdx

@@ -28,8 +28,9 @@ For more details, see the [full Integration Platform documentation](/product/int
 | OpsGenie                                                                 | X            |               |                |
 | [PagerDuty](/product/integrations/notification-incidents/pagerduty/)     | X            | X             |                |
 | Pushover                                                                 | X            |               |                |
+| [Rootly](/product/integrations/notification-incidents/rootly/)           | X            | X             |                |
 | [Slack](/product/integrations/notification-incidents/slack/)             | X            | X             | X              |
-| [Spike.sh](/product/integrations/notification-incidents/spikesh/)        | X            | X             |
+| [Spike.sh](/product/integrations/notification-incidents/spikesh/)        | X            | X             |                |
 | [Threads](/product/integrations/notification-incidents/threads/)         | X            | X             |                |
 | Twilio                                                                   | X            |               |                |
 | VictorOps                                                                | X            |               |                |

src/docs/product/integrations/integration-platform/webhooks.mdx

@@ -65,7 +65,7 @@ import hashlib
 import hmac
 import json
 
-expected_digest = request.headers['sentry-hook-signature']
+expected_digest = request.headers.get('sentry-hook-signature')  # returns None if header is missing
 body = json.dumps(request.body)
 
 digest = hmac.new(
@@ -74,8 +74,10 @@ digest = hmac.new(
     digestmod=hashlib.sha256,
 ).hexdigest()
 
+if not expected_digest:  # The signature is missing
+    raise UnauthorizedError
 
-if digest != expected_digest:
+if not hmac.compare_digest(digest, expected_digest):
     raise UnauthorizedError
 ```
 

src/docs/product/integrations/notification-incidents/index.mdx

@@ -11,6 +11,7 @@ Learn more about Sentry's notification and incidents integrations:
 - OpsGenie
 - [PagerDuty](/product/integrations/notification-incidents/pagerduty/)
 - Pushover
+- [Rootly](/product/integrations/notification-incidents/rootly/)
 - [Slack](/product/integrations/notification-incidents/slack/)
 - [Spike.sh](/product/integrations/notification-incidents/spikesh/)
 - [Threads](/product/integrations/notification-incidents/threads/)

src/docs/product/integrations/notification-incidents/rootly/index.mdx

@@ -0,0 +1,26 @@
+---
+title: Rootly
+sidebar_order: 1
+redirect_from:
+  - /product/integrations/rootly/
+description: "Learn about Sentry's Rootly integration and how it creates incidents from Sentry Alerts."
+---
+
+Rootly is a Slack-native incident management app and platform that automates tedious manual work during incidents.
+
+
+This integration is maintained and supported by the company that created it. For more details, check out our [Integration Platform documentation](/product/integrations/integration-platform/).
+
+## Install and Configure
+
+<Note>
+
+Sentry owner, manager, or admin permissions are required to install this integration.
+
+Rootly **won't** work with self-hosted Sentry.
+
+</Note>
+
+1. Navigate to **Settings > Integrations > Rootly**
+
+2. Follow the full [Rootly installation instructions](https://docs.rootly.com/integrations/sentry).

src/docs/product/issues/issue-details/index.mdx

@@ -35,6 +35,6 @@ This page displays the "Details" tab when it first opens, but several other tabs
 - **User Feedback** - Any feedback collected from users through the <PlatformLink to="/enriching-events/user-feedback/">SDK's user feedback</PlatformLink>.
 - <PlatformLink to="/enriching-events/attachments/">**Attachments**</PlatformLink> - Stored additional files, such as config or log files that are related to the error event.
 - **Tags** - More detailed information about the tags across all the events included in the issue.
-- **Events** - A list of all the error events included in the issue.
+- **All Events** - A list of all the error events included in the issue.
 - **Merged Issues** - A list of error issues that have been merged with this one.
 - **Similar Issues** - A list of error issues that have a similar stack trace [that you can merge](/product/data-management-settings/event-grouping/merging-issues/).

src/docs/product/performance/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Performance Monitoring"
+title: "Performance"
 sidebar_order: 2
 redirect_from:
   - /performance/

src/docs/product/sentry-basics/search/searchable-properties.mdx

@@ -93,6 +93,10 @@ Release properties overlap with event and issue search properties, so they don't
 | device.name | Details of the device | x |  | string |
 | device.online | Whether the device was online or not. A string that is either `True` or `False`. | x |  | string |
 | device.orientation | Describes the orientation of the device and can be either `portrait` or `landscape`. | x | x | string |
+| device.screen_density | Device screen density in pixels. | x | x | string |
+| device.screen_dpi | Number of dots per inch of the device screen. | x | x | string |
+| device.screen_height_pixels | Device screen height in pixels. | x | x | string |
+| device.screen_width_pixels | Device screen width in pixels. | x | x | string |
 | device.simulator | Indicates whether this device is a simulator or a real device. A string that is either `True` or `False`. | x |  | string |
 | device.uuid | Deprecated | x | x | uuid |
 | dist | Distinguishes build or deployment variants of the same release of an application. For example, the dist can be the build number of an XCode build or the version code of an Android build. | x | x | string |

src/gatsby/onPostBuild.ts

@@ -73,18 +73,18 @@ export default async ({ graphql }) => {
 };
 
 const parsePathSlug = (slug: string) => {
-  if (slug.includes("performance-onboarding")) {
+  if (slug.includes("/performance-onboarding/") || slug.includes("/replay-onboarding/")) {
     const pathMatch = slug.match(
-      /^\/(?<platform>[^/]+)\/performance-onboarding\/(?<sub_platform>[^/]+)\/(?<step>[^/]+)\/$/
+      /^\/(?<platform>[^/]+)\/(?<product>performance|replay)-onboarding\/(?<sub_platform>[^/]+)\/(?<step>[^/]+)\/$/
     );
-    
+
     if(!pathMatch) {
       throw new Error(`Unable to parse performance onboarding from slug: ${slug}`);
     }
-    
-    const { platform, sub_platform } = pathMatch.groups;
+
+    const { platform, product, sub_platform } = pathMatch.groups;
     const step = String(pathMatch.groups.step).replace(/\./g, "-");
-    const sub = platform === sub_platform ? `performance-onboarding-${step}` : `${sub_platform}-performance-onboarding-${step}`;
+    const sub = platform === sub_platform ? `${product}-onboarding-${step}` : `${sub_platform}-${product}-onboarding-${step}`;
 
     return {
       platform,

src/gatsby/utils/resolveOpenAPI.ts

@@ -3,7 +3,7 @@ import { promises as fs } from "fs";
 
 // SENTRY_API_SCHEMA_SHA is used in the sentry-docs GHA workflow in getsentry/sentry-api-schema.
 // DO NOT change variable name unless you change it in the sentry-docs GHA workflow in getsentry/sentry-api-schema.
-const SENTRY_API_SCHEMA_SHA = "d907372d5ed461a40d1d99b16fcee5ec52279ed0"
+const SENTRY_API_SCHEMA_SHA = "cf7f2cc9a9e4bfa437f947ba8b007ebe10b7dc16"
 
 const activeEnv =
   process.env.GATSBY_ENV || process.env.NODE_ENV || "development";

src/platform-includes/enriching-events/attach-screenshots/flutter.mdx

@@ -0,0 +1,19 @@
+```dart
+import 'package:flutter/widgets.dart';
+import 'package:sentry_flutter/sentry_flutter.dart';
+
+Future<void> main() async {
+  await SentryFlutter.init(
+    (options) {
+      options.dsn = '___PUBLIC_DSN___';
+      options.attachScreenshot = true;
+    },
+    appRunner: () => runApp(
+      // Wrap your app widget with the [SentryScreenshotWidget] widget.
+      SentryScreenshotWidget(
+        child: MyApp(),
+      ),
+    ),
+  );
+}
+```

src/platform-includes/getting-started-config/apple.mdx

@@ -16,6 +16,7 @@ func application(_ application: UIApplication,
         options.enableAppHangTracking = true
         options.enableFileIOTracking = true
         options.enableCoreDataTracking = true
+        options.enableCaptureFailedRequests = true
     }
 
     return true
@@ -35,6 +36,7 @@ func application(_ application: UIApplication,
         options.enableAppHangTracking = YES;
         options.enableFileIOTracking = YES;
         options.enableCoreDataTracking = YES;
+        options.enableCaptureFailedRequests = YES;
     }];
 
     return YES;
@@ -57,6 +59,7 @@ struct SwiftUIApp: App {
             options.enableAppHangTracking = true
             options.enableFileIOTracking = true
             options.enableCoreDataTracking = true
+            options.enableCaptureFailedRequests = true
         }
     }
 }

src/platform-includes/getting-started-primer/android.mdx

@@ -38,6 +38,8 @@ The SDK builds a crash report that persists to disk and tries to send the report
     - Apollo request spans with [Apollo Integration](/platforms/android/configuration/integrations/apollo/)
     - Distributed tracing through [OkHttp](/platforms/android/configuration/integrations/okhttp/) and [Apollo](/platforms/android/configuration/integrations/apollo/) integrations
 - [Application Not Responding (ANR)](/platforms/android/configuration/app-not-respond/) reported if the application is blocked for more than five seconds
+- [HTTP Client Errors](/platforms/android/configuration/integrations/okhttp/#http-client-errors)
+- [Screenshot attachments for errors](/platforms/android/enriching-events/screenshots/)
 - Code samples provided in both Kotlin and Java as the Android SDK uses both languages
 - We provide a [sample application](https://github.com/getsentry/sentry-java/tree/master/sentry-samples/sentry-samples-android) for our Android users
 - Our [video tutorial](/platforms/android/android-video/) visually demonstrates how to set up our SDK

src/platform-includes/getting-started-primer/apple.mdx

@@ -11,6 +11,7 @@
   - Error messages of fatalError, assert, and precondition
   - [App Hang Detection](/platforms/apple/configuration/app-hangs/)
   - [Out of memory](/platforms/apple/configuration/out-of-memory/)
+  - [HTTP Client Errors](/platforms/apple/configuration/http-client-errors/)
   - Start-up crashes. The SDK init waits synchronously for up to 5 seconds to flush out events if the app crashes within 2 seconds after the SDK init.
 - Events [enriched](/platforms/apple/enriching-events/context/) with device data
 - Offline caching when a device is unable to connect; we send a report once we receive another event
@@ -32,3 +33,4 @@
   - <PlatformLink to="/performance/instrumentation/automatic-instrumentation/#user-interaction-tracing">User Interaction</PlatformLink> transactions for UI clicks (experimental)
 - [Attachments](/platforms/apple/enriching-events/attachments/) enrich your event by storing additional files, such as config or log files
 - [User Feedback](/platforms/apple/enriching-events/user-feedback/) provides the ability to collect user information when an event occurs
+- [Screenshot attachments for errors](/platforms/apple/guides/ios/enriching-events/screenshots/)

src/platform-includes/getting-started-primer/flutter.mdx

@@ -29,5 +29,6 @@ Features:
   - [Slow and frozen frames](/platforms/flutter/performance/instrumentation/automatic-instrumentation/#slow-and-frozen-frames)
   - [AssetBundle Instrumentation](/platforms/flutter/performance/instrumentation/automatic-instrumentation/#assetbundle-instrumentation)
 - [Logging Integration](/platforms/dart/configuration/integrations/logging)
+- [Screenshot attachments for errors](/platforms/flutter/enriching-events/screenshots/)
 - Limited support for Flutter Web, Windows, and Linux
 - Under the hood the SDK relies on the [Dart SDK](/platforms/dart/); the minimum required version is `2.12.0` and Flutter SDK version is `1.17.0`.

src/platform-includes/performance/connect-services/node.mdx

@@ -1,5 +1,27 @@
-If you are also using Performance Monitoring for [JavaScript](/platforms/javascript/performance/), depending on where your request originates, you can connect traces:
-1. For requests that start in your backend, by [adding a meta tag](/platforms/javascript/performance/connect-services/#pageload) in your HTML template that contains tracing information.
-2. For requests that start in JavaScript, by the SDK [setting a header](/platforms/javascript/performance/connect-services/#navigation-and-other-xhr-requests) on requests to your backend.
+## Distributed Tracing
 
-Otherwise, backend services with Performance Monitoring connect automatically.
+To obtain a trace from a span, use `toTraceParent()` method. This method returns a string that can be used as a value of the `traceparent` HTTP header:
+
+```javascript
+const sentryTraceHeader = span.toTraceparent();
+
+requestOptions.headers = {
+  ...requestOptions.headers,
+  'sentry-trace': sentryTraceHeader,
+};
+```
+
+To create a span as a continuation of the trace retrieved from the upstream service, use `extractTraceparentData` function from `@sentry/tracing`:
+
+```javascript
+import { extractTraceparentData } from "@sentry/tracing";
+
+// The request headers sent by your upstream service to your backend.
+const traceparentData = extractTraceparentData(request.headers['sentry-trace']);
+
+const transaction = Sentry.startTransaction({
+  op: 'transaction_op',
+  name: 'transaction_name',
+  ...traceparentData,
+});
+```

src/platforms/android/common/gradle.mdx

@@ -5,8 +5,13 @@ description: "Learn about using the Sentry Android Gradle Plugin."
 ---
 
 The [Sentry Android Gradle Plugin](https://github.com/getsentry/sentry-android-gradle-plugin) is an addition to the main Android and Hybrid SDKs (like React Native and Flutter) and offers
-seamless integration with the Gradle build system. It supports the upload of ProGuard/R8 mappings and of Native debug symbols and sources, as well as
-auto-instrumentation tracing through bytecode manipulation.
+seamless integration with the Gradle build system. It supports the following features:
+
+- ProGuard/R8 mappings upload
+- Native debug symbols and sources upload
+- Auto-instrumentation tracing through bytecode manipulation
+- Auto-installation of the Sentry Android SDK and its integrations
+- External dependencies report
 
 ## Setup
 
@@ -89,7 +94,7 @@ sentry {
 
       // Specifies a set of instrumentation features that are eligible for bytecode manipulation.
       // Defaults to all available values of InstrumentationFeature enum class.
-      features = [InstrumentationFeature.DATABASE, InstrumentationFeature.FILE_IO, InstrumentationFeature.OKHTTP]
+      features = [InstrumentationFeature.DATABASE, InstrumentationFeature.FILE_IO, InstrumentationFeature.OKHTTP, InstrumentationFeature.COMPOSE]
     }
 
     // Enable auto-installation of Sentry components (sentry-android SDK and okhttp, timber and fragment integrations).
@@ -109,6 +114,14 @@ sentry {
       // Defaults to the latest published sentry version.
       sentryVersion = '{{ packages.version('sentry.java.android', '5.0.0') }}'
     }
+    
+    // Disables or enables dependencies metadata reporting for Sentry.
+    // If enabled, the plugin will collect external dependencies and
+    // upload them to Sentry as part of events. If disabled, all the logic
+    // related to the dependencies metadata report will be excluded.
+    //
+    // Default is enabled.
+    includeDependenciesReport = true
 }
 ```
 
@@ -154,10 +167,10 @@ sentry {
 
       // Specifies a set of instrumentation features that are eligible for bytecode manipulation.
       // Defaults to all available values of InstrumentationFeature enum class.
-      features.set(setOf(InstrumentationFeature.DATABASE, InstrumentationFeature.FILE_IO, InstrumentationFeature.OKHTTP))
+      features.set(setOf(InstrumentationFeature.DATABASE, InstrumentationFeature.FILE_IO, InstrumentationFeature.OKHTTP, InstrumentationFeature.COMPOSE))
     }
 
-    // Enable auto-installation of Sentry components (sentry-android SDK and okhttp, timber and fragment integrations).
+    // Enable auto-installation of Sentry components (sentry-android SDK and okhttp, timber, fragment and compose integrations).
     // Default is enabled.
     // Only available v3.1.0 and above.
     autoInstallation {
@@ -174,6 +187,15 @@ sentry {
       // Defaults to the latest published sentry version.
       sentryVersion.set("{{ packages.version('sentry.java.android', '5.0.0') }}")
     }
+    
+    // Disables or enables dependencies metadata reporting for Sentry.
+    // If enabled, the plugin will collect external dependencies and 
+    // upload them to Sentry as part of events. If disabled, all the logic
+    // related to the dependencies metadata report will be excluded.
+    //
+    // Default is enabled.
+    //
+    includeDependenciesReport.set(true)
 }
 ```
 
@@ -292,7 +314,15 @@ enum class InstrumentationFeature {
      * Requires sentry-android SDK version 5.0.0 and above.
      * Only available v3.1.0 and above of the Sentry Android Gradle plugin.
      */
-    OKHTTP
+    OKHTTP,
+
+    /**
+     * When enabled the SDK will create breadcrumbs when navigating
+     * using [androidx.navigation.NavController].
+     * This feature uses bytecode manipulation and adds an OnDestinationChangedListener to all
+     * navigation controllers used in Jetpack Compose.
+     */
+    COMPOSE
 }
 ```
 
@@ -306,7 +336,7 @@ To learn more about the internals of auto-instrumentation, check out this [blog
 
 ## Auto-Installation
 
-The plugin offers the automated installation feature of the Sentry Android SDK and the [Fragment](/platforms/android/configuration/integrations/fragment/), [Timber](/platforms/android/configuration/integrations/timber/), and [OkHttp](/platforms/android/configuration/integrations/okhttp/) integrations. Starting with version 3.1.0, the feature is enabled by default, so you don't need to add any dependencies — you just use the Sentry Gradle plugin.
+The plugin offers the automated installation feature of the Sentry Android SDK and the [Fragment](/platforms/android/configuration/integrations/fragment/), [Timber](/platforms/android/configuration/integrations/timber/), [OkHttp](/platforms/android/configuration/integrations/okhttp/), and [Jetpack Compose](/platforms/android/configuration/integrations/jetpack-compose/) integrations. Starting with version 3.1.0, the feature is enabled by default, so you don't need to add any dependencies — you just use the Sentry Gradle plugin.
 
 The plugin algorithm does the following when defining dependency versions:
 

src/platforms/android/configuration/integrations/fragment.mdx

@@ -81,6 +81,25 @@ SentryAndroid.init(this) { options ->
 }
 ```
 
+You can also configure which fragment lifecycle events will be added as breadcrumbs.
+
+```kotlin
+import android.app.Application
+import io.sentry.android.core.SentryAndroid
+import io.sentry.android.fragment.FragmentLifecycleIntegration
+import io.sentry.android.fragment.FragmentLifecycleState.CREATED
+import io.sentry.android.fragment.FragmentLifecycleState.DESTROYED
+
+SentryAndroid.init(this) { options ->
+    options.addIntegration(
+        FragmentLifecycleIntegration(
+            this,
+            filterFragmentLifecycleBreadcrumbs = setOf(FragmentLifecycleState.CREATED, FragmentLifecycleState.DESTROYED)
+            )
+        )
+}
+```
+
 ## Verify
 
 Create a new `Fragment` view and add a button to it.