jearly/lita-alertlogic

Alert Logic plugin for Lita

lita-alertlogic

lita-alertlogic is a handler for Lita. It can be used to pull various data points about Alert Logic customers directly from Hipchat.

Installation

Add lita-alertlogic to your Lita instance's Gemfile:

gem 'lita-alertlogic'

Usage

Run 'lita help alertlogic' to get detailed usage:

 [You] lita help alertlogic
[Lita Bot] 
Lita: alertlogic customerinfo <customer_id or customer_name> - Displays customer and child list.
Lita: alertlogic appliance agent counts <customer_id> - Displays count of agents assigned to each appliance
Lita: alertlogic policies agent counts <customer_id> - Displays count of agents assigned to each policy
Lita: alertlogic agent ip counts <customer_id> - Display count of IP's assigned to agents
Lita: alertlogic lm appliances <customer_id> - Displays customer LM appliance list.
Lita: alertlogic lm applianceinfo <customer_id> <applaince_uuid> - Displays LM appliance details.
Lita: alertlogic lm policies <customer_id> - Displays customer log assignment policies.
Lita: alertlogic lm sources <customer_id> - Displays customer log sources.
Lita: alertlogic lm hosts <customer_id> - Displays customer log hosts.
Lita: alertlogic tm appliances <customer_id> - Displays customer TM appliance list.
Lita: alertlogic tm applianceinfo <customer_id> <applaince_uuid> - Displays TM appliance details.
Lita: alertlogic tm policies <customer_id> - Displays customer threat assignment policies.
Lita: alertlogic tm hosts <customer_id> - Displays customer threat hosts hosts.
Lita: alertlogic protectedhosts status <customer_id> - Displays protected hosts summary.
Lita: alertlogic protectedhosts list <customer_id> - Displays complete protected hosts lists.
Lita: alertlogic protectedhosts search <customer_id> <protected host name or uuid>- Search protected hosts by name or uuid.

Example:

 [You] lita alertlogic customerinfo Alert
[Lita Bot]
Information for parent customer: Alert Logic Inc.
Customer ID |  Customer Name 
------------+----------------
XXXXX       | Alert Logic 

Config

Lita.configure do |config|
  # Alert Logic API Settings
  config.handlers.alertlogic.customer_id = 'your-alertlogic-customer-id'
  config.handlers.alertlogic.api_auth = 'your-api-key-obtained-from-alert-logic:'
  config.handlers.alertlogic.lm_api_url = 'https://publicapi.alertlogic.net/api/lm/v1'
  config.handlers.alertlogic.tm_api_url = 'https://publicapi.alertlogic.net/api/tm/v1'
  config.handlers.alertlogic.customer_api_url = 'https://api.alertlogic.net/api/customer/v1'
  config.handlers.alertlogic.monitoring_api_url = 'https://api.alertlogic.net/api/monitoring/v1'
  config.handlers.alertlogic.incident_api_url = 'https://api.alertlogic.net/api/incident'
end

Sample config with Hipchat plugin

Lita.configure do |config|
  # Logging level
  config.robot.log_level = :info
  
  # Hipchat adapter
  config.robot.adapter = :hipchat
  
  # Bot name
  config.robot.name = "Lita Bot"

  # Bot admins Type: String or Array of Jabber ID(s)
  config.robot.admins = ['[email protected]']
  config.adapters.hipchat.jid = '[email protected]'
  config.adapters.hipchat.password = 'bots-password'

  # Hipchat room(s) Type: String or Array
  config.adapters.hipchat.rooms = :all
  
  # Debugging mode
  #config.adapters.hipchat.debug = false

  # Alert Logic Settings
  config.handlers.alertlogic.customer_id = 'your-alertlogic-customer-id'
  config.handlers.alertlogic.api_auth = 'your-api-key-obtained-from-alert-logic:'
  config.handlers.alertlogic.lm_api_url = 'https://publicapi.alertlogic.net/api/lm/v1'
  config.handlers.alertlogic.tm_api_url = 'https://publicapi.alertlogic.net/api/tm/v1'
  config.handlers.alertlogic.customer_api_url = 'https://api.alertlogic.net/api/customer/v1'
  config.handlers.alertlogic.monitoring_api_url = 'https://api.alertlogic.net/api/monitoring/v1'
  config.handlers.alertlogic.incident_api_url = 'https://api.alertlogic.net/api/incident'
end

License

MIT