Skip to main content

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

Project description

docs Documentation Status
tests
Travis-CI 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.

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.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nameko-chassis, version 0.5.0
Filename, size File type Python version Upload date Hashes
Filename, size nameko_chassis-0.5.0-py2.py3-none-any.whl (10.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size nameko-chassis-0.5.0.tar.gz (15.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page