Merging changes synced from https://github.com/MicrosoftDocs/azure-docs-pr (branch live)

Author: Learn Build Service GitHub App

articles/app-service/webjobs-sdk-get-started.md

@@ -4,7 +4,7 @@ description: Learn how to enable your web apps to run background tasks. Use this
 author: ggailey777
 ms.devlang: csharp
 ms.custom: devx-track-csharp
-ms.date: 06/25/2021
+ms.date: 01/17/2025
 ms.author: glenga
 ms.topic: tutorial
 
@@ -15,7 +15,7 @@ ms.topic: tutorial
 
 Get started with the Azure WebJobs SDK for Azure App Service to enable your web apps to run background tasks, scheduled tasks, and respond to events. 
 
-Use Visual Studio 2022 to create a .NET Core console app that uses the WebJobs SDK to respond to Azure Storage Queue messages, run the project locally, and finally deploy it to Azure.
+Use Visual Studio 2022 to create a .NET 8 console app that uses the WebJobs SDK to respond to Azure Storage Queue messages, run the project locally, and finally deploy it to Azure.
 
 In this tutorial, you will learn how to:
 
@@ -37,7 +37,7 @@ In this tutorial, you will learn how to:
 In this section, you start by creating a project in Visual Studio 2022. Next, you'll add tools for Azure development, code publishing, and functions that listen for triggers and call functions. Last, you'll set up console logging that disables a legacy monitoring tool and enables a console provider with default filtering. 
 
 >[!NOTE]  
->The procedures in this article are verified for creating a .NET Core console app that runs on .NET 6.0.
+>The procedures in this article are verified for creating a C# console app that runs on .NET 8.0.
 
 ### Create a project
 
@@ -64,6 +64,9 @@ Install the latest WebJobs NuGet package. This package includes Microsoft.Azure.
      ```powershell
      Install-Package Microsoft.Azure.WebJobs.Extensions -version <4_X_VERSION>
      ```
+     >[!NOTE]
+     >The sample code in this article works with package versions 4.x. Make sure you use a 4.x version because you get build errors when using package versions 5.x.
+       
 5. In the **Package Manager Console**, execute the command. The extension list appears and automatically installs. 
   
 ### Create the Host
