No project description provided
Project description
A Monasca-Statsd Python client.
================
Quick Start Guide
-----------------
First install the library with `pip` or `easy_install`
# Install in system python ...
sudo pip install monasca-statsd
# .. or into a virtual env
pip install monasca-statsd
Then start instrumenting your code:
```
# Import the module.
import monascastatsd as mstatsd
# Create the connection
conn = mstatsd.Connection(host='localhost', port=8125)
# Create the client with optional dimensions
client = mstatsd.Client(connection=conn, dimensions={'env': 'test'})
NOTE: You can also create a client without specifying the connection and it will create the client
with the default connection information for the monasca-agent statsd processor daemon
which uses host='localhost' and port=8125.
client = mstatsd.Client(dimensions={'env': 'test'})
# Increment and decrement a counter.
counter = client.get_counter(name='page.views')
counter.increment()
counter += 3
counter.decrement()
counter -= 3
# Record a gauge 50% of the time.
gauge = client.get_gauge('gauge', dimensions={'env': 'test'})
gauge.send('metric', 123.4, sample_rate=0.5)
# Sample a histogram.
histogram = client.get_histogram('histogram', dimensions={'test': 'True'})
histogram.send('metric', 123.4, dimensions={'color': 'red'})
# Time a function call.
timer = client.get_timer()
@timer.timed('page.render')
def render_page():
# Render things ...
pass
# Time a block of code.
timer = client.get_timer()
with timer.time('t'):
# Do stuff
time.sleep(2)
# Add dimensions to any metric.
histogram = client.get_histogram('my_hist')
histogram.send('query.time', 10, dimensions = {'version': '1.0', 'environment': 'dev'})
```
Repository
-------------
The monasca-statsd code is located here:
[here](https://github.com/stackforge/monasca-statsd).
Feedback
--------
To suggest a feature, report a bug, or general discussion, head over
[here](https://bugs.launchpad.net/monasca).
License
-------
See LICENSE file
Code was originally forked from Datadog's dogstatsd-python, hence the dual license.
================
Quick Start Guide
-----------------
First install the library with `pip` or `easy_install`
# Install in system python ...
sudo pip install monasca-statsd
# .. or into a virtual env
pip install monasca-statsd
Then start instrumenting your code:
```
# Import the module.
import monascastatsd as mstatsd
# Create the connection
conn = mstatsd.Connection(host='localhost', port=8125)
# Create the client with optional dimensions
client = mstatsd.Client(connection=conn, dimensions={'env': 'test'})
NOTE: You can also create a client without specifying the connection and it will create the client
with the default connection information for the monasca-agent statsd processor daemon
which uses host='localhost' and port=8125.
client = mstatsd.Client(dimensions={'env': 'test'})
# Increment and decrement a counter.
counter = client.get_counter(name='page.views')
counter.increment()
counter += 3
counter.decrement()
counter -= 3
# Record a gauge 50% of the time.
gauge = client.get_gauge('gauge', dimensions={'env': 'test'})
gauge.send('metric', 123.4, sample_rate=0.5)
# Sample a histogram.
histogram = client.get_histogram('histogram', dimensions={'test': 'True'})
histogram.send('metric', 123.4, dimensions={'color': 'red'})
# Time a function call.
timer = client.get_timer()
@timer.timed('page.render')
def render_page():
# Render things ...
pass
# Time a block of code.
timer = client.get_timer()
with timer.time('t'):
# Do stuff
time.sleep(2)
# Add dimensions to any metric.
histogram = client.get_histogram('my_hist')
histogram.send('query.time', 10, dimensions = {'version': '1.0', 'environment': 'dev'})
```
Repository
-------------
The monasca-statsd code is located here:
[here](https://github.com/stackforge/monasca-statsd).
Feedback
--------
To suggest a feature, report a bug, or general discussion, head over
[here](https://bugs.launchpad.net/monasca).
License
-------
See LICENSE file
Code was originally forked from Datadog's dogstatsd-python, hence the dual license.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
monasca-statsd-1.2.1.tar.gz
(18.5 kB
view details)
Built Distribution
File details
Details for the file monasca-statsd-1.2.1.tar.gz.
File metadata
- Download URL: monasca-statsd-1.2.1.tar.gz
- Upload date:
- Size: 18.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8c38c247d62bfbd3b1e7b405d14e4652cfca672f6c97122a6b59531a0b9ea9e1 |
|
| MD5 | 22aea4cf4abf97d87bfa0e9fc8990971 |
|
| BLAKE2b-256 | 6b76c593150c76986b1ef9f36a00d90397dece08985b9746352177570d802f1d |
Provenance
File details
Details for the file monasca_statsd-1.2.1-py2.py3-none-any.whl.
File metadata
- Download URL: monasca_statsd-1.2.1-py2.py3-none-any.whl
- Upload date:
- Size: 15.4 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 30a9278d882d8082ca2c41cd6be04c7eef21bb4830acfd5ec49cfdc6d636f3e7 |
|
| MD5 | 85aeebe54f44216fe5ca573162f84228 |
|
| BLAKE2b-256 | f917c043e48ba65118387fe2c341352a2b4f469b5c875b3c91a3f91e8d6eede2 |
