00f5d6994b
Assert that exception message is not empty Added voluptuous |
||
---|---|---|
almanach | ||
tests | ||
.gitignore | ||
.travis.yml | ||
LICENSE | ||
README.md | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
test-requirements.txt | ||
tox.ini |
README.md
Almanach
Almanach stores the utilization of OpenStack resources (instances and volumes) for each tenant.
What is Almanach?
The main purpose of this software is to bill customers based on their usage of the cloud infrastructure.
Almanach is composed of two parts:
- Collector: Listen for OpenStack events and store the relevant information in the database.
- REST API: Expose the information collected to external systems.
Requirements
- OpenStack infrastructure installed (Nova, Cinder...)
- MongoDB
- Python 2.7
Command line usage
Usage:
usage: almanach [-h] [--logging LOGGING] {api,collector} config_file
Start the API daemon:
almanach api /path/to/almanach.cfg
Start the collector:
almanach collector /path/to/almanach.cfg
Custom logging configuration:
almanach collector /path/to/almanach.cfg --logging /path/to/logging.cfg
The syntax of the logging configuration file is available in the official Python documentation.
Environment variables
You can override the configuration parameters by using environment variables:
export RABBITMQ_URL="amqp://openstack:openstack@hostname:5672"
almanach collector /path/to/almanach.cfg
Database entities
Each entity have at least these properties:
entity_id
: Unique id for the entity (UUID)entity_type
: "instance" or "volume"project_id
: Tenant unique ID (UUID)start
: Start date of the resource usageend
: End date of the resource usage ornull
if the resource still in use by the tenantname
: Resource name
Compute Object
{
"entity_id": "UUID",
"entity_type": "instance",
"project_id": "UUID",
"start": "2014-01-01T06:00:00.000Z",
"end": null,
"last_event": "2014-01-01T06:00:00.000Z",
"flavor": "MyFlavor1",
"os": {
"distro": "ubuntu",
"version": "14.04"
},
"name": "my-virtual-machine.domain.tld"
}
Block Storage Object
{
"entity_id": "UUID",
"entity_type": "volume",
"project_id": "UUID",
"start": "2014-01-01T06:00:00.000Z",
"end": null,
"last_event": "2014-01-01T06:00:00.000Z",
"volume_type": "MyVolumeType",
"size": 50,
"name": "my-virtual-machine.domain.tld-volume",
"attached_to": "UUID"
}
List of events handled
Almanach will process those events:
compute.instance.create.end
compute.instance.delete.end
compute.instance.resize.confirm.end
compute.instance.rebuild.end
volume.create.end
volume.delete.end
volume.resize.end
volume.attach.end
volume.detach.end
volume.update.end
volume.exists
volume_type.create
License
Almanach is distributed under Apache 2.0 LICENSE.