AWS.Messaging.Telemetry.OpenTelemetry 0.9.1

用于.NET的AWS消息处理框架的OpenTelemetry插件

注意： 此库处于开发者预览版。它提供对即将推出的aws消息处理框架中的功能的早期访问。1.0.0之前的所有发布可能包含破坏性更改。

此软件包是一种仪表库，用于配‍置AWS消息处理框架的 .NET，以收集发送和接收的消息的跟踪信息。

配置

1. 安装软件包

添加对 AWS.Messaging.Telemetry.OpenTelemetry 的引用。在这个例子中，我们将配置我们的 IServiceCollection 上的 OpenTelemetry，因此也要添加对 OpenTelemetry.Extensions.Hosting 的引用。如果通过 CreateTracerProviderBuilder 来启动和停止跟踪，则不需要此引用。

您还可以添加一个或多个 导出器 来可视化您的遥测数据。

dotnet add package AWS.Messaging.Telemetry.OpenTelemetry
dotnet add package OpenTelemetry.Extensions.Hosting

2. 启用仪器化

在 Startup 类中添加对 AddOpenTelemetry 的调用以配置 OpenTelemetry。在 TracerProviderBuilder 上调用 AddAWSMessagingInstrumentation 以开始捕获 .NET 的 AWS Message Processing Framework 的跟踪。

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddAWSMessageBus(builder =>
        {
            builder.AddSQSPoller("https://sqs.us-west-2.amazonaws.com/012345678910/MPF");
            builder.AddMessageHandler<ChatMessageHandler, ChatMessage>("chatMessage");
        });

        services.AddOpenTelemetry()
            .ConfigureResource(resource => resource.AddService("myApplication"))
            .WithTracing(tracing => tracing
                .AddAWSMessagingInstrumentation()
                .AddConsoleExporter());
    }
}

有用链接

• AWS Message Processing Framework for .NET 设计文档
• 演示应用 - 包含发布者服务、长时间运行的订阅者服务、Lambda 函数处理程序以及使用 Polly 覆盖框架内置回退逻辑的示例应用。
• 开发人员指南
• API 参考
• 介绍 AWS Message Processing Framework for .NET 预览版（预览）博客文章 - 演示如何创建简单应用程序以发送和接收 SQS 消息。

安全性

有关更多信息，请参阅 CONTRIBUTING。

许可

本项目采用 Apache-2.0 许可证。