https://github.com/exoscale/collectd-cloudstack

collectd plugin for collecting usefull metrics from cloudstack API
https://github.com/exoscale/collectd-cloudstack

Last synced: 28 days ago
JSON representation

collectd plugin for collecting usefull metrics from cloudstack API

• Host: GitHub
• URL: https://github.com/exoscale/collectd-cloudstack
• Owner: exoscale
• License: mit
• Created: 2012-10-30T21:41:56.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2018-08-27T02:13:35.000Z (over 6 years ago)
• Last Synced: 2023-03-12T06:29:00.433Z (almost 2 years ago)
• Language: Python
• Homepage:
• Size: 47.9 KB
• Stars: 8
• Watchers: 27
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-cloudstack - collectd-cloudstack Plugin

README

        
collectd-cloudstack

================

This is a plugin for collecting stats from the CloudStack API. It can get information about zones, pods, storage, clusters and hosts.

It requires the python plugin in collectd in order to gather data.

The values collected are :

* Number of instances : Total, Running and Stopped

* Public IPs: Total and Used

* Private IPs: Total and Used

* Memory: Total (with and without over-provisioning), Allocated and Used

* CPU: Total (with and without over-provisioning), Allocated and Used

* Primary Storage: Total (with and without over-provisioning), Allocated and Used

* Secondary Storage: Total and Used

* LocaStorage : Total and Used

* Network: Read and Write

* Console Proxy : Number of active sessions

Requirements

------------

*CloudStack*  

In order to use this module, you need to have a valid API access on the root domain. This module has been tested and developped against CloudStack 4.x API.

*CS Client*

CS client must be installed. See ()

*collectd*  

collectd must have the Python plugin installed. See ()

Options

-------

* `Api`  

URL of cloudstack API to monitor and the TCP on which your API runs

* `Auth`  

Wether your API is protected or not. Default unprotected API listens on 8096 on CloudStack

* `ApiKey`  

API key from an account on the root level.

* `Secret`  

Associated API Secret from the account.

* `Verbose`  

Verbose logging. Default to false.

Example

-------

    

        Globals true

    

    

        # cloudstack.py is at /usr/lib/collectd/cloudstack.py

        ModulePath "/usr/lib64/collectd/"

        Import "cloudstack"

	

	  Api "https://mycloudstack.com:443/client/api"

	  Auth "True"

	  ApiKey "RANDOM-KEY-FROM-CS"

	  Secret "SECRET-FROM-CS"

	

    

Credits

-------

In production use at [exoscale](https://www.exoscale.com) and licensed under the MIT License.