Posted by Vladimir Kostyukov on May 29, 2020
Runtime Behavior Changes
- finagle: Bump jackson version to 2.11.0. 696bb515
- inject-mdc: Move MDC integration from inject/inject-slf4j to inject/inject-mdc.
- finatra-http|finatra-thrift: Update TraceIdMDCFilter...
Posted by Yufan Gong on April 26, 2020
April Release encountered some issues running on JDK 8, here’s a patch release that should address it.
Posted by Ian Bennett on April 6, 2020
In these unprecedented times, we wish for nothing but your health and safety. April showers 🌦️ bring May flowers 🌻, so #StayAtHome and fill some time reading about some of the changes in our latest release.
Posted by Yufan Gong on March 9, 2020
Days are getting longer🌻, March has arrived. Here’s what we have done in this release.
- finagle-opencensus-tracing: Add support for providing a custom TextFormat for header
Runtime Behavior Changes
Posted by Ian Bennett on February 27, 2020
It is ⌛time to take a 👀 look back on the 🌇 twilight of the year 2019, when the seasons shift from 🍂 Fall to Winter ❄️. Across our projects, we have introduced support for JDK 11 and added support for Scala 2.13 across a large portion...
Posted by Moses Nakamura on February 4, 2020
Welcome to the optometrically significant year–the year of perfect hindsight 🤓
- finagle-memcached: Upgrade to Bijection 0.9.7. de0ec2c6
- finagle-opencensus-tracing: Enables cross-build for 2.13.0. fee83b10
Posted by Bryce Anderson on December 13, 2019
The seasons changed and depending on which hemisphere you’re in it’s time to enjoy either the snow ❄️ or the sun ☀️!
- finagle-core, finagle-exp: Add annotations to
DarkTrafficFilter to identify which span
is dark, as well...
Posted by Dave Rusek on November 5, 2019
Now that Halloween has come and gone, it’s time to get ready for cold weather fun! ❄️
- finagle-base-http: The Uri class now provides access publicly to its
path, which is the request uri without the query parameters.
Posted by Yufan Gong on October 23, 2019
Fall has arrived in the Northern Hemisphere 🌍🌎🌏, and in San Francisco, we are enjoying the light breeze🎐and warm sunshine☀️. Here are some quick highlights of our work from July, August, and September. If you want to keep an 👁 on our...
Posted by Christopher Coco on October 9, 2019
In preparation for Halloween 👻 at the end of the month, we are very happy to announce
our October 🕷️ release: no tricks 🎃 – all treats 🍬.
- finagle-partition: Enables cross-build for 2.13.0. 89f06885
- finagle-exception: Enables...
Posted by Jing Yan on September 10, 2019
Embrace a beautiful fall with our freshly baked September release! 🍪
Posted by Yufan Gong on August 15, 2019
A point release to publish Util on scala 2.13.
- util: Enables cross-build for 2.13.0. d5d20cc3
addGauge become final, override
Posted by Kevin Oliver on August 7, 2019
Hot off the press — the August releases. Here’s what’s what.
Breaking API Changes
- finagle-core: The contents of the c.t.f.dispatch.GenSerialClientDispatcher object have been
moved to the new c.t.f.dispatch.ClientDispatcher object. The...
Posted by Christopher Coco on July 26, 2019
Summer ⛱️ is now in full-effect around the world 🌍 but we interrupt your travel 🚙and ice cream 🍦 to quickly highlight the 🆒 things released over the spring and early summer 🐚 months of April, May, and June. Just a note, if you’d like...
Posted by Dorothy Ordogh on July 18, 2019
- finagle-http: Measure streaming (message.isChunked) chunk payload size with two new histograms:
stream/request/chunk_payload_bytes and stream/response/chunk_payload_bytes, they are
published with a debug verbosity level. These...
Posted by Ruben Oanta on June 19, 2019
We’ve cut a June release for our libraries! Here are some highlights:
util-core: Use Local at callback creation for a Future’s interrupt handler rather than
the raiser’s locals so that it is consistent with other callbacks. We believe...
Posted by Moses Nakamura on May 29, 2019
Spring has sprung, and we’re beginning to ease into summer. 🚲season has begun
in New York City! We’ve been busy little bees, and this review comes a little
bit late, so it won’t include all of the work we’ve done since the last review...
Posted by Ryan O'Neill on May 21, 2019
With it being late May, the beginning of summer is right around the corner. Along with that comes a
new release of our libraries. Unfortunately, there was an
with our first attempt (19.5.0) so we created a point release (19.5.1), which fixes...
Posted by Vladimir Kostyukov on April 19, 2019
- After several years of continuous effort decoupling Finagle from Netty 3, we’ve finally got to the
point the dependency can be dropped. As of this release, there is no Netty 3 artifacts on the
- Finagle HTTP now transmits trailing...
Posted by Ian Bennett on March 14, 2019
Spring has almost sprung, so take a look at all that we have done!
- finagle-core: Added tracing annotations to backup requests. 5201f623
- Timestamped annotation “Client Backup Request Issued”
- Timestamped annotation “Client...
Posted by Yufan Gong on February 20, 2019
It is the rainy season in San Francisco, grab a cup of hot tea and take a look at our new February release!
Posted by Dave Rusek on January 18, 2019
Winter is in full swing, a new year is upon us, and the coyotes
are still doing their thing, and so are all of us here at Twitter. As part of your
new year resolutions please make it a point to check out the
releases of our open source offerings...
Posted by Ryan O'Neill on January 14, 2019
Happy New Year folks! Hopefully new years resolutions are still on pace. In
the meantime, let’s kick off 2019 with a fresh new release of libraries.
Posted by Moses Nakamura on December 18, 2018
It’s hot chocolate season in the big apple. That means mittens, ice-skating,
and curling up by the radiator. Grab your puffer, it’s the most beautiful time
of the year.
Posted by Dave Rusek on November 13, 2018
Halloween has come and gone and it’s already snowing here in the Rockies. Time to cuddle up with a warm compiler and check out the new edition of Twitter’s open source libraries!
Posted by Neuman Vong on October 24, 2018
Here we are in the month of October, just a few weeks until creatures of
fantasy roam the streets together with people dressed up as creatures of
Speaking of the fantastic, we have new releases!
Posted by Neuman Vong on October 18, 2018
Fall is here! If you live in Boulder, you might take a 🚶and watch coyotes
hunt prairie dogs.
The new season brings about a change of clothes, but what about a change of
code? Upgrade to the latest Finagle
version and enjoy the new
features, APIs, and...
Posted by Christopher Coco on October 3, 2018
TravisCI announced that it is moving open source projects from travis-ci.org to travis-ci.com which will use Github Apps for a tigther integration with Github.
We plan on working with TravisCI to migrate the entirety of the Finagle Org (github.com...
Posted by Ryan O'Neill on September 27, 2018
September is beach season here in the Bay Area, and it looks like our release earlier
this month got caught in a wash cycle. So, we’ve made a point release.
See below for details on the
util-slf4j-api dependency fix for the reason
why we decided to...
Posted by Jordan Parker on September 18, 2018
September is beach season here in the Bay Area! Time to finally get out to the beach and
cut fresh new versions of our libraries.
and Util 18.9.0.
Posted by Kevin Oliver on August 7, 2018
Fogust is upon us
and brings the August releases.
and Util 18.8.0.
Posted by Jordan Parker on July 19, 2018
Believe it or not, summer is in full swing and it’s once again time to take stock of where we’ve been and where we’re headed. For a full list of changes over the past quarter, check out the older posts on this blog.
We’ve continued to...
Posted by Daniel Schobel on July 11, 2018
Hot off the presses, the July releases are here!
and Util 18.7.0.
Runtime Behavior Changes:
Posted by Christopher Coco on June 15, 2018
Just in time for the official start to summer 🏝 our June releases are here!
and Util 18.6.0.
Runtime Behavior Changes:
Posted by Vladimir Kostyukov on May 8, 2018
Good news, everyone! Finagle & Finatra May releases are here!
As usual, all the corresponding Github projects for Finagle, Finatra, Util, Twitter Server, and
Scrooge have their release pages updated:
Posted by Kevin Oliver on April 18, 2018
It’s time to take a look back at what went down with Finagle, Finatra & friends over the past three months, and get an idea of what’s to come. As projects don’t tend to care about quarterly boundaries, some of our work is a work in progress.
Posted by Bryce Anderson on April 11, 2018
Our April releases have arrived!
Finagle 18.4.0, Finatra 18.4.0, Scrooge 18.4.0, TwitterServer 18.4.0, and Util 18.4.0.
Posted by Stefan Lance on March 6, 2018
Our March releases have arrived!
Finagle 18.3.0, Finatra 18.3.0, Scrooge 18.3.0, TwitterServer 18.3.0, and Util 18.3.0.
Posted by Yufan Gong on February 5, 2018
Happy Lunar New Year! The February release is here.
Finagle 18.2.0, Finatra 18.2.0, Scrooge 18.2.0, TwitterServer 18.2.0, and Util 18.2.0.
Posted by Daniel Schobel on January 25, 2018
We’ve been running scalac around the clock to fend off the cold and bring you another quarter’s
worth of features and improvements to Finagle and Friends: Finagle,
Future received a more efficient...
Posted by Christopher Coco on January 17, 2018
Time to turn the calendar to a new year and a new release — our January release is here!
Finagle 18.1.0, Finatra 18.1.0, Scrooge 18.1.0, TwitterServer 18.1.0, and Util 18.1.0.
Posted by Isabel Martin on December 12, 2017
The December release has arrived!
Finagle 17.12.0, Finatra 17.12.0, Scrooge 17.12.0, TwitterServer 17.12.0, and Util 17.12.0.
Posted by Kevin Oliver on December 12, 2017
We have been minimizing our dependency on Guava, which is big
and often causes version conflicts for our users. This work will be
released as part of January’s 18.1 release, though there are 2 places
Posted by Moses Nakamura on November 17, 2017
It’s November, and you know what that means! Library releases!!! We’re now publishing
with sbt 1.0.x, and we now also publish sbt-scrooge-plugin for sbt 1.0.x. We are also
continuing to publish sbt-scrooge-plugin for sbt 0.13.x.
Posted by Stefan Lance on November 2, 2017
If you’ve ever tried to debug asynchronous code written with Twitter
you may have found that the stack trace isn’t always helpful. The stack trace
at a given point in the program includes the active stack frames and thus shows
the chain of...
Posted by Jordan Parker on October 27, 2017
The October releases have arrived! For this release and hereafter, Finagle, Finatra,
Scrooge, Util, and TwitterServer will be versioned as $year.$month.$patch, as opposed to
$major.$minor.$patch. This means that all project versions will be in sync...
Posted by Kevin Oliver on October 18, 2017
Seven years ago a simple commit got Finagle’s open source repository
started. Finagle began as a means of dealing with the complexity and
fragility of distributed systems issues here at Twitter. While
distributed systems remain complex and it is not...
Posted by Christopher Coco on October 12, 2017
As we move headlong into Autumn we thought this might be a good time to take a
quick look back at some of the work from the previous quarter in
Util and preview what we’re working on this
quarter and beyond...
Posted by Kevin Oliver on September 7, 2017
The September releases are here.
Finagle 7.1.0, Finatra 2.13.0, Scrooge 4.20.0, TwitterServer 1.32.0, and Util 7.1.0.
Posted by Daniel Schobel on August 17, 2017
The August release is here and brings a major version bump for both Finagle and Util to v7! 🍰🍰🍰
Over the last few years Finagle has had an extensive internal overhaul to support Netty 4 along with a rewrite of all its protocols so now as the last...
Posted by Kevin Oliver on July 12, 2017
It’s time to take a look back at what went down in
Finatra and related libraries
over the past few months and get an idea of what’s to come. This
(apologies for missing May) as well as the upcoming 7.0.0...
Posted by Eitan Adler on June 9, 2017
We have integrated CLA Assistant with the Finagle Github repository.
Due to lack of discoverability, not everyone has been consistent about signing Twitter’s existing CLA. We believe that this will be less of a burden than manually checking CLAs against...
Posted by Kevin Oliver on April 6, 2017
As mentioned in our spring planning notes, we are sunsetting a number of modules that have been unsupported or exist in a zombie-like state.
Posted by Kevin Oliver on March 20, 2017
The team working on Finagle, Finatra, and related libraries met last week and did our planning for the next three months. These are high-level goals and as such, have varying degrees of confidence and certainty.
In the spirit of Spring cleaning:
Posted by Kevin Oliver on March 14, 2017
The March releases are hot off the printing press for Finagle 6.43.0, Finatra 2.9.0, Scrooge 4.15.0, TwitterServer 1.28.0, and Util 6.42.0.
Here’s a few of the highlights:
See accompanying blog post for details.
Posted by Vladimir Kostyukov on February 6, 2017
It’s been quite a while since the Netty 4 migration in Finagle was initially
announced. We’ve travelled a long way and are happy to announce that there is now (as of
Finagle 6.42) support for Netty 4 transports in most of the protocols: Thrift, ThriftMux...
Posted by Jillian Crossley on December 23, 2016
As the year ends, we’ve got an exciting new release for you! Here’s a quick rundown
of what we’ve been up to.
Scala 2.12 Support is Here
Finagle, Util, Ostrich, Scrooge, and Twitter-Server are all now cross-compiled for Scala 2.11 and 2.12(!)
Posted by Bryce Anderson on November 29, 2016
Historically Finagle has depended on a forked org.apache.thrift libthrift
version 0.5.x, which happens to not be published to the Central
Repository. We have published the artifact to maven.twttr.com,
but this requires users to add the maven.twttr...
Posted by Kevin Oliver on September 1, 2016
💔 SPOILER ALERT: you do not want to go to this party 💔
Blocking Finagle’s event loop via calls to
will cause your application to experience unexpected slowness, a
decrease in throughput, and potentially deadlocks. Find...
Posted by Vladimir Kostyukov on July 8, 2016
This is Finagle’s first release only for Java 8 and Scala 2.11. Since the previous release, the team
has been focusing on the Netty 4 migration as well as eliminating some technical debt.
Towards Netty 4
The team is firing on all cylinders towards...
Posted by Kevin Oliver on May 19, 2016
This Wireshark dissector provides basic decoding of all
Mux messages including:
- Frame length
- Message type
- Tag number
Don’t know about Wireshark
Follow the links for introductions.
While this was released as part of Finagle 6.33.0 we...
Posted by Kevin Oliver on April 20, 2016
The upcoming releases of our family of projects will be the final release for
Scala 2.10 and Java 7. These should be:
- Finagle 6.35.0
- Finatra 2.1.6
- Util 6.34.0
- Scrooge 4.7.0
- TwitterServer 1.20.0
- Ostrich 9.18.0
Java 7 reached its end-of-life
Posted by Vladimir Kostyukov on March 11, 2016
This release we’ve been focusing on improving both overall stability of Finagle components and
debugging features. We also reverted a patch that cased duplicate tag error that looks as
com.twitter.finagle.mux.ServerError: Duplicate tag 6
Posted by Moses Nakamura on February 15, 2016
tl;dr AsyncStream is replacing Spool.
Big shoutout to Neuman Vong, who designed and built AsyncStream soup to nuts ✧٩(•́⌄•́๑)
We know and love Spool, the Twitter util tool for asynchronous object streaming. The main
advantages of asynchronous stream...
Posted by Kevin Oliver on February 9, 2016
Finagle’s new response classifiers improve client’s avoidance of
faulty nodes thus increasing your success rate. To get this benefit,
you must wire up the application’s rules into your clients and how to
do so is explained below.
First, a pop quiz...
Posted by Kevin Oliver on February 8, 2016
Ever had your service attacked by a retry storm from your clients? Or
your clients’ clients? Or has your service ever been the attacker in
one of those situations?
To help you avoid this, in release 6.31 we’ve introduced the notion of...
Posted by Vladimir Kostyukov on February 5, 2016
In this milestone, we’ve been focusing on two major directions:
- Improving the user experience by providing friendly APIs and updating docs
- Continuing to improve Finagle’s resiliency
There is a new user-friendly API for configuring...
Posted by Nik Shkrob on September 10, 2015
We’ve released Service-per-endpoint support for Scala Thrift clients generated by Scrooge. This change has been introduced in Scrooge 4.0.0.
This allows the use of Finagle filters with Thrift services to do retries, timeouts, etc. in a Finagle-idiomatic...
Posted by Travis Brown on July 29, 2015
FinagleCon is just over two weeks away, and we’re looking for a
few attendees who are interested in giving lightning talks to kick off the
afternoon. The talks will be capped at five minutes and can be on a wide range
of Finagle-related topics: how you’re using Finagle, suggested changes,
far-fetched experiments, integration with other libraries or tools, etc.
Posted by Travis Brown on July 16, 2015
Most of Twitter’s open source projects for the JVM are published to Maven
Central, but for various reasons a few are still published to
maven.twttr.com, a Maven repository that is hosted by Twitter. While Finagle
itself is in Maven Central, some of its subprojects and some
Finagle-related libraries and tools require dependencies from
We’re actively working to eliminate the need for this separate repository, but
we don’t have a definite timeline for moving everything to Maven Central, and so
this week we have enabled secure access to the repository, which was previously
only available over unsecured HTTP.
Posted by Travis Brown on July 15, 2015
We’re pleased to announce that this year’s FinagleCon will now be
hosted at Twitter’s new One 10th Street Expansion in San Francisco.
We believe that this location will be more convenient than the Kaiser Center in
Oakland for many attendees, and we’re looking forward to showing off this brand
Posted by Travis Brown on June 11, 2015
Yesterday we opened registration and the call for participation for
FinagleCon, a new annual conference for the Finagle community.
This year’s conference will be a Scala by the Bay event hosted
at Twitter HQ in San Francisco, and will take place on Thursday,
August 13, the day before Scala by the Bay begins.
The conference program will include keynotes by Twitter’s
Marius Eriksen and SoundCloud’s Phil Calçado, talks by Finagle
adopters and contributors, and workshops and tutorials on a range of
Finagle-related topics (including Finatra and Finch).
Posted by Travis Brown on February 6, 2015
Most internal services at Twitter speak the Thrift protocol, which
provides many benefits—once you’ve defined your data types and service
interfaces, for example, it’s possible to create bindings for a wide range of
programming languages, and Twitter’s Scrooge in particular makes
it easy to create high-performance Finagle servers and clients for your Thrift
In some cases, though, it would be more convenient not to have to worry about
things like interface description files, the build system plugins necessary to
generate bindings from them, etc. In particular, being able to define Finagle
services that take arbitrary types as inputs and outputs in a Scala REPL would
make writing tutorials and quickstart projects much more straightforward, and
would enable easier experimentation with other parts of the Finagle API.
Posted by Vladimir Kostyukov on December 10, 2014
At Konfettin we decided to build a REST API backend using a Finagle stack. While it’s possible to do that using pure Finagle abstractions, we ended up writing the Finch library to simplify things and get more suitable building blocks. And it worked well: we shipped the product and got the customers. This library has been running in production for about six months so far and it’s pretty stable and well-tested. This post gives an overview of Finch: explains its core design principles and use cases.
Posted by Travis Brown on October 30, 2014
Part of my role as an open source advocate for Scala projects at Twitter
involves talking to developers outside of Twitter about how we can make
our open source projects
more widely useful and accessible, and one of the most common requests for
Finagle is for more introductory tutorials and examples.
One of the steps we’re taking in this direction is a major overhaul of
which we’ll be moving out of the main Finagle repository and
into its own project under the Finagle organization
on GitHub. At the same time we’ll be
filling out the top-level introduction to the examples (which is currently a
adding more detailed API documentation, providing better example coverage for
and creating a larger set of
to show off our new work on improving Java compatibility.
Posted by Sonja Keserovic on October 20, 2014
Netty 4 was released more than a year
ago and Netty 5 Alpha is
already available. Finagle is still using Netty 3, which is getting outdated
quickly and is preventing us from taking advantage of various performance
improvements in newer versions. It’s also creating additional work for the
Finagle team at Twitter as we need to port important security and performance
fixes back to Netty 3.
Posted by Kevin Oliver on October 7, 2014
For Finagle and its associated libraries,
known internally at Twitter as the Core Systems Libraries, we plan to change
the way we push code to GitHub and publish releases. The other libraries
included are util,
Posted by Moses Nakamura on August 12, 2014
We’re experimenting with a new form of release notes, so that it’s easier to get context on what’s going on in Finagle-land, especially with an eye to letting consumers see what the latest and greatest features are, and providing a little more context around what’s going on.
Finagle is an extensible RPC system for the JVM, used to construct high-concurrency servers. Finagle implements uniform client and server APIs for several protocols, and is designed for high performance and concurrency. Most of Finagle's code is protocol agnostic, simplifying the implementation of new protocols.
For more information, please see the project website
or source code repository,
or get in touch through
our mailing list,
#finagle IRC channel on Freenode.