@@ -109,10 +112,10 @@ Set up console logging that uses the [ASP.NET Core logging framework](/aspnet/co
 
 1. Get the latest stable version of the [`Microsoft.Extensions.Logging.Console` NuGet package](https://www.nuget.org/packages/Microsoft.Extensions.Logging.Console/), which includes `Microsoft.Extensions.Logging`.
 
-2. In the following command, replace `<6_X_VERSION>` with the current version number you found in step 1. Each type of NuGet Package has a unique version number.
+2. In the following command, replace `<9_X_VERSION>` with the current version number you found in step 1. Each type of NuGet Package has a unique version number.
 
    ```powershell
-   Install-Package Microsoft.Extensions.Logging.Console -version <6_X_VERSION>
+   Install-Package Microsoft.Extensions.Logging.Console -version <9_X_VERSION>
    ```
 3. In the **Package Manager Console**, fill in the current version number and execute the command. The extension list appears and automatically installs. 
 
@@ -126,24 +129,30 @@ Set up console logging that uses the [ASP.NET Core logging framework](/aspnet/co
     ```cs
     builder.ConfigureLogging((context, b) =>
     {
-        b.AddConsole();
+         b.SetMinimumLevel(LogLevel.Error);
+         b.AddFilter("Function", LogLevel.Information);
+         b.AddFilter("Host", LogLevel.Debug);
+         b.AddConsole();
     });
     ```
 
-    The `Main` method now looks like this:
+    This adds logging that captures log output for function executions at the `Information` level, the host at the `Debug` level, and the `error` level for all other components. The `Main` method now looks like this:
 
     ```cs
     static async Task Main()
     {
         var builder = new HostBuilder();
         builder.ConfigureWebJobs(b =>
-                {
-                    b.AddAzureStorageCoreServices();
-                });
+        {
+            b.AddAzureStorageCoreServices();
+        });
         builder.ConfigureLogging((context, b) =>
-                {
-                    b.AddConsole();
-                });
+        {
+            b.SetMinimumLevel(LogLevel.Error);
+            b.AddFilter("Function", LogLevel.Information);
+            b.AddFilter("Host", LogLevel.Debug);
+            b.AddConsole();
+        });
         var host = builder.Build();
         using (host)
         {
@@ -170,7 +179,7 @@ In this section, you create a function triggered by messages in an Azure Storage
 Starting with version 3 of the WebJobs SDK, to connect to Azure Storage services you must install a separate Storage binding extension package. 
 
 >[!NOTE]
-> Beginning with 5.x, Microsoft.Azure.WebJobs.Extensions.Storage has been [split by storage service](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Microsoft.Azure.WebJobs.Extensions.Storage/CHANGELOG.md#major-changes-and-features) and has migrated the `AddAzureStorage()` extension method by service type.
+> Beginning with 5.x, Microsoft.Azure.WebJobs.Extensions.Storage has been [split by storage service](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Microsoft.Azure.WebJobs.Extensions.Storage/CHANGELOG.md#major-changes-and-features) and has migrated the `AddAzureStorage()` extension method by service type. This version also requires you to update the version of the `Microsoft.Azure.WebJobs.Host.Storage` assembly used by the SDK.
 
 1. Get the latest stable version of the [Microsoft.Azure.WebJobs.Extensions.Storage](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Storage) NuGet package, version 5.x.
 
@@ -179,8 +188,15 @@ Starting with version 3 of the WebJobs SDK, to connect to Azure Storage services
     ```powershell
     Install-Package Microsoft.Azure.WebJobs.Extensions.Storage -Version <5_X_VERSION>
     ```
+    
 1. In the **Package Manager Console**, execute the command with the current version number at the `PM>` entry point.
 
+1. Also run this command to update the `Microsoft.Azure.WebJobs.Host.Storage` package to version 4.1.0:
+
+    ```powershell
+    Install-Package Microsoft.Azure.WebJobs.Host.Storage -Version 4.1.0
+    ``` 
+
 1. Continuing in **Program.cs**, in the `ConfigureWebJobs` extension method, add the `AddAzureStorageQueues` method on the [`HostBuilder`](/dotnet/api/microsoft.extensions.hosting.hostbuilder) instance (before the `Build` command) to initialize the Storage extension. At this point, the `ConfigureWebJobs` method looks like this:
 
     ```cs
@@ -205,15 +221,18 @@ Starting with version 3 of the WebJobs SDK, to connect to Azure Storage services
     {
         var builder = new HostBuilder();
         builder.UseEnvironment(EnvironmentName.Development);
-        builder.ConfigureLogging((context, b) =>
-        {
-            b.AddConsole();
-        });
         builder.ConfigureWebJobs(b =>
         {
             b.AddAzureStorageCoreServices();
             b.AddAzureStorageQueues();
         });
+        builder.ConfigureLogging((context, b) =>
+        {
+            b.SetMinimumLevel(LogLevel.Error);
+            b.AddFilter("Function", LogLevel.Information);
+            b.AddFilter("Host", LogLevel.Debug);
+            b.AddConsole();
+        });
         var host = builder.Build();
         using (host)
         {
@@ -238,7 +257,7 @@ The `QueueTrigger` attribute tells the runtime to call this function when a new
 
     namespace WebJobsSDKSample
     {
-        public class Functions
+        public static class Functions
         {
             public static void ProcessQueueMessage([QueueTrigger("queue")] string message, ILogger logger)
             {
@@ -307,7 +326,7 @@ Build and run the project locally and create a message queue to trigger the func
 
 5. Go back to the **Queue** window and refresh it. The message is gone, since it has been processed by your function running locally.
 
-6.  Close the console window. 
+6.  Close the console window or type Ctrl+C. 
 
 It's now time to publish your WebJobs SDK project to Azure.
 
@@ -368,11 +387,11 @@ When the WebJob runs in Azure, you can't monitor function execution by viewing c
 
 1. In your **Publish** profile page, select the three dots above **Hosting** to show **Hosting profile section actions** and choose **Open in Azure Portal**.
 
-1. In the web app under **Settings**, choose **Application Insights**, and select **Turn on Application Insights**.
+1. In the web app under **Monitoring**, choose **Application Insights**, and select **Turn on Application Insights**.
 
-1. Verify the generated **Resource name** for the instance and the **Location**, and select **Apply**. 
+1. Verify the generated **Resource name** for the instance and the **Location**, and select **Apply** and then **Yes**. 
 
-1. Under **Settings**, choose **Configuration** and verify that a new `APPINSIGHTS_INSTRUMENTATIONKEY` was created. This key is used to connect your WebJob instance to Application Insights.   
+1. Under **Settings**, choose **Environment variables** and verify that a new `APPINSIGHTS_INSTRUMENTATIONKEY` was created. This key is used to connect your WebJob instance to Application Insights.   
 
 To take advantage of [Application Insights](/azure/azure-monitor/app/app-insights-overview) logging, you need to update your logging code as well.
 
@@ -406,23 +425,26 @@ The `Main` method code should now look like the following example:
 static async Task Main()
 {
     var builder = new HostBuilder();
-    builder.UseEnvironment(EnvironmentName.Development);
+    //builder.UseEnvironment(EnvironmentName.Development);
     builder.ConfigureWebJobs(b =>
-            {
-                b.AddAzureStorageCoreServices();
-                b.AddAzureStorage();
-            });
+    {
+        b.AddAzureStorageCoreServices();
+        b.AddAzureStorageQueues();
+    });
     builder.ConfigureLogging((context, b) =>
-            {
-                b.AddConsole();
+    {
+        b.SetMinimumLevel(LogLevel.Error);
+        b.AddFilter("Function", LogLevel.Information);
+        b.AddFilter("Host", LogLevel.Debug);
+        b.AddConsole();
 
-                // If the key exists in settings, use it to enable Application Insights.
-                string instrumentationKey = context.Configuration["APPINSIGHTS_INSTRUMENTATIONKEY"];
-                if (!string.IsNullOrEmpty(instrumentationKey))
-                {
-                    b.AddApplicationInsightsWebJobs(o => o.InstrumentationKey = instrumentationKey);
-                }
-            });
+        // If the key exists in settings, use it to enable Application Insights.
+        string? instrumentationKey = context.Configuration["APPINSIGHTS_INSTRUMENTATIONKEY"];
+        if (!string.IsNullOrEmpty(instrumentationKey))
+        {
+            b.AddApplicationInsightsWebJobs(o => o.InstrumentationKey = instrumentationKey);
+        }
+    });
     var host = builder.Build();
     using (host)
     {
@@ -431,7 +453,7 @@ static async Task Main()
 }
 ```
 
-This initializes the Application Insights logging provider with default [filtering](webjobs-sdk-how-to.md#log-filtering). When running locally, all Information and higher-level logs are written to both the console and Application Insights.
+This initializes the Application Insights logging provider with default [filtering](webjobs-sdk-how-to.md#log-filtering). When running locally, all Information and higher-level logs are written to both the console and Application Insights. When running locally, Application Insights logging is only supported after you also add the `APPINSIGHTS_INSTRUMENTATIONKEY` to the `appsetting.json` file in the project. 
 
 ### Republish the project and trigger the function again
 
@@ -441,7 +463,7 @@ This initializes the Application Insights logging provider with default [filteri
 
 1. In your **Publish** profile page, select the three dots above **Hosting** to show **Hosting profile section actions** and choose **Open in Azure Portal**.
 
-1. In the web app under **Settings**, choose **Application Insights**, and select **View Application Insights data**.
+1. In the web app under **Settings** > **Monitor**, choose **Application Insights**, and select **View Application Insights data**.
 
 1. Select **Search** and then select **See all data in the last 24 hours**.
 

articles/azure-cache-for-redis/cache-overview-vector-similarity.md

@@ -12,7 +12,7 @@ ms.date: 04/24/2024
 
 # What are Vector Embeddings and Vector Search in Azure Cache for Redis?
 
-Vector similarity search (VSS) has become a popular technology for AI-powered intelligent applications. Azure Cache for Redis can be used as a vector database by combining it models like [Azure OpenAI](/azure/ai-services/openai/overview) for Retrieval-Augmented Generative AI and analysis scenarios. This article is a high-level introduction to the concept of vector embeddings, vector similarity search, and how Redis can be used as a vector database powering intelligent applications.
+Vector similarity search (VSS) has become a popular technology for AI-powered intelligent applications. Azure Cache for Redis can be used as a vector database when combined with models like [Azure OpenAI](/azure/ai-services/openai/overview) for Retrieval-Augmented Generative AI and other analysis scenarios. This article is a high-level introduction to the concept of vector embeddings, vector similarity search, and how Redis can be used as a vector database powering intelligent applications.
 
 For tutorials and sample applications on how to use Azure Cache for Redis and Azure OpenAI to perform vector similarity search, see the following:
 

articles/azure-maps/media/power-bi-visual/bubble-layer-no-legend.png

@@ -4,7 +4,7 @@ titleSuffix: Microsoft Azure Maps
 description: In this article, you learn how to use the bubble layer in an Azure Maps Power BI visual.
 author: deniseatmicrosoft
 ms.author: limingchen
-ms.date: 12/04/2023
+ms.date: 01/17/2025
 ms.topic: how-to
 ms.service: azure-maps
 ms.subservice: power-bi-visual
@@ -14,9 +14,13 @@ ms.subservice: power-bi-visual
 
 The **Bubble layer** renders location data as scaled circles on the map.
 
-:::image type="content" source="./media/power-bi-visual/bubble-layer-with-legend-color.png" alt-text="A map displaying point data using the bubble layer":::
+:::image type="content" source="./media/power-bi-visual/bubble-layer-no-legend.png" lightbox="./media/power-bi-visual/bubble-layer-no-legend.png"alt-text="A map displaying point data using the bubble layer, all bubbles are blue.":::
 
-Initially all bubbles have the same fill color. If a field is passed into the **Legend** bucket of the **Fields** pane, the bubbles are colored based on their categorization. The outline of the bubbles is white be default but can be changed to a new color or by enabling the high-contrast outline option. The **High-contrast outline** option dynamically assigns an outline color that is a high-contrast variant of the fill color. This helps to ensure the bubbles are clearly visible regardless of the style of the map. The following are the primary settings in the **Format** pane that are available in the **Bubble layer** section.
+Initially all bubbles have the same fill color. If a field is passed into the **Legend** bucket of the **Fields** pane, the bubbles are colored based on their categorization.
+
+:::image type="content" source="./media/power-bi-visual/bubble-layer-with-legend-color.png" lightbox="./media/power-bi-visual/bubble-layer-with-legend-color.png"alt-text="A map displaying point data using the bubble layer, the bubbles are colored based on their categorization with a legend showing what color is associated with which business.":::
+
+The outline of the bubbles is white be default but can be changed to a new color or by enabling the high-contrast outline option. The **High-contrast outline** option dynamically assigns an outline color that is a high-contrast variant of the fill color. This helps to ensure the bubbles are clearly visible regardless of the style of the map. The following are the primary settings in the **Format** pane that are available in the **Bubble layer** section.
 
 | Setting        | Description    |
 |----------------|----------------|
@@ -41,8 +45,6 @@ If a field is passed into the **Size** bucket of the **Fields** pane, the bubble
 
 When the **bubble layer** displays on a map, the **Category labels** settings become active in the **Format visual** pane.
 
-:::image type="content" source="./media/power-bi-visual/category-labels.png" alt-text="A screenshot showing the category labels settings in the format visual section of Power BI." lightbox="./media/power-bi-visual/category-labels.png":::
-
 The **Category labels** settings enable you to customize font setting such as font type, size and color as well as the category labels background color and transparency.
 
 :::image type="content" source="./media/power-bi-visual/category-labels-example.png" alt-text="A screenshot showing the category labels on an Azure Maps map in Power BI." lightbox="./media/power-bi-visual/category-labels-example.png":::

articles/azure-maps/media/power-bi-visual/bubble-layer-with-legend-color.png

@@ -4,19 +4,19 @@ titleSuffix: Azure Maps Power BI visual
 description: This article demonstrates how to use the tile layer in Azure Maps Power BI visual.
 author: deniseatmicrosoft
 ms.author: limingchen
-ms.date: 07/18/2023
+ms.date: 01/17/2025
 ms.topic: how-to
 ms.service: azure-maps
 ms.subservice: power-bi-visual
 ---
 
 # Add a tile layer
 
-The tile layer feature, like the reference layer feature, allows additional data to be overlaid on the map to provide more context. Tile layers allow you to superimpose images on top of the Azure Maps base map tiles. Superimposing images is a great way to overlay large or complex datasets such as imagery from drones, or millions of rows of data.
+The tile layer feature, like the reference layer feature, allows other data to be overlaid on the map to provide more context. Tile layers allow you to superimpose images on top of the Azure Maps base map tiles. Superimposing images is a great way to overlay large or complex datasets such as imagery from drones, or millions of rows of data.
 
-:::image type="content" source="./media/power-bi-visual/radar-tile-layer-with-bubbles.png"alt-text="A map displaying a bubble layer above a tile layer showing current infrared weather data from Azure Maps.":::
+:::image type="content" source="./media/power-bi-visual/tile-layer.png" lightbox="./media/power-bi-visual/tile-layer.png" alt-text="A map displaying an open street map tile layer in an Azure Maps Power BI Visual.":::
 
-A tile layer loads in tiles from a server. These images can either be prerendered or dynamically rendered. prerendered images are stored like any other image on a server using a naming convention that the tile layer understands. Dynamically rendered images use a service to load the images close to real time. Tile layers are a great way to visualize large datasets on the map. Not only can a tile layer be generated from an image, vector data can also be rendered as a tile layer too.
+A tile layer loads in tiles from a server. These images can either be prerendered or dynamically rendered. Prerendered images are stored like any other image on a server using a naming convention that the tile layer understands. Dynamically rendered images use a service to load the images close to real time. Tile layers are a great way to visualize large datasets on the map. Not only can a tile layer be generated from an image, vector data can also be rendered as a tile layer too.
 
 The bounding box and zoom range of where a tile service is available can be passed as settings to limit where tiles are requested, a performance enhancement for both the visual and the tile service. The following table gives an overview of all settings available in the **Format** pane available in the **Tile layer** section.