particle-iot/ParticlePapertrail

Name: ParticlePapertrail

Owner: Particle

Description: Papertrail logging handler for Particle platforms

Forked from: barakwei/ParticlePapertrail

Created: 2017-01-30 16:12:47.0

Updated: 2017-01-30 16:12:49.0

Pushed: 2018-01-03 18:39:12.0

Homepage: null

Size: 149

Language: C++

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Papertrail logging library for Particle

Ever wanted to get a log from your code without having to connect it to a PC and use Serial to debug? This library enables Particle hardware to write log to Papertrail, and debug your application even when it's not connected to your machine. This library uses the existing logging mechanism, so you can move to using Papertrail in minutes. Currently, the library send the logs on UDP without any encryption. Since UDP is used, the order of the log entries in Papertrail can be different from the order of the entries sent.

What is Papertrail?

Papertrail provides hosted log management. That means you can upload any log to the cloud. Once uploaded, you can view the entire log, filter it and search it.

Is it free?

Yes! Papertrail provides a free plan! Use referral code 668c8a to get an extra 50/MB/month more log volume for 1 year (and I will get as well).

Logging format

The library always reports the same system (Particle). And the application name is configurable. The log message itself follows the same pattern as the SerialLogHandler class.

For example a full log entry looks like this Dec 23 00:09:09 Particle App: [app] ERROR: An error occurred!

Compatible Hardware:

• Particle Photon is currently the only hardware tested to work with this library.

Example:

1. To use the example, first you need to sign up to Papertrail.
2. Once signed up, go to Settings -> Log destinations. There you'll see your host and port. Should be something like logs53.papertrailapp.com:12345.
3. In the example file, replace logsX.papertrailapp.com with your own host, and the port (12345) with your own.
4. You can also replace the app name there (In this example, it was changed to “App”).
5. Flash the application.
6. On your Papertrail dashboard, a new system will be created called Particle. Click on it.
7. Your log should look like this:

Contributing

Feel free to open an issue, open a PR, or to ask a question.