Record deletion in Grail via API
You can delete records from Grail via API by leveraging DQL. DQL allows you to specify criteria for selecting records to be deleted.
You can delete the following data types:
logseventsbizeventsspans
To delete records in Grail
- Search for and select Dynatrace API.
- In the Select a definition field, select Grail - Storage Record Deletion.
- Authenticate with your API token.
For details, see Authentication. - Perform one of the following actions.
| To do this | Go to Record Delete and select this |
|---|---|
Cancel running process | POST/delete:cancel |
Start new deletion process | POST/delete:execute |
Get status of currently running process | POST/delete:status |
To delete your records, you need to use the /delete:execute endpoint and a DQL query which can contain the following commands and functions.
| Available DQL commands | Available DQL functions |
|---|---|
|
|
Record deletion is final and can't be undone.
Record deletion permissions
To delete the records, the policy bound to your user group must contain the following permissions:
storage:records:deletestorage:events:readstorage:logs:readstorage:bizevents:readstorage:spans:read
If you don't have these permissions, you'll get a 403 error.
To learn more about permissions, see IAM policies.
Limitations
To avoid excessive deletions on a large volume of records, we introduced the following limitations.
- You can have 1 deletion in progress per tenant.
- The timeframe for record deletion is 24 hours.
- The end of the timeframe must be at least 4 hours prior to the time of record deletion.