From 013c6582398721db06b83d51f6b23e6af64bb581 Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@koston.org>
Date: Mon, 9 Nov 2020 10:54:48 -1000
Subject: [PATCH] Add object logging services for investigating memory leaks
 (#15566)

---
 source/_integrations/profiler.markdown | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/source/_integrations/profiler.markdown b/source/_integrations/profiler.markdown
index 63dc567c17b..908bcfd8f9e 100644
--- a/source/_integrations/profiler.markdown
+++ b/source/_integrations/profiler.markdown
@@ -53,3 +53,25 @@ The `hpy` file can be viewed with any text editor. A visual representation can b
 from guppy import hpy
 hpy().pb()
 ```
+
+### Service `profiler.start_log_objects`
+
+Start logging the growth of objects in memory.
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `scan_interval` | yes | The the frequency between logging objects. Defaults to 30.0
+
+Periodically log the growth of new objects in memory. This service's primary use case is finding memory leaks.
+
+### Service `profiler.stop_log_objects`
+
+Stop logging the growth of objects in memory.
+
+### Service `profiler.dump_log_objects`
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `type` | no | The type of object to dump to the log.
+
+When `start_log_objects` highlights the growth of a collection of objects in memory, this service can help investigate. The `repr` of each object that matches `type` will be logged.