Oracle logo

Oracle Management Cloud – sendQuick Cloud Integration Guide

Version 1.0

Download

1.1 About TalariaX Pte Ltd

TalariaX™ develops and offers enterprise mobile messaging solutions to facilitate and improve business workflow and communication, and is widely used in areas such as IT alerts & notifications, secure remote access via 2-Factor Authentication, emergency & broadcast messaging, business process automation and system availability monitoring.

In addition to functionality, TalariaX’s messaging solutions have also been developed with other key features in mind. These include security and confidentiality of company information, and ease in mitigating disruption during unplanned system downtime such as that arising from cyberattacks.

1.2 About sendQuick Cloud

sendQuick Cloud is a cloud based Software-as-a-Service (Saas) application to monitor and notify for cloud based incidents with omni-channel messaging capability. It has ability to monitor using ICMP Ping, Port check and URL check. It has policy based notifications using Email and Webhook, supporting any applications as well as Cloud Providers like AWS, Azure, Alibaba Cloud, Google Cloud and Oracle. Given the above integration methods, sendQuick Cloud is able to work with any applications to send notifications. Supporting notification channels include SMS, Telegram, Slack, Facebook Messenger and others. Lastly, there is Roster for messaging based on duties and time frame for each recipients, reducing alert fatigue.

1.3 Purpose of Document

This document is a guide on how to integrate sendQuick Cloud with Oracle Management Cloud (Oracle) to send message notifications and alerts. In this guide, we will be using sendQuick Cloud for the integration.

Oracle Management Cloud is accessible from the Oracle Cloud Portal. You will need to login to Oracle Cloud Portal and select Platform Services > Management Cloud and is presented with all the Oracle Management Cloud options. Select Administration > Notification Channels. You will need to configure the Notifications function as found in the Right of the Web Interface and shown in the diagram below.

Oracle Management Cloud – sendQuick Cloud Integration Guide

Oracle Management Cloud – sendQuick Cloud Integration Guide

Oracle Management Cloud – sendQuick Cloud Integration Guide

Oracle Management Cloud – sendQuick Cloud Integration Guide

In Oracle, you can send Alert via Email (SMTP) and Webhook (HTTP) method. This document will explain both methods in details in the following sections.

sendQuick Cloud (sendQuick) is designed to complement the systems, virtual instances, devOps and other applications on the cloud for sending message notifications when an event happen. This will your services uptime for your cloud services.

2.1  Email Filters in sendQuick Cloud

sendQuick can receive any emails (SMTP) from any applications, apply the configured filters (policies) and if the condition matches, messages will be sent to the recipients. When starting to configure, create an account in sendQuick and go to Email Filter (left Menu) and Create New Mail Filter Rule. You will be presented with the interface as shown below.

You will notice the Email Address TO as the first Policy item. The email address is pre-assigned by sendQuick and will follow the name of your account name. This email address cannot be changed and will be used to configure in Cloud Monitor as explained in section 3.1.

Oracle Management Cloud – sendQuick Cloud Integration Guide
Email Address TO, sending to sendQuick Cloud

2.2  Cloud Provider in sendQuick Cloud using Webhook

The second method to integrate between Cloud Monitor and sendQuick is using Webhook method. This is via an Application Programming Interface (API) where the event information is sent to sendQuick and sendQuick will process and check against the pre-configured policies (conditions). If the conditions are met, it will trigger an alert to the assigned users.

In summary, the flow is as below:

Oracle Management Cloud – sendQuick Cloud Integration Guide

The webhook to send to sendQuick is found on the Service Configuration for Cloud Provider in sendQuick. This is depicted in interface below.

 Oracle Management Cloud – sendQuick Cloud Integration Guide

Chose the Cloud Provider as shown on the left Menu in the diagram above.

Copy the Integration URL as shown on the top of the Integration page. This is the URL to be configured in Azure Action as shown in section 4.0.

Oracle Management Cloud – sendQuick Cloud Integration Guide

When any event happens or there is a need to send a notification alert, Oracle Notification Channel (Oracle) can trigger an email and Webhook to sendQuick Cloud (sendQuick). sendQuick will then convert the email message and Webhook to alerts and send to mobile phone based on the policy (filter) rules assigned. The email messages and webhook are sent from Oracle to sendQuick for processing.

In Oracle, the first configuration is to configure the Notification Channel, creating the recipient list to receive the notifications. Since sendQuick is used to manage the recipients on the different channels, you just need to configure one (1) email  and one (1) webhook for Oracle. This is explained below.

3.1  Configure Email and Webhook for sendQuick in Oracle

In Oracle, select Create Notification Channel and choose Email or Webhook. These are shown in the Figures below.

