update alerts docs

Author: mamccrea

articles/stream-analytics/media/stream-analytics-job-diagnostic-logs/diagnostic-logs-monitoring.png

@@ -7,12 +7,12 @@ ms.author: jeanb
 ms.reviewer: jasonh
 ms.service: stream-analytics
 ms.topic: conceptual
-ms.date: 12/07/2018
+ms.date: 01/10/2018
 ms.custom: seodec18
 ---
 # Troubleshoot Azure Stream Analytics by using diagnostics logs
 
-Occasionally, an Azure Stream Analytics job unexpectedly stops processing. It's important to be able to troubleshoot this kind of event. The event might be caused by an unexpected query result, by connectivity to devices, or by an unexpected service outage. The diagnostics logs in Stream Analytics can help you identify the cause of issues when they occur, and reduce recovery time.
+Occasionally, an Azure Stream Analytics job unexpectedly stops processing. It's important to be able to troubleshoot this kind of event. The event might be caused by an unexpected query result, by connectivity to devices, or by an unexpected service outage. The diagnostics logs in Stream Analytics can help you identify the cause of issues when they occur and reduce recovery time.
 
 ## Log types
 
@@ -24,17 +24,17 @@ Stream Analytics offers two types of logs:
 > You can use services like Azure Storage, Azure Event Hubs, and Azure Log Analytics to analyze nonconforming data. You are charged based on the pricing model for those services.
 >
 
-## Turn on diagnostics logs
+## Send diagnostics to Log Analytics
 
 Diagnostics logs are **off** by default. To turn on diagnostics logs, complete these steps:
 
-1.  Sign in to the Azure portal, and go to the streaming job blade. Under **Monitoring**, select **Diagnostics logs**.
+1.  Sign in to the Azure portal, and navigate to your Stream Analytics job. Under **Monitoring**, select **Diagnostics logs**. Then select **Turn on diagnostics**.
 
     ![Blade navigation to diagnostics logs](./media/stream-analytics-job-diagnostic-logs/diagnostic-logs-monitoring.png)  
 
-2.  Select **Turn on diagnostics**.
+2.  Create a **Name** in **Diagnostic settings** and check the box next to **Send to Log Analytics**. Then add an existing or create a new **Log analytics workspace**. Check the boxes for **Execution** and **Authoring** under **LOG**.
 
-    ![Turn on Stream Analytics diagnostics logs](./media/stream-analytics-job-diagnostic-logs/turn-on-diagnostic-logs.png)
+    ![Settings for diagnostics logs](./media/stream-analytics-job-diagnostic-logs/diagnostic-settings.png)
 
 3.  On the **Diagnostics settings** page, for **Status**, select **On**.
 

articles/stream-analytics/media/stream-analytics-job-diagnostic-logs/diagnostic-settings.png

@@ -7,37 +7,60 @@ ms.author: jeanb
 ms.reviewer: mamccrea
 ms.service: stream-analytics
 ms.topic: conceptual
-ms.date: 12/07/2018
+ms.date: 01/10/2019
 ms.custom: seodec18 
 ---
 # Set up alerts for Azure Stream Analytics jobs
-You can set up alerts to trigger an alert when a metric reaches a condition that you specify. For example, you might set up an alert for a condition like the following:
 
