#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]