nameko-chassis 0.3.1

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

docs
tests
package

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

Features

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

• error reporting using Sentry

• integrated metrics endpoint for Prometheus

• request tracing with Zipkin

• helpers for service discovery (TODO)

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

Usage

from nameko.rpc import rpc
from nameko_chassis.service import Service


class MyService(Service):
    name = "my_service"

    @rpc
    def my_method(self):
        try:
            self.zipkin.update_binary_annotations({
               "foo": "bar",
            })
        except Exception:
            self.sentry.captureException()

Note

If the RPC method raises an unhandled exception, nameko-sentry will automatically capture it to Sentry. The example above demonstrates the case when one wants to access the client manually.

Documentation

https://nameko-chassis.readthedocs.io/

Development

To run the all tests run:

tox

Authors

nameko-chassis is developed and maintained by Emplocity.

License

This work is released under the Apache 2.0 license.