Skip to content

Releases: go-kit/kit


25 Aug 14:22
Choose a tag to compare

Go kit v0.13.0 is released, containing mostly minor fixes and dependency updates.

What's Changed

New Contributors

Full Changelog: v0.12.0...v0.13.0


23 Sep 20:44
Choose a tag to compare

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.


04 Jul 17:31
Choose a tag to compare

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:

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)


Documentation, examples, tests

See more details in the 0.11.0 milestone.


17 Feb 20:02
Choose a tag to compare

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 endpoint with (#952) (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)


27 Jun 14:07
Choose a tag to compare

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)


  • 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 (#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)


10 Nov 04:41
Choose a tag to compare

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)


Documentation, examples, and testing


19 Mar 18:53
Choose a tag to compare

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


Documentation, examples, and testing


09 Oct 09:15
Choose a tag to compare

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! 🏌️‍♀️

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


  • 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


20 Jun 07:54
Choose a tag to compare

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


  • 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


08 Mar 09:31
Choose a tag to compare

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 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


  • 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: is no more :( (#468) — thanks, @17twenty
  • Testing: Upgrade CI to use go1.7.5 and go1.8 (#471)