pygray 0.9.8

Description:

pygray 0.9.8

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/pygray cd pygray/ pip3 install . -r requirements.txtUsage--------PyGray enables you to make searches using the official Graylog query language. To understand how to make queries please 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 format whenever an environment or format is omitted.Here is a example for your pygray.cfg file: [environment:default] host=mygraylogserver.com port=443 username=john.doe [environment:dev] host=mygraylogserver.dev.com port=443 proxy=mycompanyproxy.com username=john.doe default_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-keyring Use 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 the csv. -o, --output TEXT Output logs to file (only tail/dump mode) -f, --follow Poll the logging server for new logs matching 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 stored session 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 pygray calls* 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.