arduino-esp32/libraries/Insights/examples/MinimalDiagnostics
Lucas Saavedra Vaz 9f3010f214
ci(json): Improve requirement checking (#10554)
* ci(json): Change requirements for sketches that use WiFi

* ci(checks): Optimize requirement checking

* fix(tests): Additional checks before running tests

---------

Co-authored-by: Jan Procházka <90197375+P-R-O-C-H-Y@users.noreply.github.com>
2024-11-06 18:08:16 +02:00
..
ci.json ci(json): Improve requirement checking (#10554) 2024-11-06 18:08:16 +02:00
MinimalDiagnostics.ino refactor(style): Change some style options (#9526) 2024-04-19 18:16:55 +03:00
README.md docs(vale): Enable vale and fix errors (#10231) 2024-08-28 15:48:18 +03:00

Minimal Diagnostics example

What to expect in this example?

  • This example demonstrates the use of ESP Insights framework in minimal way
  • Device will try to connect with the configured Wi-Fi network
  • ESP Insights is enabled in this example, so any error/warning logs, crashes will be reported to cloud
  • This example collects heap and Wi-Fi metrics every 10 minutes and network variables are collected when they change

Try out the example

Facilitate the Auth Key

In this example we will be using the auth key that we downloaded while setting up ESP Insights account.

Copy Auth Key to the example

const char insights_auth_key[] = "<ENTER YOUR AUTH KEY>";

Enter Wi-Fi Credentials

Inside the example sketch, enter your Wi-Fi credentials in WIFI_SSID and WIFI_PASSPHRASE macros.

Get the Node ID

  • Start the Serial monitor

  • Once the device boots, it will connect to the Wi-Fi network, look for logs similar to below and make a note of Node ID.

I (4161) esp_insights: =========================================
I (4171) esp_insights: Insights enabled for Node ID 246F2880371C
I (4181) esp_insights: =========================================

Insights Dashboard

Once everything is set up, any diagnostics information reported will show up on the Insights Dashboard. Sign in using the your credentials.

Monitor the device diagnostics

Visit Nodes section on the dashboard and click on the Node ID to monitor device diagnostics information.

Note: Diagnostics data is reported dynamically or when the buffers are filled to configured threshold. So, it can take some time for the logs to reflect on the dashboard. Moreover, if a large number of logs are generated then data will be sent to cloud but, if it fails(eg reasons: Wi-Fi failure, No internet) then any newer logs will be dropped.