DEV Community
·
无全局变量的Go OTEL追踪
内容提要
本文讨论了在Go服务中添加OTEL追踪的过程，强调了OTEL SDK的复杂性，建议使用结构体传递追踪组件，避免全局变量。通过环境变量设置OTEL端点，推荐在HTTP服务器中使用OTEL插件，并提供了创建路由器和处理请求的示例。最后总结了避免全局变量、使用环境变量和过滤特定请求的重要性。
关键要点
-
在Go服务中添加OTEL追踪的过程涉及多个组件的传递，避免使用全局变量。
-
需要传递的关键组件包括trace.Tracer、trace.TracerProvider和propagation.TextMapPropagator。
-
使用环境变量设置OTEL端点，便于在不修改代码的情况下进行更改。
-
推荐在HTTP服务器中使用OTEL插件，确保与路由器兼容。
-
可以通过过滤特定路径（如/healthcheck和/metrics）来避免不必要的追踪。
-
在处理请求时，确保正确记录错误并设置状态。
-
HTTP客户端需要传递必要的组件以注入追踪头。
延伸解读
避免全局变量的好处
在Go服务中使用OTEL追踪时，避免全局变量可以提高代码的可维护性和可测试性。全局变量可能导致状态管理混乱，增加调试难度。通过将追踪组件封装在结构体中，可以更清晰地管理依赖关系，降低耦合度。
环境变量的灵活性
使用环境变量配置OTEL端点和其他参数，使得在不同环境中部署时无需修改代码。这种做法不仅提高了灵活性，还能减少因代码变更引发的潜在错误，适合持续集成和持续部署的场景。
请求过滤的重要性
在进行OTEL追踪时，过滤特定请求（如/healthcheck和/metrics）可以避免不必要的追踪数据，减少系统负担。这有助于提高追踪数据的质量，使开发者更专注于关键业务逻辑的性能监控。
延伸问答
在Go服务中如何添加OTEL追踪？
在Go服务中添加OTEL追踪需要传递trace.Tracer、trace.TracerProvider和propagation.TextMapPropagator等组件，避免使用全局变量。
为什么不建议在Go中使用全局变量？
不建议使用全局变量是因为它们会增加代码的复杂性和不易维护性，建议通过结构体传递所需组件。
如何通过环境变量设置OTEL端点？
可以通过环境变量设置OTEL端点，这样可以在不修改代码的情况下进行更改，提升灵活性。
在HTTP服务器中如何使用OTEL插件？
在HTTP服务器中使用OTEL插件时，建议选择与所用路由器兼容的插件，并在创建路由器时传递OTEL相关组件。
如何过滤特定请求以避免不必要的追踪？
可以通过定义过滤函数，排除特定路径（如/healthcheck和/metrics）来避免不必要的追踪。
在处理请求时如何记录错误？
在处理请求时，可以使用span.RecordError(err)记录错误，并使用span.SetStatus设置状态。
