# \[APP\]\[Pro\] Audit - Adds logging and tracing to your Homey Pro and integrates into third party systems

**URL:** <https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554>\
**Category:** Apps\
**Created:** [January 18, 2024, 1:22pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554 "2024-01-18T13:22:00Z")\
**Posts on this page:** 20\
**Page:** 2

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [June 3, 2024, 2:02pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/21 "2024-06-03T14:02:54Z")

</div>

Just a brainfart Jamie, but is it an idea to have the option to send any changed state to the Simple Log app log? I think it’s possible without flows.  
Maybe it’s something for the future.

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [June 3, 2024, 3:37pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/22 "2024-06-03T15:37:27Z")

</div>

Hey Peter, yes its an option, was waiting on an API to add entires directly to SimpleLog.

Flows are less then ideal as they have had a rate limit which shuts down the flow when many updates happen in a short period.

The app has been submitted to Athom for approval.

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [June 4, 2024, 4:35pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/23 "2024-06-04T16:35:31Z")

</div>

Got a message asking me to update the readme file, which I have now done. Hopefully its going off to code review soon.

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [June 6, 2024, 11:54am UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/24 "2024-06-06T11:54:10Z")

</div>

Got a message from the review saying the readme is now to long 😠 they are like the goldilocks of app descriptions.

The names of the flows are ‘not detailed enough’, i’ve updated to be more detailed but also less correct.

They are concerned that the flows might fire too often for the hardware to keep up with, it actually protected already by flood protection but Ive given them some other options - fingers crossed they don’t ask me to remove the feature all together as it will be useful to the community.

* * *

Going to do one more final submission, this process is just to frustrating and time consuming.

---

<div class="post-metadata">

