Creating a Trigger

Prev Next

DataEngine functions are triggered by events. Create triggers to define which events to watch for. A trigger can either produce events on a schedule or watch for events related to objects in a bucket. You can build triggers into a pipeline and so that they trigger functions.

  1. From the left navigation menu, select Manage Elements (ManageElementsMenuIcon.png) and then Triggers.

  2. Click Create New Trigger.

  3. Enter a name for the trigger in the Trigger Name field.

  4. In the Trigger Type dropdown, select the type of trigger you want to create:

    • Element. A trigger that watches for events related to elements in a source view.  

    • Schedule. A trigger that produces events on a schedule.

  5. Complete the relevant fields:

    • If you selected Element as the Trigger Type:

      Description

      A description for the trigger.

      Source view

      From the dropdown, select the view in which the events will occur. The dropdown lists all S3 bucket views on the local VAST Cluster tenant to which you have permission to access.

      Event type

      From the dropdown, select a type of event.

      • ElementCreated. The creation of an element in the source view.

      • ElementDeleted. The deletion of an element from the source view.

      • ElementTagCreated. The creation of a tag on an element in the source view.  

      • ElementTagDeleted. The deletion of a tag on an element in the source view.

      Note

      You will be able to restrict the relevant elements by object key prefix and suffix.

      Source type

      The type of elements that register events for the trigger. This is restricted to S3 objects in the current version. Therefore, the field is read only and displays S3.

      Destination

      Target Event Broker View

      From the dropdown, select the view that hosts the VAST Event Broker to use to stream events for the trigger.  

      Topic

      From the dropdown, select the event broker topic that should be used.

      Filters

      Object Key Filters

      To filter elements by suffix or prefix, enter a prefix and/or a suffix. The event type definition will be restricted to objects with the specified prefix and/or suffix in their object keys.

      Custom Extensions

      Use this field to add key-value pairs to be passed as event output extensions. Each key can contain only lowercase letters and digits, must start with a letter, and must be 1-20 characters long.

      Tags

      Use this field to tag the trigger.

      To add a tag, click Add Tags, enter a key-value pair in the fields provided and then click Add to Tags.

    • If you selected Schedule as the Trigger Type:

      Description

      A description for the trigger.

      Destination

      Target Kafka View

      From the dropdown, select the view that hosts the VAST Event Broker to use to stream events for the trigger.  

      Topic

      From the dropdown, select the event broker topic that should be used.

      Schedule

      Do either of the following to define a schedule for the trigger:

      • Select Simple and use the fields provided to enter a frequency.

      • Select Advanced to type the schedule in Quartz syntax.

      Custom Extensions

      Use this field to add key-value pairs to be passed as event output extensions. Each key can contain only lowercase letters and digits, must start with a letter, and must be 1-20 characters long.

      Tags

      Optionally add tags to the trigger. To add a tag, click Add Tags, enter a key-value pair in the fields provided and then click Add to Tags.  

  6. Click Create Trigger.

    The trigger is created and is listed in the Triggers page.