OpsGenie Lamp with Go SDK
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cfg
command
conf
.gitignore
CONTRIBUTING.md
LICENSE
NOTICE
README.md
build_lamp
build_lamp.bat
lamp.go

README.md

Lamp: OpsGenie Command line interface

Introduction

Lamp is a command line utility to interact with OpsGenie service. It allows users to create and close alerts, attach files, etc. Lamp is used to integrate any management tool that can execute a shell script with OpsGenie. Lamp interacts with the OpsGenie service through the RESTful Web API.

Lamp has a built in contextual help system for obtaining information on available commands, and available options for their use. If you invoke lamp with the --help option, you will see the available list of commands. If you invoke lamp with the --help option with a specific command, you will see the options for that command.

For ease of use apiKey should be set in conf file that lamp will use, for some flexible use cases --apiKey parameter can also be used when executing lamp commands.

Pre-requisites

  • The API is built using Go 1.4.2. Some features may not be available or supported unless you have installed a relevant version of Go. Please click https://golang.org/dl/ to download and get more information about installing Go on your computer.
  • Make sure you have properly set both GOROOT and GOPATH environment variables.
  • Before you can begin, you need to sign up OpsGenie if you don't have a valid account yet. Create an API Integration and get your API key.

Installation

To download all packages in the repo with their dependencies, simply run

go get github.com/opsgenie/opsgenie-lamp/...

The command will automatically download and install necessary package files and dependencies under the src directory of the GOPATH.

Then cd to GOPATH/src/github.com/opsgenie/opsgenie-lamp and run:

go install

Configuration

You can make configurations via Lamp configuration file. It's located under

LAMP_HOME/conf/lamp.conf

If you want to use a configuration file located in some custom location, you can define it in your commands:

opsgenie-lamp createAlert --message "host down" --config "/opt/conf/myConfigurationFile.conf"

Usage

After run go install you can start executing commands using OpsGenie Lamp.

You can create an alert OpsGenie by executing the command below:

lamp createAlert --message "appserver1 down" --recipients john.smith@acme.com --apiKey your_api_key

For more information and command samples about OpsGenie Lamp, please refer to OpsGenie Lamp