Merge pull request #257647 from v-jbasden/v-jbasden-convert-images-to-learn-format-visualizations-1

[BULK UPDATE #1] Converting Azure Monitor legacy image formatting to Learn formatting - Visualizations subservice

Author: PMEds28

articles/azure-monitor/visualize/grafana-plugin.md

@@ -45,15 +45,15 @@ Sign in to Grafana by using the endpoint URL of your Azure Managed Grafana works
 
 Azure Managed Grafana includes an Azure Monitor data source plug-in. By default, the plug-in is preconfigured with a managed identity that can query and visualize monitoring data from all resources in the subscription in which the Grafana workspace was deployed. Skip ahead to the section "Build a Grafana dashboard."
 
-![Screenshot that shows the Azure Managed Grafana home page.](./media/grafana-plugin/azure-managed-grafana.png)
+:::image type="content" source="./media/grafana-plugin/azure-managed-grafana.png" lightbox="./media/grafana-plugin/azure-managed-grafana.png" alt-text="Screenshot that shows the Azure Managed Grafana home page.":::
 
 You can expand the resources that can be viewed by your Azure Managed Grafana workspace by [configuring additional permissions](../../managed-grafana/how-to-permissions.md) to assign the included managed identity the [Monitoring Reader role](../roles-permissions-security.md) on other subscriptions or resources.
 
  If you're using an instance that isn't Azure Managed Grafana, you have to set up an Azure Monitor data source.
 
 1. Select **Add data source**, filter by the name **Azure**, and select the **Azure Monitor** data source.
 
-    ![Screenshot that shows Azure Monitor data source selection.](./media/grafana-plugin/azure-monitor-data-source-list.png)
+    :::image type="content" source="./media/grafana-plugin/azure-monitor-data-source-list.png" lightbox="./media/grafana-plugin/azure-monitor-data-source-list.png" alt-text="Screenshot that shows Azure Monitor data source selection.":::
 
 1. Pick a name for the data source and choose between managed identity or app registration for authentication.
 
@@ -67,7 +67,7 @@ If you're hosting Grafana on your own Azure Virtual Machines or Azure App Servic
 
 1. Select **Save & test** and Grafana will test the credentials. You should see a message similar to the following one.
 
-   ![Screenshot that shows Azure Monitor data source with config-approved managed identity.](./media/grafana-plugin/managed-identity.png)
+   :::image type="content" source="./media/grafana-plugin/managed-identity.png" lightbox="./media/grafana-plugin/managed-identity.png" alt-text="Screenshot that shows Azure Monitor data source with config-approved managed identity.":::
 
 ### Use app registration
 
@@ -85,17 +85,17 @@ If you're hosting Grafana on your own Azure Virtual Machines or Azure App Servic
 
 1. Select **Save & test** and Grafana will test the credentials. You should see a message similar to the following one.
 
-   ![Screenshot that shows Azure Monitor data source configuration with the approved app registration.](./media/grafana-plugin/app-registration.png)
+   :::image type="content" source="./media/grafana-plugin/app-registration.png" lightbox="./media/grafana-plugin/app-registration.png" alt-text="Screenshot that shows Azure Monitor data source configuration with the approved app registration.":::
 
 ## Use out-of-the-box dashboards
 
 Azure Monitor contains out-of-the-box dashboards to use with Azure Managed Grafana and the Azure Monitor plugin.
 
-:::image type="content" source="media/grafana-plugin/grafana-out-of-the-box-dashboards.png" alt-text="Screenshot that shows out of the box Azure Monitor grafana dashboards.":::
+:::image type="content" source="media/grafana-plugin/grafana-out-of-the-box-dashboards.png" lightbox="media/grafana-plugin/grafana-out-of-the-box-dashboards.png" alt-text="Screenshot that shows out of the box Azure Monitor grafana dashboards.":::
 
 Azure Monitor also supports out-of-the-box dashboards for seamless integration with Azure Monitor managed service for Prometheus. These dashboards are automatically deployed to Azure Managed Grafana when linked to Azure Monitor managed service for Prometheus.
 
-:::image type="content" source="media/grafana-plugin/grafana-out-of-the-box-dashboards-prometheus.png" alt-text="Screenshot that shows out of the box Azure Monitor grafana dashboards for Azure Monitor managed service for Prometheus.":::
+:::image type="content" source="media/grafana-plugin/grafana-out-of-the-box-dashboards-prometheus.png" lightbox="media/grafana-plugin/grafana-out-of-the-box-dashboards-prometheus.png" alt-text="Screenshot that shows out of the box Azure Monitor grafana dashboards for Azure Monitor managed service for Prometheus.":::
 ## Build a Grafana dashboard
 
 1. Go to the Grafana home page and select **New Dashboard**.
@@ -104,30 +104,30 @@ Azure Monitor also supports out-of-the-box dashboards for seamless integration w
 
 1. A blank graph shows up on your dashboard. Select the panel title and select **Edit** to enter the details of the data you want to plot in this graph chart.
 
-    ![Screenshot that shows Grafana new panel dropdown list options.](./media/grafana-plugin/grafana-new-graph-dark.png)
+    :::image type="content" source="./media/grafana-plugin/grafana-new-graph-dark.png" lightbox="./media/grafana-plugin/grafana-new-graph-dark.png" alt-text="Screenshot that shows Grafana new panel dropdown list options.":::
 
 1. Select the Azure Monitor data source you've configured.
    * Visualizing Azure Monitor metrics: Select **Azure Monitor** in the service dropdown list. A list of selectors shows up where you can select the resources and metric to monitor in this chart. To collect metrics from a VM, use the namespace `Microsoft.Compute/VirtualMachines`. After you've selected VMs and metrics, you can start viewing their data in the dashboard.
 
-     ![Screenshot that shows Grafana panel config for Azure Monitor metrics.](./media/grafana-plugin/grafana-graph-config-for-azure-monitor-dark.png)
+     :::image type="content" source="./media/grafana-plugin/grafana-graph-config-for-azure-monitor-dark.png" lightbox="./media/grafana-plugin/grafana-graph-config-for-azure-monitor-dark.png" alt-text="Screenshot that shows Grafana panel config for Azure Monitor metrics.":::
    * Visualizing Azure Monitor log data: Select **Azure Log Analytics** in the service dropdown list. Select the workspace you want to query and set the query text. You can copy here any log query you already have or create a new one. As you enter your query, IntelliSense suggests autocomplete options. Select the visualization type, **Time series** > **Table**, and run the query.
 
      > [!NOTE]
      >
      > The default query provided with the plug-in uses two macros: `$__timeFilter()` and `$__interval`. 
      > These macros allow Grafana to dynamically calculate the time range and time grain, when you zoom in on part of a chart. You can remove these macros and use a standard time filter, such as `TimeGenerated > ago(1h)`, but that means the graph wouldn't support the zoom-in feature.
     
-     ![Screenshot of Grafana panel config for Azure Monitor logs.](./media/grafana-plugin/grafana-graph-config-for-azure-log-analytics-dark.png)
+     :::image type="content" source="./media/grafana-plugin/grafana-graph-config-for-azure-log-analytics-dark.png" lightbox="./media/grafana-plugin/grafana-graph-config-for-azure-log-analytics-dark.png" alt-text="Screenshot of Grafana panel config for Azure Monitor logs.":::
 
 1. The following dashboard has two charts. The one on the left shows the CPU percentage of two VMs. The chart on the right shows the transactions in an Azure Storage account broken down by the Transaction API type.
 
-    ![Screenshot of Grafana dashboards with two panels.](media/grafana-plugin/grafana6.png)
+    :::image type="content" source="media/grafana-plugin/grafana6.png" lightbox="media/grafana-plugin/grafana6.png" alt-text="Screenshot of Grafana dashboards with two panels.":::
 
 ## Pin charts from the Azure portal to Azure Managed Grafana
 
 In addition to building your panels in Grafana, you can also quickly pin Azure Monitor visualizations from the Azure portal to new or existing Grafana dashboards by adding panels to your Grafana dashboard directly from Azure Monitor. Go to **Metrics** for your resource. Create a chart and select **Save to dashboard**, followed by **Pin to Grafana**. Choose the workspace and dashboard and select **Pin** to complete the operation.
 
-[![Screenshot that shows the Pin to Grafana option in the Azure Monitor metrics explorer.](media/grafana-plugin/grafana-pin-to.png)](media/grafana-plugin/grafana-pin-to-expanded.png#lightbox)
+:::image type="content" source="media/grafana-plugin/grafana-pin-to.png" lightbox="media/grafana-plugin/grafana-pin-to.png" alt-text="Screenshot that shows the Pin to Grafana option in the Azure Monitor metrics explorer.":::
 
 ## Advanced Grafana features
 
@@ -145,7 +145,7 @@ Usage
 
 You can configure a variable that will list all available **Solution** values and then update your query to use it. To create a new variable, select the dashboard's **Settings** button in the top right area, select **Variables**, and then select **New**. On the variable page, define the data source and query to run to get the list of values.
 
-![Screenshot that shows a Grafana configure variable.](./media/grafana-plugin/grafana-configure-variable-dark.png)
+:::image type="content" source="./media/grafana-plugin/grafana-configure-variable-dark.png" lightbox="./media/grafana-plugin/grafana-configure-variable-dark.png" alt-text="Screenshot that shows a Grafana configure variable.":::
 
 After it's created, adjust the query to use the selected values, and your charts will respond accordingly:
 
@@ -156,13 +156,13 @@ Usage
 | sort by TimeGenerated
 ```
 
-![Screenshot that shows Grafana use variables.](./media/grafana-plugin/grafana-use-variables-dark.png)
+:::image type="content" source="./media/grafana-plugin/grafana-use-variables-dark.png" lightbox="./media/grafana-plugin/grafana-use-variables-dark.png" alt-text="Screenshot that shows Grafana use variables.":::
 
 ### Create dashboard playlists
 
 One of the many useful features of Grafana is the dashboard playlist. You can create multiple dashboards and add them to a playlist configuring an interval for each dashboard to show. Select **Play** to see the dashboards cycle through. You might want to display them on a large wall monitor to provide a status board for your group.
 
-![Screenshot that shows a Grafana playlist example.](./media/grafana-plugin/grafana7.png)
+:::image type="content" source="./media/grafana-plugin/grafana7.png" lightbox="./media/grafana-plugin/grafana7.png" alt-text="Screenshot that shows a Grafana playlist example.":::
 ## Optional: Monitor other datasources in the same Grafana dashboards
 
 There are many data source plug-ins that you can use to bring these metrics together in a dashboard.
@@ -175,7 +175,7 @@ Here are good reference articles on how to use Telegraf, InfluxDB, Azure Monitor
 
 Here's an image of a full Grafana dashboard that has metrics from Azure Monitor and Application Insights.
 
-![Screenshot that shows a Grafana dashboard with multiple panels.](media/grafana-plugin/grafana8.png)
+:::image type="content" source="media/grafana-plugin/grafana8.png" lightbox="media/grafana-plugin/grafana8.png" alt-text="Screenshot that shows a Grafana dashboard with multiple panels.":::
 ## Clean up resources
 
 If you've set up a Grafana environment on Azure, you're charged when resources are running whether you're using them or not. To avoid incurring additional charges, clean up the resource group created in this article.

articles/azure-monitor/visualize/tutorial-logs-dashboards.md

@@ -26,8 +26,8 @@ Sign in to the [Azure portal](https://portal.azure.com).
 
 ## Create a shared dashboard
 Select **Dashboard** to open your default [dashboard](../../azure-portal/azure-portal-dashboards.md). Your dashboard will look different from the following example.
-
-![Screenshot that shows an Azure portal dashboard.](media/tutorial-logs-dashboards/log-analytics-portal-dashboard.png)
+<!-- convertborder later -->
+:::image type="content" source="media/tutorial-logs-dashboards/log-analytics-portal-dashboard.png" lightbox="media/tutorial-logs-dashboards/log-analytics-portal-dashboard.png" alt-text="Screenshot that shows an Azure portal dashboard." border="false":::
 
 Here you can bring together operational data that's most important to IT across all your Azure resources, including telemetry from Azure Log Analytics. Before we visualize a log query, let's first create a dashboard and share it. We can then focus on our example performance log query, which will render as a line chart, and add it to the dashboard.
 
@@ -40,14 +40,14 @@ Here you can bring together operational data that's most important to IT across
 > - `timechart`
 
 To create a dashboard, select **New dashboard**.
+<!-- convertborder later -->
+:::image type="content" source="media/tutorial-logs-dashboards/log-analytics-create-dashboard-01.png" lightbox="media/tutorial-logs-dashboards/log-analytics-create-dashboard-01.png" alt-text="Screenshot that shows creating a new dashboard in the Azure portal." border="false":::
 
-![Screenshot that shows creating a new dashboard in the Azure portal.](media/tutorial-logs-dashboards/log-analytics-create-dashboard-01.png)
-
-This action creates a new, empty, private dashboard. It opens in a customization mode where you can name your dashboard and add or rearrange tiles. Edit the name of the dashboard and specify **Sample Dashboard** for this tutorial. Then select **Done customizing**.<br><br> ![Screenshot that shows saving a customized Azure dashboard.](media/tutorial-logs-dashboards/log-analytics-create-dashboard-02.png)
+This action creates a new, empty, private dashboard. It opens in a customization mode where you can name your dashboard and add or rearrange tiles. Edit the name of the dashboard and specify **Sample Dashboard** for this tutorial. Then select **Done customizing**.<br><br> <!-- convertborder later -->:::image type="content" source="media/tutorial-logs-dashboards/log-analytics-create-dashboard-02.png" lightbox="media/tutorial-logs-dashboards/log-analytics-create-dashboard-02.png" alt-text="Screenshot that shows saving a customized Azure dashboard." border="false":::
 
 When you create a dashboard, it's private by default, so you're the only person who can see it. To make it visible to others, select **Share**.
-
-![Screenshot that shows sharing a new dashboard in the Azure portal.](media/tutorial-logs-dashboards/log-analytics-share-dashboard.png)
+<!-- convertborder later -->
+:::image type="content" source="media/tutorial-logs-dashboards/log-analytics-share-dashboard.png" lightbox="media/tutorial-logs-dashboards/log-analytics-share-dashboard.png" alt-text="Screenshot that shows sharing a new dashboard in the Azure portal." border="false":::
 
 Choose a subscription and resource group for your dashboard to be published to. For convenience, you're guided toward a pattern where you place dashboards in a resource group called **dashboards**. Verify the subscription selected and then select **Publish**. Access to the information displayed in the dashboard is controlled with [Azure role-based access control](../../role-based-access-control/role-assignments-portal.md).
 
@@ -57,8 +57,8 @@ Choose a subscription and resource group for your dashboard to be published to.
 In this tutorial, you'll use Log Analytics to create a performance view in graphical form and save it for a future query. Then you'll pin it to the shared dashboard you created earlier.
 
 Open Log Analytics by selecting **Logs** on the Azure Monitor menu. It starts with a new blank query.
-
-![Screenshot that shows the home page.](media/tutorial-logs-dashboards/homepage.png)
+<!-- convertborder later -->
+:::image type="content" source="media/tutorial-logs-dashboards/homepage.png" lightbox="media/tutorial-logs-dashboards/homepage.png" alt-text="Screenshot that shows the home page." border="false":::
 
 Enter the following query to return processor utilization records for both Windows and Linux computers. The records are grouped by `Computer` and `TimeGenerated` and displayed in a visual chart. Select **Run** to run the query and view the resulting chart.
 
@@ -71,17 +71,17 @@ Perf
 
 Save the query by selecting **Save**.
 
-:::image type="content" source="media/tutorial-logs-dashboards/save-query.png" alt-text="Screenshot that shows how to save a query and pin it to a dashboard.":::
+:::image type="content" source="media/tutorial-logs-dashboards/save-query.png" lightbox="media/tutorial-logs-dashboards/save-query.png" alt-text="Screenshot that shows how to save a query and pin it to a dashboard.":::
 
 In the **Save Query** control panel, provide a name such as **Azure VMs - Processor Utilization** and a category such as **Dashboards**. Select **Save**. This way you can create a library of common queries that you can use and modify. Finally, pin this query to the shared dashboard you created earlier. Select the **Pin to dashboard** button in the upper-right corner of the page and then select the dashboard name.
 
 Now that we have a query pinned to the dashboard, you'll notice that it has a generic title and comment underneath it.
 
-:::image type="content" source="media/tutorial-logs-dashboards/log-analytics-modify-dashboard-01.png" alt-text="Screenshot that shows an Azure dashboard sample.":::
+:::image type="content" source="media/tutorial-logs-dashboards/log-analytics-modify-dashboard-01.png" lightbox="media/tutorial-logs-dashboards/log-analytics-modify-dashboard-01.png" alt-text="Screenshot that shows an Azure dashboard sample.":::
 
  Rename the query with a meaningful name that can be easily understood by anyone who views it. Select **Edit** to customize the title and subtitle for the tile, and then select **Update**. A banner appears that asks you to publish changes or discard. Select **Save a copy**.
 
-:::image type="content" source="media/tutorial-logs-dashboards/log-analytics-modify-dashboard-02.png" alt-text="Screenshot that shows a completed configuration of a sample dashboard.":::
+:::image type="content" source="media/tutorial-logs-dashboards/log-analytics-modify-dashboard-02.png" lightbox="media/tutorial-logs-dashboards/log-analytics-modify-dashboard-02.png" alt-text="Screenshot that shows a completed configuration of a sample dashboard.":::
 
 ## Next steps
 In this tutorial, you learned how to create a dashboard in the Azure portal and add a log query to it. Follow this link to see prebuilt Log Analytics script samples.

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

@@ -29,8 +29,8 @@ Two types of workbook resources can be managed programmatically:
 1. Switch the workbook to edit mode by selecting **Edit**.
 1. Open the **Advanced Editor** by using the **</>** button on the toolbar.
 1. Ensure you're on the **Gallery Template** tab.
-
-    ![Screenshot that shows the Gallery Template tab.](./media/workbooks-automate/gallery-template.png)
+    <!-- convertborder later -->
+    :::image type="content" source="./media/workbooks-automate/gallery-template.png" lightbox="./media/workbooks-automate/gallery-template.png" alt-text="Screenshot that shows the Gallery Template tab." border="false":::
 
 1. Copy the JSON in the gallery template to the clipboard.
 1. The following sample ARM template deploys a workbook template to the Azure Monitor workbook gallery. Paste the JSON you copied in place of `<PASTE-COPIED-WORKBOOK_TEMPLATE_HERE>`. For a reference ARM template that creates a workbook template, see [this GitHub repository](https://github.com/microsoft/Application-Insights-Workbooks/blob/master/Documentation/ARM-template-for-creating-workbook-template).
@@ -117,8 +117,8 @@ Two types of workbook resources can be managed programmatically:
 1. Open the **Advanced Editor** by selecting **</>**.
 1. In the editor, switch **Template Type** to **ARM template**.
 1. The ARM template for creating shows up in the editor. Copy the content and use as-is or merge it with a larger template that also deploys the target resource.
-
-    ![Screenshot that shows how to get the ARM template from within the workbook UI.](./media/workbooks-automate/programmatic-template.png)
+    <!-- convertborder later -->
+    :::image type="content" source="./media/workbooks-automate/programmatic-template.png" lightbox="./media/workbooks-automate/programmatic-template.png" alt-text="Screenshot that shows how to get the ARM template from within the workbook UI." border="false":::
 
 ## Sample ARM template
 This template shows how to deploy a workbook that displays `Hello World!`.