用于 .NET、Java、Node.js 和 Python 应用程序的 Azure Monitor OpenTelemetry 筛选

许多检测库都提供筛选选项。 有关指导，请查看相应的 README 文件：

• ASP.NET Core
• HttpClient
• SqlClient

许多检测库都提供筛选选项。 有关指导，请查看相应的 README 文件：

• ASP.NET
• HttpClient
• SqlClient

使用 Java 代理版本 3.0.3+ 时，可以取消特定的自动收集遥测。 有关详细信息，请查看 Configuration 选项：Azure Monitor Application Insights for Java。

Java原生环境不支持禁止自动收集的遥测数据。 若要筛选遥测，请参阅相关的外部文档：

• Spring Boot - Spring Boot 入门
• Quarkus - 使用 OpenTelemetry 跟踪

以下示例演示如何使用 HTTP/HTTPS 监控库排除被跟踪的某个 URL：

// Import the useAzureMonitor function and the ApplicationInsightsOptions class from the @azure/monitor-opentelemetry package.
const { useAzureMonitor, ApplicationInsightsOptions } = require("@azure/monitor-opentelemetry");

// Import the HttpInstrumentationConfig class from the @opentelemetry/instrumentation-http package.
const { HttpInstrumentationConfig }= require("@opentelemetry/instrumentation-http");

// Import the IncomingMessage and RequestOptions classes from the http and https packages, respectively.
const { IncomingMessage } = require("http");
const { RequestOptions } = require("https");

// Create a new HttpInstrumentationConfig object.
const httpInstrumentationConfig: HttpInstrumentationConfig = {
    enabled: true,
    ignoreIncomingRequestHook: (request: IncomingMessage) => {
    // Ignore OPTIONS incoming requests.
    if (request.method === 'OPTIONS') {
        return true;
    }
    return false;
    },
    ignoreOutgoingRequestHook: (options: RequestOptions) => {
    // Ignore outgoing requests with the /test path.
    if (options.path === '/test') {
        return true;
    }
    return false;
    }
};

// Create a new ApplicationInsightsOptions object.
const config: ApplicationInsightsOptions = {
    instrumentationOptions: {
    http: {
        httpInstrumentationConfig
    }
    }
};

// Enable Azure Monitor integration using the useAzureMonitor function and the ApplicationInsightsOptions object.
useAzureMonitor(config);

以下示例演示如何使用 OTEL_PYTHON_EXCLUDED_URLS 环境变量排除跟踪某个 URL：

export OTEL_PYTHON_EXCLUDED_URLS="http://localhost:8080/ignore"

这样做将排除以下 Flask 示例中所示的终结点：

...
# Import the Flask and Azure Monitor OpenTelemetry SDK libraries.
import flask
from azure.monitor.opentelemetry import configure_azure_monitor

# Configure OpenTelemetry to use Azure Monitor with the specified connection string.
# Replace `<your-connection-string>` with the connection string to your Azure Monitor Application Insights resource.
configure_azure_monitor(
    connection_string="<your-connection-string>",
)

# Create a Flask application.
app = flask.Flask(__name__)

# Define a route. Requests sent to this endpoint will not be tracked due to
# flask_config configuration.
@app.route("/ignore")
def ignore():
    return "Request received but not tracked."
...

1. 使用自定义处理器：

   提示

   添加此处显示的处理器之前添加Azure Monitor。

   // Create an ASP.NET Core application builder.
   var builder = WebApplication.CreateBuilder(args);
   
   // Configure the OpenTelemetry tracer provider to add a new processor named ActivityFilteringProcessor.
   builder.Services.ConfigureOpenTelemetryTracerProvider((sp, builder) => builder.AddProcessor(new ActivityFilteringProcessor()));
   // Configure the OpenTelemetry tracer provider to add a new source named "ActivitySourceName".
   builder.Services.ConfigureOpenTelemetryTracerProvider((sp, builder) => builder.AddSource("ActivitySourceName"));
   // Add the Azure Monitor telemetry service to the application. This service will collect and send telemetry data to Azure Monitor.
   builder.Services.AddOpenTelemetry().UseAzureMonitor();
   
   // Build the ASP.NET Core application.
   var app = builder.Build();
   
   // Start the ASP.NET Core application.
   app.Run();
   

2. 使用以下代码将 ActivityFilteringProcessor.cs 添加到你的项目：

   public class ActivityFilteringProcessor : BaseProcessor<Activity>
   {
       // The OnStart method is called when an activity is started. This is the ideal place to filter activities.
       public override void OnStart(Activity activity)
       {
           // prevents all exporters from exporting internal activities
           if (activity.Kind == ActivityKind.Internal)
           {
               activity.IsAllDataRequested = false;
           }
       }
   }
   

如果没有使用 AddSource("ActivitySourceName") 显式添加特定源，则不会导出使用该源创建的任何活动。

