implement capture_stacktrace; use it for capturing unexpected situations with envelope handling

sentry_sdk_extensions/__init__.py

@@ -0,0 +1,28 @@
+from sentry_sdk.utils import capture_internal_exceptions, current_stacktrace
+import sentry_sdk
+
+
+def capture_stacktrace(message):
+    """
+    Capture the current stacktrace and send it to Sentry; the standard sentry_sdk does not provide this; it either
+    allows for sending arbitrary messages (but without local variables on your stacktrace) or it allows for sending
+    exceptions (but you have to raise an exception to capture the stacktrace).
+    """
+    client_options = sentry_sdk.client.get_options()
+    event = {}
+    with capture_internal_exceptions():
+        stacktrace = current_stacktrace(client_options["with_locals"])
+        stacktrace["frames"].pop()  # Remove the last frame, which is the present function
+        event["threads"] = {
+            "values": [
+                {
+                    "stacktrace": stacktrace,
+                    "crashed": False,
+                    "current": True,
+                }
+            ]
+        }
+
+    event["level"] = "error"
+    event["logentry"] = {"message": message}
+    sentry_sdk.capture_event(event)