A standard library for microservices.

Last update: Jan 2, 2023

Overview

Go kit

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.

Website: gokit.io
Mailing list: go-kit
Slack: gophers.slack.com #go-kit (invite)

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.

Related projects

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

afex/hystrix-go, client-side latency and fault tolerance library
armon/go-metrics, library for exporting performance and runtime metrics to external metrics systems
codahale/lunk, structured logging in the style of Google's Dapper or Twitter's Zipkin
eapache/go-resiliency, resiliency patterns
sasbury/logging, a tagged style of logging
grpc/grpc-go, HTTP/2 based RPC
inconshreveable/log15, simple, powerful logging for Go ★
mailgun/vulcand, programmatic load balancer backed by etcd
mattheath/phosphor, distributed system tracing
pivotal-golang/lager, an opinionated logging library
rubyist/circuitbreaker, circuit breaker library
sirupsen/logrus, structured, pluggable logging for Go ★
sourcegraph/appdash, application tracing system based on Google's Dapper
spacemonkeygo/monitor, data collection, monitoring, instrumentation, and Zipkin client library
streadway/handy, net/http handler filters
vitess/rpcplus, package rpc + context.Context
gdamore/mangos, nanomsg implementation in pure Go

Web frameworks

Additional reading

Architecting for the Cloud — Netflix
Dapper, a Large-Scale Distributed Systems Tracing Infrastructure — Google
Your Server as a Function (PDF) — Twitter

Comments

Explain why Logger.log() returns error
Hi,

I think go-kit/kit/log reflects my personal thoughts on logging, but I am hesitant to use it directly due to Logger.log() returning an error. In my opinion errors are intended to be checked, not ignored. And it's unreasonable to ask users to check log messages. I feel a better philosophy is for the formatters/writers that eventually output messages to disk/tcp/stdout/etc to allow registering handlers for error types. Then, when I setup logging I can say "Here is a logger that logs JSON to a file. If there is an error, call this function (maybe try stdout or maybe trigger some application "debug me" state).

Maybe something like

type jsonLogger struct { io.Writer onError func(err error, keyvals ...interface{}) }
opened by cep21 42
Discussion: package pubsub
I'd like to start thinking about a design for package pubsub/msgbus/...

Important use cases:

An async transport for existing/typical RPC messaging

A foundation for event sourcing

A way to manage streaming

Others?

Would like support for:

Kafka

RabbitMQ

NATS

NSQ

AWS SQS

GCP PubSub

Weave Mesh

Others?

Prior art:

NYTimes/gizmo/pubsub

micro/go-micro/broker

Micro on NATS

Others?

Open questions:

What are the core abstractions and interfaces?

Is streaming significantly different than event sourcing and transport use cases?

What is the lowest common denominator for serialization?

Others?

question
opened by peterbourgon 37
package log, alternate take

Inspired by #16 and the discussion there. @ChrisHines, this isn't very far along, but I'd appreciate your feedback to the general approach, which closely mirrors package metrics...

opened by peterbourgon 34
Extract github.com/go-kit/kit/log to github.com/go-kit/log

I have several use cases, now, where it would be beneficial if projects could use Go kit's package log without pulling in anything else. I would like to extract it to it's own module and package, tentatively named kitlog to avoid the name collision. And then I would like to point the existing package at it, maybe with type aliases if they are up for the task.

@ChrisHines — Do you think this is a reasonable idea, and is feasible? Can you identify any blockers?

opened by peterbourgon 32
AMQP Transport

Hello,

