Sha256: 954e03624e14ad6405e98409bf51669268c2f25f230e2514c9c2359432c86577

Contents?: true

Size: 1.52 KB

Versions: 47

Compression:

Stored size: 1.52 KB

Contents

# OpenStack Metering (Ceilometer)

This document explains how to get started using OpenStack Metering (Ceilometer) with Fog. It assumes you have read the [Getting Started with Fog and the OpenStack](getting_started.md) document.

Fog uses the [OpenStack Metering API](http://docs.openstack.org/developer/ceilometer/webapi/v2.html).

## Metering Service

Get a handle on the Metering service:

```ruby
service = Fog::Metering::OpenStack.new({
  :openstack_auth_url  => 'http://KEYSTONE_HOST:KEYSTONE_PORT/v2.0/tokens', # OpenStack Keystone endpoint
  :openstack_username  => OPEN_STACK_USER,                                  # Your OpenStack Username
  :openstack_tenant    => OPEN_STACK_TENANT,                                # Your tenant id
  :openstack_api_key   => OPEN_STACK_PASSWORD,                              # Your OpenStack Password
  :connection_options  => {}                                                # Optional
})
```

## Events

* `service.events([<query_filter>])`: Return a list of events.
* `service.events.find_by_id(<message_id>)`: Return the event matching message_id, or nil if no such event exists.

### Filter events example

Return events newer than 2016-03-17T09:59:44.606000.

```ruby
query_filter = [{
  'field' => 'start_timestamp',
  'op'    => 'gt',
  'value' => '2016-03-17T09:59:44.606000'
}]

service.events(query_filter)
```

## Resources

* `service.resources`: Return a list of resources.
* `service.resources.find_by_id(<resource_id>)`: Return the resource matching resource_id, or nil if no such resource exists.

Version data entries

47 entries across 45 versions & 3 rubygems

Version Path
fog-openstack-0.1.31 docs/metering.md
fog-openstack-0.3.10 docs/metering.md
fog-openstack-0.1.30 docs/metering.md
fog-openstack-0.1.29 docs/metering.md
fog-openstack-0.3.9 docs/metering.md
fog-openstack-0.1.28 docs/metering.md
fog-openstack-0.3.8 docs/metering.md
fog-openstack-0.3.7 docs/metering.md
fog-openstack-0.3.6 docs/metering.md
fog-openstack-0.3.5 docs/metering.md
fog-openstack-0.3.4 docs/metering.md
fog-openstack-0.3.3 docs/metering.md
fog-openstack-0.3.2 docs/metering.md
fog-openstack-0.3.0 docs/metering.md
fog-openstack-0.2.4 docs/metering.md
fog-openstack-0.2.3 docs/metering.md
fog-openstack-0.2.2 docs/metering.md
fog-openstack-0.2.1 docs/metering.md
fog-openstack-0.2.0 docs/metering.md
fog-zj-0.1.28 docs/metering.md