Creating an Event Notifications topic

Creating a topic

1. Select Topics in the Event Notifications console.

2. Click Create, and enter the following topic details:

   • Name: enter a name for the topic.

   • Description: add an optional description for the topic.

   • Source: select a source from the list. Sources are of 3 types:

     • IBM Source
     • API Source
     • Periodic Timer Source

3. If your chosen source is an IBM Source:

   Add the following rules to your topic:

   • Event type: select event type from the list.
   • Event subtype: select event sub type from the event sub type list.
   • Severity: select severity from the severity list.
   • Advanced conditions: create your own custom conditions, which must follow JSONpath specifications. The correctly written rule will extract the appropriate data from the incoming request payload. Event Notifications supports conditional operators >=, <=, ==, >, <, !=, =~ and logical operators ||, && for JSONPath evaluation. You can validate your JSONPath here.

   The "=~" operator is a powerful tool that helps you search for patterns in strings using regular expressions.

   Example:

   {
   "data": {
      "details": [
         {
            "id": 1,
            "name": "Bob",
            "gender": "male",
            "age": 30,
            "country": "China"
         },
         {
            "id": 2,
            "name": "Alice",
            "gender": "female",
            "age": 25,
            "country": "India"
         },
         {
            "id": 3,
            "name": "Charlie",
            "gender": "male",
            "age": 35,
            "country": "USA"
         }
      ],
      "location": "London",
      "company": "IBM",
      "region": "london"
   }
   }
   

   Based on the previous JSON input, the following valid JSONPaths can be constructed:

      1. $.data.details[1].age >= 25
         Output: True
   
      2. $.data.details[0].name == "Bob"
         Output: True
   
      3. $.data.details[2].name != "unknown"
         Output: True
   
      4. $.data.details[0].name == "Bob" || $.data.location == "New york"
         Output: True
         
      5. $.data.details[1].age > 20 && $.data.company == "IBM"
         Output: True
   
      6. $.data.details[0].age <= 30  || $.data.details[1].id >= 3
         Output: True
   
      7. $.data.details[2].id < 4
         Output: True
   
      8. $.data.location == "London"
         Output: True
      
      9. $.data.region =~ "dallas|london|sydney"
         Output: True 
   
      10. $.data.details[?(@.country == "India")].name == "Alice"
         Output: True 
   

If your chosen source is an API source , then you can only add the "Advanced Conditions" rule to your topic.

If your chosen source is a Periodic Timer Source , then refer here for steps to set rules for your topic.

Step 2 created a topic, step 3 provisions optional custom rules for the topic.

1. Click Add a condition.

   If you do not select any rules, a default rule is added, which means all notifications route to the topic by default.

2. Click Create in the topic wizard.