Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/connectrpc/otelconnect-go

OpenTelemetry tracing and metrics for Connect.
https://github.com/connectrpc/otelconnect-go

connectrpc golang grpc metrics opentelemetry prometheus rpc tracing

Last synced: 2 months ago
JSON representation

OpenTelemetry tracing and metrics for Connect.

Host: GitHub
URL: https://github.com/connectrpc/otelconnect-go
Owner: connectrpc
License: apache-2.0
Created: 2022-06-03T20:14:27.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-07-24T13:29:43.000Z (4 months ago)
Last Synced: 2024-07-24T15:33:23.734Z (4 months ago)
Topics: connectrpc, golang, grpc, metrics, opentelemetry, prometheus, rpc, tracing
Language: Go
Homepage: https://connectrpc.com
Size: 441 KB
Stars: 116
Watchers: 14
Forks: 25
Open Issues: 6
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

README

        otelconnect

===========

[![Build](https://github.com/connectrpc/otelconnect-go/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/connectrpc/otelconnect-go/actions/workflows/ci.yaml)

[![Report Card](https://goreportcard.com/badge/connectrpc.com/otelconnect)](https://goreportcard.com/report/connectrpc.com/otelconnect)

[![GoDoc](https://pkg.go.dev/badge/connectrpc.com/otelconnect.svg)][godoc]

`connectrpc.com/otelconnect` adds support for [OpenTelemetry][opentelemetry.io]

tracing and metrics collection to [Connect][connect] servers and clients.

For more on Connect, OpenTelemetry, and `otelconnect`, see the [Connect

announcement blog post][blog] and the observability documentation on

[connectrpc.com](https://connectrpc.com/docs/go/observability/).

## An example

```go

package main

import (

	"context"

	"fmt"

	"log"

	"net/http"

	"connectrpc.com/connect"

	"connectrpc.com/otelconnect"

	// Generated from your protobuf schema by protoc-gen-go and

	// protoc-gen-connect-go.

	pingv1 "connectrpc.com/otelconnect/internal/gen/observability/ping/v1"

	"connectrpc.com/otelconnect/internal/gen/observability/ping/v1/pingv1connect"

)

func main() {

	mux := http.NewServeMux()

	otelInterceptor, err := otelconnect.NewInterceptor()

	if err != nil {

		log.Fatal(err)

	}

	// otelconnect.NewInterceptor provides an interceptor that adds tracing and

	// metrics to both clients and handlers. By default, it uses OpenTelemetry's

	// global TracerProvider and MeterProvider, which you can configure by

	// following the OpenTelemetry documentation. If you'd prefer to avoid

	// globals, use otelconnect.WithTracerProvider and

	// otelconnect.WithMeterProvider.

	mux.Handle(pingv1connect.NewPingServiceHandler(

		&pingv1connect.UnimplementedPingServiceHandler{},

		connect.WithInterceptors(otelInterceptor),

	))

	http.ListenAndServe("localhost:8080", mux)

}

func makeRequest() {

	otelInterceptor, err := otelconnect.NewInterceptor()

	if err != nil {

		log.Fatal(err)

	}

	client := pingv1connect.NewPingServiceClient(

		http.DefaultClient,

		"http://localhost:8080",

		connect.WithInterceptors(otelInterceptor),

	)

	resp, err := client.Ping(

		context.Background(),

		connect.NewRequest(&pingv1.PingRequest{}),

	)

	if err != nil {

		log.Fatal(err)

	}

	fmt.Println(resp)

}

```

## Configuration for internal services

By default, instrumented servers are conservative and behave as though they're

internet-facing. They don't trust any tracing information sent by the client,

and will create new trace spans for each request. The new spans are linked to

the remote span for reference (using OpenTelemetry's

[`trace.Link`](https://pkg.go.dev/go.opentelemetry.io/otel/trace#Link)), but

tracing UIs will display the request as a new top-level transaction.

If your server is deployed as an internal service, configure `otelconnect` to

trust the client's tracing information using

[`otelconnect.WithTrustRemote`][WithTrustRemote]. With this option, servers

will create child spans for each request.

## Reducing metrics and tracing cardinality

By default, the [OpenTelemetry RPC conventions][otel-rpc-conventions] produce

high-cardinality server-side metric and tracing output. In particular, servers

tag all metrics and trace data with the server's IP address and the remote port

number. To drop these attributes, use

[`otelconnect.WithoutServerPeerAttributes`][WithoutServerPeerAttributes]. For

more customizable attribute filtering, use

[otelconnect.WithFilter][WithFilter].

## Status

|         | Unary | Streaming Client | Streaming Handler |

|---------|:-----:|:----------------:|:-----------------:|

| Metrics | ✅    | ✅               | ✅                |

| Tracing | ✅    | ✅               | ✅                |

## Ecosystem

* [connect-go][connect]: Service handlers and clients for Go

* [connect-swift]: Swift clients for idiomatic gRPC & Connect RPC

* [connect-kotlin]: Kotlin clients for idiomatic gRPC & Connect RPC

* [connect-es]: Type-safe APIs with Protobuf and TypeScript.

* [Buf Studio]: web UI for ad-hoc RPCs

* [conformance]: Connect, gRPC, and gRPC-Web interoperability tests

## Support and Versioning

`otelconnect` supports:

* The [two most recent major releases][go-support-policy] of Go.

* v1 of the `go.opentelemetry.io/otel` tracing and metrics SDK.

## Legal

Offered under the [Apache 2 license][license].

[Buf Studio]: https://buf.build/studio

[Getting Started]: https://connectrpc.com/docs/go/getting-started

[WithFilter]: https://pkg.go.dev/connectrpc.com/otelconnect#WithFilter

[WithTrustRemote]: https://pkg.go.dev/connectrpc.com/otelconnect#WithTrustRemote

[WithoutServerPeerAttributes]: https://pkg.go.dev/connectrpc.com/otelconnect#WithoutServerPeerAttributes

[blog]: https://buf.build/blog/connect-a-better-grpc

[conformance]: https://github.com/connectrpc/conformance

[connect]: https://github.com/connectrpc/connect-go

[connect-kotlin]: https://github.com/connectrpc/connect-kotlin

[connect-swift]: https://github.com/connectrpc/connect-swift

[connect-es]: https://github.com/connectrpc/connect-es

[docs]: https://connectrpc.com

[go-support-policy]: https://golang.org/doc/devel/release#policy

[godoc]: https://pkg.go.dev/connectrpc.com/otelconnect

[license]: https://github.com/connectrpc/otelconnect-go/blob/main/LICENSE

[opentelemetry.io]: https://opentelemetry.io/

[otel-go-quickstart]: https://opentelemetry.io/docs/instrumentation/go/getting-started/

[otel-go]: https://github.com/open-telemetry/opentelemetry-go

[otel-rpc-conventions]: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/rpc/README.md