open-telemetry/opentelemetry-specification

Feedback from a newcomer on logging specs

开放

#1,806 创建于 2021年7月8日

 (2 条评论) (2 个反应) (0 位负责人)Makefile (987 个派生)auto 404
Stalehelp wantedspec:logs

仓库指标

星标
 (4,267 个星标)
PR 合并指标
 (PR 指标待抓取)

描述

What are you trying to achieve?

I was reading the spec regarding the logs in attempt to understand what I can do to implement it.

What did you expect to see?

From reading the overview, it wasn’t at all clear that logs are meant to be shipped using OTLP, which is an established protocol one should be aware of.

After asking around, I learnt about OTLP. Having re-read the overview, I can see OTLP being mentioned, but I think there should be a section somewhere at the top that addresses it more explicitly. That section should say that the spec is about the wire format for log, and transport protocol is OTLP, it should also provide a short summary of what OTLP actually is.

Additionally, I found all reference to the collector in the overview document on logs rather confusing, I wished these were spared for a a blog post or some other content. This makes it seem like the spec is heavily tied to the current implementation of the collector, but from what I gathered it doesn't seem to be intended that way.

贡献者指南