Common schema and logic app documentation

Author: ananthradhakrishnan

articles/azure-monitor/platform/alerts-common-schema-integrations.md

@@ -0,0 +1,140 @@
+---
+title: How to integrate the common alert schema with Logic Apps 
+description: Learn how to create a logic app that leverages the common alert schema to handle all your alerts.
+author: anantr
+services: azure-monitor
+ms.service: azure-monitor
+ms.topic: conceptual
+ms.date: 05/27/2019
+ms.author: anantr
+ms.subservice: alerts
+---
+# How to integrate the common alert schema with Logic Apps
+
+This article shows you how to create a logic app that leverages the common alert schema to handle all your alerts.
+
+## Overview
+
+The [common alert schema](https://aka.ms/commonAlertSchemaDocs) provides a standardised and extensible JSON schema across all your different alert types. One of the best places to leverage this is through a logic app. You can now have a single logic app that handles all your alerts. The logic app described in this article creates well-defined variables for the ['essential' fields](https://docs.microsoft.com/azure/azure-monitor/platform/alerts-common-schema-definitions#essentials-fields), and also describes how you can handle [alert type]('https://docs.microsoft.com/azure/azure-monitor/platform/alerts-common-schema-definitions#alert-context-fields') specific logic.
+
+
+## Pre-requisites 
+
+This article assumes that the reader is familiar with 
+* Setting up alert rules ([metric](https://docs.microsoft.com/azure/azure-monitor/platform/alerts-metric), [log](https://docs.microsoft.com/azure/azure-monitor/platform/alerts-log), [activity log](https://docs.microsoft.com/azure/azure-monitor/platform/alerts-activity-log))
+* Setting up [action groups](https://docs.microsoft.com/azure/azure-monitor/platform/action-groups)
+* Enabling the [common alert schema](https://docs.microsoft.com/azure/azure-monitor/platform/alerts-common-schema#how-do-i-enable-the-common-alert-schema) from within action groups
+
+## Create a logic app leveraging the common alert schema
+
+1. Follow the steps outlined [here](https://docs.microsoft.com/azure/azure-monitor/platform/action-groups-logic-app) to create your logic app. 
+
+1.  Select the trigger: **When a HTTP request is received**.
+
+    ![Logic app triggers](media/action-groups-logic-app/logic-app-triggers.png "Logic app triggers")
+
+1.  Select **Edit** to change the HTTP request trigger.
+
+    ![HTTP request triggers](media/action-groups-logic-app/http-request-trigger-shape.png "HTTP request triggers")
+
+
+1.  Copy and paste the following schema:
+
+    ```json
+        {
+            "type": "object",
+            "properties": {
+                "schemaId": {
+                    "type": "string"
+                },
+                "data": {
+                    "type": "object",
+                    "properties": {
+                        "essentials": {
+                            "type": "object",
+                            "properties": {
+                                "alertId": {
+                                    "type": "string"
+                                },
+                                "alertRule": {
+                                    "type": "string"
+                                },
+                                "severity": {
+                                    "type": "string"
+                                },
+                                "signalType": {
+                                    "type": "string"
+                                },
+                                "monitorCondition": {
+                                    "type": "string"
+                                },
+                                "monitoringService": {
+                                    "type": "string"
+                                },
+                                "alertTargetIDs": {
+                                    "type": "array",
+                                    "items": {
+                                        "type": "string"
+                                    }
+                                },
+                                "originAlertId": {
+                                    "type": "string"
+                                },
+                                "firedDateTime": {
+                                    "type": "string"
+                                },
+                                "resolvedDateTime": {
+                                    "type": "string"
+                                },
+                                "description": {
+                                    "type": "string"
+                                },
+                                "essentialsVersion": {
+                                    "type": "string"
+                                },
+                                "alertContextVersion": {
+                                    "type": "string"
+                                }
+                            }
+                        },
+                        "alertContext": {
+                            "type": "object",
+                            "properties": {}
+                        }
+                    }
+                }
+            }
+        }
+    ```
+
+1. Select **+** **New step** and then choose **Add an action**.
+
+    ![Add an action](media/action-groups-logic-app/add-action.png "Add an action")
+
+1. At this stage, you can add a variety of connectors (Microsoft Teams, Slack, Salesforce, etc.) based on your specific business requirements. You can use the 'essential fields' out-of-the-box. 
+
+    ![Essential fields](media/alerts-common-schema-integrations/logic-app-essential-fields.png "Essential fields")
+    
+    Alternatively, you can author conditional logic based on the alert type using the 'Expression' option.
+
+    ![Logic app expression](media/alerts-common-schema-integrations/logic-app-expressions.png "Logic app expression")
+    
+     The ['monitoringService' field]('https://docs.microsoft.com/azure/azure-monitor/platform/alerts-common-schema-definitions#alert-context-fields') allows you to uniquely identify the alert type, based on which you can create the conditional logic.
+
+    
+    For example, the below snippet checks if the alert is a Application Insights based log alert, and if so prints the search results. Else, it prints 'NA'.
+
+    ```text
+      if(equals(triggerBody()?['data']?['essentials']?['monitoringService'],'Application Insights'),triggerBody()?['data']?['alertContext']?['SearchResults'],'NA')
+    ```
+    
+     You can learn more about writing logic app expressions [here](https://docs.microsoft.com/azure/logic-apps/workflow-definition-language-functions-reference#logical-comparison-functions).
+
+    
+
+
+## Next steps
+
+* [Learn more about action groups](../../azure-monitor/platform/action-groups.md).
+* [Learn more about the common alert schema](https://aka.ms/commonAlertSchemaDocs).
+