Skip to content

Latest commit

 

History

History
51 lines (34 loc) · 2.5 KB

README.md

File metadata and controls

51 lines (34 loc) · 2.5 KB

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 install Lamp, run:

go install github.com/opsgenie/opsgenie-lamp@latest

The command will create the executable file GOPATH/bin/opsgenie-lamp

Configuration

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

GOPATH/conf/opsgenie-integration.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 [email protected] --apiKey your_api_key

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