Merge pull request #221193 from v-jbasden/jbasden-add-workbooks-content

Adding workbooks content

Author: prmerger-automator[bot]

articles/azure-monitor/visualize/workbooks-create-workbook.md

@@ -125,6 +125,52 @@ To add a query to an Azure Workbook:
       ```
 
    In this case, the query returns no rows if the **AzureDiagnostics** table is missing, or if the **ResourceId** column is missing from the table.
+
+### Tutorial - resource centric logs queries in workbooks
+
+This video shows you how to use resource level logs queries in Azure Workbooks. It also has tips and tricks on how to enable advanced scenarios and improve performance.
+
+[![Making resource centric log queries in workbooks](https://img.youtube.com/vi/8CvjM0VvOA8/0.jpg)](https://youtu.be/8CvjM0VvOA8 "Video showing how to make resource centric log queries in workbooks")
+
+#### Dynamic resource type parameter
+Uses dynamic scopes for more efficient querying. The snippet below uses this heuristc:
+1. _Individual resources_: if the count of selected resource is less than or equal to 5
+2. _Resource groups_: if the number of resources is over 5 but the number of resource groups the resources belong to is less than or equal to 3
+3. _Subscriptions_: otherwise
+
+```
+Resources
+| take 1
+| project x = dynamic(["microsoft.compute/virtualmachines", "microsoft.compute/virtualmachinescalesets", "microsoft.resources/resourcegroups", "microsoft.resources/subscriptions"])
+| mvexpand x to typeof(string)
+| extend jkey = 1
+| join kind = inner (Resources 
+| where id in~ ({VirtualMachines})
+| summarize Subs = dcount(subscriptionId), resourceGroups = dcount(resourceGroup), resourceCount = count()
+| extend jkey = 1) on jkey
+| project x, label = 'x', 
+      selected = case(
+        x in ('microsoft.compute/virtualmachinescalesets', 'microsoft.compute/virtualmachines') and resourceCount <= 5, true, 
+        x == 'microsoft.resources/resourcegroups' and resourceGroups <= 3 and resourceCount > 5, true, 
+        x == 'microsoft.resources/subscriptions' and resourceGroups > 3 and resourceCount > 5, true, 
+        false)
+```
+#### Static resource scope for querying multiple resource types
+```json
+[
+    { "value":"microsoft.compute/virtualmachines", "label":"Virtual machine", "selected":true },
+    { "value":"microsoft.compute/virtualmachinescaleset", "label":"Virtual machine scale set", "selected":true }
+]
+```
+#### Resource parameter grouped by resource type
+```
+Resources
+| where type =~ 'microsoft.compute/virtualmachines' or type =~ 'microsoft.compute/virtualmachinescalesets' 
+| where resourceGroup in~({ResourceGroups}) 
+| project value = id, label = id, selected = false, 
+      group = iff(type =~ 'microsoft.compute/virtualmachines', 'Virtual machines', 'Virtual machine scale sets') 
+```
+
 ## Add parameters
 
 You can collect input from consumers and reference it in other parts of the workbook using parameters. Use parameters to scope the result set or to set the right visual. Parameters help you build interactive reports and experiences. For more information on how parameters can be used, see [workbook parameters](workbooks-parameters.md).

articles/azure-monitor/visualize/workbooks-data-sources.md

@@ -39,6 +39,12 @@ You can use Kusto query language (KQL) queries that transform the underlying res
 
 You can easily query across multiple resources to create a unified rich reporting experience.
 
+See also: [Log Analytics query optimization tips](../logs/query-optimization.md)
+
+See also: [Workbooks best practices and hints for logs queries](workbooks-create-workbook.md#best-practices-for-querying-logs)
+
+Tutorial: [Making resource centric log queries in workbooks](workbooks-create-workbook.md#tutorial---resource-centric-logs-queries-in-workbooks)
+
 ## Metrics
 
 Azure resources emit [metrics](../essentials/data-platform-metrics.md) that can be accessed via workbooks. Metrics can be accessed in workbooks through a specialized control that allows you to specify the target resources, the desired metrics, and their aggregation. You can then plot this data in charts or grids.
@@ -71,6 +77,8 @@ For the **Cluster Name** field, add the region name following the cluster name.
 
 ![Screenshot that shows Kusto query window.](./media/workbooks-data-sources/data-explorer.png)
 
+See also: [Azure Data Explorer query best practices](/azure/data-explorer/kusto/query/best-practices)
+
 ## JSON
 
 The JSON provider allows you to create a query result from static JSON content. It's most commonly used in parameters to create dropdown parameters of static values. Simple JSON arrays or objects will automatically be converted into grid rows and columns. For more specific behaviors, you can use the **Results** tab and JSONPath settings to configure columns.
@@ -112,6 +120,10 @@ Workbooks support these merges:
 * Union
 * Duplicate table
 
+### Merge examples
+
+[Using the Duplicate Table option to reuse queried data](workbooks-commonly-used-components.md#reuse-query-data-in-different-visualizations)
+
 ## Custom endpoint
 
 Workbooks support getting data from any external source. If your data lives outside Azure, you can bring it to workbooks by using this data source type.