**Author:** ![Sharkys](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/sharkys/32/54029_2.png) [@Sharkys](https://community.homey.app/u/Sharkys)\
**Post date:** [June 6, 2024, 12:44pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/25 "2024-06-06T12:44:40Z")

</div>

Strange, a pity, they normally let the release go and just give you recommendation, so I wonder why they changed approach, mostly when dealing with so experienced developer. ☹  
Just don’t give up.

---

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [June 6, 2024, 3:29pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/26 "2024-06-06T15:29:55Z")

</div>

The readme is too long… 🙄🤔🥴  
Shoot me 😶

* * *

@Jamie Maybe a readme pointing to a wiki @ git is an idea? Like Baldhor did for example:

> [@\[APP\]\[Pro\] ESPhome - Control your ESP8266/ESP32 by simple configuration files](https://community.homey.app/t/app-pro-esphome-control-your-esp8266-esp32-by-simple-configuration-files/87271/1):
>
> **I wrote a wiki to explain all the concepts, and it includes a user guide:**
> 
> [Home · Baldhor/Homey-ESPhome-Enhanced Wiki · GitHub](https://github.com/Baldhor/Homey-ESPhome-Enhanced/wiki)

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [June 26, 2024, 1:02pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/27 "2024-06-26T13:02:35Z")

</div>

Test is approved, let me know how you go.

> **[Audit](https://homey.app/en-au/app/com.audit/Audit/)**
>
> Adds logging and tracing to your homey and integrates into third party systems

---

<div class="post-metadata">

**Author:** ![PeterHa](https://avatars.discourse-cdn.com/v4/letter/p/94ad74/32.png) [@PeterHa](https://community.homey.app/u/PeterHa)\
**Post date:** [June 26, 2024, 2:28pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/28 "2024-06-26T14:28:06Z")

</div>

Hi @Jamie ,  
great that the first version is available!

Currently it’s only working with Betterstack, and Syslog will follow later on, right?  
And you mentioned above that data would be available as a daily zip file. How can I get this files?

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [June 26, 2024, 2:37pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/29 "2024-06-26T14:37:10Z")

</div>

The files are stored locally on the homey and rotated/zipped then eventually deleted.

http://{HOMEY\_IP}/app/com.audit/userdata/detail-yyyy-mm-dd.log  
http://{HOMEY\_IP}/app/com.audit/userdata/message-yyyy-mm-dd.log

ie.  
[http://192.168.0.100/app/com.audit/userdata/detail-2024-06-26.log](http://192.168.0.100/app/com.audit/userdata/detail-2024-06-26.log)  
[http://192.168.0.100/app/com.audit/userdata/message-2024-06-26.log](http://192.168.0.100/app/com.audit/userdata/message-2024-06-26.log)

---

<div class="post-metadata">

**Author:** ![Sharkys](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/sharkys/32/54029_2.png) [@Sharkys](https://community.homey.app/u/Sharkys)\
**Post date:** [June 27, 2024, 6:40am UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/30 "2024-06-27T06:40:44Z")

</div>

Do I get it right that I would need to create trigger for every value update or just by setting it in the settings, all activities will be send to the desired target, eg. Betterstack ?

 ![audit](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/f/e/feba1a2f57d6170c5adc85db55b482844d650964.png)

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [June 27, 2024, 8:23am UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/31 "2024-06-27T08:23:26Z")

</div>

All of the above.

**You don’t need to create triggers, the audit will automatically be logged**

- Everything is logged automatically to the enabled targets.
- And if you want you can also use the flow cards triggers to do additional actions.
- You can send additional information to the audit (which will send it to what ever you enabled)

The trigger flows are are value-add, the action flows are useful for auditing the paths through your flows.

---

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [June 27, 2024, 5:24pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/32 "2024-06-27T17:24:04Z")

</div>

Hi Jamie,

First of all congrats with the app and app approval.  
You probably got my auto-generated crash reports already.  
The app crashes @ Homey 2019, i.e. I can’t save settings _before_ it crashes.  
If you need me to do anything, just let me know.

---

<div class="post-metadata">

**Author:** ![Le\_Cactus](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/le_cactus/32/9727_2.png) [@Le\_Cactus](https://community.homey.app/u/Le_Cactus)\
**Post date:** [June 27, 2024, 7:14pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/33 "2024-06-27T19:14:10Z")

</div>

> [@Jamie](#):
>
> ## Betterstack
> 
> By far the best method! Go to betterstack and create a new account, then just add the “id” to the app.  
> All your audit logs will be available directly with in betterstack,. The free account will keep the data for 3 days.

Thanks for this app. Very nice indeed!

---

<div class="post-metadata">

**Author:** ![Jamie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jamie/32/5274_2.png) [@Jamie](https://community.homey.app/u/Jamie)\
**Post date:** [June 28, 2024, 12:41am UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/34 "2024-06-28T00:41:30Z")

</div>

Are you using the latest test version?

I fixed a crash issue almost immediately but it’s still waiting from approval from Athom?

---

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [June 28, 2024, 12:32pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/35 "2024-06-28T12:32:46Z")

</div>

Thanx Jamie, it works fine now, with v1.0.8

Jamie, @Sharkys This I don’t understand:

> [@Jamie](#):
>
> Go to betterstack and create a new account, then just add the “id” to the app.  
> All your audit logs will be available directly with in betterstack,.

I got an API key, and it seems connected  
`2024-06-28 12:30:06.254] alert: BetterStack is connected`  
Then I’m lost.  
Do I need a ‘Logs API key’? Or a ‘Global API key’?  
And, where can I view my logs at [betterstack.com](http://betterstack.com)?  
Do I need to create a dashboard?  
I’ve spend hours @ betterstack to try and test → meaning: I really tried, but no luck yet 😊

Tia!

---

<div class="post-metadata">

**Author:** ![DirkG](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/dirkg/32/118897_2.png) [@DirkG](https://community.homey.app/u/DirkG)\
**Post date:** [June 28, 2024, 1:16pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/36 "2024-06-28T13:16:23Z")

</div>

Same problem here, Peter. Absolutely no idea how Betterstack works.  
Does “ID” even mean API key?

---

<div class="post-metadata">

**Author:** ![Sharkys](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/sharkys/32/54029_2.png) [@Sharkys](https://community.homey.app/u/Sharkys)\
**Post date:** [June 28, 2024, 1:37pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/37 "2024-06-28T13:37:49Z")

</div>

@DirkG@Peter_Kawa , I created resource and the copied SOURCE TOKEN.

 ![better](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/d/a/da3ca6dce26b39fa408aea773d21004b8287faee.png)

---

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [June 28, 2024, 1:57pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/38 "2024-06-28T13:57:24Z")

</div>

Ah yes, did that as well, but I was unsure what to select @ “_platform_”. I choose Javascript.  
But that seems irrelevant 🤷‍♂️  
After adding this API key / token in the app settings, and hitting “`>`Live tail” at that betterstack page, it works 🥰

> ![Screenshot_20240628-155337_Chrome](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/4/f/4ffa51de58e8b0a2baf56dee77b949160be2b2c2.jpeg)

---

<div class="post-metadata">

**Author:** ![SingKT](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/singkt/32/173226_2.png) [@SingKT](https://community.homey.app/u/SingKT)\
**Post date:** [June 28, 2024, 8:57pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/39 "2024-06-28T20:57:13Z")

</div>

My Aqara devices won’t show up in Audit.  
The Info: battery low from devolo device wasn’t recorded either.  
Am talking about the local message log.  
A restart of apps triggers an Audit flow but no messages in log, using level notice.  
Any ideas?  
Home pro 2023, version 11.1.1, Audit 1.0.8, Aqara 1.9.0.  
Haven’t done a PTP yet.

As timestamp I would prefer local time instead of UTC.

---

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [June 28, 2024, 11:02pm UTC](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554/40 "2024-06-28T23:02:59Z")

</div>

> [@SingKT](#):
>
> As timestamp I would prefer local time instead of UTC.

+1

> [@SingKT](#):
>
> no messages in log, using level notice

Level _Notice_ doesn’t show all info. I’d like to suggest to use level _Info_, and if this also doesn’t show the expected data, try level _Debug_  
See:

> [@Jamie](#):
>
> 1. **Notice** (`notice`): applies to normal but significant conditions that may require monitoring.
> 2. **Informational** (`info`): includes messages that provide a record of the normal operation of the system.
> 3. **Debug** (`debug`): intended for logging detailed information about the system for debugging purposes.

[Previous page](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554.md?page=1)

[Next page](https://community.homey.app/t/app-pro-audit-adds-logging-and-tracing-to-your-homey-pro-and-integrates-into-third-party-systems/101554.md?page=3)
