https://github.com/opentracing-contrib/go-grpc

Package otgrpc provides OpenTracing support for any gRPC client or server.
https://github.com/opentracing-contrib/go-grpc

go grpc opentracing

Last synced: 1 day ago
JSON representation

Package otgrpc provides OpenTracing support for any gRPC client or server.

• Host: GitHub
• URL: https://github.com/opentracing-contrib/go-grpc
• Owner: opentracing-contrib
• License: apache-2.0
• Created: 2018-05-07T21:27:58.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2025-01-24T09:13:17.000Z (9 days ago)
• Last Synced: 2025-01-25T03:15:07.721Z (8 days ago)
• Topics: go, grpc, opentracing
• Language: Go
• Homepage:
• Size: 60.5 KB
• Stars: 73
• Watchers: 4
• Forks: 11
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# OpenTracing support for gRPC in Go

[![CI](https://github.com/opentracing-contrib/go-grpc/actions/workflows/ci.yml/badge.svg)](https://github.com/opentracing-contrib/go-grpc/actions/workflows/ci.yml)

[![Go Report Card](https://goreportcard.com/badge/github.com/opentracing-contrib/go-grpc)](https://goreportcard.com/report/github.com/opentracing-contrib/go-grpc)

![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/opentracing-contrib/go-grpc)

[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/opentracing-contrib/go-grpc?logo=github&sort=semver)](https://github.com/opentracing-contrib/go-grpc/releases/latest)

The `otgrpc` package makes it easy to add OpenTracing support to gRPC-based

systems in Go.

## Installation

```shell

go get github.com/opentracing-contrib/go-grpc

```

## Documentation

See the basic usage examples below and the [package documentation on

godoc.org](https://godoc.org/github.com/opentracing-contrib/go-grpc).

## Client-side usage example

Wherever you call `grpc.Dial`:

```go

// You must have some sort of OpenTracing Tracer instance on hand.

var tracer opentracing.Tracer = ...

...

// Set up a connection to the server peer.

conn, err := grpc.Dial(

    address,

    ... // other options

    grpc.WithUnaryInterceptor(

        otgrpc.OpenTracingClientInterceptor(tracer)),

    grpc.WithStreamInterceptor(

        otgrpc.OpenTracingStreamClientInterceptor(tracer)))

// All future RPC activity involving `conn` will be automatically traced.

```

## Server-side usage example

Wherever you call `grpc.NewServer`:

```go

// You must have some sort of OpenTracing Tracer instance on hand.

var tracer opentracing.Tracer = ...

...

// Initialize the gRPC server.

s := grpc.NewServer(

    ... // other options

    grpc.UnaryInterceptor(

        otgrpc.OpenTracingServerInterceptor(tracer)),

    grpc.StreamInterceptor(

        otgrpc.OpenTracingStreamServerInterceptor(tracer)))

// All future RPC activity involving `s` will be automatically traced.

```