Package: pygray
PyGray===============================* Free software: Apache Software License 2.0PyGray is an open source command line interface for Graylog2.Instalation--------Try:pip3 install pygrayor you can even install it from a GitHub clone:git clone https://github.com/globocom/pygraycd pygray/pip3 install . -r requirements.txtUsage--------PyGray enables you to make searches using the official Graylog query language. To understand how to make queriesplease see the `documentation <http://docs.graylog.org/en/2.1/pages/queries.html>`.Once you've installed the tool now it's time to run some commands, the following:> pygray -h mygraylog.server.com -u john.doe -p password -@ "10 minutes ago" "source:my-app-server"-> pygray -h mygraylog.server.com -u john.doe -p password "message:200"-> pygray -h mygraylog.server.com -u john.doe -p password -f-> pygray -h mygraylog.server.com -u john.doe -p password "level:DEBUG"-> pygray -h mygraylog.server.com -u john.doe -p password "level:DEBUG" -f-> pygray -h mygraylog.server.com -u john.doe -p password "level:DEBUG" -d --fields timestamp,level,message -o dump.csv-> pygray -h mygraylog.server.com -u john-doe -p password -@ "2016-11-21 00:00:00" -# "2016-11-21 01:00:00" 'message:blabla'-> pygray -e dev -r short-> pygray -e dev -r short -st mystreamid-> pygray -e dev -r short -st '*'Configuration--------PyGray can reuse some common configurations like address of your Graylog server and your credentials, it will look for a*~/.pygray.cfg* or a *pygray.cfg* (in your current directory). PyGray will use default environment and formatwhenever an environment or format is omitted.Here is a example for your pygray.cfg file:[environment:default]host=mygraylogserver.comport=443username=john.doe[environment:dev]host=mygraylogserver.dev.comport=443proxy=mycompanyproxy.comusername=john.doedefault_stream=57e14cde6fb78216a60d35e8[format:default]format={host} {level} {facility} {timestamp} {message}[format:short]format=[{timestamp}] {level} {message}[format:long]format=time: [{timestamp}] level: {level} msg: {message} tags: {tags}color=falsePlease run the *help* command to more detailed information about all the client features.Usage: pygray [OPTIONS] [QUERY]Options:-v, --version                   Prints your pygray version-h, --host TEXT                 Your graylog node's host-e, --environment TEXT          Label of a preconfigured graylog node-sq, --saved-query              List user saved queries for selection--port TEXT                     Your graylog port--no-tls                        Not use TLS to connect to Graylog server-u, --username TEXT             Your graylog username-p, --password TEXT             Your graylog password (default: prompt)-k, --keyring / -nk, --no-keyringUse keyring to store/retrieve password-@, --search-from TEXT          Query range from-#, --search-to TEXT            Query range to (default: now)--tail                          Show the last n lines for the query(default)-d, --dump                      Print the query result as a csv--fields TEXT                   Comma separated fields to be printed in thecsv.-o, --output TEXT               Output logs to file (only tail/dump mode)-f, --follow                    Poll the logging server for new logsmatching the query (sets search from to now,limit to None)-n, --limit INTEGER             Limit the number of results (default: 100)-a, --latency INTEGER           Latency of polling queries (default: 2)-st, --stream TEXT              Stream ID of the stream to query (default:no stream filter)-s, --sort TEXT                 Field used for sorting (default: timestamp)--asc / --desc                  Sort ascending / descending--proxy TEXT                    Proxy to use for the http/s request-r, --format-template TEXT      Message format template for the log(default: default format--no-color                      Don't show colored logs-c, --config TEXT               Custom config file path--help                          Show this message and exit.Contributing--------See `contributing <https://github.com/pantuza/pygray/blob/master/CONTRIBUTING.rst>` document to learn how to contribute with us.=======History=======0.9.4 (2019-03-15)------------------* Session expiration was not handled properly when create-session was set and storedsession Id was expired. It should try to authenticate again. Fixed.0.9.4 (2019-03-15)------------------* Allow the session Id to be stored in the configuration file for subsequent pygraycalls* Fixed various calls to str's "encode", no longer necessary in Python30.9.2 (2019-03-15)------------------* Messages were printed as Python3's "bytestrings", not regular strings. Fixed.0.9.1 (2019-03-15)------------------* Fixed crash when follow mode was activated0.9.0 (2019-03-15)------------------* First release on PyPI.