logshare-client
Simple log-sharing utility built with Node.js and Cloudant.
Installation
npm install -g logshare
Running
>tail -f /var/log/system.log | logshare
Share URL: https://logshare.mybluemix.net/share/kkdgapgdx
Put the URL in your browser and share it with the people you want to share your data with.
Alternatively, they can run logshare too like this:
> logshare https://logshare.mybluemix.net/share/kkdgapgdx
or
> logshare kkdgapgdx
to consume the stream of logs at their terminal.
Stopping
Ctrl-C
When logshare is killed not further data can be streamed to that channel.
Options
When sharing a stream, you can also view the stream on your terminal by adding the -f command-line switch e.g.
>tail -f /var/log/system.log | logshare -f
Share URL: https://logshare.mybluemix.net/share/kkdgapgdx
2016-01-01 Log Messages appear here
2016-01-01 and here
If you wish to use a logshare server other than "https://logshare.mybluemix.net", then you can specify it with an environment variable "LOGSHARE":
export LOGSHARE=http://localhost:6020
Live Demo
Visit https://logshare.mybluemix.net for a live demo.
What is this code?
This is the command-line client code for logshare. The server-side code lives in a separate repository.
Privacy and data retention
This project makes no guarantees as to the privacy of the data that you stream to logshare. If you are using https://logshare.mybluemix.net then the data is encrypted between the producer and server, and between the server and the consumers. There is no authentication mechanism to prevent an unknown third party observing your data stream, if they can guess the nine-digit session token. So don’t consider it safe for confidential data. It is designed to relay streaming data across development teams temporarily, not for anything you wouldn’t want others to see.
This project does not store your data at any time. Log data goes to a Redis pubsub channel and then relays immediately to any connected clients who have subscribed to that session. The data is then discarded, with only meta data about the session (the number of lines of data and the number of bytes of data received) being retained.