Merge pull request #276474 from AaronMaxwell/aaronmax-otel-livemetrics

OTEL Live Metrics

Author: prmerger-automator[bot]

articles/azure-monitor/app/opentelemetry-configuration.md

@@ -302,7 +302,7 @@ export OTEL_SERVICE_NAME="my-helloworld-service"
 
 ## Enable Sampling
 
-You might want to enable sampling to reduce your data ingestion volume, which reduces your cost. Azure Monitor provides a custom *fixed-rate* sampler that populates events with a sampling ratio, which Application Insights converts to `ItemCount`. The *fixed-rate* sampler ensures accurate experiences and event counts. The sampler is designed to preserve your traces across services, and it's interoperable with older Application Insights SDKs. For more information, see [Learn More about sampling](sampling.md#brief-summary).
+You might want to enable sampling to reduce your data ingestion volume, which reduces your cost. Azure Monitor provides a custom *fixed-rate* sampler that populates events with a sampling ratio, which Application Insights converts to `ItemCount`. The *fixed-rate* sampler ensures accurate experiences and event counts. The sampler is designed to preserve your traces across services, and it's interoperable with older Application Insights Software Development Kits (SDKs). For more information, see [Learn More about sampling](sampling.md#brief-summary).
 
 > [!NOTE]
 > Metrics and Logs are unaffected by sampling.
@@ -385,6 +385,86 @@ export OTEL_TRACES_SAMPLER_ARG=0.1
 
 <a name='enable-entra-id-formerly-azure-ad-authentication'></a>
 
+## Live metrics
+
+[Live metrics](live-stream.md) provides a real-time analytics dashboard for insight into application activity and performance.
+
+#### [ASP.NET Core](#tab/aspnetcore)
+
+> [!IMPORTANT]
+> 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 in beta, preview, or otherwise not yet released into general availability.
+
+This feature is enabled by default.
+
+Users can disable Live Metrics when configuring the Distro.
+
+```csharp
+builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
+	// Disable the Live Metrics feature.
+    options.EnableLiveMetrics = false;
+});
+```
+
+#### [.NET](#tab/net)
+
+This feature isn't available in the Azure Monitor .NET Exporter.
+
+#### [Java](#tab/java)
+
+The Live Metrics experience is enabled by default.
+
+For more information on Java configuration, see [Configuration options: Azure Monitor Application Insights for Java](java-standalone-config.md#configuration-options-azure-monitor-application-insights-for-java).
+
+#### [Node.js](#tab/nodejs)
+
+> [!IMPORTANT]
+> 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 in beta, preview, or otherwise not yet released into general availability.
+
+Users can enable/disable Live Metrics when configuring the Distro using the `enableLiveMetrics` property.
+
+```typescript
+const options: AzureMonitorOpenTelemetryOptions = {
+    azureMonitorExporterOptions: {
+        connectionString:
+            process.env["APPLICATIONINSIGHTS_CONNECTION_STRING"] || "<your connection string>",
+    },
+    enableLiveMetrics: false
+};
+
+useAzureMonitor(options);
+```
+
+<!--
+
+TODO:
+
+This feature is/isn't enabled by default.
+
+Functionality and customization are covered in the following configuration sample.
+
+```
+Configuration sample
+```
+
+-->
+
+#### [Python](#tab/python)
+
+> [!IMPORTANT]
+> 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 in beta, preview, or otherwise not yet released into general availability.
+
+You can enable live metrics using the Azure monitor OpenTelemetry Distro for Python as follows:
+
+```python
+...
+configure_azure_monitor(
+	enable_live_metrics=True
+)
+...
+```
+
+---
+
 ## Enable Microsoft Entra ID (formerly Azure AD) authentication
 
 You might want to enable Microsoft Entra authentication for a more secure connection to Azure, which prevents unauthorized telemetry from being ingested into your subscription.
@@ -874,4 +954,4 @@ For more information about OpenTelemetry SDK configuration, see the [OpenTelemet
 
 [!INCLUDE [azure-monitor-app-insights-opentelemetry-faqs](../includes/azure-monitor-app-insights-opentelemetry-faqs.md)]
 
-[!INCLUDE [azure-monitor-app-insights-opentelemetry-support](../includes/azure-monitor-app-insights-opentelemetry-support.md)]
+[!INCLUDE [azure-monitor-app-insights-opentelemetry-support](../includes/azure-monitor-app-insights-opentelemetry-support.md)]

articles/azure-monitor/includes/azure-monitor-app-insights-opentelemetry-faqs.md

@@ -93,7 +93,7 @@ The following chart breaks out OpenTelemetry feature support for each language.
 | [Logs collection](../app/asp-net-trace-logs.md)                                                                       | :white_check_mark: | :warning:          | :white_check_mark: | :white_check_mark: |
 | [Custom Events](../app/usage-overview.md#custom-business-events)                                                      | :warning:          | :warning:          | :warning:          | :white_check_mark: |
 | [Microsoft Entra authentication](../app/azure-ad-authentication.md)                                                   | :white_check_mark: | :white_check_mark: | :white_check_mark: | :white_check_mark: |
-| [Live metrics](../app/live-stream.md)                                                                                 | :x:                | :x:                | :x:                | :white_check_mark: |
+| [Live metrics](../app/live-stream.md)                                                                                 | :warning:          | :warning:          | :warning:          | :white_check_mark: |
 | Detect Resource Context for VM/VMSS and App Service                                                                   | :white_check_mark: | :x:                | :white_check_mark: | :white_check_mark: |
 | Detect Resource Context for Azure Kubernetes Service (AKS) and Functions                                              | :x:                | :x:                | :x:                | :white_check_mark: |           
 | Availability Testing Span Filtering                                                                                   | :x:                | :x:                | :x:                | :white_check_mark: |