BeyondERP.Newsletter
Menu

Job page · System administration

Workload history data cleanup

A periodic job, titled Cleanup Cloud&Edge history data on its dialog, that belongs to the cloud and edge scale units of a distributed hybrid topology.

Business process
Administer system features
Menu item
action:SysWorkloadHistoryDataCleanup
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA periodic job, titled Cleanup Cloud&Edge history data on its dialog, that belongs to the cloud and edge scale units of a distributed hybrid topology.
What you do hereUse it, if your environment runs scale units, to run the clean-up of workload history data now or on a schedule in the background.
ExampleFor example, an environment with a warehouse scale unit has the clean-up run in the background by a user with the Scale unit administrator role.
Workload history data cleanup page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAdminister system features
Menu pathSystem administration › Periodic tasks › Workload history data cleanup
Set up firstBatch group Microsoft Learn
Used next byBatch jobs (check the run) Microsoft Learn
Related pagesMessage processor messages Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

When to run it

When to run itIn environments that run cloud or edge scale units.
How oftenAs a recurring background job.
Batch settingsRun in the background is the only section on the dialog.
What the output showsA batch job run that you check on Batch jobs.

Source: Checked in Dynamics 365

Setup steps on this page

Schedule the scale unit history clean-up

Run the workload history clean-up of cloud and edge scale units in the background.

How to use it

  1. Go to System administration > Periodic tasks > Workload history data cleanup. The Cleanup Cloud&Edge history data dialog opens.
  2. Expand Run in the background to run the clean-up as a batch job and set its recurrence.
  3. Select OK.
  4. Open Inquiries > Batch jobs and check that the job ended without errors.

Source: Checked in Dynamics 365

Fields on the page

FieldWhat it means
Run in the backgroundThe only section on the dialog: batch processing and recurrence for the clean-up.Checked in Dynamics 365
Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Schedule the scale unit history clean-upRun it only in environments with scale units, as a background job, after testing it in a test environmentLearn: cleanup routines should be run only after the business confirms the data is no longer required, and tested in a test environment first.Is the workload history clean-up scheduled?Scheduling it in environments without scale units, where it has nothing to do.Test: The clean-up runs in the background

Feature management and licence

Licence or add-inOn this system the page opens for Scale unit administrator and Hub scale unit admin. No Feature management feature needs to be turned on for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyApplies only where scale units are used: the dialog belongs to cloud and edge scale units, and on this system only Scale unit administrator and Hub scale unit admin can run it. Microsoft Learn
Can it be undoneNo: Treat it like other cleanup routines: run it only after you confirm the data is no longer required, and test it first. Microsoft Learn
If you change it laterMicrosoft advises running cleanup routines only after the business confirms the data is no longer required, and testing each one in a test environment before production. Microsoft Learn
Technical architect

6Technical

Menu itemaction:SysWorkloadHistoryDataCleanup Checked in Dynamics 365
Roles to set it up and use itTo use itScale unit administrator ScaleUnitRuntimeAdminHub scale unit admin Give people one of these roles. On this system, 2 roles can run this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=action:SysWorkloadHistoryDataCleanup
Data migrationLoad order: Workload history data cleanup has no data entity in Data management, so it can't be loaded from a file or a configuration template. It is a periodic job; schedule it again in each environment that runs scale units.Checked in Dynamics 365
Everyone

8Sources