Skip to main content

Create an oops Config from a definition encoded as a dict

Project description

Create an oops.Config object from a definition encoded as a dictionary.

Dependencies

Also the following dependencies are required depending on the configs you will use:

For testing all of the above are needed, along with:

  • python-testtools

Use

To use run:

from oops_dictconfig import config_from_dict

oops_config = config_from_dict(dict_config)

where dict_config is a dict describing the oops.Config that is wanted.

The empty dict is valid, and will get you an oops.Config with no publishers, however, you will usually want at least one publisher.

To do that have a publishers key in dict_config whose value is a list of dicts. Each of those dicts will add a publisher to the oops.Config.

There is one mandatory key for all publisher types:

  • type: the type of publisher, currently “datedir” and “amqp” are

    supported.

All publishers support the following optional key:

  • new_only: if this is True then the publisher will be wrapped in

    oops.publish_only_new, meaning that the oops will only be sent to this publisher if no previous publisher in the chain published it.

Each publisher type also has further options detailed below.

datedir

There is one further mandatory key for the datedir publisher:

  • error_dir: the path on filesystem where the oops should be written.

    It doesn’t need to already exist.

The following optional keys are also supported:

  • instance_id: If None, OOPS file names are named after the OOPS

    id which is generated by hashing the serialized OOPS (without the id field). Otherwise OOPS file names and ids are created by allocating file names through a UniqueFileAllocator. UniqueFileAllocator has significant performance and concurrency limits and hash based naming is recommended.

  • inherit_id: If True, use the oops ID (if present) supplied in

    the report, rather than always assigning a new one.

  • stash_path: If True, the filename that the OOPS was written to

    is stored in the OOPS report under the key ‘datedir_repo_filepath’. It is not stored in the OOPS written to disk, only the in-memory model.

amqp

There are several other mandatory keys for the amqp publisher:

  • host: the hostname of the AMQP broker to connect to. If a port

    is needed then specify it after the hostname, separated by a colon. Examples: example.com, 1.2.3.4:5022.

  • user: the username to use when connecting to the AMQP broker.

  • password: the password to use when connecting to the AMQP broker.

  • vhost: the vhost to send messages on the AMQP broker.

  • exchange_name: The name of the exchange to publish to.

  • routing_key: The routing key for messages.

There is one other optional key for the amqp publisher:

  • inherit_id If True any ‘True’ ‘id’ in an OOPS report is

    preserved. Handy if an id that has already been shown to a user is being published (but uniqueness cannot be guaranteed).

Examples

The following would create a DateDirRepo as the only publisher:

{
    'publishers': [
        {
            'type': 'datedir',
            'error_dir': '/var/log/oopses/',
            'instance_id': 'theinstance',
        },
    ],
}

The following is a simple config for an AMQP publisher:

{
    'publishers': [
        {
            'type': 'amqp',
            'host': 'amqp.example.com:5302',
            'user': 'oopsuser',
            'password': 'oopspassword',
            'vhost': 'oopses',
            'exchange_name': 'oopses',
            'routing_key': 'oopses',
        },
    ],
}

The following is an example that publishes to AMQP with a fallback to DateDirRepo if AMQP is not availble:

{
    'publishers': [
        {
            'type': 'amqp',
            'host': 'amqp.example.com:5302',
            'user': 'oopsuser',
            'password': 'oopspassword',
            'vhost': 'oopses',
            'exchange_name': 'oopses',
            'routing_key': 'oopses',
        },
        {
            'type': 'datedir',
            'error_dir': '/var/log/oopses/',
            'instance_id': 'theinstance',
            'new_only': True,
        },
    ],
}

configglue

If you are using configglue to manage your configuration an Option subclass is supplied that can be used in your schema as appropriate:

from configglue import schema
from oops_dictconfig.configglue import OopsOption

class MySchema(schema.Schema):

    oopses = OopsOption()

Once that is defined you can produce the config described above using your configglue config file:

oopses = oopses_config

[oopses_config]
publishers = amqp_publisher
             datedir_publisher

[amqp_publisher]
type = amqp
host = amqp.example.com:6832
user = oopsuser
password = oopspassword
vhost = oopses
exchange_name = oopses
routing_key = oopses

[datedir_publisher]
type = datedir
error_dir = /var/log/oopses
instance_id = theinstance
only_new = True

Running Tests

Install testrepository and python-subunit and run:

testr init
testr run

or run:

python -m testools.run oops_dictconfig.tests.test_suite

Copyright (c) 2012, Canonical Ltd

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, version 3 only.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see <http://www.gnu.org/licenses/>. GNU Lesser General Public License version 3 (see the file LICENSE).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oops_dictconfig-0.0.1.tar.gz (8.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page