Oracle Management Cloud – sendQuick Cloud Integration Guide

Create Notification Channel

Oracle Management Cloud – sendQuick Cloud Integration Guide

We will configure Email first. Select Email in the above Figure and you will see the Fugure below. Assign a name, insert the email address (from Email Filter rules in sendQuick Cloud) and set the language and timezone. Then select Create.

Oracle Management Cloud – sendQuick Cloud Integration Guide

You need to verify and confirm the email address first before the email can be used. The email will be sent to sendQuick Cloud system and you can view the Oracle email in sendQuick Cloud, under Email Filter and Inbox. The steps to verify the email is shown below.

Oracle Management Cloud – sendQuick Cloud Integration Guide

Oracle Management Cloud – sendQuick Cloud Integration Guide

Once you select the Oracle email, you will see the Email content, Click on Confirm Subscription and the Confirmation Page will be shown. Once it is confirmed, you can use the Email notification from Oracle.

Oracle Management Cloud – sendQuick Cloud Integration Guide

You can repeat the same process (in creating email to create a Webhook), select Webhook and complete the information in Figure below. The URL is obtained from sendQuickCloud in Section 2.2 above.

Oracle Management Cloud – sendQuick Cloud Integration Guide

Oracle Management Cloud – sendQuick Cloud Integration Guide

For Webhook, we need to insert the payload for Oracle to send messages to sendQuick. The payload details as below. This is to complete the JSON payload when data is sent to sendQuick. The last two items (in blue), company name and key is obtained from sendQuickCloud Integration page in Section 2.2 above.

Payload:

{
“alertId”:”${alert.id}”,
“ruleName”:”${rule.ruleName}”,
“conditionName”:”${rule.conditionName}”,
“updateType”:”${updateType}”,
“message”:”${alert.message}”,
“severity”:”${alert.severity}”,
“time”:”${alert.time}”,
“eventName”:”${alert.eventName}”,
“alertDetailUrl”:”${alert.detailUiUrl}”,
“entityId”:”${entity.id}”,
“entityName”:”${entity.name}”,
“entityType”:”${entity.type}”,
“entityDisplayName”:”${entity.displayName}”,
“entityHostName”:”${entity.hostName}”,
“coy”:”democompany”,
“key”:”e42a79c7546b33fa00a52bcec59ae4b196bd6b3823f5daafd2a93a8ff4db5738″

}

Once completed, select Create and the webhook is created. The Notification Channels summary as shown below.

Oracle Management Cloud – sendQuick Cloud Integration Guide

In Oracle, the configuration for Email (SMTP) and webhook is configured in the same Alert rule. Hence, this section will explain both methods in the same configuration.

In the Left Menu, Administration select Alert Rules > Services (select Monitoring) and Create Alert Rule and you will see the interface to configure the rule as below.

Oracle Management Cloud – sendQuick Cloud Integration Guide

Provide a Rule Name and Enable the Rule. Then you can alert based on entity types or individual entities, In this example, we are configuring based on Individual Entity. Choose the entity that you are monitoring to send alerts. This is shown below

Oracle Management Cloud – sendQuick Cloud Integration Guide

You can select the Add Condition, and set the condition for the alert or threshold. Set the relevant value (eg, Warning and Critical) as seen below.

Oracle Management Cloud – sendQuick Cloud Integration Guide

Next select the Use Custom Message and insert the formatted text in all the three message box (Warning, Critical and Clear). This will ensure the data values are sent over to sendQuick when the event happens. This is shown below and the text is display below as well.

{“metric”:”CPUUtilization”,”actualValue”:”%{sys.value}%”,”operator”:”%{sys.operator}%”,”warningThreshold”:”%{sys.warningThreshold}%”,”criticalThreshold”:”%{sys.criticalThreshold}%”}

Oracle Management Cloud – sendQuick Cloud Integration Guide

Use Custom Message Configuration

Then, select Notifications and you can choose to send using Email or Integration (webhook). Since we had configured the various Notification Channels earlier, the item are ready for selection in the next two Figures below.

Oracle Management Cloud – sendQuick Cloud Integration Guide

Oracle Management Cloud – sendQuick Cloud Integration Guide

Once this is completed, select Save at the top right corner and you will see a summary of Alert Rules as displayed below.

Oracle Management Cloud – sendQuick Cloud Integration Guide

Alert Rules Summary

You can create more rules, as desired and use either Email or webhook to send the notifications to sendQuick.

Upon completion, you can start using sendQuick Cloud and configure all the filter/policies and user roster to receive the alerts on their phones. For more sendQuick Cloud configuration, refer to sendQuick Cloud User Manual or Video Tutorial.