Skip to main content

Send global broadcast messages to Megaphone on changes

Project description

kinto-megaphone

travis Coverage

Send global broadcast messages to Megaphone on changes.

Installation

Install the Python package:

pip install kinto-megaphone

Add it to kinto.includes:

kinto.includes = kinto_megaphone

Then, you’ll want to add a listener.

The kinto-megaphone listener is called KintoChangesListener and it watches the monitor/changes collection from kinto-changes. You provide a list of resources, and when those resources are updated in monitor/changes, we notify Megaphone with the new collection timestamp.

If talking to Megaphone fails, it will abort the request (including rolling back the changes made in the request).

kinto-megaphone only offers this one kind of listener right now, but that could change later.

Add it using configuration like:

kinto.event_listeners = mp
kinto.event_listeners.mp.use = kinto_megaphone.listeners
kinto.event_listeners.mp.api_key = foobar
kinto.event_listeners.mp.url = https://megaphone.example.com/
kinto.event_listeners.mp.broadcaster_id = remote-settings
kinto.event_listeners.mp.match_kinto_changes = /buckets/main /buckets/blocklists/collections/addons /buckets/blocklists/collections/gfx
# Optional parameter ``except_kinto_changes``:
# kinto.event_listeners.mp.except_kinto_changes = /buckets/main/collections/cfr-models

Note that the match_kinto_changes configuration only lets you describe resources that are tracked by kinto-changes – you won’t be able to put e.g. groups or accounts in there.

Changelog

This document describes changes between each past release.

0.5.0 (2020-03-24)

New features

  • Add option to exclude certain resources (fixes #75)

0.4.1 (2019-12-23)

Bug fixes

  • Send resource timestamp instead of event timestamp (fixes #65)

0.4.0 (2019-09-30)

  • Log version value when broadcasting to Megaphone

0.3.0 (2018-11-12)

  • Add configuration to restrict what kinto-changes records cause notifications (#13).

0.2.3 (2018-11-07)

  • Remove a broken log message (#10).

0.2.2 (2018-11-07)

  • I failed to correctly release 0.2.1. Try again.

0.2.1 (2018-11-07)

  • Add a few log messages to help try to troubleshoot.

0.2.0 (2018-09-25)

  • Update to match kinto 10.1.1 – see Kinto/kinto#1770 (#2).

  • Add a heartbeat feature.

0.1.0 (2018-09-12)

  • Initial implementation

Contributors

Project details


Download files

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

Source Distribution

kinto-megaphone-0.5.0.tar.gz (6.6 kB view hashes)

Uploaded Source

Built Distribution

kinto_megaphone-0.5.0-py2.py3-none-any.whl (7.1 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page