nameko-chassis

docs

Documentation Status

tests

Github Actions Build Status
Coverage Status

package

PyPI Package latest release PyPI Wheel Supported versions Supported implementations
Commits since latest release

nameko-chassis provides an opinionated base class for building resilient, observable microservices with the nameko framework.

nameko-chassis releases and distributed tracing

We’ve changed the approach to distributed tracing over a few releases. Here’s an overview:

  • 0.9.0 supports only nameko 2 and has Zipkin integration

  • 1.0 supports both nameko 2 and 3 RC, while dropping Zipkin. If you need Zipkin support and your service is still on nameko 2, either stay on nameko-chassis 0.9, or upgrade to 1.x and manage nameko-zipkin yourself.

  • 2.0 supports only nameko v3 and provides a predefined OpenTelemetry integration to base Service class. You can still use OpenTelemetry with nameko-chassis 1.0 (provided you’re using nameko 3), but before 2.0 you’ll need to set it up yourself.

Features

By using nameko_chassis.service.Service, you’ll get:

  • error reporting using Sentry

  • integrated metrics endpoint for Prometheus

  • helpers for service discovery

  • partial* support for OpenTelemetry tracing

*You’ll need to call the instrumentors yourself, but we provide basic configuration as a dependency provider.

Installation

pip install nameko-chassis

You can also install the in-development version with:

pip install https://github.com/Emplocity/nameko-chassis/archive/master.zip

Contents

Indices and tables