-`If there are zero input events in the last 5 minutes, send email notification to sa-admin@example.com`
+It is important to monitor your Azure Stream Analytics job to ensure the job is running continuously without any problems. This article describes how to set up alerts for common scenarios that should be monitored. 
 
 Rules can be set up on metrics through the portal, or can be configured [programmatically](https://code.msdn.microsoft.com/windowsazure/Receive-Email-Notifications-199e2c9a) over Operation Logs data.
 
 ## Set up alerts in the Azure portal
-1. In the Azure portal, open the Stream Analytics job you want to create an alert for. 
 
-2. In the **Job** blade, click the **Monitoring** section.  
+1. In the Azure portal, open the Stream Analytics job you want to create an alert for.
 
-3. In the **Metric** blade, click the **Add alert** command.
+2. On the **Job** page, navigate to the the **Monitoring** section.  
 
-      ![Azure portal Stream Analytics alerts setup](./media/stream-analytics-set-up-alerts/06-stream-analytics-set-up-alerts.png)  
+3. Select **Metrics**, and then click **New alert rule**.
 
-4. Enter a name and a description.
+   ![Azure portal Stream Analytics alerts setup](./media/stream-analytics-set-up-alerts/stream-analytics-set-up-alerts.png)  
 
-5. Use the selectors to define the condition under which the alert will be sent.
+4. Your Stream Analytics job name should automatically appear under **RESOURCE**. Click **Add condition**, and select **All Administrative operations** under **Configure signal logic**.
 
-6. Provide information about where the alert should go.
+   ![Select signal name for Stream Analytics alert](./media/stream-analytics-set-up-alerts/stream-analytics-condition-signal.png)  
 
-      ![Setting up an alert for an Azure Streaming Analytics job](./media/stream-analytics-set-up-alerts/stream-analytics-add-alert.png)  
+5. Under **Configure signal logic**, change **Event Level** to **All** and change **Status** to **Failed**. Leave **Event initiated by** blank and click **Done**.
 
-For more detail on configuring alerts in the Azure portal, see [Receive alert notifications](../monitoring-and-diagnostics/insights-receive-alert-notifications.md).  
+   ![Configure signal logic for Stream Analytics alert](./media/stream-analytics-set-up-alerts/stream-analytics-configure-signal-logic.png) 
+
+6. Select an existing action group or create a new group. In this example, a new action group called **TIDashboardGroupActions** was created with an **Emails** action that sends an email to users with the **Owner** Azure Resource Manager Role.
+
+   ![Setting up an alert for an Azure Streaming Analytics job](./media/stream-analytics-set-up-alerts/stream-analytics-add-group-email-action.png)
+
+7. The **RESOURCE**, **CONDITION**, and **ACTION GROUPS** should each have an entry.
+
+   ![Create Stream Analytics alert rule](./media/stream-analytics-set-up-alerts/stream-analytics-create-alert-rule-2.png)
+
+   Add an **Alert rule name**, **Description**, and your **Resource Group** to the **ALERT DETAILS** and click **Create alert rule** to create the rule for your Stream Analytics job.
 
+   ![Create Stream Analytics alert rule](./media/stream-analytics-set-up-alerts/stream-analytics-create-alert-rule.png)
+
+## Scenarios to monitor
+
+The following alerts are recommended for monitoring the performance of your Stream Analytics job. These metrics should be evaluated every minute over the last 5-minute period. If your job suffers from performance issues, you can leverage query parallelization to make it more optimal and try increasing the number of streaming units.
+
+|Metric|Condition|Time Aggregation|Threshold|Corrective Actions|
+|-|-|-|-|-|
+|SU% Utilization|Greater than|Maximum|80|There are multiple factors that increase SU% Utilization. You can scale with query parallelization or increase the number of streaming units.|
+|Runtime errors|Greater than|Total|0|Examine the activity or diagnostic logs and make appropriate changes to the inputs, query or outputs.|
+|Watermark delay|Greater than|Maximum|When average value of this metric over the last 15 minutes is greater than late arrival tolerance (in seconds). If you have not modified the late arrival tolerance, the default is set to 5 seconds.|Try increasing the number of SUs or parallelizing your query.|
+|Input deserialization errors|Greater than|Total|0|Examine the activity or diagnostic logs and make appropriate changes to the input.|
 
 ## Get help
+
+For more detail on configuring alerts in the Azure portal, see [Receive alert notifications](../monitoring-and-diagnostics/insights-receive-alert-notifications.md).  
+
 For further assistance, try our [Azure Stream Analytics forum](https://social.msdn.microsoft.com/Forums/azure/home?forum=AzureStreamAnalytics)
 
 ## Next steps