1. 使用自定义处理器：

   // Create an OpenTelemetry tracer provider builder.
   // It is important to keep the TracerProvider instance active throughout the process lifetime.
   using var tracerProvider = Sdk.CreateTracerProviderBuilder()
           .AddSource("OTel.AzureMonitor.Demo") // Add a source named "OTel.AzureMonitor.Demo".
           .AddProcessor(new ActivityFilteringProcessor()) // Add a new processor named ActivityFilteringProcessor.
           .AddAzureMonitorTraceExporter() // Add the Azure Monitor trace exporter.
           .Build();
   

2. 使用以下代码将 ActivityFilteringProcessor.cs 添加到你的项目：

   public class ActivityFilteringProcessor : BaseProcessor<Activity>
   {
       // The OnStart method is called when an activity is started. This is the ideal place to filter activities.
       public override void OnStart(Activity activity)
       {
           // prevents all exporters from exporting internal activities
           if (activity.Kind == ActivityKind.Internal)
           {
               activity.IsAllDataRequested = false;
           }
       }
   }
   

如果没有使用 AddSource("ActivitySourceName") 显式添加特定源，则不会导出使用该源创建的任何活动。

若要筛选来自Java应用程序的遥测数据，可以使用采样替代（建议）或遥测处理器。 有关详细信息，请查看以下文档：

• 采样替代
• 遥测处理器（预览版）
• 遥测处理器示例

Java 原生环境不支持采样覆盖和遥测处理器。 若要筛选遥测，请参阅相关的外部文档：

• Spring Boot - Spring Boot 入门
• Quarkus - 使用 OpenTelemetry 跟踪

你可以使用自定义范围处理器来排除导出某些范围。 若要将范围标记为不导出，请将 TraceFlag 设置为 DEFAULT。

使用 自定义属性示例，但替换以下代码行：

// Import the necessary packages.
const { SpanKind, TraceFlags } = require("@opentelemetry/api");
const { ReadableSpan, Span, SpanProcessor } = require("@opentelemetry/sdk-trace-base");

// Create a new SpanEnrichingProcessor class.
class SpanEnrichingProcessor implements SpanProcessor {
    forceFlush(): Promise<void> {
        return Promise.resolve();
    }

    shutdown(): Promise<void> {
        return Promise.resolve();
    }

    onStart(_span: Span): void {}

    onEnd(span) {
        // If the span is an internal span, set the trace flags to NONE.
        if(span.kind == SpanKind.INTERNAL){
        span.spanContext().traceFlags = TraceFlags.NONE;
        }
    }
}

你可以使用自定义范围处理器来排除导出某些范围。 若要将范围标记为不导出，请将 TraceFlag 设置为 DEFAULT：

...
# Import the necessary libraries.
from azure.monitor.opentelemetry import configure_azure_monitor
from opentelemetry import trace

# Configure OpenTelemetry to use Azure Monitor with the specified connection string.
# Replace `<your-connection-string>` with the connection string to your Azure Monitor Application Insights resource.
configure_azure_monitor(
    connection_string="<your-connection-string>",
    # Configure the custom span processors to include span filter processor.
    span_processors=[span_filter_processor],
)

...

使用以下代码将 SpanFilteringProcessor 添加到你的项目：

# Import the necessary libraries.
from opentelemetry.trace import SpanContext, SpanKind, TraceFlags
from opentelemetry.sdk.trace import SpanProcessor

# Define a custom span processor called `SpanFilteringProcessor`.
class SpanFilteringProcessor(SpanProcessor):

    # Prevents exporting spans from internal activities.
    def on_start(self, span, parent_context):
        # Check if the span is an internal activity.
        if span._kind is SpanKind.INTERNAL:
            # Create a new span context with the following properties:
            #   * The trace ID is the same as the trace ID of the original span.
            #   * The span ID is the same as the span ID of the original span.
            #   * The is_remote property is set to `False`.
            #   * The trace flags are set to `DEFAULT`.
            #   * The trace state is the same as the trace state of the original span.
            span._context = SpanContext(
                span.context.trace_id,
                span.context.span_id,
                span.context.is_remote,
                TraceFlags(TraceFlags.DEFAULT),
                span.context.trace_state,
            )

有关故障排除信息，请参阅 排查 .NET 中的 OpenTelemetry 问题 ，以及 排查 Azure Monitor Application Insights 中缺少的应用程序遥测问题。

有关故障排除信息，请参阅 排查 .NET 中的 OpenTelemetry 问题 ，以及 排查 Azure Monitor Application Insights 中缺少的应用程序遥测问题。

有关故障排除的信息，请参阅 在 Java 中排查 OpenTelemetry 问题的方法 ，以及 在 Azure Monitor Application Insights 中排查应用程序遥测丢失的问题。

有关故障排除指南，请参阅 在 Spring Boot 原生镜像应用程序中处理 OpenTelemetry 问题 和 排查 Azure Monitor Application Insights 中缺少的应用程序遥测问题。

有关故障排除信息，请参阅 排查 Node.js中的 OpenTelemetry 问题 ，以及 排查 Azure Monitor Application Insights 中缺少的应用程序遥测问题。

