Path: csiph.com!fu-berlin.de!uni-berlin.de!not-for-mail
From: Hynek Schlawack <hs@ox.cx>
Newsgroups: comp.lang.python.announce
Subject: [ANN] prometheus_async: asyncio/Twisted-aware Python Prometheus instrumentation
Date: Fri, 20 May 2016 09:53:13 +0200
Lines: 37
Approved: python-announce-list@python.org
Message-ID: <mailman.49.1463732716.27390.python-announce-list@python.org>
References: <64C542E8-604C-4DB4-B828-EED93489736A@ox.cx>
Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\))
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Trace: news.uni-berlin.de 6Erv/FAsXlnsanji9h6GXQfWftrzdSk6+5RJ6urorY+Q==
Return-Path: <hs@ox.cx>
X-Original-To: python-announce-list@python.org
Delivered-To: python-announce-list@mail.python.org
X-Spam-Status: OK 0.000
X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'pycon': 0.03; 'yet.': 0.03; 'subject:Python': 0.05; '<>,': 0.07; 'subject:ANN': 0.07; 'url:pycon': 0.08; 'discovery.': 0.09; 'i\xe2\x80\x99ve': 0.09; 'merged': 0.09; 'metrics': 0.09; 'received:internal': 0.09; 'that).': 0.09; 'topic:': 0.09; 'url:github': 0.09; 'python': 0.10; 'apps': 0.15; 'properly': 0.15; 'coroutines': 0.16; 'i\xe2\x80\x99d': 0.16; 'partly': 0.16; 'received:10.202': 0.16; 'received:10.202.2': 0.16; 'received:10.202.2.44': 0.16; 'received:66.111': 0.16; 'received:66.111.4': 0.16; 'received:66.111.4.27': 0.16; 'received:compute4.internal': 0.16; 'received:io': 0.16; 'received:messagingengine.com': 0.16; 'received:out3-smtp.messagingengine.com': 0.16; 'received:psf.io': 0.16; 'sadly': 0.16; 'thread.': 0.16; 'twisted': 0.16; '(in': 0.18; 'solution.': 0.18; 'subject:] ': 0.19; 'library': 0.20; 'subject:skip:i 10': 0.22; 'cheers,': 0.22; 'leave': 0.23; '(you': 0.23; 'separate': 0.27; 'it\xe2\x80\x99s': 0.29; 'wraps': 0.29; 'subject:/': 0.30; 'ist': 0.31; 'another': 0.32; 'implement': 0.32; 'software,': 0.32; 'received:84': 0.32; 'topic': 0.32; 'maybe': 0.33; 'class': 0.33; 'decorators': 0.33; 'case,': 0.34; 'subject:skip:p 10': 0.35; 'but': 0.36; 'too': 0.36; 'url:org': 0.36; '(and': 0.36; 'subject:: ': 0.37; 'received:10': 0.37; 'two': 0.37; 'client': 0.37; 'integration': 0.38; 'received:66': 0.38; 'means': 0.39; 'why': 0.39; 'subject:[': 0.39; 'subject:-': 0.39; 'to:addr:python.org': 0.40; 'some': 0.40; 'header:Message- Id:1': 0.61; 'more': 0.63; 'great': 0.63; 'monitoring': 0.64; 'due': 0.65; 'liked': 0.67; 'dear': 0.67; 'friends': 0.82; 'regular,': 0.84; 'url:2016': 0.84; 'url:readthedocs': 0.84; 'url:schedule': 0.84; 'welcome!': 0.84; 'instrument': 0.95; 'invite': 0.98
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:message-id:mime-version:subject:to:x-sasl-enc :x-sasl-enc; s=smtpout; bh=o+NuPYLG+la8MbDq3WQl68ougNs=; b=kAcTV 7RprtesCf1w02OLf6xSQp8nkwOzaAmH8mrDTBAqINYGBvi9ViulPg4eQ9Y3KQtpd A18eb+Bvx2XLgBquShrBcAqY2N0r/fK6951j/d6U3RHXxMRaFsLIYLHdTMFIfPzT oq+5TMtS6H+IIUUUL5vE9i1QB0RPD9/bNx00yA=
X-Sasl-enc: J6+G5+tgor55lV63ktWCKygBr1Sruc/cgl2jM5gW3t2W 1463730794
X-Mailer: Apple Mail (2.3124)
X-Mailman-Approved-At: Fri, 20 May 2016 04:25:15 -0400
X-BeenThere: python-announce-list@python.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: Announcement-only list for the Python programming language <python-announce-list.python.org>
List-Unsubscribe: <https://mail.python.org/mailman/options/python-announce-list>, <mailto:python-announce-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-announce-list/>
List-Post: <mailto:python-announce-list@python.org>
List-Help: <mailto:python-announce-list-request@python.org?subject=help>
List-Subscribe: <https://mail.python.org/mailman/listinfo/python-announce-list>, <mailto:python-announce-list-request@python.org?subject=subscribe>
X-Mailman-Original-Message-ID: <64C542E8-604C-4DB4-B828-EED93489736A@ox.cx>
Xref: csiph.com comp.lang.python.announce:2146

Dear fellow friends of asynchronous software,

maybe some of you have already bumped into the Prometheus monitoring =
system <https://prometheus.io> and liked it like I do (in any case, =
I=E2=80=99d like to invite you to my PyCon US talk on that topic: =
<https://us.pycon.org/2016/schedule/presentation/1601/>!)

And while it=E2=80=99s great that Python is a first class citizen due to =
the official Python client library =
<https://github.com/prometheus/client_python>, asyncio and Twisted sadly =
aren=E2=80=99t!

That=E2=80=99s why I=E2=80=99ve just released prometheus_async: =
https://prometheus-async.readthedocs.io/

First and foremost it wraps the metrics from the official client (you =
don=E2=80=99t want *me* to do math!) and makes them work properly on =
coroutines and Deferreds (and makes them well-behaved decorators too but =
that=E2=80=99s a topic for another day=E2=80=A6).

Additionally, it adds a few goodies:

- Metric-exposure via aiohttp that ist much more flexible than what =
comes with the stdlib-based official solution.
- =E2=80=A6that can also be started in a separate thread.  That means =
you can use them in regular, *synchronous* Python 3 applications as well =
(I instrument all my Pyramid apps like that).
- Integration with service discovery.  Listen on port 0 and leave =
registration to Consul Agent (integration is pluggable, just implement =
two methods)!

Sadly the goodies are asyncio-only so far.  Partly because the official =
client has some Twisted Web support merged but not released yet.  =
Contributions are very welcome!

Cheers,
Hynek=