Metadata-Version: 2.0
Name: netuitive
Version: 0.0.7
Summary: Python Client for Netuitive Cloud.
Home-page: https://github.com/netuitive/netuitive-client-python
Author: Netuitive
Author-email: python@netuitive.com
License: Apache License 2.0
Keywords: netuitive
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4

===============================
Netuitive Python Client
===============================

Features
--------

* Create a Netuitive Element with the following data:
    * Element Name
    * Attributes
    * Tags
    * Metric Samples


Usage
-----

* Setup the Client
    ``ApiClient = netuitive.Client(api_key='<my_api_key>')``


* Setup the Element
    ``MyElement = netuitive.Element()``

* Add an Attribute
    ``MyElement.add_attribute('Language', 'Python')``

* Add a Tag
    ``MyElement.add_tag(('Production', 'True')``

* Add a Metric Sample
    ``MyElement.add_sample('cpu.idle', 1432832135, 1, host='my_hostname')``

* Add a Metric Sample with a Sparse Data Strategy
    ``MyElement.add_sample('app.zero', 1432832135, 1, host='my_hostname', sparseDataStrategy='ReplaceWithZero')``

* Add a Metric Sample with unit type
    ``MyElement.add_sample('app.requests', 1432832135, 1, host='my_hostname', unit='requests/s')``


* Send the Samples
    ``ApiClient.post(MyElement)``

* Remove the samples already sent
    ``MyElement.clear_samples()``

Example
-------
::

    import netuitive

    ApiClient = netuitive.Client(apikey='aaaa9956110211e594444697f922ec7b')

    MyElement = netuitive.Element()

    MyElement.add_attribute('Language', 'Python')
    MyElement.add_attribute('app_version', '7.0')

    MyElement.add_tag(('Production', 'True')
    MyElement.add_tag(('app_tier', 'True')

    MyElement.add_sample('app.error', 1432832135, 1, host='appserver01')
    MyElement.add_sample('app.request', 1432832135, 10, host='appserver01')

    ApiClient.post(MyElement)

    MyElement.clear_samples()


Copyright and License
---------------------

Copyright 2015 Netuitive, Inc. under [the Apache 2.0 license](LICENSE).




History
-------

0.0.7 (2015-06-23)
---------------------

* Fix for Preventing duplicate metrics


0.0.6 (2015-06-23)
---------------------

* Add support for Spare Data Strategy and Unit settings for Metrics
* Prevent duplicate metrics
* Documentation improvements


0.0.5 (2015-06-12)
---------------------

* Element type is now easier to set

0.0.3 (2015-06-01)
---------------------

* Fixes for API URL setting

0.0.2 (2015-05-28)
---------------------

* First release on PyPI.


