kit

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 1, 2022 License: MIT

README

Go kit

GitHub Workflow Status GoDev codecov Go Report Card Sourcegraph

Go kit is a programming toolkit for building microservices (or elegant monoliths) in Go. We solve common problems in distributed systems and application architecture so you can focus on delivering business value.

Sponsors

Click here or Sponsor, above, for more information on sponsorship.

Motivation

Go has emerged as the language of the server, but it remains underrepresented in so-called "modern enterprise" companies like Facebook, Twitter, Netflix, and SoundCloud. Many of these organizations have turned to JVM-based stacks for their business logic, owing in large part to libraries and ecosystems that directly support their microservice architectures.

To reach its next level of success, Go needs more than simple primitives and idioms. It needs a comprehensive toolkit, for coherent distributed programming in the large. Go kit is a set of packages and best practices, which provide a comprehensive, robust, and trustable way of building microservices for organizations of any size.

For more details, see the website, the motivating blog post and the video of the talk. See also the Go kit talk at GopherCon 2015.

Goals

  • Operate in a heterogeneous SOA — expect to interact with mostly non-Go-kit services
  • RPC as the primary messaging pattern
  • Pluggable serialization and transport — not just JSON over HTTP
  • Operate within existing infrastructures — no mandates for specific tools or technologies

Non-goals

  • Supporting messaging patterns other than RPC (for now) — e.g. MPI, pub/sub, CQRS, etc.
  • Re-implementing functionality that can be provided by adapting existing software
  • Having opinions on operational concerns: deployment, configuration, process supervision, orchestration, etc.

Contributing

Please see CONTRIBUTING.md. Thank you, contributors!

Dependency management

Go kit is modules aware, and we encourage users to use the standard modules tooling. But Go kit is at major version 0, so it should be compatible with non-modules environments.

Code generators

There are several third-party tools that can generate Go kit code based on different starting assumptions.

Projects with a ★ have had particular influence on Go kit's design (or vice-versa).

Service frameworks
  • gizmo, a microservice toolkit from The New York Times ★
  • go-micro, a distributed systems development framework ★
  • gotalk, async peer communication protocol & library
  • Kite, a micro-service framework
  • gocircuit, dynamic cloud orchestration
Individual components
Web frameworks

Additional reading

Directories

