Skip to content

Commit 40c5fe4

Browse files
authored
Merge pull request #203860 from AbbyMSFT/workbooks
Workbooks updated ms. date on all articles
2 parents 75df4e4 + 3b99be3 commit 40c5fe4

34 files changed

+111
-113
lines changed

articles/azure-monitor/toc.yml

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1343,10 +1343,16 @@ items:
13431343
items:
13441344
- name: Overview
13451345
href: visualize/workbooks-overview.md
1346-
- name: Working with workbooks
1346+
- name: Getting started with workbooks
1347+
href: visualize/workbooks-getting-started.md
1348+
- name: Creating a workbook
13471349
items:
1348-
- name: Getting started with workbooks
1349-
href: visualize/workbooks-getting-started.md
1350+
- name: Using workbook templates
1351+
href: visualize/workbooks-templates.md
1352+
- name: Creating a new workbook
1353+
href: visualize/workbooks-create-workbook.md
1354+
- name: Workbook configuration options
1355+
href: visualize/workbooks-configurations.md
13501356
- name: Data sources
13511357
href: visualize/workbooks-data-sources.md
13521358
- name: Visualizations
@@ -1373,16 +1379,8 @@ items:
13731379
href: visualize/workbooks-composite-bar.md
13741380
- name: Renderers
13751381
href: visualize/workbooks-renderers.md
1376-
- name: Workbook result limits
1377-
href: visualize/workbooks-limits.md
1378-
- name: Creating a workbook
1379-
items:
1380-
- name: Using workbook templates
1381-
href: visualize/workbooks-templates.md
1382-
- name: Creating a new workbook
1383-
href: visualize/workbooks-create-workbook.md
1384-
- name: Workbook configuration options
1385-
href: visualize/workbooks-configurations.md
1382+
- name: Link actions
1383+
href: visualize/workbooks-link-actions.md
13861384
- name: Working with parameters
13871385
items:
13881386
- name: Workbook parameters
@@ -1400,9 +1398,9 @@ items:
14001398
- name: Resource parameters
14011399
href: visualize/workbooks-resources.md
14021400
- name: Multi-value parameters
1403-
href: visualize/workbooks-multi-value.md
1404-
- name: Link actions
1405-
href: visualize/workbooks-link-actions.md
1401+
href: visualize/workbooks-multi-value.md
1402+
- name: Workbook result limits
1403+
href: visualize/workbooks-limits.md
14061404
- name: Integrating with other Azure services
14071405
items:
14081406
- name: Deploy with Azure Resource Manager
@@ -1413,11 +1411,11 @@ items:
14131411
href: visualize/workbooks-jsonpath.md
14141412
- name: Move Workbooks to another region
14151413
href: visualize/workbooks-move-region.md
1416-
- name: Move Workbook Templates to another region
1414+
- name: Move Workbook templates to another region
14171415
href: visualize/workbook-templates-move-region.md
14181416
- name: Workbook Samples
14191417
items:
1420-
- name: Links
1418+
- name: Sample Workbooks
14211419
href: visualize/workbooks-sample-links.md
14221420
- name: Other visualizations
14231421
items:

articles/azure-monitor/visualize/workbook-templates-move-region.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.workload: tbd
99
ms.tgt_pltfrm: ibiza
1010
ms.topic: how-to
1111
ms.custom: subject-moving-resources
12-
ms.date: 08/12/2020
12+
ms.date: 07/05/2022
1313
ms.author: jgardner
1414

1515
#Customer intent: As an Azure service administrator, I want to move my resources to another Azure region

articles/azure-monitor/visualize/workbooks-automate.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-monitor
55
ms.workload: tbd
66
ms.tgt_pltfrm: ibiza
77
ms.topic: conceptual
8-
ms.date: 04/30/2020
8+
ms.date: 07/05/2022
99
---
1010

