使用go-sdk将指标发送到Opentelemetry的步骤与方法

我尝试使用 go-sdk 将指标推送到 opentelemetry，但我没有找到任何有关它的文档。到目前为止，我尝试使用这段代码，但不知道下一步是什么，说实话，我对提供者和读者的东西有点困惑，我是监控方面的新手

func main() {
    ctx := context.Background()

    res, err := resource.New(ctx, resource.WithAttributes(semconv.ServiceName("my-service")))
    if err != nil {
        panic(err)
    }

    ctx, cancel := context.WithTimeout(ctx, time.Second)
    defer cancel()
    conn, err := grpc.DialContext(ctx, "localhost:4317", grpc.WithTransportCredentials(insecure.NewCredentials()), grpc.WithBlock())
    if err != nil {
        panic(err)
    }

    metricExporter, err := otlpmetricgrpc.New(ctx, otlpmetricgrpc.WithGRPCConn(conn))
    if err != nil {
        panic(err)
    }

    exporter, err := prometheus.New()
    if err != nil {
        panic(err)
    }

    provider := metric.NewMeterProvider(metric.WithReader(exporter))
    meter := provider.Meter("github.com/open-telemetry/opentelemetry-go/example/prometheus")

    counter, err := meter.Float64Counter("foo", instrument.WithDescription("a simple counter"))
    if err != nil {
        panic(err)
    }
    counter.Add(ctx, 5)

    reader := metric.NewPeriodicReader(metricExporter, metric.WithInterval(1*time.Second))

}

到目前为止，我所掌握的源信息来自此处的示例和此处的示例

正确答案

首先，值得注意的是，OTel Go 指标 API 和 SDK 目前被认为不稳定。我将尽力将我的答案集中在稳定的 OpenTelemetry 指标规范中包含的更高级别的项目上，这样它就不会过时。以下任何特定于 go 的内容都可能会发生变化。

您似乎正在尝试设置两种不同类型的出口商。 Prometheus 导出器由 Prometheus 抓取，并且 otelmetricgrpc 导出器创建一个连接，通过 OTLP 将指标推送到 OpenTelemetry Collector 等接收器。您可能只需要其中之一，而不是两者都需要。您链接的第一个示例实际上仅用于跟踪，而不是指标，但原理大致相同。

任何 OpenTelemetry SDK 中指标的入口点都是 meter 提供商 。仪表提供程序处理与度量相关的配置、聚合和数据导出。这也是用户获取 meters 的方式。每个代码模块通常都有自己的仪表。根据该仪表指标创建，并根据这些指标记录数据点。所有指标点都聚合在一起并通过计量提供商回流。

为了从仪表提供商读取指标，您需要某种 metric reader 。如果您尝试使用 OTLP 等协议推送指标，则可以使用定期导出指标读取器之类的工具，该读取器定期从计量提供商收集指标并使用导出器导出它们。

如果您尝试使用基于拉动的度量系统（例如普罗米修斯），则导出器的作用类似于度量读取器，并在度量系统每次请求抓取端点时读取度量。这就是您链接的第二个示例中所做的事情。 serveMetrics 函数打开侦听端口 2223 并处理对 localhost:2223/metrics 的请求的 Web 服务器。每次 GET 请求进入该端点时，都会根据仪表提供程序配置聚合指标并在响应正文中返回。这允许像 Prometheus 这样的系统定期从您的应用程序请求指标。