有关故障排除信息，请参阅 排查 Python 中的 OpenTelemetry 问题 ，以及 排查 Azure Monitor Application Insights 中缺少的应用程序遥测问题。

• 如有 Azure 支持方面的问题，请提交 Azure 支持工单。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry .NET 社区联系。
• 有关与 Azure Monitor 导出程序相关的未解决问题列表，请参阅 GitHub 问题页。

• 如有 Azure 支持方面的问题，请提交 Azure 支持工单。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry .NET 社区联系。
• 有关与 Azure Monitor 导出程序相关的未解决问题列表，请参阅 GitHub 问题页。

• 如有 Azure 支持方面的问题，请提交 Azure 支持工单。
• 有关疑难解答的帮助，请参阅疑难解答步骤。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry 社区联系。
• 有关 Azure Monitor Java 自动探测相关的待处理问题列表，请参阅 GitHub 问题页。

• 如有 Azure 支持方面的问题，请提交 Azure 支持工单。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry 社区联系。
• 有关 Spring Boot 本机应用程序的开放问题列表，请参阅 GitHub 问题页面。
• 有关 Quarkus 本机应用程序的待解决问题列表，请参阅 GitHub 问题页。

• 如有 Azure 支持方面的问题，请提交 Azure 支持工单。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry JavaScript 社区联系。
• 有关与 Azure Monitor 导出程序相关的未解决问题列表，请参阅 GitHub 问题页。

• 如有 Azure 支持方面的问题，请提交 Azure 支持工单。
• 有关 OpenTelemetry 问题，请直接与 OpenTelemetry Python 社区联系。
• 有关与 Azure Monitor Distro 相关的未解决问题列表，请参阅 GitHub 问题页。

• 若要查看源代码，请参阅 Azure Monitor ASP.NET Core GitHub 存储库。
• 若要查看示例应用程序，请参阅 适用于 ASP.NET Core 的 Azure Monitor OpenTelemetry。
• 若要安装 NuGet 包、检查更新或查看发行说明，请参阅 Azure Monitor AspNetCore NuGet 包页面。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请参阅 OpenTelemetry .NET GitHub 存储库。
• 若要启用使用体验， 请启用 Web 或浏览器用户监视。

• 若要查看源代码，请参阅 Azure Monitor 导出器 GitHub 存储库。
• 若要查看示例应用程序，请参阅 适用于 .NET 的 Azure Monitor OpenTelemetry。
• 若要安装 NuGet 包、检查更新或查看发行说明，请参阅 Azure Monitor 导出程序 NuGet 包 页。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请参阅 OpenTelemetry .NET GitHub 存储库。
• 若要启用使用体验， 请启用 Web 或浏览器用户监视。

• 若要查看配置选项，请参阅 Java 自动检测配置选项。
• 若要查看源代码，请参阅 Azure Monitor Java 自动检测 GitHub 存储库。
• 若要查看示例应用程序，请参阅 Application Insights Java 示例。
• 查看GitHub上的 release 注释。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请查看 OpenTelemetry Java GitHub 存储库。
• 若要启用使用体验功能，请查看“启用网络或浏览器用户监视”。

• 若要查看源代码，请参阅 Spring Boot 原生映像 Java 应用程序中的 Azure Monitor OpenTelemetry 发行版 和 Quarkus OpenTelemetry Exporter for Azure。
• 若要查看示例应用程序，请参阅 GraalVM 原生映像遥测。
• 查看GitHub上的 release 注释。
• 在 OpenTelemetry SpringBoot 入门中详细了解 Spring Boot 原生映像应用程序的功能
• 在 Quarkus OpenTelemetry Exporter for Azure 中详细了解 Quarkus 原生应用程序的功能。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请查看 OpenTelemetry Java GitHub 存储库。

• 若要查看源代码，请参阅 适用于 JavaScript 存储库的 Azure Monitor OpenTelemetry。
• 若要查看示例应用程序，请参阅 Azure Monitor OpenTelemetry for Node.js。
• 若要安装 npm 包并检查更新，请参阅 @azure/monitor-opentelemetry npm 包页面。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请参阅 OpenTelemetry JavaScript GitHub 存储库。
• 若要启用使用体验， 请启用 Web 或浏览器用户监视。

• 若要查看源代码和额外文档，请参阅 Azure Monitor Python GitHub 存储库。
• 若要查看示例应用程序，请参阅 适用于 Python 的 Azure Monitor OpenTelemetry。
• 若要安装 PyPI 包并检查更新，请参阅 Azure Monitor 发行版 PyPI 包 页。
• 查看GitHub上的 release 注释。
• 若要查看可用的 OpenTelemetry 检测和组件，请参阅 OpenTelemetry 参与者 Python GitHub 存储库。
• 若要了解有关 OpenTelemetry 及其社区的详细信息，请查看 OpenTelemetry Python GitHub 存储库。
• 若要启用使用体验， 请启用 Web 或浏览器用户监视。