From 3319eaa7b647a09a7c0142c229eaebe7ac3a8a19 Mon Sep 17 00:00:00 2001 From: c_fons Date: Mon, 15 Dec 2025 14:05:07 +0000 Subject: [PATCH 1/3] Document new data management admin page --- doc/administration/admin_area.md | 44 ++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index d61d3f231d6e2a..fa71c03e942075 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -598,6 +598,50 @@ The Sidekiq dashboard contains: - Current memory usage, measured in MB - Peak memory usage, measured in MB +### Data management + +{{< history >}} + +- [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/550952) in GitLab 18.8. + +{{< /history >}} + +The **Data management** page provides a comprehensive interface to view and manage verification status across all components. +The components include [all data types](geo/replication/datatypes.md) supported by Geo. + +#### List View + +The List View displays verification status for a selected component. Each component is presented as a tab, allowing you +to switch between different verification models. + +It includes: + +- Component tabs: Switch between different verification models (Projects, Uploads, etc.) +- Status filtering: Filter objects by checksum status (Failed, Pending, Successful) +- Pagination: Navigate through large result sets +- Verification details: View last checksum time, last failed time, and failure reasons for each object +- Bulk actions: Trigger checksum calculation for all objects at once +- Single actions: Checksum individual objects + +#### Details View + +The Details View provides comprehensive information about a specific object's verification status. It can be accessed by +clicking on an individual model from the list view. + +Information displayed: + +- Model information: Details about the verified object +- Checksum information: Current checksum status and history +- Error details: Detailed failure reasons if verification failed +- Actions: Options to re-calculate the checksum of the object + +#### Use Cases + +- Troubleshooting verification failures: Identify orphaned files or database records that lead to verification failures + without requiring Rails console access. +- Self-service resolution: View detailed error information and take corrective actions directly from the UI. +- Monitoring verification health: Track verification status across all components and identify patterns in failures. + ### Database diagnostics {{< history >}} -- GitLab From bc7cb950856647a3cbb16febef02cc3014a7bc02 Mon Sep 17 00:00:00 2001 From: c_fons Date: Mon, 15 Dec 2025 15:23:19 +0000 Subject: [PATCH 2/3] Address Duo comments --- doc/administration/admin_area.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index fa71c03e942075..d2fcd56d832528 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -606,13 +606,14 @@ The Sidekiq dashboard contains: {{< /history >}} -The **Data management** page provides a comprehensive interface to view and manage verification status across all components. +The **Data management** page provides a comprehensive interface to view and manage verification status +across all components. The components include [all data types](geo/replication/datatypes.md) supported by Geo. #### List View -The List View displays verification status for a selected component. Each component is presented as a tab, allowing you -to switch between different verification models. +The List View displays verification status for a selected component. +Each component is presented as a tab, allowing you to switch between different verification models. It includes: @@ -625,8 +626,8 @@ It includes: #### Details View -The Details View provides comprehensive information about a specific object's verification status. It can be accessed by -clicking on an individual model from the list view. +The Details View provides comprehensive information about a specific object's verification status. +It can be accessed by clicking on an individual model from the list view. Information displayed: @@ -637,10 +638,12 @@ Information displayed: #### Use Cases -- Troubleshooting verification failures: Identify orphaned files or database records that lead to verification failures - without requiring Rails console access. -- Self-service resolution: View detailed error information and take corrective actions directly from the UI. -- Monitoring verification health: Track verification status across all components and identify patterns in failures. +- Troubleshooting verification failures: Identify orphaned files or database records that lead to + verification failures without requiring Rails console access. +- Self-service resolution: View detailed error information and take corrective actions directly + from the UI. +- Monitoring verification health: Track verification status across all components and identify + patterns in failures. ### Database diagnostics -- GitLab From 2efbcb00d719f8ca5488b98716fd84c567135db3 Mon Sep 17 00:00:00 2001 From: Chloe Fons Date: Wed, 17 Dec 2025 09:55:03 +0000 Subject: [PATCH 3/3] Apply 2 suggestion(s) to 1 file(s) Co-authored-by: Zack Cuddy --- doc/administration/admin_area.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index d2fcd56d832528..1508ce9aca552a 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -613,11 +613,11 @@ The components include [all data types](geo/replication/datatypes.md) supported #### List View The List View displays verification status for a selected component. -Each component is presented as a tab, allowing you to switch between different verification models. +Each component is available in the listbox, allowing you to switch between different verification models. It includes: -- Component tabs: Switch between different verification models (Projects, Uploads, etc.) +- Components Listbox: Switch between different verification models (Projects, Uploads, etc.) - Status filtering: Filter objects by checksum status (Failed, Pending, Successful) - Pagination: Navigate through large result sets - Verification details: View last checksum time, last failed time, and failure reasons for each object -- GitLab