opbeatcli 2.0.2

opbeatcli is a command line client for `Opbeat <https://opbeat.com/>`_. It provides access to the Opbeat API through the command line. It is also useful for use in your own applications. "opbeat" is installed as a binary.

Command line client for Opbeat.

Installation

Make sure you have Git and a supported version Python installed on your system. The supported Python versions are: 2.6.x, 2.7.x, 3.3+ and PyPy.

$ python --version

Opbeat CLI can then be installed using the standard Python package installation method:

$ pip install opbeatcli

If pip is not available, you can alternatively use easy_install:

$ easy_install opbeatcli

To verify successful installation of Opbeat CLI:

$ opbeat --version

Usage

$ opbeat [common options] sub-command [sub-command options]

Common Options

These options are shared by all sub-commands.

To obtain these, please go to your app settings on opbeat.com:

--org-id, -o	Organization ID
--app-id, -a	Application ID.
--secret-token, -t	Secret API authentication token.

For more information and a complete list of the available common options, please see the command help:

$ opbeat --help

Sub-Commands

deployment

This command registers a deployment of an application to a machine with the Opbeat API. Deployment tracking enables advanced features of the Opbeat platform, such as version history and the ability to relate errors with particular deployments, etc. It is meant to be run from the machine that is being deployed to:

# A basic deployment registration: Run this from your application
# repository directory on the machine which it's been deployed to:
$ opbeat -o ORGANISATION_ID -a APP_ID -t SECRET_TOKEN \
    deployment --component path:.

For more information and examples please see deployment tracking documentation and the command help:

$ opbeat deployment --help