[Profiler] document how to disable data collector internal tracing logic

Author: 94noni

profiler.rst

@@ -368,6 +368,38 @@ data serialization (during :ref:`kernel.terminate <component-http-kernel-kernel-
     with ``autoconfigure``, then Symfony will start using your data collector after the
     next page refresh. Otherwise, :ref:`enable the data collector by hand <data_collector_tag>`.
 
+.. warning::
+
+    It arrives that some data collector leverage some decorated underlying service (traceable service).
+    And as the profiler mechanism can be disabled, you may adapt your collector to handle such case
+    to avoid unwanted useless memory leak.
+    You can do so by injecting the ``profiler.is_disabled_state_checker`` service::
+
+    // src/DataCollector/ServiceCollector.php
+    namespace App\DataCollector;
+
+    use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+
+    class ServiceCollector extends AbstractDataCollector
+    {
+        public function __construct(
+            private ServiceInterface $decoratedService,
+            protected readonly ?\Closure $disabled = null, // profiler.is_disabled_state_checker
+        ) {}
+
+        public function action(): void
+        {
+            if ($this->disabled?->__invoke()) {
+                return $this->decoratedService->action();
+            }
+
+            // do the trace job to have some data to be collected by your data collector.
+        }
+    }
+
+
 Adding Web Profiler Templates
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~