diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-deleted-resource-data.png b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-deleted-resource-data.png new file mode 100644 index 00000000..eb895c39 Binary files /dev/null and b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-deleted-resource-data.png differ diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-locate-region.png b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-locate-region.png new file mode 100644 index 00000000..02def38f Binary files /dev/null and b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-locate-region.png differ diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-resources-tab.png b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-resources-tab.png new file mode 100644 index 00000000..6940c448 Binary files /dev/null and b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-resources-tab.png differ diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-search-bar.png b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-search-bar.png new file mode 100644 index 00000000..314444fa Binary files /dev/null and b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-search-bar.png differ diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-descendant-tab.png b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-descendant-tab.png new file mode 100644 index 00000000..66f8b81f Binary files /dev/null and b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-descendant-tab.png differ diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-resource-type-filter.png b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-resource-type-filter.png new file mode 100644 index 00000000..2f6afb11 Binary files /dev/null and b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-resource-type-filter.png differ diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-timestamp.png b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-timestamp.png new file mode 100644 index 00000000..6e50a82e Binary files /dev/null and b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-timestamp.png differ diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-type-filter.png b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-type-filter.png new file mode 100644 index 00000000..01fef89f Binary files /dev/null and b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/guardrails-select-type-filter.png differ diff --git a/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/index.md b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/index.md new file mode 100644 index 00000000..4459fdd4 --- /dev/null +++ b/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history/index.md @@ -0,0 +1,69 @@ +--- +title: Find Deleted Resources History +sidebar_label: Find Deleted Resources History +--- + +# Find Deleted Resources History + +In this guide, you will learn how to: +- Use the Guardrails UI to access historical data for resources that have been deleted from Guardrails. + +When a resource is deleted from Guardrails, the [resource](/guardrails/docs/reference/glossary#resource) itself is no longer visible in the console. However, its historical activity remains accessible via the **Activity** tab. This information is particularly useful for troubleshooting, auditing, and debugging. + +## Prerequisites + +- **Turbot/Operator** permissions at the Turbot resource level. +- Familiarity with the Guardrails console. + +## Step 1: Navigate to the Resources Tab + +Log in to the Guardrails console using valid credentials and select the **Resources** tab from the top menu. + +![Guardrails Resources Tab](./guardrails-resources-tab.png) + +## Step 2: Navigate to the Region + +Drill down into the region where the deleted resource previously existed. For example, navigate to `us-east-2` if the resource was located there. Select the **Activity** tab to view historical events. + +![Guardrails Locate Region](./guardrails-locate-region.png) + +## Step 3: Configure Activity Filters + +Use the following filters to narrow your search and include relevant activity history: + +**Descendant**: Enable the `Descendant` checkbox on the left. This allows the search to include all child resources under the selected parent. + + ![Descendant Filter](./guardrails-select-descendant-tab.png) + +**Resource Type**: From the right-hand filter pane, open the `Resource Type` dropdown and select the appropriate resource type. + > For demonstration purposes, this guide uses `AWS > S3 > Bucket` as an example. You should select the resource type relevant to your use case. + + ![Resource Type Filter](./guardrails-select-resource-type-filter.png) + +**Type**: Select both **Control** and **Resource** under the `Type` dropdown to view lifecycle changes and control evaluations. + + ![Type Filter](./guardrails-select-type-filter.png) + +**Timestamp**: Use the `Timestamp` dropdown to define a date range if you know roughly when the deletion occurred. + + ![Timestamp Filter](./guardrails-select-timestamp.png) + +## Step 4: Search Deleted Resource + +Enter the resource name (or a keyword) into the **Search Box** to locate any matching historical entries. The results may include the full activity history of the deleted resource, including creation events, configuration and policy changes, control evaluations, and the deletion event itself. + + Select the entry to view detailed information. + +![Search for Resource](./guardrails-search-bar.png) + +## Step 5: Review Deleted Resource Data + +The resource data is displayed under the Deleted Resource section, which can be used to understand the context and impact of the removal or to capture any required information for auditing or troubleshooting. + +![Activity Results](./guardrails-deleted-resource-data.png) + +If you encounter any further issues, please [Open Support Ticket](https://support.turbot.com) and attach the relevant information to assist you more efficiently. + +- The full resource name or ARN (if known). +- The region and approximate deletion time. +- A brief description of what you're trying to find and any filters you applied. diff --git a/docs/guides/using-guardrails/troubleshooting/index.md b/docs/guides/using-guardrails/troubleshooting/index.md index c4a40268..5254161e 100644 --- a/docs/guides/using-guardrails/troubleshooting/index.md +++ b/docs/guides/using-guardrails/troubleshooting/index.md @@ -11,4 +11,5 @@ The following guides will assist with the self-resolution of common problems. If - [Fix Invalid Controls](/guardrails/docs/guides/using-guardrails/troubleshooting/fix-invalid-controls) - [Resolve Calculated Policy Errors](/guardrails/docs/guides/using-guardrails/troubleshooting/fix-calc-policy-evaluation-errors) - [Run Controls Using Scripts](/guardrails/docs/guides/using-guardrails/troubleshooting/run-controls-using-scripts) -- [Retrieve Resource ID from Guardrails Console](/guardrails/docs/guides/using-guardrails/troubleshooting/retrieve-resource-id) \ No newline at end of file +- [Retrieve Resource ID from Guardrails Console](/guardrails/docs/guides/using-guardrails/troubleshooting/retrieve-resource-id) +- [Find Deleted Resources History](/guardrails/docs/guides/using-guardrails/troubleshooting/find-deleted-resources-history) \ No newline at end of file diff --git a/docs/guides/using-guardrails/troubleshooting/retrieve-resource-id/index.md b/docs/guides/using-guardrails/troubleshooting/retrieve-resource-id/index.md index f2cff42d..d0566b31 100644 --- a/docs/guides/using-guardrails/troubleshooting/retrieve-resource-id/index.md +++ b/docs/guides/using-guardrails/troubleshooting/retrieve-resource-id/index.md @@ -1,9 +1,9 @@ --- -title: Retrieve Resource ID from Guardrails Console -sidebar_label: Retrieve Resource ID from Guardrails Console +title: Retrieve Resource ID +sidebar_label: Retrieve Resource ID --- -# Retrieve a Resource ID from Guardrails Console +# Retrieve a Resource ID in Guardrails Console In this guide, you will: - Learn a step-by-step approach to locating the Resource ID of any managed resource within the Guardrails Console diff --git a/docs/sidebar.json b/docs/sidebar.json index 8a3dd136..8fc992b8 100644 --- a/docs/sidebar.json +++ b/docs/sidebar.json @@ -360,7 +360,8 @@ "guides/using-guardrails/troubleshooting/fix-invalid-controls", "guides/using-guardrails/troubleshooting/access-control-logs", "guides/using-guardrails/troubleshooting/run-controls-using-scripts", - "guides/using-guardrails/troubleshooting/retrieve-resource-id" + "guides/using-guardrails/troubleshooting/retrieve-resource-id", + "guides/using-guardrails/troubleshooting/find-deleted-resources-history" ] } ]