ref: add high level flush to flush all resources

Author: Litarnus

src/SentrySdk.php

@@ -4,6 +4,8 @@
 
 namespace Sentry;
 
+use Sentry\Logs\Logs;
+use Sentry\Metrics\TraceMetrics;
 use Sentry\State\Hub;
 use Sentry\State\HubInterface;
 
@@ -61,4 +63,20 @@ public static function setCurrentHub(HubInterface $hub): HubInterface
 
         return $hub;
     }
+
+    /**
+     * Flushes all buffered telemetry data.
+     *
+     * This is a convenience facade that forwards the flush operation to all
+     * internally managed components.
+     *
+     * Calling this method is equivalent to invoking `flush()` on each component
+     * individually. It does not change flushing behavior, improve performance,
+     * or reduce the number of network requests.
+     */
+    public static function flush(): void
+    {
+        Logs::getInstance()->flush();
+        TraceMetrics::getInstance()->flush();
+    }
 }

src/functions.php

@@ -396,3 +396,18 @@ function addFeatureFlag(string $name, bool $result): void
         $scope->addFeatureFlag($name, $result);
     });
 }
+
+/**
+ * Flushes all buffered telemetry data.
+ *
+ * This is a convenience facade that forwards the flush operation to all
+ * internally managed components.
+ *
+ * Calling this method is equivalent to invoking `flush()` on each component
+ * individually. It does not change flushing behavior, improve performance,
+ * or reduce the number of network requests.
+ */
+function flush(): void
+{
+    SentrySdk::flush();
+}