1. 什么是 OpenObserve？

  • OpenObserve 是一个开源的可观测性平台（支持日志、指标、追踪），旨在成为 Elasticsearch/Datadog 的轻量级替代方案。

  • 它支持通过 OpenTelemetry（OTLP）协议接收数据。

2. 搭建 OpenObserve

  • docker 本地运行或部署 OpenObserve（参考 官方文档）：

  • docker run -d --name openobserve -p 5080:5080 -e ZO_ROOT_USER_EMAIL="root@example.com" -e ZO_ROOT_USER_PASSWORD="root123" public.ecr.aws/zinclabs/openobserve:latest

  • 访问 http://localhost:5080（默认账号：root@example.com，密码：root123）。

3. .NET Core 的 OpenTelemetry 配置

  • 安装必要的 NuGet 包：

    <PackageReference Include="OpenTelemetry.Exporter.Console" Version="1.10.0" />
    <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.10.0" />
    <PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.10.0" />
    <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.10.0" />
    <PackageReference Include="OpenTelemetry.Instrumentation.Http" Version="1.10.0" />
    <PackageReference Include="OpenTelemetry.Instrumentation.Runtime" Version="1.10.0" />

4. 在 .NET Core 中配置 OpenTelemetry

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
var builder = WebApplication.CreateBuilder(args);<br> //base
var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes( "root@example.com:root123" ));
// 配置OpenTelemetry 日志Log
builder.Logging.ClearProviders();
 
var resourceBuilder = ResourceBuilder.CreateDefault()
     .AddService( "xxxapi" )
     .AddAttributes( new Dictionary< string , object >
     {
         [ "environment" ] = "development" ,
         [ "service.version" ] = "1.0.0"
     });
 
builder.Logging.AddOpenTelemetry(logging => {
     logging.IncludeFormattedMessage = true ;
     logging.SetResourceBuilder(resourceBuilder)
         .AddConsoleExporter()  // Keep console logging for debugging
         .AddOtlpExporter(otlpOptions => {
             otlpOptions.BatchExportProcessorOptions = new BatchExportProcessorOptions<Activity>
             {
                 MaxQueueSize = 100,        // 减小队列避免堆积
                 MaxExportBatchSize = 10,   // 减小批量大小
                 ScheduledDelayMilliseconds = 500, // 更频繁导出
             };
             otlpOptions.Endpoint = new Uri( "http://localhost:5080/api/default/v1/logs" );
             otlpOptions.Headers = $ "Authorization=Basic {credentials}" ;
             otlpOptions.Protocol = OpenTelemetry.Exporter.OtlpExportProtocol.HttpProtobuf;
         });
});
 
// Add services to the container.
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(c =>
{
     c.SwaggerDoc( "v1" , new OpenApiInfo { Title = "xxx API" , Version = "v1" });
});
builder.Services.AddHttpClient();
 
// 配置 OpenTelemetry 追踪Tracing
builder.Services.AddOpenTelemetry()
     .WithTracing(builder => builder
         .SetResourceBuilder(resourceBuilder)
         .AddSource( "xxxapi" )
         .AddAspNetCoreInstrumentation()
         .AddHttpClientInstrumentation()
         .AddOtlpExporter(opts =>
         {
             opts.Endpoint = new Uri( "http://localhost:5080/api/default/v1/traces" );
             opts.Headers = $ "Authorization=Basic {credentials}" ;
             opts.Protocol = OpenTelemetry.Exporter.OtlpExportProtocol.HttpProtobuf;
         }));
 
var app = builder.Build();
        
// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
     app.UseSwagger();
     app.UseSwaggerUI(c => c.SwaggerEndpoint( "/swagger/v1/swagger.json" , "xxx API v1" ));
}
 
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();
 
app.Run();

5. 关键细节

  • OTLP 端点：OpenObserve 使用 /api/default/接收 OTLP 数据。

  • 认证：默认使用基本认证（账号 root@example.com，密码 root123）。需将凭据编码为 Base64：

    ?
    1
    2
    3
    // 将 "root@example.com:root123" 转为 Base64
    var credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes( "root@example.com:root123" ));
    opt.Headers = $ "Authorization=Basic {credentials}" ;

  • 数据类型：上述配置会向 OpenObserve 发送追踪（Traces）、指标（Metrics）和日志（Logs）。

6. 在 OpenObserve 中验证数据

  • 访问 http://localhost:5080：

    • 日志：在 Logs Explorer 中查看。

    •  

    • 追踪：在 Traces Explorer 中查看。

    •  

    • 指标：在 Metrics Explorer 中查看。

    •  

7. 故障排除

  • 确保 OpenObserve 正在运行。

  • 检查 OTLP 端点和认证头是否正确。

  • 启用 OpenTelemetry 的诊断输出（调试用）：

         logging.AddConsoleExporter() //将日志数据输出到控制台

         tracing.AddConsoleExporter() //将追踪数据输出到控制台

     

更多参考：

 

原创作者: honglinjia 转载于: https://www.cnblogs.com/honglinjia/p/18803657
# .netcore
Logo
火山引擎 ADG 社区

火山引擎开发者社区是火山引擎打造的AI技术生态平台，聚焦Agent与大模型开发，提供豆包系列模型（图像/视频/视觉）、智能分析与会话工具，并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长，新用户可领50万Tokens权益，助力构建智能应用。

更多推荐

Chess用户界面设计：Tailwind CSS样式系统和组件库

GitHub推荐项目精选中的ch/chess是一个类似chess.com的多人在线象棋平台，它采用现代化的前端技术栈构建，尤其在用户界面设计上通过Tailwind CSS样式系统和组件库实现了优雅且功能丰富的交互体验。本文将深入探讨该项目如何利用Tailwind CSS打造一致的设计语言和高效的组件系统，为象棋爱好者提供沉浸式的游戏界面。## 🎨 Tailwind CSS样式系统：构建统一视

avatar 火山引擎 ADG 社区

终极指南：GPT-Engineer如何通过AI自动发现代码问题并提升质量

GPT-Engineer是一款强大的AI驱动代码工具，它能帮助开发者自动检测潜在代码问题、优化代码质量，让编程效率提升3倍以上。无论是新手还是资深开发者，都能通过这款工具轻松发现代码中的隐藏缺陷，减少调试时间，释放更多精力在创造性工作上。## 一键发现代码问题：GPT-Engineer的AI审查魔力GPT-Engineer的核心能力在于其内置的智能代码分析系统。通过集成Python代码格式

avatar 火山引擎 ADG 社区

SatDump中的纠错编码技术：从RS码到Turbo码的完整实现指南

在卫星数据传输过程中，信号往往会受到各种干扰，导致数据错误。SatDump作为一款通用卫星数据处理软件，集成了多种先进的纠错编码技术，确保从卫星接收到的数据能够准确解码。本文将深入解析SatDump中从Reed-Solomon（RS）码到Turbo码的实现细节，帮助读者理解这些技术如何保障卫星通信的可靠性。## 为什么纠错编码对卫星数据至关重要？卫星与地面站之间的通信链路面临着空间辐射、大

avatar 火山引擎 ADG 社区