Skip to content

Commit 770bd1e

Browse files
authored
Merge pull request #126795 from RohitRanjanMS/roranjan/docs-update
Updates related to OpenTelemetry.
2 parents 8bba6fe + fe83fc6 commit 770bd1e

File tree

4 files changed

+31
-17
lines changed

4 files changed

+31
-17
lines changed

articles/azure-functions/configure-monitoring.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Configure monitoring for Azure Functions
33
description: Learn how to connect your function app to Application Insights for monitoring and how to configure data collection.
44
ms.service: azure-functions
55
ms.topic: how-to
6-
ms.date: 08/06/2024
6+
ms.date: 05/19/2025
77
ms.custom: devdivchpfy22
88

99
# Customer intent: As a developer, I want to understand how to configure monitoring for my functions correctly, so I can collect the data that I need.
@@ -297,7 +297,9 @@ When you create your function app in the [Azure portal](./functions-get-started.
297297
You can use the [`APPLICATIONINSIGHTS_AUTHENTICATION_STRING`](./functions-app-settings.md#applicationinsights_authentication_string) setting to enable connections to Application Insights using Microsoft Entra authentication. This creates a consistent authentication experience across all Application Insights pipelines, including Profiler and Snapshot Debugger, as well as from the Functions host and language-specific agents.
298298

299299
>[!NOTE]
300-
>There's no Entra authentication support for local development.
300+
>There's currently no Microsoft Entra ID authentication support for local development.
301+
>
302+
>When Ingesting data in a sovereign cloud, Microsoft Entra ID authentication isn't available when using the Application Insights SDK. OpenTelemetry-based data collection supports Microsoft Entra ID authentication across all cloud environments, including sovereign clouds.
301303
302304
The value contains either `Authorization=AAD` for a system-assigned managed identity or `ClientId=<YOUR_CLIENT_ID>;Authorization=AAD` for a user-assigned managed identity. The managed identity must already be available to the function app, with an assigned role equivalent to [Monitoring Metrics Publisher](/azure/role-based-access-control/built-in-roles/monitor#monitoring-metrics-publisher). For more information, see [Microsoft Entra authentication for Application Insights](/azure/azure-monitor/app/azure-ad-authentication).
303305

articles/azure-functions/dotnet-isolated-process-guide.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Guide for running C# Azure Functions in an isolated worker process
33
description: Learn how to use the .NET isolated worker model to run your C# functions in Azure, which lets you run your functions on currently supported versions of .NET and .NET Framework.
44
ms.service: azure-functions
55
ms.topic: conceptual
6-
ms.date: 09/05/2024
6+
ms.date: 05/19/2025
77
ms.custom:
88
- template-concept
99
- devx-track-dotnet
@@ -128,8 +128,7 @@ var builder = FunctionsApplication.CreateBuilder(args);
128128

129129
builder.Services
130130
.AddApplicationInsightsTelemetryWorkerService()
131-
.ConfigureFunctionsApplicationInsights()
132-
.AddSingleton<IHttpResponderService, DefaultHttpResponderService>();
131+
.ConfigureFunctionsApplicationInsights();
133132

134133
builder.Logging.Services.Configure<LoggerFilterOptions>(options =>
135134
{

articles/azure-functions/opentelemetry-howto.md

Lines changed: 22 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This article shows you how to enable export of application logs and
44
ms.service: azure-functions
55
ms.custom: devx-track-extended-java, devx-track-js, devx-track-python, devx-track-ts
66
ms.topic: how-to
7-
ms.date: 05/16/2024
7+
ms.date: 05/19/2025
88
zone_pivot_groups: programming-languages-set-functions
99

1010
#CustomerIntent: As a developer, I want to learn how to enable the export of logs and metrics from my function apps by using OpenTelemetry so I can consume and analyze my application telemetry data either in Application Insights or to any OTLP-compliant tools.
@@ -81,7 +81,7 @@ The way that you instrument your application to use OpenTelemetry depends on you
8181
```cmd
8282
dotnet add package Microsoft.Azure.Functions.Worker.OpenTelemetry --version 1.0.0-preview1
8383
dotnet add package OpenTelemetry.Extensions.Hosting
84-
dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore
84+
dotnet add package Azure.Monitor.OpenTelemetry.Exporter
8585
```
8686
8787
### [OTLP Exporter](#tab/otlp-export)
@@ -98,7 +98,7 @@ The way that you instrument your application to use OpenTelemetry depends on you
9898
### [Application Insights](#tab/app-insights)
9999
100100
```csharp
101-
using Azure.Monitor.OpenTelemetry.AspNetCore;
101+
using Azure.Monitor.OpenTelemetry.Exporter;
102102
```
103103
### [OTLP Exporter](#tab/otlp-export)
104104
@@ -113,15 +113,15 @@ The way that you instrument your application to use OpenTelemetry depends on you
113113
114114
```csharp
115115
services.AddOpenTelemetry()
116-
.UseFunctionsWorkerDefaults()
117-
.UseAzureMonitor();
116+
.UseAzureMonitorExporter()
117+
.UseFunctionsWorkerDefaults();
118118
```
119119
### [OTLP Exporter](#tab/otlp-export)
120120
121121
```csharp
122122
services.AddOpenTelemetry()
123-
.UseFunctionsWorkerDefaults()
124-
.UseOtlpExporter();
123+
.UseOtlpExporter()
124+
.UseFunctionsWorkerDefaults();
125125
```
126126
---
127127
@@ -215,6 +215,8 @@ These instructions only apply for an OTLP exporter:
215215
216216
::: zone-end
217217
::: zone pivot="programming-language-python"
218+
1. Add an application setting named PYTHON_ENABLE_OPENTELEMETRY with value of True.
219+
218220
1. Add this entry in your `requirements.txt` file:
219221
220222
### [Application Insights](#tab/app-insights)
@@ -278,11 +280,21 @@ These instructions only apply for an OTLP exporter:
278280
279281
When you export your data using OpenTelemetry, keep these current considerations in mind.
280282
281-
+ When the host is configured to use OpenTelemetry, only logs and traces are exported. Host metrics aren't currently exported.
283+
+ At this time, only HTTP, Service Bus and Event Hub triggers are supported with OpenTelemetry outputs.
284+
285+
+ When the host is configured to use OpenTelemetry, the Azure portal doesn't support log streaming or recent function invocation traces.
286+
287+
+ [Azure Functions diagnostics](functions-diagnostics.md) in the Azure portal is a useful resource for detecting and diagnosing potential monitoring-related issues.
282288
283-
+ You can't currently run your app project locally using Core Tools when you have OpenTelemetry enabled in the host. You currently need to deploy your code to Azure to validate your OpenTelemetry-related updates.
289+
To access diagnostics in your app:
284290
285-
+ At this time, only HTTP trigger and Azure SDK-based triggers are supported with OpenTelemetry outputs.
291+
1. In the [Azure portal](https://portal.azure.com) navigate to your function app resource.
292+
293+
1. In the left pane, select **Diagnose and solve problems** and search for the *Function App missing telemetry Application Insights or OpenTelemetry* workflow.
294+
295+
1. Select this workflow, choose your ingestion method, and select **Next**.
296+
297+
1. Review the guidelines and any recommendations provided by the troubleshooter.
286298
287299
## Related content
288300

includes/functions-opentelemetry-preview-note.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,9 @@
22
author: ggailey777
33
ms.service: azure-functions
44
ms.topic: include
5-
ms.date: 05/17/2024
5+
ms.date: 05/19/2025
66
ms.author: glenga
77
---
88
> [!IMPORTANT]
9-
> OpenTelemetry support for Azure Functions is currently in preview.
9+
> OpenTelemetry support for Azure Functions is currently in preview.
10+
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are not yet generally available.

0 commit comments

Comments
 (0)