Path Synopsis
auth
jwt
Package circuitbreaker implements the circuit breaker pattern.
Package circuitbreaker implements the circuit breaker pattern.
Package endpoint defines an abstraction for RPCs.
Package endpoint defines an abstraction for RPCs.
log
Package log provides a structured logger.
Package log provides a structured logger.
deprecated_levels
Package levels implements leveled logging on top of Go kit's log package.
Package levels implements leveled logging on top of Go kit's log package.
level
Package level implements leveled logging on top of Go kit's log package.
Package level implements leveled logging on top of Go kit's log package.
logrus
Package logrus provides an adapter to the go-kit log.Logger interface.
Package logrus provides an adapter to the go-kit log.Logger interface.
syslog
Deprecated: Use github.com/go-kit/log/syslog instead.
Deprecated: Use github.com/go-kit/log/syslog instead.
term
Package term provides tools for logging to a terminal.
Package term provides tools for logging to a terminal.
zap
Package metrics provides a framework for application instrumentation.
Package metrics provides a framework for application instrumentation.
cloudwatch2
Package cloudwatch2 emits all data as a StatisticsSet (rather than a singular Value) to CloudWatch via the aws-sdk-go-v2 SDK.
Package cloudwatch2 emits all data as a StatisticsSet (rather than a singular Value) to CloudWatch via the aws-sdk-go-v2 SDK.
discard
Package discard provides a no-op metrics backend.
Package discard provides a no-op metrics backend.
dogstatsd
Package dogstatsd provides a DogStatsD backend for package metrics.
Package dogstatsd provides a DogStatsD backend for package metrics.
expvar
Package expvar provides expvar backends for metrics.
Package expvar provides expvar backends for metrics.
generic
Package generic implements generic versions of each of the metric types.
Package generic implements generic versions of each of the metric types.
graphite
Package graphite provides a Graphite backend for metrics.
Package graphite provides a Graphite backend for metrics.
influx
Package influx provides an InfluxDB implementation for metrics.
Package influx provides an InfluxDB implementation for metrics.
influxstatsd
Package influxstatsd provides support for InfluxData's StatsD Telegraf plugin.
Package influxstatsd provides support for InfluxData's StatsD Telegraf plugin.
internal/convert
Package convert provides a way to use Counters, Histograms, or Gauges as one of the other types
Package convert provides a way to use Counters, Histograms, or Gauges as one of the other types
internal/ratemap
Package ratemap implements a goroutine-safe map of string to float64.
Package ratemap implements a goroutine-safe map of string to float64.
multi
Package multi provides adapters that send observations to multiple metrics simultaneously.
Package multi provides adapters that send observations to multiple metrics simultaneously.
pcp
prometheus
Package prometheus provides Prometheus implementations for metrics.
Package prometheus provides Prometheus implementations for metrics.
provider
Package provider provides a factory-like abstraction for metrics backends.
Package provider provides a factory-like abstraction for metrics backends.
statsd
Package statsd provides a StatsD backend for package metrics.
Package statsd provides a StatsD backend for package metrics.
teststat
Package teststat provides helpers for testing metrics backends.
Package teststat provides helpers for testing metrics backends.
sd
Package sd provides utilities related to service discovery.
Package sd provides utilities related to service discovery.
consul
Package consul provides Instancer and Registrar implementations for Consul.
Package consul provides Instancer and Registrar implementations for Consul.
dnssrv
Package dnssrv provides an Instancer implementation for DNS SRV records.
Package dnssrv provides an Instancer implementation for DNS SRV records.
etcd
Package etcd provides an Instancer and Registrar implementation for etcd.
Package etcd provides an Instancer and Registrar implementation for etcd.
etcdv3
Package etcdv3 provides an Instancer and Registrar implementation for etcd v3.
Package etcdv3 provides an Instancer and Registrar implementation for etcd v3.
eureka
Package eureka provides Instancer and Registrar implementations for Netflix OSS's Eureka
Package eureka provides Instancer and Registrar implementations for Netflix OSS's Eureka
lb
Package lb implements the client-side load balancer pattern.
Package lb implements the client-side load balancer pattern.
zk
Package zk provides Instancer and Registrar implementations for ZooKeeper.
Package zk provides Instancer and Registrar implementations for ZooKeeper.
Package tracing provides helpers and bindings for distributed tracing.
Package tracing provides helpers and bindings for distributed tracing.
opencensus
Package opencensus provides Go kit integration to the OpenCensus project.
Package opencensus provides Go kit integration to the OpenCensus project.
opentracing
Package opentracing provides Go kit integration to the OpenTracing project.
Package opentracing provides Go kit integration to the OpenTracing project.
zipkin
Package zipkin provides Go kit integration to the OpenZipkin project through the use of zipkin-go, the official OpenZipkin tracer implementation for Go.
Package zipkin provides Go kit integration to the OpenZipkin project through the use of zipkin-go, the official OpenZipkin tracer implementation for Go.
Package transport contains helpers applicable to all supported transports.
Package transport contains helpers applicable to all supported transports.
amqp
Package amqp implements an AMQP transport.
Package amqp implements an AMQP transport.
awslambda
Package awslambda provides an AWS Lambda transport layer.
Package awslambda provides an AWS Lambda transport layer.
grpc
Package grpc provides a gRPC binding for endpoints.
Package grpc provides a gRPC binding for endpoints.
http
Package http provides a general purpose HTTP binding for endpoints.
Package http provides a general purpose HTTP binding for endpoints.
http/jsonrpc
Package jsonrpc provides a JSON RPC (v2.0) binding for endpoints.
Package jsonrpc provides a JSON RPC (v2.0) binding for endpoints.
httprp
Package httprp provides an HTTP reverse-proxy transport.
Package httprp provides an HTTP reverse-proxy transport.
nats
Package nats provides a NATS transport.
Package nats provides a NATS transport.
util
conn
Package conn provides utilities related to connections.
Package conn provides utilities related to connections.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL