Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Application Event Ingestion

Contrail Insights can ingest events from a registered application and perform alarms on them. You can register an application with Contrail Insights and specify the event IDs for which the application will be posting data. Upon successful registration, a token is given to the application. The application uses that token to post events to Contrail Insights for any of the event IDs registered. Alarms can be configured for these events.

Register an Application

To register an application:

  1. Select Settings in the top right of the Dashboard.

    Figure 1: Select Settings in the DashboardSelect Settings in the Dashboard
  2. Select AppFormix Settings, then click the Registered Applications tab. Click Add Application.

  3. Provide the Application Name and add all the Application Event IDs for which the application will be posting data by clicking +Add Event. Then click Setup.

    Figure 2: AppFormix Settings for Adding an Application and Application Event IDsAppFormix Settings for Adding an Application and Application Event IDs
  4. The Application appears as successfully added. It can be deleted by clicking the Trash icon.

    Figure 3: Successfully Added ApplicationSuccessfully Added Application

Application registration can also be achieved using the API:

Request:

url:

headers:

data:

Response:

Post Events for a Registered Application

After an application is configured, it can post events to Contrail Insights.

The data should be in the following format:

Request:

url:

headers:

data:

Response:

status code:

All the posted events are displayed on the UI in the Application Events page. From this page, in the right panel, select any application to toggle the displaying and hiding of events from that application.

Figure 4: Viewing Latest Application EventsViewing Latest Application Events

Alarms for Application Events

Alarms can be configured for any of the event IDs registered for the application.

Figure 5: Configuring Alarms for Application EventsConfiguring Alarms for Application Events

Alarm configuration using the API:

url:

data:

When the threshold configured in the alarm is exceeded, the triggered alarm is shown on the Alarms page in the UI.

Figure 6: Viewing Event Alarm on DashboardViewing Event Alarm on Dashboard

The alarm is also sent to Kafka with the topic being the alarm's name. For more information, see Contrail Insights with Kafka.