The aodh.storage.base Module

Base classes for storage engines

class aodh.storage.base.Connection(conf, url)

Bases: object

Base class for alarm storage system connections.

static clear()

Clear database.

static clear_expired_alarm_history_data(alarm_history_ttl)

Clear expired alarm history data from the backend storage system.

Clearing occurs according to the time-to-live.

Parameters:alarm_history_ttl – Number of seconds to keep alarm history records for.

static create_alarm(alarm)

Create an alarm. Returns the alarm as created.

Parameters:alarm – The alarm to create.

static delete_alarm(alarm_id)

Delete an alarm and its history data.

static get_alarm_changes(alarm_id, on_behalf_of, user=None, project=None, alarm_type=None, severity=None, start_timestamp=None, start_timestamp_op=None, end_timestamp=None, end_timestamp_op=None, pagination=None)

Yields list of AlarmChanges describing alarm history

Changes are always sorted in reverse order of occurrence, given the importance of currency.

Segregation for non-administrative users is done on the basis of the on_behalf_of parameter. This allows such users to have visibility on both the changes initiated by themselves directly (generally creation, rule changes, or deletion) and also on those changes initiated on their behalf by the alarming service (state transitions after alarm thresholds are crossed).

Parameters:

• alarm_id – ID of alarm to return changes for
• on_behalf_of – ID of tenant to scope changes query (None for administrative user, indicating all projects)
• user – Optional ID of user to return changes for
• project – Optional ID of project to return changes for
• alarm_type – Optional change type
• severity – Optional change severity
• start_timestamp – Optional modified timestamp start range
• start_timestamp_op – Optional timestamp start range operation
• end_timestamp – Optional modified timestamp end range
• end_timestamp_op – Optional timestamp end range operation
• pagination – Pagination parameters.

static get_alarms(name=None, user=None, state=None, meter=None, project=None, enabled=None, alarm_id=None, alarm_type=None, severity=None, exclude=None, pagination=None)

Yields a lists of alarms that match filters.

Parameters:

• name – Optional name for alarm.
• user – Optional ID for user that owns the resource.
• state – Optional string for alarm state.
• meter – Optional string for alarms associated with meter.
• project – Optional ID for project that owns the resource.
• enabled – Optional boolean to list disable alarm.
• alarm_id – Optional alarm_id to return one alarm.
• alarm_type – Optional alarm type.
• severity – Optional alarm severity.
• exclude – Optional dict for inequality constraint.
• pagination – Pagination parameters.

classmethod get_capabilities()

Return an dictionary with the capabilities of each driver.

classmethod get_storage_capabilities()

Return a dictionary representing the performance capabilities.

This is needed to evaluate the performance of each driver.

static query_alarm_history(filter_expr=None, orderby=None, limit=None)

Return an iterable of model.AlarmChange objects.

Parameters:

• filter_expr – Filter expression for query.
• orderby – List of field name and direction pairs for order by.
• limit – Maximum number of results to return.

static query_alarms(filter_expr=None, orderby=None, limit=None)

Return an iterable of model.Alarm objects.

Parameters:

• filter_expr – Filter expression for query.
• orderby – List of field name and direction pairs for order by.
• limit – Maximum number of results to return.

static record_alarm_change(alarm_change)

Record alarm change event.

static update_alarm(alarm)

Update alarm.

static upgrade()

Migrate the database to version or the most recent version.

class aodh.storage.base.Model(**kwds)

Bases: object

Base class for storage API models.

as_dict()

classmethod get_field_names()