Skip to main content

Library for posting metrics to a server

Project description

A python library to send application metrics using UDP.

Build Status

Installation

pip install measures

Usage

  • count

from measures import Measure
measure = Measure('myclient', ('localhost', 1984))
measure.count('mymetric', dimensions={'name': 'john'})
  • time (measure time spent on a given block)

import time
from measures import Measure
measure = Measure('myclient', ('localhost', 1984))
with measure.time('mymetric'):
    # do some slow operation:
    time.sleep(3.14159)
import time
from measures import Measure
measure = Measure('myclient', ('localhost', 1984))
with measure.time('mymetric') as dimensions:
    # do some slow operation:
    time.sleep(1.61803)
    # add any relevant information, if necessary:
    dimensions['relevant_info'] = 'pertinent_info'
  • send

from measures import Measure
measure = Measure('myclient', ('localhost', 1984))
dimensions = {
    'time': 10.1,
    'relevant_info': pertinent_info
}
measure.send('mymetric', dimensions)
  • multiple destinations

Metrics can be sent to more than one backend

from measures import Measure

measure = Measure('myclient', [('backend.host.1', 1984), ('backend.host.2', 1984)]

Contributing

  • Set up your environment

git clone https://github.com/globocom/measures.git
cd measures
mkvirtualenv measures
pip install -r test_requirements.txt
  • Run the tests

make tests
  • Write tests for your new feature or bug fix

  • Write needed code changes

  • Iterate, have fun :)

  • Make a pull request with your changes

Who do I talk to?

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

measures-1.4.0.tar.gz (2.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page