# Alerts ## Why an alerting service? Errors often occur in integrations, it can be anything from faulty data entry in the Source system, to time out or formatting issues in the Destination system. When an error occurs it is of upmost importance to understand that something has happened, what happened and why it happened for an end-user to easily address the issue. The HighCohesion alerting service is design to support in all of the above four steps, in real time and in granular detail on a Job and Event basis. ## What is the alerting service and how is it structured? The HighCohesion alerting service is configurable to fit every organisations specific needs, and alerts on three alert types: #### JOB: * This alert notifies the client about a failed job. #### EVENT\_TRANSFORMED: * This alert notifies the client about a failed event in the transformation process (CORE) #### EVENT\_DESTINATION: * This alert notifies the client about a failed event in the destination (SDF) **The alerts can easily be configurable by:** * Deciding who shall receive the email alerts * Selecting which Streams from the Organisation that should be included * Configuring a flood control based on count & time, to ensure the end-user does not get spammed with emails in case a high traffic Stream sees errors * Opt-in for daily or weekly alert reports with a summary of the alert count per Stream for a specific alert type ## Use cases See below illustration for an example: **Alert configuration settings**: \ **flood\_type = streamID**\ **flood\_count = 20**\ **flood\_time = 15\_MIN** **Scenario**: \ Simple Street Supplies sees the highest trading volume of the year during Black Friday. When the amount of orders peak, their FTP times out resulting in 53 events with alert\_type = Error (failed in destination), the 53 Events with error are all created within 5 seconds. **Alerting service output:** ![](/files/-MUTQ3GloVtcpbwfzz-C) ## Email alert templates ### JOB\_ERROR ![](/files/-MUTPubqw5a71JxZ4oAt) ### EVENT\_DESTINATION ERROR ![](/files/-MUU0VnZ8Zs_8M4I20-j) ### EVENT\_TRANSFORMATION ERROR ![](/files/-MUU0bcbwl503hQwCypy) {% hint style="info" %} The above templates are examples of emails that are sent to the end-user for the first time. If the email is triggered after having been retained by the flood control feature, a paragraph will be added on the top of the email outlining how many Jobs / Events failed before the email was triggered (e.g. the number of the flood\_count). See example below: {% endhint %} ![](/files/-MUTPjXd36zgXm4IFk7c) ## Alert report The alert report feature provides a holistic overview of all the alerts that have been triggered over the last **day** or **week** for a specific alert type (e.g. JOB ERROR, EVENT\_TRANSFORMATION ERROR or EVENT*\_*DESTINATION ERRROR. This is especially helpful for organisations that are using the Flood Control feature, too easily see the exact number of alerts triggered, per stream and alert type. A DAILY report will be sent every day at 16:00 UST A WEEKLY REPORT will be sent every Friday at 16:00 UST ### How can I easily differentiate an alert email from a report email? The alert report will be sent from . The subject line will always start with "DAILY/WEEKLY REPORT". ### **ALERT REPORT TEMPLATE** ![](/files/-MUTPdvRBJoYC6NrGgme) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.highcohesion.com/monitoring-streams/alerts.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.