diff --git a/doc/administration/admin_area.md b/doc/administration/admin_area.md index d61d3f231d6e2a5af74b21dba0e3942a6b826d38..1508ce9aca552ad8d742df0cf9ff77b07376fe72 100644 --- a/doc/administration/admin_area.md +++ b/doc/administration/admin_area.md @@ -598,6 +598,53 @@ 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 available in the listbox, allowing you to switch between different verification models. + +It includes: + +- 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 +- 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 >}}