1111
# Programmatically manage workbooks
@@ -286,7 +286,7 @@ The example below demonstrates the customization of an exported Workbook Azure R
286286
}
287287
```
288288

289-
In this example, the following steps facilitated the customization of an exported Azure Resource Manager template:
289+
In this example, the following steps facilitate the customization of an exported Azure Resource Manager template:
290290
1. Export the Workbook as an Azure Resource Manager template as explained in the above section
291291
2. In the template's `variables` section:
292292
1. Parse the `serializedData` value into a JSON object variable, which creates a JSON structure including an array of items that represent the content of the Workbook.

articles/azure-monitor/visualize/workbooks-bring-your-own-storage.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ services: azure-monitor
66
ms.workload: tbd
77
ms.tgt_pltfrm: ibiza
88
ms.topic: conceptual
9-
ms.date: 12/11/2020
9+
ms.date: 07/05/2022
1010
---
1111

1212
# Bring your own storage to save workbooks

articles/azure-monitor/visualize/workbooks-chart-visualizations.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-monitor
55
ms.workload: tbd
66
ms.tgt_pltfrm: ibiza
77
ms.topic: conceptual
8-
ms.date: 09/04/2020
8+
ms.date: 07/05/2022
99
---
1010

1111
# Chart visualizations
@@ -22,7 +22,7 @@ Azure Monitor logs gives resources owners detailed information about the working
2222

2323
The example below shows the trend of requests to an app over the previous days.
2424

25-
1. Switch the workbook to edit mode by selecting the **Edit** toolbar item.
25+
1. Switch the workbook to edit mode by selecting **Edit** in the toolbar.
2626
2. Use the **Add query** link to add a log query control to the workbook.
2727
3. Select the query type as **Log**, resource type (for example, Application Insights) and the resources to target.
2828
4. Use the Query editor to enter the [KQL](/azure/kusto/query/) for your analysis (for example, trend of requests).
@@ -142,7 +142,7 @@ Most Azure resources emit metric data about state and health (for example, CPU u
142142

143143
The following example will show the number of transactions in a storage account over the prior hour. This allows the storage owner to see the transaction trend and look for anomalies in behavior.
144144

145-
1. Switch the workbook to edit mode by selecting the **Edit** toolbar item.
145+
1. Switch the workbook to edit mode by selecting **Edit** in the toolbar.
146146
2. Use the **Add metric** link to add a metric control to the workbook.
147147
3. Select a resource type (for example, Storage Account), the resources to target, the metric namespace and name, and the aggregation to use.
148148
4. Set other parameters if needed - like time range, split-by, visualization, size, and color palette.

articles/azure-monitor/visualize/workbooks-composite-bar.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-monitor
55
ms.workload: tbd
66
ms.tgt_pltfrm: ibiza
77
ms.topic: conceptual
8-
ms.date: 9/04/2020
8+
ms.date: 07/05/2022
99
---
1010

1111
# Composite bar renderer
@@ -20,8 +20,8 @@ Composite bar renderer is supported for grids, tiles, and graphs visualizations.
2020

2121
## Adding composite bar renderer
2222

23-
1. Switch the workbook to edit mode by selecting *Edit* toolbar item.
24-
2. Select *Add* then *Add query*.
23+
1. Switch the workbook to edit mode by selecting **Edit** in the toolbar.
24+
2. Select **Add** and then **Add query**.
2525
3. Set *Data source* to "JSON" and *Visualization* to "Grid".
2626
4. Add the following JSON data.
2727

articles/azure-monitor/visualize/workbooks-configurations.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ manager: carmonm
77
ms.workload: tbd
88
ms.tgt_pltfrm: ibiza
99
ms.topic: conceptual
10-
ms.date: 07/20/2020
10+
ms.date: 07/05/2022
1111
---
1212

1313
# Workbook Configuration Options
@@ -22,7 +22,7 @@ The workbooks settings has these tabs to help you configure your workbook.
2222
|Resources|This tab contains the resources that appear as default selections in this workbook.<br>The resource marked as the **Owner** resource is where the workbook will be saved, and the location of the workbooks and templates you'll see when browsing. The owner resource can't be removed.<br> You can add a default resource by selecting **Add Resources**. You can remove resources by selecting a resource or several resources, and selecting **Remove Selected Resources**. When you're done adding and removing resources, select **Apply Changes**.|
2323
|Versions| This tab contains a list of all the available versions of this workbook. Select a version and use the toolbar to compare, view, or restore versions. Previous workbook versions are available for 90 days.<br><ul><li>**Compare**: Compare the JSON of the previous workbook to the most recently saved version.</li><li>**View**: Opens the selected version of the workbook in a context pane.</li><li>**Restore**: Saves a new copy of the workbook with the contents of the selected version and overwrites any existing current content. You'll be prompted to confirm this action.</li></ul><br>|
2424
|Style |In this tab, you can set a padding and spacing style for the whole workbook. The possible options are `Wide`, `Standard`, `Narrow`, `None`. `Standard` is the default style setting.|
25-
|Pin |While in pin mode, you can select **Pin Workbook** to pin an item from this workbook to a dashboard. Select **Link to Workbook**, to pin a static link to this workbook on your dashboard. You can choose a specific item in your workbook to pin.|
25+
|Pin |While in pin mode, you can select **Pin Workbook** to pin an component from this workbook to a dashboard. Select **Link to Workbook**, to pin a static link to this workbook on your dashboard. You can choose a specific component in your workbook to pin.|
2626
|Trusted hosts |In this tab, you can enable a trusted source or mark this workbook as trusted in this browser. See [trusted hosts](#trusted-hosts) for detailed information. |
2727

2828
> [!NOTE]
@@ -50,7 +50,7 @@ There are several ways that you can create interactive reports and experiences i
5050
- **Grid, tile, and chart selections**: You can construct scenarios where clicking a row in a grid updates subsequent charts based on the content of the row. For example, if you have a grid that shows a list of requests and some statistics like failure counts, you can set it up so that if you click on the row of a request, the detailed charts below update to show only that request. Learn how to [set up a grid row click](#set-up-a-grid-row-click).
5151
- **Grid Cell Clicks**: You to add interactivity with a special type of grid column renderer called a [link renderer](#link-renderer-actions). A link renderer converts a grid cell into a hyperlink based on the contents of the cell. Workbooks support many kinds of link renderers including renderers that open resource overview blades, property bag viewers, App Insights search, usage, transaction tracing, etc. Learn how to [set up a grid cell click](#set-up-grid-cell-clicks).
5252
- **Conditional Visibility**: You can make controls appear or disappear based on the values of parameters. This allows you to have reports that look different based on user input or telemetry state. For example, you can show consumers a summary when there are no issues, and show detailed information when there's something wrong. Learn how to [set up conditional visibility](#set-conditional-visibility).
53-
- **Export parameters with multi-selections**: You can export parameters from query and metrics workbook items when a row or multiple rows are selected.Learn how to [set up multi-selects in grids and charts](#set-up-multi-selects-in-grids-and-charts).
53+
- **Export parameters with multi-selections**: You can export parameters from query and metrics workbook components when a row or multiple rows are selected.Learn how to [set up multi-selects in grids and charts](#set-up-multi-selects-in-grids-and-charts).
5454

5555

5656
### Set up a grid row click
@@ -142,7 +142,7 @@ The following image shows a more elaborate interactive report in read mode based
142142
143143
### Set conditional visibility
144144
145-
1. Follow the steps in the [Setting up interactivity on grid row click](#set-up-a-grid-row-click) section to set up two interactive controls.
145+
1. Follow the steps in the [setting up interactivity on grid row click](#set-up-a-grid-row-click) section to set up two interactive controls.
146146
1. Add a new parameter with these values:
147147
- Name: `ShowDetails`
148148
- Parameter type: `Drop down`
@@ -165,19 +165,19 @@ The following image shows a more elaborate interactive report in read mode based
165165
166166
The following image shows the case where `ShowDetails` is `Yes`:
167167
168-
:::image type="content" source="media/workbooks-configurations/workbooks-conditional-visibility-visible.png" alt-text="Screenshot showing a workbook with a conditional item that is visible.":::
168+
:::image type="content" source="media/workbooks-configurations/workbooks-conditional-visibility-visible.png" alt-text="Screenshot showing a workbook with a conditional component that is visible.":::
169169
170-
The image below shows the hidden case where `ShowDetails` is `No`
170+
The image below shows the hidden case where `ShowDetails` is `No`:
171171
172-
:::image type="content" source="media/workbooks-configurations/workbooks-conditional-visibility-invisible.png" alt-text="Screenshot showing a workbook with a conditional item that is hidden.":::
172+
:::image type="content" source="media/workbooks-configurations/workbooks-conditional-visibility-invisible.png" alt-text="Screenshot showing a workbook with a conditional component that is hidden.":::
173173
174174
### Set up multi-selects in grids and charts
175175
176-
Query and metrics items can export parameters when a row or multiple rows are selected.
176+
Query and metrics components can export parameters when a row or multiple rows are selected.
177177
178178
:::image type="content" source="media/workbooks-configurations/workbooks-export-parameters.png" alt-text="Screenshot showing the workbooks export parameters settings with multiple parameters.":::
179179
180-
1. In the query step displaying the grid, select **Advanced settings**.
180+
1. In the query component displaying the grid, select **Advanced settings**.
181181
2. Select the `When items are selected, export parameters` checkbox.
182182
1. Select the `allow selection of multiple values` checkbox.
183183
- The displayed visualization allows multi-selecting and the exported parameter's values will be arrays of values, like when using multi-select dropdown parameters.
@@ -189,7 +189,7 @@ When single selection is enabled, you can specify which field of the original da
189189
When multi-selection is enabled, you specify which field of the original data to export. Fields include parameter name, parameter type, quote with and delimiter. The quote with and delimiter values are used when turning arrow values into text when being replaced in a query. In multi-selection, if no values are selected, the default value is an empty array.
190190
191191
> [!NOTE]
192-
> For multi select, only unique values are exported. For example, you will not see output array values like " 1,1,2,1". The array output will be get "1,2".
192+
> For multi-select, only unique values are exported. For example, you will not see output array values like " 1,1,2,1". The array output will be get "1,2".
193193
194194
If you leave the `Field to export` setting empty in the export settings, all the available fields in the data will be exported as a stringified JSON object of key:value pairs. For grids and titles, the string includes the fields in the grid. For charts, the available fields are x,y,series, and label (depending on the type of chart).
195195

0 commit comments

Comments
 (0)