Add AssetId slicer, clarity edits

Author: baanders

articles/iot-operations/get-started-end-to-end-sample/media/quickstart-get-insights/add-parameter.png

@@ -6,7 +6,7 @@ ms.author: baanders
 ms.topic: quickstart
 ms.custom:
   - ignite-2023
-ms.date: 08/05/2024
+ms.date: 10/01/2024
 
 #CustomerIntent: As an OT user, I want to create a visual report for my processed OPC UA data that I can use to analyze and derive insights from it.
 ---
@@ -27,7 +27,7 @@ Before you begin this quickstart, you must complete the following quickstarts:
 - [Quickstart: Add OPC UA assets to your Azure IoT Operations Preview cluster](quickstart-add-assets.md)
 - [Quickstart: Send asset telemetry to the cloud using a dataflow](quickstart-upload-telemetry-to-cloud.md)
 
-You also need a Microsoft Fabric subscription. In your subscription, you need access to a **premium workspace** with **Contributor** or above permissions.
+You also need a Microsoft Fabric subscription. In your subscription, you need access to a workspace with **Contributor** or above permissions.
 
 Additionally, your Fabric tenant must allow the creation of Real-Time Dashboards. This is a setting that can be enabled by your tenant administrator. For more information, see [Enable tenant settings in the admin portal](/fabric/real-time-intelligence/dashboard-real-time-create#enable-tenant-settings-in-the-admin-portal).
 
@@ -45,7 +45,7 @@ In this section, you create an eventstream that will be used to bring your data
 
 Start by navigating to the [Real-Time Intelligence experience in Microsoft Fabric](https://msit.powerbi.com/home?experience=kusto).
 
-Follow the steps in [Create an eventstream in Microsoft Fabric](/fabric/real-time-intelligence/event-streams/create-manage-an-eventstream?pivots=enhanced-capabilities) to create a new eventstream from the Real-Time Intelligence capabilities.
+Follow the steps in [Create an eventstream in Microsoft Fabric](/fabric/real-time-intelligence/event-streams/create-manage-an-eventstream?pivots=standard-capabilities#create-an-eventstream-1) to create a new eventstream from the Real-Time Intelligence capabilities.
 
 After the eventstream is created, you'll see the main editor where you can start adding sources to the eventstream.
 
@@ -55,10 +55,12 @@ After the eventstream is created, you'll see the main editor where you can start
 
 Next, add your event hub from the previous quickstart as a data source for the eventstream.
 
-Follow the steps in [Add Azure Event Hubs source to an eventstream](/fabric/real-time-intelligence/event-streams/add-source-azure-event-hubs?pivots=enhanced-capabilities) to add the event source. Keep the following notes in mind:
+Follow the steps in [Add Azure Event Hubs source to an eventstream](/fabric/real-time-intelligence/event-streams/add-source-azure-event-hubs?pivots=standard-capabilities#add-an-azure-event-hub-as-a-source) to add the event source. Keep the following notes in mind:
 
-- When it's time to select a **Data format**, choose *Json* (it might be selected already by default).
-- Make sure to complete all the steps in the article through selecting **Publish** on the ribbon.
+- You'll be creating a new cloud connection with Shared Access Key authentication.
+    - Make sure local authentication is enabled on your event hub. You can set this from its Overview page in the Azure portal.
+- For **Consumer group**, use the default selection (*$Default*).
+- For **Data format**, choose *Json* (it might be selected already by default).
 
 After completing this flow, the Azure event hub is visible in the eventstream live view as a source.
 
@@ -83,7 +85,7 @@ In this section, you create a KQL database in your Microsoft Fabric workspace to
 
 1. Follow the steps in [Create an eventhouse](/fabric/real-time-intelligence/create-eventhouse#create-an-eventhouse-1) to create a Real-Time Intelligence eventhouse with a child KQL database. You only need to complete the section entitled **Create an eventhouse**.
 
-1. Next, create a KQL table in your database. Call it *OPCUA* and use the following columns.
+1. Next, create a table in your database. Call it *OPCUA* and use the following columns.
 
     | Column name | Data type |
     | --- | --- |
@@ -106,7 +108,7 @@ In this section, you create a KQL database in your Microsoft Fabric workspace to
 
 Next, return to your eventstream view, where you can add your new KQL table as an eventstream destination.
 
-Follow the steps in [Add a KQL Database destination to an eventstream](/fabric/real-time-intelligence/event-streams/add-destination-kql-database?pivots=enhanced-capabilities#direct-ingestion-mode) to add the destination. Keep the following notes in mind:
+Follow the steps in [Add a KQL Database destination to an eventstream](/fabric/real-time-intelligence/event-streams/add-destination-kql-database?pivots=standard-capabilities#direct-ingestion-mode) to add the destination. Keep the following notes in mind:
 
 - Use direct ingestion mode.
 - On the **Configure** step, select the *OPCUA* table that you created earlier.
@@ -129,7 +131,7 @@ If you want, you can also view and query this data in your KQL database directly
 
 ## Create a Real-Time Dashboard
 
-In this section, you'll create a new [Real-Time Dashboard](/fabric/real-time-intelligence/dashboard-real-time-create) to visualize your quickstart data. The dashboard will automatically allow filtering by timestamp, and will display visual summaries of temperature and humidity data.
+In this section, you'll create a new [Real-Time Dashboard](/fabric/real-time-intelligence/dashboard-real-time-create) to visualize your quickstart data. The dashboard will allow filtering by asset ID and timestamp, and will display visual summaries of temperature and humidity data.
 
 >[!NOTE]
 >You can only create Real-Time Dashboards if your tenant admin has enabled the creation of Real-Time Dashboards in your Fabric tenant. For more information, see [Enable tenant settings in the admin portal](/fabric/real-time-intelligence/dashboard-real-time-create#enable-tenant-settings-in-the-admin-portal).
@@ -142,19 +144,46 @@ Then, follow the steps in the [Add data source](/fabric/real-time-intelligence/d
 
 - In the **Data sources** pane, your database will be under **OneLake data hub**.
 
+### Configure parameters
+
+Next, configure some parameters for your dashboard so that the visuals can be filtered by asset ID and timestamp. The dashboard comes with a default parameter to filter by time range, so you only need to create one that can filter by asset ID.
+
+1. Switch to the **Manage** tab, and select **Parameters**. Select **+ Add** to add a new parameter.
+
+    :::image type="content" source="media/quickstart-get-insights/add-parameter.png" alt-text="Screenshot of adding a parameter to a dashboard.":::
+
+1. Create a new parameter with the following characteristics:
+    * **Label**: *Asset*
+    * **Parameter type**: *Single selection* (already selected by default)
+    * **Variable name**: *_asset*
+    * **Data type**: *string* (already selected by default)
+    * **Source**: *Query*
+        * **Data source**: Your database (already selected by default)
+        * Select **Edit query** and add the following KQL query.
+
+            ```kql
+            OPCUA
+            | summarize by AssetId
+            ```
+    * **Value column**: *AssetId*
+    * **Default value**: *Select first value of query*
+
+1. Select **Done** to save your parameter.
+
 ### Create line chart tile
 
-Next, add a tile to your dashboard to show a line chart of temperature and humidity over time for the selected time range.
+Next, add a tile to your dashboard to show a line chart of temperature and humidity over time for the selected asset and time range.
 
 1. Select either **+ Add tile** or **New tile** to add a new tile.
 
     :::image type="content" source="media/quickstart-get-insights/add-tile.png" alt-text="Screenshot of adding a tile to a dashboard.":::
 
-1. Enter the following KQL query for the tile. This query applies a built-in filter parameter from the dashboard selector for time range, and pulls the resulting records with their timestamp, temperature, and humidity.
+1. Enter the following KQL query for the tile. This query applies filter parameters from the dashboard selectors for time range and asset, and pulls the resulting records with their timestamp, temperature, and humidity.
 
     ```kql
     OPCUA 
     | where Timestamp between (_startTime.._endTime)
+    | where AssetId == _asset
     | project Timestamp, Temperature, Humidity
     ```
 
@@ -188,11 +217,12 @@ Next, create some tiles to display the maximum values of temperature and humidit
 
 1. Select **New tile** to create a new tile.
 
-1. Enter the following KQL query for the tile. This query applies a built-in filter parameter from the dashboard selector for time range, and takes the highest temperature value from the resulting records.
+1. Enter the following KQL query for the tile. This query applies filter parameters from the dashboard selectors for time range and asset, and takes the highest temperature value from the resulting records.
 
     ```kql
     OPCUA
     | where Timestamp between (_startTime.._endTime)
+    | where AssetId == _asset
     | top 1 by Temperature desc
     | summarize by Temperature
     ```
@@ -225,6 +255,7 @@ Next, create some tiles to display the maximum values of temperature and humidit
     ```kql
     OPCUA
     | where Timestamp between (_startTime.._endTime)
+    | where AssetId == _asset
     | top 1 by Humidity desc
     | summarize by Humidity
     ```