Metadata-Version: 1.1
Name: almanach
Version: 1.0.4
Summary: Stores usage of OpenStack volumes and instances for each tenant
Home-page: https://github.com/internap/almanach
Author: Internap Hosting
Author-email: opensource@internap.com
License: Apache-2
Description: Almanach
        ========
        
        [![Build Status](https://travis-ci.org/internap/almanach.svg?branch=master)](https://travis-ci.org/internap/almanach)
        [![PyPI version](https://badge.fury.io/py/almanach.svg)](https://badge.fury.io/py/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
        
        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 usage
        - `end`: End date of the resource usage or `null` if the resource still in use by the tenant
        - `name`: Resource name
        
        ### Compute Object
        
        ```json
        {
            "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
        
        ```json
        {
            "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.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Telecommunications Industry
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 2.7
