hondoohnaka / hoover

Simple library for logging to Loggly

#Hoover

A python wrapper used to hit the Loggly. API

For more information on Hoover see http://wiki.loggly.com/hooverguide

##Install

With this git repo: cd /hoover sudo python setup.py install

Easy Install: $easy_install -U hoover

Pypi: http://pypi.python.org/pypi/Hoover

##Using Hoover

Enter your credentials in hoover.LogglySession after importing:

import hoover
.
.
.
i = hoover.LogglySession('<subdomain>','<username>','<password>')

i.search(q='apache2 error', starttime='NOW-2DAYS', format='csv')
i.search(q='json.priority:err', starttime='NOW-15MINUTES') #Defaults to json if format is left out

##Search Properties

For more details on using search within Loggly check out http://wiki.loggly.com/searchguide

Property	Description
rows	Number of rows returned by your query. Defaults to 10.
start	Offset for starting row. Defaults to 0.
starttime	Start time for the search. Defaults to NOW-24HOURS.
endtime	End time for the search. Defaults to NOW.
order	Direction of results returned, either 'asc' or 'desc'. Defaults to 'desc'.
callback	JSONP callback to receive a JSONP response.
format	Output format, either 'json', 'xml', or 'text'. Defaults to 'json'
fields	Which fields should be output. One or more of the following separated by commas: 'id', 'timestamp', 'ip', 'inputname', 'text'.

##More Functions

Function	Description
*.config_inputs()	Configures each input in your loggly account, register a python logger with the input's name logging to the input.
*.create_input()	Creates a new input on your loggly account.
*.facets()	Thin wrapper on Loggly's facet search API. facetby can be input, ip, or date
*.http_inputs()	Lists all http inputs
*.search()	See above "Search Properties"
*.inputs	Lists all inputs

Meta

Created and maintained by Mike Blume

If you have questions contact [email protected]