Add doc for job diagram in VS

Author: sujie-ms

articles/stream-analytics/TOC.yml

@@ -176,6 +176,8 @@
       href: stream-analytics-live-data-local-testing.md
     - name: View jobs in Visual Studio
       href: stream-analytics-vs-tools.md
+    - name: Debug query step by step using job diagram 
+      href: stream-analytics-debug-locally-using-job-diagram.md
     - name: Develop an edge job
       href: stream-analytics-tools-for-visual-studio-edge-jobs.md
     - name: Set up CI/CD pipeline

articles/stream-analytics/media/vs-job-diagram/live-input.png

@@ -0,0 +1,115 @@
+---
+title: Debug Azure Stream Analytics query locally using job diagram in Visual Studio
+description: This article describes how to debug queries locally using job diagram in Azure Stream Analytics Tools for Visual Studio.
+author: su-jie
+ms.author: sujie
+ms.reviewer: mamccrea
+ms.service: stream-analytics
+ms.topic: conceptual
+ms.date: 01/9/2020
+---
+
+# Debug Azure Stream Analytics query locally using job diagram in Visual Studio
+
+Job outputing no result or unexpected result are common trouble shooting scenarios for streaming queries. You can use the job diagram while testing your query locally in Visual Studio to examine the intermediate result set and metrics for each step, to more quickly isolate the source of a problem when you trouble shoot issues.
+
+## Debug query step by step using job diagram
+
+An Azure Stream Analytics script represents the logic of transforming input data to output data. The job diagram is to show how data flows from input sources (Event Hub, IoT Hub, etc) through multiple query steps and finally output to sinks. Each query step is mapped to a temporary result set defined in the script using WITH statement. You can view the data as well as metrics in each query step in each intermediate result set to find the source of the issue.
+
+> [!NOTE]
+> This job diagram only shows the data and metrics for local testing in a single node. It should not be used for performance tuning and trouble shooting.
+
+### Start local testing
+
+Use this [Quickstart](stream-analytics-quick-create-vs.md) to learn how to create a Stream Analytics job using Visual Studio or [export an existing job to a local project](stream-analytics-vs-tools#export-jobs-to-a-project). If you want to test the query with local input data, follow this [instruction](stream-analytics-live-data-local-testing.md). Or if you want to test with live input, you can move to the next step.
+
+> [!NOTE]
+> If you export a job to local project and want to test against live input stream, you need to specify the credentials for all inputs again.  
+
+Choose the input and output source from the script editor and then click **Run locally**. Then the job diagram shows up on the right side.
+
+### View intermediate result set  
+
+#### Navigate to script
+
+Select the query step and it brings you to the corresponding script in the editor on the left.
+
+![Job diagram navigate script](./media/vs-job-diagram/navigate-script.png)
+
+#### Preview result set
+
+Select the query step and select **Preview** in the popped up dialog. The result set is shown in a tab in the bottom result window.
+
+![Job diagram preview result](./media/vs-job-diagram/preview-result.png)
+
+### View step metrics
+
+* **Input sources (Live stream)**
+
+   ![Job diagram live input sources](./media/vs-job-diagram/live-input.png)
+
+  * **TaxiRide**: The name of the input.
+  * **Event Hub**: Input source type.
+  * **Events**: The number of events read.
+  * **Backlogged Event Sources**: How many more messages need to be read for Event Hubs and IoT Hub inputs.
+  * **Events in Bytes**:The number of bytes read.
+  * **Degraded Events**:The count of events that had an issue other than with deserialization.
+  * **Early Events**: The number of events that have an application timestamp before the high watermark.
+  * **Late Events**: The number of events that have an application timestamp after the high watermark.
+  * **Event Sources**: The number of data units read. For example, the number of blobs.
+
+* **Input sources (Local input)**
+
+  ![Job diagram local input sources](./media/vs-job-diagram/local-input.png)
+
+  * **TaxiRide**: The name of the input.
+  * **Row Count**: The number of rows generated from the step.
+  * **Data Size**: The size of data generated from this step.
+  * **Local input**: Use local data as input.
+
+* **Query steps**
+
+  ![Job diagram query step](./media/vs-job-diagram/query-step.png)
+
+  * **TripData**: The name of the temporary result set.
+  * **Row Count**: The number of rows generated from the step.
+  * **Data Size**: The size of data generated from this step.
+  
+* **Output sinks** (Live output)
+
+  ![Job diagram local output sinks](./media/vs-job-diagram/live-output.png)
+
+   * **regionaggEH**: The name of the output.
+   * **Events**: The number of events output to sinks.
+
+* **Output sinks** (Local output)
+
+  ![Job diagram local output sinks](./media/vs-job-diagram/local-output.png)
+
+   * **regionaggEH**: The name of the output.
+   * **Local Output**: Result output to a local file.
+   * **Row Count**: The number of rows output to the local file.
+   * **Data Size**: The size of data output to the local file.
+
+### Close job diagram
+
+If you don't need the job diagram anymore, select **Close** on the top right corner. After closing the diagram window, you need to start local testing again to see it.
+
+### View job level metrics and stop running
+
+Other job level metrics shows up in the pop up console. Press Ctrl+C in the console if you want to stop the job.
+
+![Job diagram stop job](./media/vs-job-diagram/stop-job.png)
+
+## Limitations
+
+* Power BI and Azure Data Lake Storage Gen1 output sinks are not supported due to authentication model limitations.
+
+* Only cloud input options have [time policies](stream-analytics-out-of-order-and-late-events.md) support, while local input options do not.
+
+## Next steps
+
+* [Quickstart: Create a Stream Analytics job using Visual Studio](stream-analytics-quick-create-vs.md)
+* [Use Visual Studio to view Azure Stream Analytics jobs](stream-analytics-vs-tools.md)
+* [Test live data locally using Azure Stream Analytics tools for Visual Studio (Preview)](stream-analytics-live-data-local-testing.md)