https://github.com/ericvolp12/connect-interceptors

A library of interceptors for ConnectRPC that I've found handy
https://github.com/ericvolp12/connect-interceptors

buf connect connectrpc golang

Last synced: over 1 year ago
JSON representation

A library of interceptors for ConnectRPC that I've found handy

• Host: GitHub
• URL: https://github.com/ericvolp12/connect-interceptors
• Owner: ericvolp12
• License: mit
• Created: 2024-07-27T06:29:37.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-27T07:01:51.000Z (almost 2 years ago)
• Last Synced: 2025-03-02T02:40:50.575Z (over 1 year ago)
• Topics: buf, connect, connectrpc, golang
• Language: Go
• Homepage:
• Size: 8.79 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ConnectRPC Interceptors

A library of interceptors for ConnectRPC that I've found handy

## Interceptors

- `pkg/retry` - An interceptor that allows you to retry RPCs that fail with specific error conditions.

    - Supports custom backoff strategies and custom functions for parsing errors to determine if you should retry.

    - Defaults to a 1 second backoff, 10 retry maximum, and automatic retries on connection errors.

- `pkg/prom` - An interceptor that adds some prometheus metrics to your RPCs to track latencies and request throughput.

    - Make sure to call `RegisterMetrics(registry)` with your prometheus registerer if you're not using the default registerer (if you are, promauto will take care of it).

    - Feel free to fork this one and tune the buckets or add additional metrics for your service.

## Using an Interceptor

Read more about ConnectRPC Interceptors [here](https://connectrpc.com/docs/go/interceptors)

To plug any of these interceptors into your ConnectRPC Client or Server, you can initialize your server or client as follows:

```go

import (

    "github.com/ericvolp12/connect-interceptors/pkg/retry"

)

interceptors := connect.WithInterceptors(retry.NewRetryInterceptor(nil, nil))

// For handlers:

mux := http.NewServeMux()

mux.Handle(greetv1connect.NewGreetServiceHandler(

  &greetServer{},

  interceptors,

))

// For clients:

client := greetv1connect.NewGreetServiceClient(

  http.DefaultClient,

  "https://api.acme.com",

  interceptors,

)

```