Homey Community Forum

PaperTrails Log - Advanced Logging and Log management (v0.6.0)

PaperTrails Log

Advanced Logging and Log management

Today I published my App for Logging and Log management.
This app makes it possible to add time based logging to your flow’s and send logs to a standard SysLog server and some log management to the App.

It has an option to limit the size of the log and some action cards to clean or truncate the ever growing log.

For example with the e-mail sender app it is possible to send emails with the complete log of the truncated part for archiving in email.

The following Triggers / Conditions / Actions (T/C/A):

  • T: PaperTrails at Max. configured Lines

  • T: PaperTrails greater than ## Lines

  • T: The log is Truncated

  • C: Add to the Log (Condition is always True)

  • A: Clear the Log => T: The log is Cleared

  • A: Trigger a Flow => T: This Flow is Tiggered

  • A: Remove oldest % of Log => T: The log is Truncated

  • A: Remove log older than # Hours => T: The log is Truncated

Find it in the App Store:

and read some examples on the GitHub Wiki

Let me know if you like it or have any requests!

Updated the app and published:

Version 0.6.0

  • several updates to Fix on Homey firmware v2.0
  • Removed option to import Z-wave logs (Not possible anymore on Homey 2.0)
  • Hide Download Button on Mobile Interface (pls Go to Developers site)
  • Temporary hide Maintenance panel (as it doesn’t work in 2.0)
  • Started migration to i18n and translating from en to nl and de

Version 0.5.0 and previous versions

  • add Filter option on Log viewer
  • cleanup some code
  • Remove option to choose not to append!
  • Enter only one 0 to ignore or stop logging (after adding Logging to all flows).
  • fixed someting with the Z-Wave import.
  • Changed separator between time and log to
  • Added an App name, Prefix first word with $ to have a App Name
    Time - AppName - Message
  • Added option to send to syslog.
  • Added option to Import Z-Wave Log.
  • Added api /log to Log something from fe HomeyScript.
  • Converted Settings to two Objects & some Cleanup.
  • Fixed “Report an issue” Link to Own GitHub.

** Warning **
Only use Import Z-Wave Log on Append Logging (Top-Down) and with Geek- Zulu Time.
Will continue working on that later …

Moved the following to a Web App Dashboard Behind the Community HomeyBackup Web App: https://homeybackup.web.app/login/ (as it is not possible from Homey V2 anymore)

  • Added Magic!
    • Automatic Adding & Removing Logging to All Flows with a Prefix.
    • Migrating Flows from Simple Log.

// Trigger Logging to PaperTrails from HomeyScript
let HomeyScript = await Homey.apps.getApp({ id: ‘nu.dijker.papertrails’ } );
HomeyScript.apiPost(‘log’, { log:‘Hello World of PaperTrails! Here HomeyScript!’} );

For the old Forum discussion see here: https://forum.athom.com/discussion/3473/app-papertrails-advanced-logging-and-log-management-v0-3-7

For any questions just comment here !

1 Like

Reserved for future info.

I’m using papertrails for a while now and I’m happy to use.
I only missing one feature: Search function in the log.
Is it possible to add this feature?

1 Like

Thanks, I have it already some time in mind but first want to finish some other work.
It is on the list and I probably will add it!

F:slight_smile:
Just want to express that I am very happy with “papertrails”

The change to wintertime resulted in some unplanned behaviour of my homey flows.
Papertrails made it really easy to track down the mistakes in my flows. Made some adjustments in the conditions…
Within 2 days my flows are running as desired again.

Thanks! Great app.

(PS:I have papertrails running all the time, so not just for debugging. I have logging for every then and else I have. This makes it really easy to find issues in the flows)

1 Like

Thanks @FKey and everyone supporting PaperTrails Log
@Canedje still thinking about a search, the start for it is there now with Filtering :wink:

Updated the app and published: (Now Alpha 2018-11-04)

Version 0.5.0

  • add Filter option on Log viewer
  • cleanup some code
  • Remove option to choose not to append!
  • Enter only one 0 in the Log filed to ignore or stop logging (after adding Logging to all flows).
  • fixed someting with the Z-Wave import.
  • Changed separator between time and log to
  • Added an App name, Prefix first word with $ to have a App Name
    Time - AppName - Message
  • Added option to send to a default syslog server.
  • Added option to Import Z-Wave Log.

Sounds good. Thanks :+1:t2:
I will wait for the Betha version. I think a filter will work already

I just installed the newest version.
Filter works very nice. Thanks!
I’m happy

1 Like

Is PaperTrails ready for Homey 2.0 (2.x)?

Not yet completely but basic logging works, will have to find some time next week to do additional testing and update the app.

1 Like

Since this Morning PaperTrails often stopped working. Restart helps a Moment but crashing then again.

Since today I have an hour of-set. If I create a log, the time in the log is 1 hour behind the actual time of my Homey. In developers / system I see the correct time (but also the 1 hour earlier time):

I am on Homey Firmware Versie: 1.5.13 and App version v0.5.0

What can I do to get the timing right again?

Your time is right. NL = UTC +1. For log files (like paper trails) it is a good practice to translate time to UTC.

afbeelding

Till today these times were in sync. What has changed? And, how do I translate time to UTC?

UPDATE
Time is in sync again :slight_smile:
A restart of the App made no difference. A day later Homey rebooted (every day at noon) and now the time stamp is correct again. I bet that reboot was what made it work again.

1 Like

I tried to download the logfile. It made the Homey app (Android) crash! I’m on latest versions. :face_with_thermometer:

I use Papertrials to log to my ubuntuserver syslog but i see always a difference in time.
The logging from homey to syslog is always 1 hour early, GMT i think.
logging from other things to my ubuntuserver syslog has the correct time.
When logging to the local papertrials file i have the correct time.

Did also reboot of homey like you did but i see no difference.

Anyone able to download the logfile?

Try download from https://developer.athom.com/tools/app-settings
As it is not possible in the mobile app.
Don’t know if Athom will fix it but I will make a note in the settings that it doesn’t work from the mobile.

That works!!! Thanks a lot @Dijker

Hi Aart,
Sorry I missed your msg.
Question,
What is your Timezone (Where does your Homey Live) and what time do you see in:

I use internally and send the UTC/ Zulu time in my app ( var logDate = new Date(); )

For me it is in developer.athom.com/tools/system:

|date|“2019-03-05T20:43:20.533Z”|
|dateHuman|“dinsdag 5de maart 2019 21:43:20”|

and in Papertrails Log I see:

[2019-03-05T20:43:40.035Z] test 21:43

in my Syslog server PapertriailsApp.com configured for TimeZone Amsterdam (GMT+1) I see:

Mar 05 21:43:40 [PQR-HomeyV2.0] test 21:43

and although is sounds maybe strange but this is what I expect.

If I change my PapertrailsApp.com display setting to UTC (GMT+00:00) it displays as in the internal text log:

Mar 05 20:43:40 [PQR-HomeyV2.0]test 21:43

So I guess your other things log in GMT and not in UTC

It could have to do with the configuration of RFC5424 settings: (https://tools.ietf.org/html/rfc5424)