Scheduling Enforcement Set Runs
  • 09 Jul 2023
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Scheduling Enforcement Set Runs

  • Dark
    Light
  • PDF

Article Summary

You can schedule an Enforcement Set to run at specified times and under certain conditions. This enables you to automate Enforcement Set runs. Scheduling criteria are available at the bottom of every Enforcement Set drawer.

EnforcementSetScheduling

To schedule an Enforcement Set run

  1. In the Edit Enforcement Set page, toggle on Set scheduling and set the parameters you want.
    • Repeat schedule run

      • Every global discovery cycle - The Enforcement Set will run on the same schedule as the global discovery cycle, at the end of the cycle. See Discovery Cycle for more information about Discovery Cycles.
        Note: The Enforcement Set runs during the last phase of the discovery cycle after adapter fetches are finished, even if they are not successful. You can enable the Only when following adapter connections successfully completed fetch earlier in discovery cycle option (see below) to ensure that the Enforcement Set runs only if the adapter fetches are completed successfully.

      • Every x hours - In Scheduled run every (hours), enter the hour interval for runs.

        ECSchedule-hours-fix

      • Every x days - In Scheduled run every (days), enter the day interval for runs.

        ECSchedule-days.png

      • Days of week - In Scheduled run day(s), a tile for each weekday is added by default. Click the x on the tile to remove a day. You can also click in the field and select or clear days from the list. The Enforcement Set will run only on the days whose tile appears.

        ECSchedule-daysofWeek.png

      • Days of month - In Scheduled run day(s), a tile for the first day of the month is added by default. Click in the field and select or clear days from the list. Tiles for selected days are added and tile for cleared days are removed. Click the x on the tile to remove a day. The Enforcement Set will run only on the days whose tile appears.

        ECSchedule-month.png

    • Scheduled run time - Click in the field and select a time from the list. The Enforcement Set will run on the days selected above and at the time selected here. If you have multiple Enforcement Sets, schedule them to run at different times to reduce network traffic.
      ECSchedule-time.png

    • Run on added entities only - When selected, the Enforcement Set is only run on assets discovered since the last global discovery cycle.

    • Run on top N results only - Run the Enforcement Set only on the first N assets that match the query. Sorting the query results may result in a different set of top N results.

    • Wait until cycle ends - Select this option to run the Enforcement Set only after a discovery cycle in progress has completed. This means that all Enforcement Sets with this option enabled and that were scheduled to start while the discovery cycle is in progress, are postponed to run at the end of the discovery cycle. Before choosing this option, decide whether running the Enforcement Set on up-to-date data significantly justifies delaying its execution.
      Use case example: An Enforcement Set that creates CMDB assets is scheduled to run daily at 11:00. Enabling the Wait until cycle ends option guarantees that this Enforcement Set runs after all assets are fully updated by all adapters and correlations.

Note:
The Wait until cycle ends option is not relevant when:

  • No discovery cycle is running at the scheduled trigger time of the Enforcement Set.
  • The Enforcement Set is configured to run at the end of Every global discovery cycle.
  • Only when following adapter connections successfully completed fetch earlier in discovery cycle - Select this option to run the Enforcement Set only if the adapter connections selected in the dropdown completed successfully their fetches. This ensures that the Enforcement Set runs on updated asset data. This option is available in one of these two cases:
    • If Repeat schedule run is set to Every global discovery cycle.
    • If Repeat schedule run is set to specific days or hours AND the Wait until cycle ends option is enabled.

EnforcementSetSchedulingAdapterFetchDropdown

Note:
When you enable the Only when following adapter connections successfully completed fetch earlier in discovery cycle option and select adapter connections from the dropdown, these adapter connections are remembered, even after you disable this option and then re-enable it.

  • Additional conditions - Select as many additional conditions as you need.

    • Only when assets have been added since the last execution - The Enforcement Set will run only when the asset count is higher than the previous run. If this is the first run, the Enforcement Set will run on all assets that match the Enforcement Set query.

    • Only when assets have been removed since the last execution - The Enforcement Set will run only when the asset count is less than the previous run. If this is the first run, the Enforcement Set will run on all assets that match the Enforcement Set query.

    • Only when the number of assets is above N - Enter a number in the text box that appears to the right. The Enforcement Set runs only when the asset count is above this number. When N is 0 (zero) and no assets match the query, the Enforcement Set is not run.

    • Only when the number of assets is below N - Enter a number in the text box that appears to the right. The Enforcement Set runs only when the asset count is below this number.


Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.