feat(godot): Enriching events with scene tree data (#13531)

Author: limbonaut

docs/platforms/godot/configuration/options.mdx

@@ -102,6 +102,12 @@ If enabled, the SDK will try to take a screenshot and attach it to the event.
 
 </ConfigKey>
 
+<ConfigKey name="attach-scene-tree">
+
+If enabled, the SDK will capture and attach scene tree information to events. The scene tree data is attached as a `view-hierarchy.json` file, and you can explore it in the "Scene Tree" section of each issue that includes this attachment. This provides valuable context about your game's scene tree at the time of the error. See <PlatformLink to="/enriching-events/view-hierarchy/">Scene Tree</PlatformLink> for more details.
+
+</ConfigKey>
+
 ## Error Logger Options
 
 <ConfigKey name="logger-enabled">

docs/platforms/godot/enriching-events/view-hierarchy/img/project-settings.png

@@ -0,0 +1,44 @@
+---
+title: "Scene Tree"
+description: "Learn more about capturing scene tree data during errors and crashes. Sentry provides a visual representation of your game's scene tree at the time of failure, giving you additional insight into issues."
+---
+
+Sentry captures a JSON representation of engine's scene tree during errors and crashes, adding it to the event as an attachment. This feature is also known as View Hierarchy in Sentry.
+
+<Alert title="Note">
+
+This process can only be performed on the main thread, which means it may not be available during events that happen on threads other than the main thread. Additionally, if an error occurs before the scene tree is initialized, this information cannot be captured. Inherently, this feature should be considered a best-effort solution.
+
+</Alert>
+
+## Enabling Scene Tree Attachments
+
+Scene tree capturing is an opt-in feature. To attach scene tree information to your events, navigate to **Project Settings > Sentry > Options** and enable the **Attach Scene Tree** option:
+
+![Project Settings Screenshot](./img/project-settings.png)
+
+Or, like so, if you're <PlatformLink to="/configuration/options/">configuring things programmatically</PlatformLink>:
+
+```GDScript
+extends SentryConfiguration
+
+func _configure(options: SentryOptions):
+	options.attach_scene_tree = true
+```
+
+## Viewing Scene Tree Attachments
+
+Scene tree information is attached as `view-hierarchy.json` file. You can find it in the "Attachments" tab, where you can view all attachments, as well as associated events. Click the event ID to open the [Issue Details](/product/issues/issue-details) page of that specific event.
+
+<Include name="common-imgs/viewhierarchy-list-example" />
+
+On the **Issue Details** page, you can interact with the scene tree attachment in a section called "Scene Tree". This section represents the state of your scene tree at the time of an error event. There are two displays: a tree view, and detailed view for a selected node. You can select nodes in the tree to view the properties collected by the SDK. The SDK will report on the following keys for each node in the view:
+
+- `name`: The name of the node.
+- `class`: Built-in class of the node.
+- `script`: The file path of the script attached to the node. Only nodes with a script attached include this property.
+- `scene`: The original scene's file path, if the node has been instantiated from a PackedScene file. Only scene root nodes include this property.
+
+This feature provides a snapshot of your game's scene tree structure at the moment of error, making it easier to identify which nodes were active or gain a better understanding of the relationship between the nodes.
+
+![Scene Tree Example](./img/scene-tree-example.png)