[App][Pro] PaperTrails Log - Advanced Logging and SysLog

Apps
, ,
1

PaperTrails Log App for Homey | Homey

Advanced 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:

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

Updated the app and published:

History for latest update.

Version 0.7.4 (in /Test)

  • Updated to SDK3 an homey-api module, now finally compatible with Homey Pro (Early 2023)
  • Removed both localized time presentations (“Normal Seconds” and “Precise mSec.”) to simplify the App. Only option and default is now “UTC” aka “GMT” aka “Zulu” time. presented in the format: [2024-10-03T21:09:51.998Z]
  • Fixed the issue with the setting screen reported above.

After some more testing it will be released to stable channel.

For the old Forum discussion see here: [App] PaperTrails - Advanced Logging and Log management (v0.3.7) — Athom Forum Archive

For any questions just comment here !

4 Likes
2

Update tot SDK 3 for Homey Pro (Early 2023)

FAQ

Q: Time notation is strange

A: No, it is different. It is in the form [YYYY-MM-DD T HH:mm:ss:mSec Z] (Added spaces for Readability) one of the notations conform ISO_8601

Q: Time is 2 hours off (Or any other number of hours depending your location)

A: No, it reports Homey’s UTC clock the default internal clock. Athom changed this in SDK3 and will now be used by Papertrails Log. Conversion to the timezone of the user is to cumbersome and I can live with UTC. Therefore I removed the Local Time from the options.

3

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
4

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!

5

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
6

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.
7

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

8

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

1 Like
9

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

10

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
11

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

12

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):

09
Schermafbeelding 2018-12-17 om 17.28.09.png796×214 7.86 KB

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?

13

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

afbeelding

14

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
15

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

16

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.

17

Anyone able to download the logfile?

18

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.

19

That works!!! Thanks a lot @Dijker

20

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 Homey Developer Tools

|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: (RFC 5424 - The Syslog Protocol)