Merge pull request #2003 from brefphp/update-sentry-docs

Document that Sentry captures timeouts and "response too large" Lambda errors

Author: mnapoli

website/src/pages/sentry.mdx

@@ -1,4 +1,4 @@
-import { BugAntIcon, ClockIcon, CodeBracketSquareIcon, FingerPrintIcon } from '@heroicons/react/20/solid';
+import { BugAntIcon, ClockIcon, CodeBracketSquareIcon, FingerPrintIcon, MagnifyingGlassIcon } from '@heroicons/react/20/solid';
 import sentry from './sentry/sentry.png';
 import Image from 'next/image';
 import Breadcrumbs from '../components/Breadcrumbs';
@@ -72,7 +72,12 @@ export function Sentry() {
 
     const features = [
         {
-            name: 'Exception tracking.',
+            name: 'Advanced error tracking.',
+            description: 'Track AWS Lambda errors that are outside of PHP-FPM, like timeouts or "response too big" errors in Sentry.',
+            icon: MagnifyingGlassIcon,
+        },
+        {
+            name: 'Non-HTTP exception tracking.',
             description: 'Add exception tracking to AWS Lambda handlers like SQS, EventBridge, S3 handlers, and more.',
             icon: BugAntIcon,
         },

website/src/pages/sentry/docs.mdx

@@ -10,6 +10,7 @@ import { Callout } from 'nextra/components';
 
 This package provides an advanced integration between Bref applications and [Sentry monitoring](https://sentry.io/):
 
+- Capture AWS Lambda errors that would otherwise be invisible: Lambda timeouts, "response too large" errors, etc. (these errors happen outside PHP-FPM workers and are not captured by the Sentry SDK by default)
 - Trace cold starts in performance tracing
 - Capture exceptions and trace event handlers using the [function runtime](/docs/runtimes/function) (like EventBridge, SQS, S3…)
 - Trace AWS SDK calls in performance tracing