mirror of
https://github.com/fnproject/fn.git
synced 2022-10-28 21:29:17 +03:00
e637661ea2
* Adding a way to inject a request ID It is very useful to associate a request ID to each incoming request, this change allows to provide a function to do that via Server Option. The change comes with a default function which will generate a new request ID. The request ID is put in the request context along with a common logger which always logs the request-id We add gRPC interceptors to the server so it can get the request ID out of the gRPC metadata and put it in the common logger stored in the context so as all the log lines using the common logger from the context will have the request ID logged
87 lines
4.7 KiB
Markdown
87 lines
4.7 KiB
Markdown
# Go gRPC Middleware
|
|
|
|
[](https://travis-ci.org/grpc-ecosystem/go-grpc-middleware)
|
|
[](https://goreportcard.com/report/github.com/grpc-ecosystem/go-grpc-middleware)
|
|
[](https://godoc.org/github.com/grpc-ecosystem/go-grpc-middleware)
|
|
[](https://sourcegraph.com/github.com/grpc-ecosystem/go-grpc-middleware/?badge)
|
|
[](https://codecov.io/gh/grpc-ecosystem/go-grpc-middleware)
|
|
[](LICENSE)
|
|
[](#status)
|
|
[](https://join.slack.com/t/improbable-eng/shared_invite/enQtMzQ1ODcyMzQ5MjM4LWY5ZWZmNGM2ODc5MmViNmQ3ZTA3ZTY3NzQwOTBlMTkzZmIxZTIxODk0OWU3YjZhNWVlNDU3MDlkZGViZjhkMjc)
|
|
|
|
[gRPC Go](https://github.com/grpc/grpc-go) Middleware: interceptors, helpers, utilities.
|
|
|
|
**Important** The repo recently moved to `github.com/grpc-ecosystem/go-grpc-middleware`, please update your import paths.
|
|
|
|
## Middleware
|
|
|
|
[gRPC Go](https://github.com/grpc/grpc-go) recently acquired support for
|
|
Interceptors, i.e. [middleware](https://medium.com/@matryer/writing-middleware-in-golang-and-how-go-makes-it-so-much-fun-4375c1246e81#.gv7tdlghs)
|
|
that is executed either on the gRPC Server before the request is passed onto the user's application logic, or on the gRPC client either around the user call. It is a perfect way to implement
|
|
common patterns: auth, logging, message, validation, retries or monitoring.
|
|
|
|
These are generic building blocks that make it easy to build multiple microservices easily.
|
|
The purpose of this repository is to act as a go-to point for such reusable functionality. It contains
|
|
some of them itself, but also will link to useful external repos.
|
|
|
|
`grpc_middleware` itself provides support for chaining interceptors. See [Documentation](DOC.md), but here's an example:
|
|
|
|
```go
|
|
import "github.com/grpc-ecosystem/go-grpc-middleware"
|
|
|
|
myServer := grpc.NewServer(
|
|
grpc.StreamInterceptor(grpc_middleware.ChainStreamServer(
|
|
grpc_ctxtags.StreamServerInterceptor(),
|
|
grpc_opentracing.StreamServerInterceptor(),
|
|
grpc_prometheus.StreamServerInterceptor,
|
|
grpc_zap.StreamServerInterceptor(zapLogger),
|
|
grpc_auth.StreamServerInterceptor(myAuthFunction),
|
|
grpc_recovery.StreamServerInterceptor(),
|
|
)),
|
|
grpc.UnaryInterceptor(grpc_middleware.ChainUnaryServer(
|
|
grpc_ctxtags.UnaryServerInterceptor(),
|
|
grpc_opentracing.UnaryServerInterceptor(),
|
|
grpc_prometheus.UnaryServerInterceptor,
|
|
grpc_zap.UnaryServerInterceptor(zapLogger),
|
|
grpc_auth.UnaryServerInterceptor(myAuthFunction),
|
|
grpc_recovery.UnaryServerInterceptor(),
|
|
)),
|
|
)
|
|
```
|
|
|
|
## Interceptors
|
|
|
|
*Please send a PR to add new interceptors or middleware to this list*
|
|
|
|
#### Auth
|
|
* [`grpc_auth`](auth) - a customizable (via `AuthFunc`) piece of auth middleware
|
|
|
|
#### Logging
|
|
* [`grpc_ctxtags`](tags/) - a library that adds a `Tag` map to context, with data populated from request body
|
|
* [`grpc_zap`](logging/zap/) - integration of [zap](https://github.com/uber-go/zap) logging library into gRPC handlers.
|
|
* [`grpc_logrus`](logging/logrus/) - integration of [logrus](https://github.com/sirupsen/logrus) logging library into gRPC handlers.
|
|
|
|
|
|
#### Monitoring
|
|
* [`grpc_prometheus`⚡](https://github.com/grpc-ecosystem/go-grpc-prometheus) - Prometheus client-side and server-side monitoring middleware
|
|
* [`otgrpc`⚡](https://github.com/grpc-ecosystem/grpc-opentracing/tree/master/go/otgrpc) - [OpenTracing](http://opentracing.io/) client-side and server-side interceptors
|
|
* [`grpc_opentracing`](tracing/opentracing) - [OpenTracing](http://opentracing.io/) client-side and server-side interceptors with support for streaming and handler-returned tags
|
|
|
|
#### Client
|
|
* [`grpc_retry`](retry/) - a generic gRPC response code retry mechanism, client-side middleware
|
|
|
|
#### Server
|
|
* [`grpc_validator`](validator/) - codegen inbound message validation from `.proto` options
|
|
* [`grpc_recovery`](recovery/) - turn panics into gRPC errors
|
|
|
|
|
|
## Status
|
|
|
|
This code has been running in *production* since May 2016 as the basis of the gRPC micro services stack at [Improbable](https://improbable.io).
|
|
|
|
Additional tooling will be added, and contributions are welcome.
|
|
|
|
## License
|
|
|
|
`go-grpc-middleware` is released under the Apache 2.0 license. See the [LICENSE](LICENSE) file for details.
|