I noticed that here had been interest in AMQP transport similiar to NATS (#681) as well as talks of pubsub support (#295) so I thought I might like to share an implementation of a simple AMQP client & server transport.

Comments/Reviews would be appreciated.

opened by mattfung 31
log/alt_experimental_level: concept demonstration
As a foil to #357 and following up on #368, demonstrate an alternate approach to the "level" package offered via the "github.com/go-kit/kit/log/experimental_package" import path, allowing log event level filtering via instances of the (unexported) level.leveler interface, created by functions that specify the filtering threshold.

Features not accommodated here for now:

Returning an error from log.Log when squelching an event

Returning an error from log.Log for events that lack a level
(This feature doesn't make much sense with this approach.)

Squelching events that lack a level
(This feature doesn't make much sense with this approach.)

Documentation
(We could adapt much of this from the sibling package.)

See the commit message for then benchstat comparison.
opened by seh 30
Example : Ensure that http connection will be re-use
Hello, It will be great into example to ensure that http connection will be re-use by ensuring that Body has be completely purged. That avoid performance problem for whom that use this example as primary guide.

For example for https://github.com/go-kit/kit/blob/master/examples/stringsvc3/transport.go#L50, add something like this :

func decodeUppercaseResponse(_ context.Context, r *http.Response) (interface{}, error) { // This defer ensures to reuse the tcp connection via HTTP/1.1 defer io.Copy(ioutil.Discard, r.Body) var response uppercaseResponse

Thx.
question
opened by jerome-laforge 29
kitgen implementation

So far what I've got is simple generation based on a basic interface definition.

Not complete: different layout engines.

Specific design decision here was to construct the generated AST and then format it out, as opposed to using a text/template. There's some things that are made much easier this way (i.e. the output is more likely to be correct code), but the generation code is a bit more opaque. In working with this process I've found a few things that make the process clearer, and I'm looking to implement those before this is merged. Specifically, I think many of the repeated structures could be snagged from an example codefile and then processed into target structures, rather than built out of whole cloth or partial inline parses.

opened by nyarly 28
Configuration

Filing an issue so we consider unified configuration of some kind.

Motivating example (though definitely not the only case): let's say a gokit process does want to do Dapper/Zipkin style tracing. The process will need to know where to forward the tracing information to, which won't be known at compile time.

It would be nice if all of the gokit packages were configured in the same or similar way, so that as they are used modularly, configuration of subpackages happens automatically, with little programmer assistance.

opened by jtolio 28
Add support for Twirp as a Transport
Twirp (https://github.com/twitchtv/twirp) is an RPC system that works over HTTP/1.1 using either JSON or Protobuf. It's leverages protobuf for generating servers and clients.

I still need to do a few things, but wanted to get initial feedback.

Todo

[ ] Add tests (planning to mirror what GRPC has)

[ ] Add Twirp support to addsvc example

[ ] Add documentation
opened by austinylin 26
Go kit 0.4.0 release
Edit: Due to lots of feature churn in the last few weeks/months, I've been convinced that it makes more sense to hold off on a 1.0.0 until things settle. Notes in comments below.

—

Hello! I want to cut a v1.0.0 release in the near future. This issue is created per the request of @ChrisHines to serve as a notice to anyone who may be interested, for example to raise questions, concerns, or propose specific additions.

The only thing outstanding that I'd like to get in is a promotion of log/experimental_level to log/level. I've asked @seh to weigh in on that, as he's previously commented on the package. Otherwise, let me know your thoughts. I'll leave this open until at least the weekend, so another 5 days.

edit: outstanding issues I'd want to resolve before a 1.0.0

[x] #476 — Merge log/experimental_level to level; move existing levels to deprecated_levels

[x] #420 / #421 — use stdlib context where possible

[x] #432 / #437 — log: StdlibAdapter "file" key to "caller"

[x] Optional: #434 — log: normalize StdlibAdapter timestamp format

[x] Optional: #431 — transport: implement http.EncodeJSONRequest

[x] Evaluate breaking change: #474 — Replace log.Context with log.With/WithPrefix?

If anyone feels strongly about either of those two Optionals, (cc: @willfaught) please get your PRs in within the next few days...
opened by peterbourgon 26
[NATS transport] Support for headers in EncodeJSONResponse
What would you like?

Overview

Since release v1.11.0, nats.go supports message headers. headers are very useful to transfer metadata together with messages.

I'm proposing to add basic support for headers in the default response encoder.

Proposed API

The idea is to do something similar it's done for transport/http with the Headerer interface. API change proposal is backward compatible (no public API change)

type Headerer interface { Headers() Header } func EncodeJSONResponse(_ context.Context, reply string, nc *nats.Conn, response interface{}) error { msg := nats.NewMessage(reply) if nc. HeadersSupported() { if headerer, ok := response.(Headerer); ok { msg.Header = headerer.Headers() // I wrote that to make it shorter } } msg.Data, err := json.Marshal(response) if err != nil { return err } return nc.PublishMsg(msg) }

If the proposal is accepted I can raise a PR
opened by mcosta74 4
metrics/dogstatsd: always reset all metrics before writing them when calling WriteTo

Description

This PR fixes an issue that occurred when the Dogstatsd client could not reach the Datadog agent to send metrics. It would fail to send counters, return and never reset timings and histograms, resulting in an ever-increasing memory consumption while the client cannot reach the Datadog agent.

opened by skwair 11
Consul Implementation of Instancer spams Consul and pushes consul agents to 100% CPU
What did you do?

Using the GoKit implementation of Instancer for Consul in GoKit 0.11 and up results in Instancer spamming Consul with hundreds of RPC requests/sec on any register/deregister event that occurs after the Instancer is created. This resulted in our Consul agent pods going to 100% CPU and overwhelming our Consul cluster.

Steps to re-create:

Start Consul

Register a dummy service

curl --location --request PUT 'http://localhost:8500/v1/agent/service/register' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "db-example", "id": "db-example", "address": "127.0.0.1", "port": 5432, "tags": [ "database" ] }'

Open a terminal and run the following command to get insights into what the Consul agent is doing

consul monitor -log-level=trace

Create Instancer for db-example service (see sample code below) and run app/code

Deregister the service

curl --location --request PUT 'http://localhost:8500/v1/agent/service/deregister/db-example'

Observe the behavior from consul monitor, the agent is getting slammed with requests and it never stops until the Instancer is stopped or application exits.

Simple example application.

package main import ( "fmt" "github.com/go-kit/kit/log" "github.com/go-kit/kit/sd" "github.com/hashicorp/consul/api" "time" "github.com/go-kit/kit/sd/consul" ) func main() { apiClient, err := api.NewClient(api.DefaultConfig()) if err != nil { panic(err) } client := consul.NewClient(apiClient) instancer := consul.NewInstancer(client, log.NewNopLogger(), "db-example", []string{}, true) events := make(chan sd.Event, 1) go func() { instancer.Register(events) }() go func() { for event := range events { fmt.Println(event.Instances) } }() time.Sleep(1 * time.Hour) }

What did you expect?

Consul agent should not be getting spammed with hundreds of requests a second.

What happened instead?

Instancer spammed Consul with way too many requests and drove the CPU utilization to 100%.

7.0.0.1:53702 latency=9.375µs 2022-02-12T18:06:20.710-0500 [DEBUG] agent.http: Request finished: method=GET url=/v1/health/service/db-example?index=155&passing=1 from=127.0.0.1:53702 latency=12.208µs 2022-02-12T18:06:20.710-0500 [DEBUG] agent.http: Request finished: method=GET url=/v1/health/service/db-example?index=155&passing=1 from=127.0.0.1:53702 latency=162.792µs 2022-02-12T18:06:20.710-0500 [DEBUG] agent.http: Request finished: method=GET url=/v1/health/service/db-example?index=155&passing=1 from=127.0.0.1:53702 latency=54.791µs
bug
opened by jkratz55 1
Mismatch of the tutorial section of stringsvc example and its full code

What would you like?

I have noticed a couple of differences between the tutorial section of the stringsvc3 example and its full source code. It is worth mentioning the differences are about different imports, or different number of parameters of a particular function. I was wondering which one is the most up to date one?

opened by amidam 6

Releases(v0.12.0)

v0.12.0(Sep 23, 2021)
A mostly procedural update to Go kit, including support for the latest version of Go, and updates for dependencies, including a long-awaited update to avoid a CVE in the JWT dependency.

Update for Go 1.17 (#1183) — thanks, @sagikazarmark, @ChrisHines

Update depedency speed (#1177) — thanks, @sagikazarmark

Improve code quality (#1168, #1064) — thanks, @withshubh, @sagikazarmark

Update hudl/fargo (#1167) — thanks, @sagikazarmark

Update JWT dependency (#1172) — thanks, @vovinacci

Replace kit/log with log ((#1173) — thanks, @ChrisHines

Update repo issue forms (#1169, #1166) — thanks, @sagikazarmark

Source code(tar.gz)
Source code(zip)
v0.11.0(Jul 4, 2021)
A new release with several improvements and enhancements. The first one in a long while! Huge thanks to @sagikazarmark for putting in most of the gruntwork to make it happen! You're a superstar.

The biggest thing: package log has been extracted to a separate repository and module, go-kit/log. This means that if you or your project was importing go-kit/kit just to get package log, you can significantly reduce your go.mod and dep graph by switching to the new module. Note that we have no current plans to alias the existing go-kit/kit/log to the new go-kit/log module and package, nor to deprecate the current package in favor of the new one. They are two distinct packages with no defined relationship to each other. This may change in the future.

Major changes:

The log package was extracted to a separate repository

Examples were moved to a separate repository

Deprecated kitgen was removed

Thanks to the 22 contributors who contributed to this release! 🏌️‍♂️

Bug fixes

metrics/cloudwatch: log CloudWatch response error (#961) (thanks @Trane9991)

log: defer mutex unlocks for panic safety in SyncLogger (#974)

util/conn: close old connection before reconnect (#982) (thanks @chikaku)

log/term: fix build on GOOS=js GOARCH=wasm (#993) (thanks @mvdan)

transport/http/jsonrpc: move the ClientAfter calls to before the decode (#1008) (thanks @directionless)

sd/etcdv3: fix etcdv3 client won't return error when no endpoint is available (#1009) (thanks @wayjam)

metrics/generic: fix uint64 alignment (#1007) (thanks @ldez)

log: fix stdlibadapter when prefixed (#1036) (thanks @soven)

log: capture newlines in log stdlib (#1041) (thanks @SuperQ)

Enhancements

metrics/cloudwatch: use batch values API for CloudWatch PutMetric data call (#960) (thanks @Trane9991)

log: allow to use specific logrus level in the adaptor (#962) (thanks @Trane9991)

transport/http: add NewExplicitClient (#971)

transport/http/jsonrpc: add RequestID in error body when using the DefaultErrorEncoder (#969) (thanks @esenac)

transport/http/jsonrpc: add Version to JSON-RPC client request (#990) (thanks @shirolimit)

log: add WithSuffix to append key-value pairs to those passed to Log (#992) (thanks @vinayvinay)

sd/consul: improve inconsistent Consul SD index handling (#999) (thanks @vinayvinay)

all: dependency updates (#1029, #1095, #1097, #1098, #1106, #1118, #1115, #1119, #1124) (thanks @ChrisHines, @Enrico204, @sagikazarmark)

tracing/opencensus: add support for JSONRPC (#1022) (thanks @ryan-lang)

tracing/opentracing: improve endpoint middleware options (#1072) (thanks @alebabai)

auth/jwt: fix repetition of the word "token" in JWT (#1070) (thanks @amidam)

sd/zk: replace unmaintained zk library with drop-in replacement (#1120) (thanks @sagikazarmark)

cmd/kitgen: remove deprecated kitgen (#1121) (thanks @sagikazarmark)

Documentation, examples, tests

readme: change godoc to pkg.go.dev (#963) (thanks @relunctance)

readme: add links to generator tools (#964)

metrics/cloudwatch: fix bad Gauge test (#975) (thanks @Trane9991)

readme: update the link and description for go-micro (#989) (thanks @asim)

examples: add missing "to" preposition (#1014)

tracing/opencensus: fix failing tests (#1021) (thanks @ryan-lang)

log: fix doc comment (#1028) (thanks @vrazdalovschi)

ci: upgrade to the latest version of the setup-go github action (#1040) (thanks @AntonNguyen)

ci: update Go versions for CI (#1054, #1062) (thanks @codefromthecrypt)

examples: relocate examples to a separate repository (#1100) (thanks @sagikazarmark)

transport/awslambda: replace aws lambda structs with stubs in tests (#1117) (thanks @sagikazarmark)

transport/nats: fix panic in tests (#1122) (thanks @sagikazarmark)

tracing: add a link to opentelemetry instrumentation (#1112) (thanks @sagikazarmark)

See more details in the 0.11.0 milestone.
Source code(tar.gz)
Source code(zip)
v0.10.0(Feb 17, 2020)
A new release with several minor improvements and enhancements. The major change is the adoption of Go modules: Go kit now includes a go.mod (and go.sum) specifying the precise version of our dependencies. We'll try to keep these dependencies updated, but consumers can always specify overrides, if necessary.

Thanks to the 10 contributors who contributed to this release! 🏌️‍♂️

Bug fixes

dogstatsd: Drop metrics according to sample rate (#884) (thanks @martin-sucha)

update_deps.bash: breakfixes

Fix tracing tests by replacing test.com endpoint with httpbin.org (#952) (thanks @sagikazarmark)

Enhancements

modules: Add initial go.mod file (#945) (thanks @ChrisHines, @sagikazarmark, @basvanbeek)

sd/dnssrv: Consider SRV records with port 0 as an error (#900)

transport: Introduce ErrorHandlerFunc (#915) (thanks @maratori)

log: Disable HTML escaping in JSON Logger (#914) (thanks @treuherz)

auth/casbin: Update imports to casbin/v2

tracing/opencensus: Add a span name getter to opencensus endpoint options (#948) (thanks @sagikazarmark)

Documentation, examples, tests

metrics/prometheus: Fix typo: "construts" --> "constructs" (#925) (thanks @jeffwidman)

examples: removed mention about ServiceMiddleware (#936) (thanks @icamys)

examples: Clarify rate limiter expressions in addsvc example (#943) (thanks @marselester)

log/level: Fix typo: "thte" -> "the" (#956) (thanks @HCoban)

Source code(tar.gz)
Source code(zip)
v0.9.0(Jun 27, 2019)
A new major release with incremental improvements and enhancements. Major features include support for AWS Lambda as a transport, and improved error handling in all transports. Thanks to the 26 contributors who contributed to this release! 🏌

Note that this release includes breaking changes in the metrics package, please review the documentation for changes.

Bug fixes

sd/etcdv3: serve the keepalive response channel (#803) (thanks @fangdingjun)

tracing/zipkin: swaps tested conditions (#812) (thanks @jcchavezs)

metrics/influx: Fix InfluxDB import path (#826) (thanks @flowchartsman)

kitgen: normalize backSlashes in path (#831) (thanks @obeyda)

sd/etcdv3: fix dead loop (#848) (thanks @zii)

sd/zk: fix: ProtectedEphemeralSequential in the wrong zk path (#849) (thanks @RedDragonet)

metrics/cloudwatch2: fix context in Send() (#857) (thanks @h8liu)

sd: fix data race (#865) (thanks @toffaletti)

tracing/opentracing: fix port assignment (#866) (thanks @kevinreed8263)

transport/nats: Update imports (#881) (thanks @wallyqs)

metrics/prometheus: fix for latest HEAD (#885)

metrics/dogstatsd: Drop metrics according to sample rate (#884) (thanks @martin-sucha)

Enhancements

log: Support logrus.Field logger in the logrus adapter (#793) (thanks @sagikazarmark)

transport/amqp: Add amqp.Delivery to the request func (#802) (thanks @ValeryPiashchynski)

transport/http: adding request and response encoders for Protobuf (#809) (thanks @jprobinson)

tracing/zipkin: add request sampler (#813) (thanks @jcchavezs)

tracing/opentracing: Change span injection/extraction from HTTP request (#821) (thanks @nboukeffa)

tracing/opentracing: Use opencensus' DefaultSampler instead of AlwaysSample as default (#830) (thanks @rueian)

metrics: Make Send/Write Loop context aware (#837) (thanks @jlordiales)

transport/awslambda: add support (#815) (thanks @suekto-andreas)

transport/amqp: add NopResponse option (#850) (thanks @mattfung)

log: add a log adapter for zap.Logger (#855) (thanks @MaruHyl)

transport: Implement transport level error handlers (#863) (thanks @sagikazarmark)

transport/nats: Use given context in NATS endpoint (#876) (thanks @nsmith5)

metrics/cloudwatch2: Update cloudwatch2 to latest upstream API (#878) (thanks @nsmith5)

Documentation, examples, tests

misc: fix a few misspellings (#797) (thanks @dvrkps)

examples: Replace "x/net/context" import with "context" (#810) (thanks @marselester)

metrics/prometheus: Fix test to accommodate new Prometheus metric output (#820)

kitgen: fix kitgen test in the windows (#840) (thanks @runner)

misc: add integration with builds.sr.ht (#842)

log/level: improve examples (#845)

misc: code improvements (#868) (thanks @sosiska)

sd/{etcd,etcdv3}: disable flaky integration tests (#883)

README: Update Gin framework homepage url (#888) (thanks @yellowmint)

Source code(tar.gz)
Source code(zip)
v0.8.0(Nov 10, 2018)
A major release! Featuring NATS and AMPQ transports, many other smaller enhancements, and many bug fixes. Thanks to the 25 contributors who made big contributions to this release! 🏌️

Bug fixes

Fix Client.Endpoint to not cancel when bufferedStream (#776) (thanks @xescugc)

Fix Consul SD loop exiting on EOF (#788) (thanks @kcajmagic)

Add backoff package and fix Consul CPU usage (#635) (thanks @nicot)

Fix race condition in NATS transport tests (#705) (thanks @nussjustin)

Fix pact test due to breaking api change (#720) (thanks @basvanbeek)

Add FinalizerFunc to NATS transport (#790) (thanks @kirooha)

Fix etcdv3 registrar tests (#724) (thanks @basvanbeek)

JSONRPC: add id from request to response (#742) (thanks @wangzuo)

Fix etcd import path (#756) (thanks @h8liu)

Rename 'package log' to 'log package' to fix godoc link handling. (#765) (thanks @bx2)

Enhancements

NATS transport (#680) (thanks @kirooha)

AMQP Transport (#746) (thanks @mattfung)

Metrics - Influx StatsD (#664) (#688) (thanks @james-r-smith)

HTTPClient interface (#754) (thanks @drscre)

Add casbin for authorization (#787) (thanks @suekto-andreas)

Add logrus adapter for Logger interface (#752) (#759) (thanks @aswinmprabhu)

Refactor (lint/unconvert): remove base64 call returns a string (#717) (thanks @mishudark)

Fix function names in JWT examples (#723) (thanks @zachwalton)

metrics/internal/convert: use method value insetad of lambda (#767) (thanks @Quasilyte)

metrics/teststat: replace x = x <op> y with x <op>= y (#769) (thanks @Quasilyte)

Fix Prometheus tests (#789)

Circle 2.0 support (#749, #771)

Documentation, examples, and testing

Fix minor comment typos (#687) (thanks @joe94)

Update README.md with English version of website (#708) (thanks @Olliepop)

Profilesvc docs update (#709) (thanks @wadearnold)

Remove redundant statements in profilesvc example (#721) (thanks @sudo-suhas)

Adds documentation for OpenCensus (#730) (thanks @basvanbeek)

Add kitgen README (#743) (thanks @ermik)

Adds GoBuffalo (#748) (thanks @1995parham)

Use newest Go releases for testing (#757) (thanks @ChrisHines)

Remove context in stringsvc examples 1 & 2 (#764) (thanks @bx2)

metrics: remove commented-out debug code (#770) (thanks @Quasilyte)

Delete debug.test (#777) (thanks @danp)

Source code(tar.gz)
Source code(zip)
v0.7.0(Mar 19, 2018)
An early 2018 release, containing several exciting new enhancements. First, we now have the kitgen code generation tool, for bootstrapping new services, thanks to the tireless efforts of @nyarly. Second, we have the long-awaited JSONRPC transport, due to the tireless efforts of @rossmcf, @blainsmith, and several others. Thanks also to @senseyeio. Also, we have support for etcdv3 in package sd, and a new prototype cloudwatch package for metrics.

Thanks to the 16 individual contributors who have contributed to this release! 🏌️‍♀️

Bug fixes

transport/http: Allow multiple HTTP-Headers Server (#644) -- thanks, @klaus

transport/jsonrpc: Fix various errors (#673, #679) -- thanks, @rossmcf and @basvanbeek

tracing/zipkin: Set error tag on Zipkin HTTP error status codes (#683) -- thanks, @basvanbeek

Enhancements

cmd/kitgen: Add kitgen code generator tool (#589) -- thanks, @nyarly

transport/jsonrpc: New package (#576) -- thanks, @rossmcf @blainsmith and @senseyeio

sd/etcdv3: Add support for etcdv3 (#663) -- thanks, @cabrel

metrics/cloudwatchv2: Add alternative cloudwatch package (#668) -- thanks, @nelz9999

tracing/zipkin: Add native Zipkin tracing support (#671) -- thanks, @basvanbeek

log: Add syslog support (#574) -- thanks, @mingan

transport/http: Add Server NoOpRequestDecoder (#659) -- thanks, @jdolce

ratelimit: Remove dependency on juju (#622) -- thanks, @nelz9999

Documentation, examples, and testing

examples: Update example stringsvc (#638) -- thanks, @wadearnold

log: Rename sirupsen import (#682) -- thanks, @arbourd

misc: Updates to latest Thrift (#630, #678) -- thanks @basvanbeek

misc: Doc updates (#662) -- thanks, @bflanigan

Source code(tar.gz)
Source code(zip)
v0.6.0(Oct 9, 2017)
A late-2017 release, containing mostly small enhancements and bugfixes. The biggest change not totally reflected in the changelog below is that this release includes changes to support gRPC 1.6. There are several breaking or potentially-breaking changes, including the fact that we now support only Go 1.9 and above.

Thanks to the 18 individual contributors who have contributed to this release! :golfing_woman:

Bug fixes

auth/jwt: MapClaims: improve API (#568) -- breaking change -- thanks, @litriv

transport/grpc: rm deprecated funcs (#598) -- potentially breaking change -- thanks, @travissalascox

auth/jwt: prevent concurrent reads and writes on MapClaims (#564)

transport/grpc: fix a swallowed error (#572) -- thanks, @alrs

metrics/cloudwatch: only send new counter values (#591) -- thanks, @feliksik

metrics/dogstatsd: fix for when to omit tag values (#602) -- thanks, @jfhamlin

Enhancements

Standardize names for functions moving information to and from the context (#579) -- breaking change

metrics/cloudwatch: partition API requests into separate concurrent batches (#540) -- thanks, @alpeb

ratelimit: new adapters for x/time/rate (#582) -- thanks, @nelz9999

sd: add Stop method to Instancer interface (#583)

metrics/dogstatsd: track Gauge values, and support default values (#588) -- thanks, @jfhamlin

metrics/cloudwatch: improve API for specifying percentiles (#599) -- thanks, @feliksik

auth/basic: add BasicAuth middleware (#605) -- thanks, @DimaSalakhov

metrics: set unit time on Timer type (#610) -- thanks, @esenac

Documentation, examples, and testing

Go kit now only supports go1.9 and above (#613) -- potentially breaking change

Run Coveralls on Travis (#519)

Update gRPC README information about protoc and streams (#557) -- thanks, @Fanatics

Minor documentation fixes (#561)

Remove some byte order marks (#571) -- thanks, @lwalen

metrics/cloudwatch: Small fixes to CloudWatch tests (#573) -- thanks, @alrs

examples/addsvc: improved package layout (#577)

log: improve tests (#581) -- thanks, @cam-stitt

examples: updated Thrift to latest Go library (#585) -- thanks, @basvanbeek

sd: fix TestDefaultEndpointer flake (#596)

sd: fix spelling in doc comment (#603) -- thanks, @elliotwms

examples/addsvc: fix typo in doc comments (#606) -- thanks, @gosharplite

metrics: fix missing comma in example code (#611) -- thanks, @daniel-garcia

auth/jwt: minor doc update (#617) -- thanks, @bcho

examples/addsvc: fix typo (#619) -- thanks, @karthikmuralidharan

Source code(tar.gz)
Source code(zip)
v0.5.0(Jun 20, 2017)
A pre-GopherCon release, the biggest change being breaking changes to package sd. We now expose the raw instance strings from each underlying service discovery system, so that consumers can do things with them other than construct endpoints. For background, see issues #475, #403, and #209, and for the (extensive) discussion, see PR #492.

Besides that, we just have a solid set of improvements and enhancements. See below for the full changelog. Huge thanks to Yuri Shkuro @yurishkuro for his tireless work on package sd, including dealing with my mercurial demands and frustratingly irregular schedule. And huge thanks to the 17 individual contributors who've contributed to this release! 🏌️‍♀️

Bug fixes

log: Update NewSyncWriter to work with term.IsTerminal (#501) — thanks, @ChrisHines

metrics/prometheus: move handlers to promhttp (#497) — thanks, @kavirajk

Enhancements

sd: Support push model for service discovery (#492) — thanks, @yurishkuro

sd: add Eureka SD implementation (#504) — thanks, @martinbaillie

transport/http: upgrade go1.7 ctxhttp to req.WithContext (#535) — thanks, @stanxii

transport/http: add client finalizer (#533) — thanks, @travissalascox

transport/http: make request Accept header available in context (#516)

transport/grpc: remove autoprefixing logic (#524) — thanks, @terinjokes

auth/jwt: Add *WithClaims methods to jwt middleware (#488) — thanks, @cam-stitt

auth/jwt: Improved error handling on jwt.NewParser (#521) — thanks, @basvanbeek

metrics: Cloudwatch metrics (#495) — thanks, @cam-stitt

log: Add TimestampFormat and TimeFormat (#514) — thanks, @ChrisHines

log: Add msys2/cygwin terminal detection support (#485) — thanks, @ereOn

Documentation, examples, and testing

sd: test fixes (#544, #547, #548, #550) — thanks, @yurishkuro

log/level: Remove log.NewContext mention from log/level docs (#493) — thanks, @narqo

log/level: fix typo in level test cases (#520) — thanks, @SimonRichardson

examples/shipping: header should set before WriteHeader (#538) — thanks, @bcho

examples/shipping: use log.NewSyncWriter in example (#522) — thanks, @terinjokes

examples/addsvc: Fix typo in addsvc's doc block (#518) — thanks, @annismckenzie

README: Remove h2 framework from Service frameworks (#532) — thanks, @NoahZhang

misc: Install latest by default on Travis and update go for CircleCI (#536) — thanks, @suyash

misc: Use more consistent CircleCI badge (#517) — thanks, @kevgo

Source code(tar.gz)
Source code(zip)
v0.4.0(Mar 8, 2017)
Another substantial Go kit release, with a handful of bugfixes and some major enhancements.

We now use stdlib package context wherever possible — basically, everywhere except package transport/grpc, as gRPC still imports golang.org/x/net/context and we don't have a choice but to comply. Still, there are ways to bridge the gap: see examples/addsvc for details. This means Go kit now requires Go 1.7 or above.

The other major changes in this release involve package log. We've removed NewContext and the Context type, preferring With and WithPrefix helper functions. Also, we've promoted the experiemental level package to package level, and deprecated the old levels package to deprecated_levels. I'm really happy with this: it's a slightly esoteric, but really clean and literate way to compose levels with Go kit's package log. Give it a shot!

For the full changelog, see below. My enormous gratitude goes to Chris Hines @ChrisHines for his expert work on package log, and to Bas van Beek @basvanbeek for his expert work on packages tracing and transport/grpc. And huge thanks to the 22 individual contributors who've contributed to this release! 🏌️‍♀️

Bug fixes

log/term/colorlogger: Reset bold attribute (#399) - thanks, @serge-v

metrics/influx: Fix global tags (#404) — thanks, @kihamo

metrics/generic: make goroutine-safe (#424) — thanks, @gaplyk

metrics/generic: actually track metric name thru With invocations (#455) — thanks, @yurishkuro

Enhancements

Use stdlib context where possible (#421, #480)

log: remove Context type, prefer With/WithPrefix helpers (#481)

log: DefaultTimestamp becomes nano-precision (#430) — thanks, @willfaught

log: DefaultCaller key becomes "caller" (#439) — thanks, @willfaught

log/level: brand new leveled logging package (#401, #454, #470, #476) — thanks, @groob

metrics: Gauge gets an Add method (#393) — thanks, @hardcoar, @dlmiddlecote

metrics/circonus: rm :( it was racy, difficult to test, and broke often (#442)

sd/etcd: add TTL (#413) — thanks, @buptmiao

transport: ServerBefore/ServerAfter can be repeated (#467, #479) — thanks, @djgilcrease

transport/grpc: improve error handling (#389) — thanks, @kushtrimjunuzi

transport/grpc: support Server Response Headers and Trailers (#479)

transport/http: add ServerFinalizer (#394, #405, #408, #461) — thanks, @konradreiche, @xla, @drscre

transport/http: enhance ErrorEncoder: support StatusCoder, Headerer, json.Marshaler interfaces (#414)

transport/http: don't encode JSON response with StatusNoContent (#436) — thanks, @groob

transport/http: add EncodeJSONRequest helper (#440) — thanks, @willfaught

transport/http: add EncodeXMLRequest (#456) — thanks, and condolences, to @gaplyk

Documentation, examples, and testing

examples/addsvc: correct typo (#396) — thanks, @patterns

examples/shipping: fix reciever name (#473) — thanks, @kisPocok

log: improve documentation (#429)

metrics: fix documentation (#406, #417) — thanks, @Artmann

metrics/graphite: fix typo in docs (#450) — thanks, @jkakar

tracing/zipkin: document new, easier Zipkin HTTP tracing collector (#466)

tracing/zipkin: fix typo in Zipkin docs (#469) — thanks, @frozzare

Testing: fixes for Go report card (#395)

Testing: run integration tests on Circle (#372, #416) — thanks, @rodrigosaito

Testing: use docker-compose 1.10 in integration environment (#448)

Testing: improve coverprofile wildcard in gitignore (#458) — thanks, @travissalascox

Testing: Drone.io is no more :( (#468) — thanks, @17twenty

Testing: Upgrade CI to use go1.7.5 and go1.8 (#471)

Source code(tar.gz)
Source code(zip)
v0.3.0(Nov 15, 2016)
An incremental, if large, release of Go kit. With contributions from @basvanbeek, @bbrazil, @briankassouf, @cam-stitt, @dvrkps, @everesio, @Fenthick, @groob, @jstordeur, @kpacha, @marcusolsson, @mishudark, @peterbourgon, @rossmcf, @suyash, and @xla. Thanks, contributors!

Bug fixes

Fix synchronization bug in metrics/generic.Histogram (#392)

Fixes tracking changes to OpenTracing (#387, #374, #339)

Fixes and improvements to package metrics/influx (#369)

Correct HTTP tags in distributed tracing spans (#375)

Fix some dead and breaking code in package sd/consul (#371)

Fix panic on inconsistent label cardinality (#365)

Fix To/From mixup in package tracing (#348)

Enhancements

Completely refactor package metrics (#313) ★

Add package auth/jwt (#335)

Add package metrics/pcp for Intel Performance CoPilot (#363)

Add package log/experimental_level (#357)

Custom error behavior for lb.Retry (#370)

Update examples/shipping (#388)

Go Report Card fixes (#379)

Remove unused errors from package endpoint (#361)

Add metrics.Timer (#358)

Add better unit tests for package sd/etcd.Client (#344)

Documentation

Clarify comments in package metrics (#342)

Fix typo in package auth/jwt docs (#385)

Fix typo in package log docs (#380, #351)

Fix typo in package metrics/expvar docs #356

Provide better initial guidance in package circuitbreaker docs (#345)

Source code(tar.gz)
Source code(zip)
v0.2.0(Aug 2, 2016)
An incremental release of Go kit. With contributions from @Ayiga, @basvanbeek, @ChrisHines, @eblanchette, @ifraixedes, @jygastaud, @LennartOlsen, @peterbourgon, and @xmattstrongx. Thanks, contributors!

Bug fixes

util/conn: fix Manager behavior when initial Dial fails (#293)

Fixes tracking changes to OpenTracing (#330, #315, #314, #311, #306)

Fixes and improvements to package etcd tests (#329)

Enhancements

Simple sync log (#327)

Do not log "SpanContext not found in Extract carrier" (#316)

Improvements to transports and contexts, especially gRPC (#303)

sd etcd register/deregister implementation (#299)

Documentation

Some small fixes on Profilesvc example (#318)

Adding testable example documention (#317)

Removed url.QueryEscape from the make*Endpoint functions (#309)

Fix typos (#307)

Update documentation throughout the project (#301)

Update client.go concatEndpoint (#297)

examples/addsvc: recompile protobufs (#296)

Source code(tar.gz)
Source code(zip)
v0.1.0(Jun 7, 2016)

The initial semver-compatible tagged release of Go kit. See #279.
Source code(tar.gz)
Source code(zip)