Add settings variable to opt-in for import-time parent segment

Author: hasier

README.md

@@ -315,6 +315,9 @@ XRAY_RECORDER = {
     ...
 }
 ```
+If `AUTO_PATCH_PARENT_SEGMENT_NAME` is also specified, then a segment parent will be created 
+with the supplied name, wrapping the automatic patching so that it captures any dangling
+subsegments created on the import patching.
 
 ### Add Flask middleware
 

aws_xray_sdk/ext/django/apps.py

@@ -39,7 +39,10 @@ def ready(self):
         )
 
         if settings.PATCH_MODULES:
-            with xray_recorder.in_segment('startup'):
+            if settings.AUTO_PATCH_PARENT_SEGMENT_NAME is not None:
+                with xray_recorder.in_segment(settings.AUTO_PATCH_PARENT_SEGMENT_NAME):
+                    patch(settings.PATCH_MODULES, ignore_module_patterns=settings.IGNORE_MODULE_PATTERNS)
+            else:
                 patch(settings.PATCH_MODULES, ignore_module_patterns=settings.IGNORE_MODULE_PATTERNS)
 
         # if turned on subsegment will be generated on

aws_xray_sdk/ext/django/conf.py

@@ -15,6 +15,7 @@
     'STREAMING_THRESHOLD': None,
     'MAX_TRACE_BACK': None,
     'PATCH_MODULES': [],
+    'AUTO_PATCH_PARENT_SEGMENT_NAME': None,
     'IGNORE_MODULE_PATTERNS': [],
 }