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 = ['some_jabber_id@chat.hipchat.com']
config.adapters.hipchat.jid = 'bots-hipchat-jabber-id@chat.hipchat.com'
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