ESP32 Arduino 开发指南使用 ESP Insights 库实现设备远程诊断与崩溃上报【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本指南讲解如何在 arduino-esp32 项目中集成ESP Insights远程诊断方案覆盖 Agent代理API、Metrics指标API、Variables变量API 的完整用法并结合仓库内的 MinimalDiagnostics 与 DiagnosticsSmokeTest 两个官方示例帮助你将设备日志、崩溃信息、堆内存与 Wi-Fi 指标实时上传到云端仪表盘实现量产设备的远程运维。读完本文你将掌握Insights.begin/Insights.send/Insights.metrics/Insights.variables的完整调用方式与底层实现原理。什么是 ESP Insights为什么需要远程诊断ESP Insights 是面向 Espressif 设备的远程诊断remote diagnostics解决方案用于在设备部署到现场后远程监控其运行健康状况对应文档见 docs/en/api/insights.rst。传统开发调试通常依赖 gdb 物理探测或串口日志观察但很多问题只在特定环境、特定条件下才会出现甚至产品的外壳与摆放位置都会影响行为例如隐藏在墙内的智能开关出现 Wi-Fi 断连智能音箱在某种特定使用模式下崩溃家电因供电问题频繁重启。这类仅在现场复现的问题正是 ESP Insights 的价值所在设备侧将错误日志、警告日志、事件、崩溃回溯crash dump以及自定义指标持续采集并上报到云端开发者无需拿到设备本体即可定位故障。仓库中该库的 library.properties 描述为远程监控设备错误日志、网络变量、Wi-Fi/堆内存指标以及自定义变量/指标With this library you can remotely monitor your device error logs, Network variables, WiFi/Heap Metrics, and also custom variables / metrics.版本号为 3.3.11。启用前提编译开关与组件依赖ESP Insights 并非默认编译进固件而是由 Kconfig 开关控制。查看 Insights.h 与 Insights.cpp整个库实现都被#ifdef CONFIG_ESP_INSIGHTS_ENABLED包裹两个官方示例的 CI 配置也明确要求启用该选项MinimalDiagnostics/ci.ymlrequires: - CONFIG_ESP_INSIGHTS_ENABLEDy且依赖CONFIG_SOC_WIFI_SUPPORTEDy或CONFIG_ESP_HOSTED_ENABLEDyWi-Fi 是默认传输通道。组件依赖在根目录 idf_component.yml 中声明espressif/esp_insights 1.3.3且限制target not in [esp32c2, esp32p4]、idf_version 6.0——即 ESP32-C2 与 ESP32-P4 目前不适用该组件。因此在编译前需要确保在 SDK 配置中打开CONFIG_ESP_INSIGHTS_ENABLEDy否则#include Insights.h之后所有 API 均为空实现Insights全局实例也不存在。Insights Agent API初始化、发送与反初始化Agent API 对应ESPInsightsClass全局实例为Insights见 Insights.h 中extern ESPInsightsClass Insights的声明。Insights.begin初始化诊断代理原型文档与头文件略有差异详见下文说明bool begin(const char *auth_key, const char *node_id NULL, uint32_t log_type 0xFFFFFFFF, bool alloc_ext_ram false);参数说明auth_key在 Insights 云端控制台dashboard生成并下载的认证密钥用于设备身份认证与数据上报鉴权node_id可选指定节点 ID默认NULL时由框架自动生成通常是设备 MAC 相关标识log_type需要采集的日志类型掩码可组合ESP_DIAG_LOG_TYPE_ERROR、ESP_DIAG_LOG_TYPE_WARNING与ESP_DIAG_LOG_TYPE_EVENT默认值0xFFFFFFFF表示全部采集alloc_ext_ram是否在外部 PSRAM 分配缓冲默认false适用于大内存压力场景。返回true表示初始化成功false表示失败。从源码看 Insights.cpp实际签名还包含第 5 个参数bool use_default_transport true为true时调用esp_insights_init(config)使用默认传输通道为false时调用esp_insights_enable(config)由用户自行接管传输当log_type 0xFFFFFFFF时内部会展开为ESP_DIAG_LOG_TYPE_ERROR | ESP_DIAG_LOG_TYPE_WARNING | ESP_DIAG_LOG_TYPE_EVENT三种类型。初始化成功后metrics与variables两个子对象也会被标记为已初始化metrics.setInitialized(true)未初始化时调用任何指标/变量 API 都会打印ESP Insights not initialized并返回false。Insights.send将缓冲数据发送到云端文档中该 API 写作bool sendData()而当前仓库头文件中对应方法为bool send()见 Insights.h底层调用esp_insights_send_data()Insights.cpp。调用是异步的数据从缓冲区读取并发送到云端可能需要一定时间。返回true表示发送成功false表示失败。注意正常使用中框架会根据缓冲区阈值自动上报该 API 主要用于按需强制刷新。Insights.end 与 Insights.disableInsights.end()反初始化 ESP Insights释放资源无返回值void。源码中调用esp_insights_deinit()并将initialized置回falseInsights.cpp析构函数~ESPInsightsClass()也会自动调用end()Insights.disable()文档中列出用于禁用 ESP Insights但当前仓库 Insights.h 中并未找到对应声明公开可用的停止 API 以end()为准如需禁用功能请改用Insights.end()。其他 Agent 级辅助 API头文件中还提供两个文档未展开但实用性强的方法const char *nodeID()返回当前节点 ID未初始化时返回空串示例程序用它打印节点标识void dumpTasksStatus()调用esp_diag_task_snapshot_dump()导出任务快照状态bool event(const char *tag, const char *format, ...)手动上报一个事件日志可变参数格式化内部先vsnprintf到 64 字节栈缓冲、超长则动态分配后调用esp_diag_log_eventInsights.cpp。同时头文件还暴露了 C 接口insightsEvent(tag, format, ...)宏用于输出带时间戳的EV事件日志。Metrics API注册与上报自定义指标Insights.metrics对象类型ESPInsightsMetricsClass用于数值型指标的采集适合上报堆内存、连接状态、计数等周期性数据。所有addX/setX方法底层分别对应esp_diag_metrics_register与esp_diag_metrics_add_*见 Insights.cpp。Insights.metrics.addX注册指标X可取Bool、Int、Uint、Float、String、IPv4、MAC七种类型bool addX(const char *tag, const char *key, const char *label, const char *path);tag指标标签tag用于分类key指标的唯一键label指标的显示标签path键的层级路径多级用.分隔例如system.memory。返回true成功false失败。源码实现中注册失败会打印Failed to add metric %s, err:0x%x。具体类型对应如下数据来自 Insights.h类型方法底层数据类型布尔addBoolESP_DIAG_DATA_TYPE_BOOL整型addIntESP_DIAG_DATA_TYPE_INT无符号整型addUintESP_DIAG_DATA_TYPE_UINT浮点addFloatESP_DIAG_DATA_TYPE_FLOAT字符串addStringESP_DIAG_DATA_TYPE_STRIPv4 地址addIPv4ESP_DIAG_DATA_TYPE_IPv4MAC 地址addMACESP_DIAG_DATA_TYPE_MACInsights.metrics.setX写入指标值bool setX(const char *key, const void val);key为已注册的指标键val为对应类型的值。文档中此处返回值写作ESP_OK但按仓库源码Insights.h 与 Insights.cppsetX实际返回booltrue成功、false失败。具体签名如下setBool(key, bool)、setInt(key, int32_t)、setUint(key, uint32_t)、setFloat(key, float)、setString(key, const char *)、setIPv4(key, uint32_t ip)、setMAC(key, uint8_t *mac)。Insights.metrics.remove / removeAllbool remove(const char *key)按key注销单个指标底层esp_diag_metrics_unregisterbool removeAll()注销全部已注册指标底层esp_diag_metrics_unregister_all。Insights.metrics.dumpHeap / dumpWiFi即时采集系统指标bool dumpHeap()立即采集堆内存指标并输出底层esp_diag_heap_metrics_dump()bool dumpWiFi()立即采集 Wi-Fi 指标并输出底层esp_diag_wifi_metrics_dump()Insights.cpp。两个 API 都用于在任意时刻主动获取快照返回true/false。Insights.metrics.setHeapPeriod / setWiFiPeriod调整周期采集间隔void setHeapPeriod(uint32_t period); void setWiFiPeriod(uint32_t period);默认情况下堆内存与 Wi-Fi 指标每 30 秒采集一次传入以秒为单位的period可修改该间隔设置为 0 表示停用该指标的周期采集。底层分别调用esp_diag_heap_metrics_reset_interval(seconds)与esp_diag_wifi_metrics_reset_interval(seconds)。注意文档中setWiFiPeriod的示例代码误写成了setHeapPeriod实际应调用setWiFiPeriod见 Insights.h。Variables API注册与上报设备变量Insights.variables对象类型ESPInsightsVariablesClass用于变量型数据的采集与 Metrics 的差异在于变量通常在值发生变化时上报适合温度、固件版本、运行状态等随时间变化的信息。所有方法底层对应esp_diag_variable_register与esp_diag_variable_add_*Insights.cpp。Insights.variables.addX注册变量bool addX(const char *tag, const char *key, const char *label, const char *path);参数含义与metrics.addX完全一致tag标签、key唯一键、label显示标签、path用.分隔的层级路径X同样为Bool、Int、Uint、Float、String、IPv4、MAC七种对应方法见 Insights.h。Insights.variables.setX写入变量值bool setX(const char *key, const void val);同样以key定位已注册变量并写入val返回true/false。具体类型方法为setBool/setInt(int32_t)/setUint(uint32_t)/setFloat(float)/setString(const char *)/setIPv4(uint32_t)/setMAC(uint8_t *)。Insights.variables.remove / removeAllbool remove(const char *key)按key注销单个变量bool removeAll()注销全部变量。头文件中该方法声明为removeAll()文档示例写作unregisterAll()两者指代同一功能以头文件声明为准Insights.h。实战示例一MinimalDiagnostics 最小化接入仓库自带的 MinimalDiagnostics 展示了最精简的接入流程设备连上 Wi-Fi 后调用Insights.begin此后任何错误/警告日志与崩溃都会自动上报云端并按 10 分钟周期采集堆内存与 Wi-Fi 指标、变量变化时即时上报见其 README.md。完整核心代码#include Arduino.h #include Insights.h #include WiFi.h const char insights_auth_key[] ENTER YOUR AUTH KEY; #define WIFI_SSID ENTER YOUR SSID #define WIFI_PASSPHRASE ENTER YOUR PASSWORD void setup() { Serial.begin(115200); WiFi.mode(WIFI_STA); WiFi.begin(WIFI_SSID, WIFI_PASSPHRASE); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(); Serial.println(WiFi connected); if (!Insights.begin(insights_auth_key)) { return; } Serial.println(); Serial.printf(ESP Insights enabled Node ID %s\n, Insights.nodeID()); Serial.println(); } void loop() { delay(1000); }接入步骤准备 Auth Key在设置 ESP Insights 账户时下载的认证密钥填入insights_auth_key填写 Wi-Fi 凭据修改WIFI_SSID与WIFI_PASSPHRASE两个宏获取 Node ID编译烧录后打开串口监视器设备连网并完成Insights.begin后会打印类似日志请记录 Node ID 供云端绑定I (4161) esp_insights: I (4171) esp_insights: Insights enabled for Node ID 246F2880371C I (4181) esp_insights: 云端查看登录 Insights Dashboard进入 Nodes 分区点击对应 Node ID 即可查看设备诊断信息。注意事项来自示例 README诊断数据是动态上报或缓冲区达到阈值后上报的因此日志反映到仪表盘需要一定时间若上报失败如 Wi-Fi 掉线、无网络更新的日志会被丢弃。实战示例二DiagnosticsSmokeTest 崩溃上报验证DiagnosticsSmokeTest 是一个端到端冒烟测试程序用于验证崩溃上报、错误/警告/事件日志、堆指标等全部高层特性设备每 10 秒随机打印错误/警告/事件日志并带递增计数器以 30/500 概率主动崩溃调用abort()用于验证崩溃回溯上传RTC_NOINIT_ATTR保存的s_reset_count会跨复位累计崩溃次数前 5 次启动会崩溃MAX_CRASHES为 5第 6 次启动起不再崩溃仅持续记录日志与堆指标循环中随机分配/释放内存malloc与free大小 1KB~8KB并周期性调用Insights.metrics.dumpHeap()即时上报堆指标。崩溃前串口会输出类似E (75826) diag_smoke: [count][7] [crash_count][1] [excvaddr][0x0f] Crashing...其中[crash_count][1]表示本次上电以来的首次崩溃[excvaddr][0x0f]为异常地址可用于在仪表盘核对崩溃回溯。保持设备运行 30 分钟以上后可在仪表盘按控制台打印的 Node ID 查看完整诊断数据详见其 README.md。总结从出了问题才排查到持续远程观测通过本文可以完成一套完整的 ESP Insights 集成先用Insights.begin初始化代理并自动上报错误/警告/事件与崩溃再用Insights.metrics注册堆内存、Wi-Fi 及自定义指标配合setHeapPeriod/setWiFiPeriod控制采集频率、dumpHeap/dumpWiFi按需取快照最后用Insights.variables上报实时变化的设备状态变量。结合 Insights.h 与 Insights.cpp 的源码你可以清晰理解每个 API 到 ESP-IDF 诊断组件esp_insights、esp_diagnostics等的映射关系。这套方案适用于智能开关、智能音箱、家电等需要长期部署在用户现场的 ESP32 产品把现场偶发问题转化为可追溯、可量化的云端数据。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ESP32 Arduino 开发指南：使用 ESP Insights 库实现设备远程诊断与崩溃上报
ESP32 Arduino 开发指南使用 ESP Insights 库实现设备远程诊断与崩溃上报【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本指南讲解如何在 arduino-esp32 项目中集成ESP Insights远程诊断方案覆盖 Agent代理API、Metrics指标API、Variables变量API 的完整用法并结合仓库内的 MinimalDiagnostics 与 DiagnosticsSmokeTest 两个官方示例帮助你将设备日志、崩溃信息、堆内存与 Wi-Fi 指标实时上传到云端仪表盘实现量产设备的远程运维。读完本文你将掌握Insights.begin/Insights.send/Insights.metrics/Insights.variables的完整调用方式与底层实现原理。什么是 ESP Insights为什么需要远程诊断ESP Insights 是面向 Espressif 设备的远程诊断remote diagnostics解决方案用于在设备部署到现场后远程监控其运行健康状况对应文档见 docs/en/api/insights.rst。传统开发调试通常依赖 gdb 物理探测或串口日志观察但很多问题只在特定环境、特定条件下才会出现甚至产品的外壳与摆放位置都会影响行为例如隐藏在墙内的智能开关出现 Wi-Fi 断连智能音箱在某种特定使用模式下崩溃家电因供电问题频繁重启。这类仅在现场复现的问题正是 ESP Insights 的价值所在设备侧将错误日志、警告日志、事件、崩溃回溯crash dump以及自定义指标持续采集并上报到云端开发者无需拿到设备本体即可定位故障。仓库中该库的 library.properties 描述为远程监控设备错误日志、网络变量、Wi-Fi/堆内存指标以及自定义变量/指标With this library you can remotely monitor your device error logs, Network variables, WiFi/Heap Metrics, and also custom variables / metrics.版本号为 3.3.11。启用前提编译开关与组件依赖ESP Insights 并非默认编译进固件而是由 Kconfig 开关控制。查看 Insights.h 与 Insights.cpp整个库实现都被#ifdef CONFIG_ESP_INSIGHTS_ENABLED包裹两个官方示例的 CI 配置也明确要求启用该选项MinimalDiagnostics/ci.ymlrequires: - CONFIG_ESP_INSIGHTS_ENABLEDy且依赖CONFIG_SOC_WIFI_SUPPORTEDy或CONFIG_ESP_HOSTED_ENABLEDyWi-Fi 是默认传输通道。组件依赖在根目录 idf_component.yml 中声明espressif/esp_insights 1.3.3且限制target not in [esp32c2, esp32p4]、idf_version 6.0——即 ESP32-C2 与 ESP32-P4 目前不适用该组件。因此在编译前需要确保在 SDK 配置中打开CONFIG_ESP_INSIGHTS_ENABLEDy否则#include Insights.h之后所有 API 均为空实现Insights全局实例也不存在。Insights Agent API初始化、发送与反初始化Agent API 对应ESPInsightsClass全局实例为Insights见 Insights.h 中extern ESPInsightsClass Insights的声明。Insights.begin初始化诊断代理原型文档与头文件略有差异详见下文说明bool begin(const char *auth_key, const char *node_id NULL, uint32_t log_type 0xFFFFFFFF, bool alloc_ext_ram false);参数说明auth_key在 Insights 云端控制台dashboard生成并下载的认证密钥用于设备身份认证与数据上报鉴权node_id可选指定节点 ID默认NULL时由框架自动生成通常是设备 MAC 相关标识log_type需要采集的日志类型掩码可组合ESP_DIAG_LOG_TYPE_ERROR、ESP_DIAG_LOG_TYPE_WARNING与ESP_DIAG_LOG_TYPE_EVENT默认值0xFFFFFFFF表示全部采集alloc_ext_ram是否在外部 PSRAM 分配缓冲默认false适用于大内存压力场景。返回true表示初始化成功false表示失败。从源码看 Insights.cpp实际签名还包含第 5 个参数bool use_default_transport true为true时调用esp_insights_init(config)使用默认传输通道为false时调用esp_insights_enable(config)由用户自行接管传输当log_type 0xFFFFFFFF时内部会展开为ESP_DIAG_LOG_TYPE_ERROR | ESP_DIAG_LOG_TYPE_WARNING | ESP_DIAG_LOG_TYPE_EVENT三种类型。初始化成功后metrics与variables两个子对象也会被标记为已初始化metrics.setInitialized(true)未初始化时调用任何指标/变量 API 都会打印ESP Insights not initialized并返回false。Insights.send将缓冲数据发送到云端文档中该 API 写作bool sendData()而当前仓库头文件中对应方法为bool send()见 Insights.h底层调用esp_insights_send_data()Insights.cpp。调用是异步的数据从缓冲区读取并发送到云端可能需要一定时间。返回true表示发送成功false表示失败。注意正常使用中框架会根据缓冲区阈值自动上报该 API 主要用于按需强制刷新。Insights.end 与 Insights.disableInsights.end()反初始化 ESP Insights释放资源无返回值void。源码中调用esp_insights_deinit()并将initialized置回falseInsights.cpp析构函数~ESPInsightsClass()也会自动调用end()Insights.disable()文档中列出用于禁用 ESP Insights但当前仓库 Insights.h 中并未找到对应声明公开可用的停止 API 以end()为准如需禁用功能请改用Insights.end()。其他 Agent 级辅助 API头文件中还提供两个文档未展开但实用性强的方法const char *nodeID()返回当前节点 ID未初始化时返回空串示例程序用它打印节点标识void dumpTasksStatus()调用esp_diag_task_snapshot_dump()导出任务快照状态bool event(const char *tag, const char *format, ...)手动上报一个事件日志可变参数格式化内部先vsnprintf到 64 字节栈缓冲、超长则动态分配后调用esp_diag_log_eventInsights.cpp。同时头文件还暴露了 C 接口insightsEvent(tag, format, ...)宏用于输出带时间戳的EV事件日志。Metrics API注册与上报自定义指标Insights.metrics对象类型ESPInsightsMetricsClass用于数值型指标的采集适合上报堆内存、连接状态、计数等周期性数据。所有addX/setX方法底层分别对应esp_diag_metrics_register与esp_diag_metrics_add_*见 Insights.cpp。Insights.metrics.addX注册指标X可取Bool、Int、Uint、Float、String、IPv4、MAC七种类型bool addX(const char *tag, const char *key, const char *label, const char *path);tag指标标签tag用于分类key指标的唯一键label指标的显示标签path键的层级路径多级用.分隔例如system.memory。返回true成功false失败。源码实现中注册失败会打印Failed to add metric %s, err:0x%x。具体类型对应如下数据来自 Insights.h类型方法底层数据类型布尔addBoolESP_DIAG_DATA_TYPE_BOOL整型addIntESP_DIAG_DATA_TYPE_INT无符号整型addUintESP_DIAG_DATA_TYPE_UINT浮点addFloatESP_DIAG_DATA_TYPE_FLOAT字符串addStringESP_DIAG_DATA_TYPE_STRIPv4 地址addIPv4ESP_DIAG_DATA_TYPE_IPv4MAC 地址addMACESP_DIAG_DATA_TYPE_MACInsights.metrics.setX写入指标值bool setX(const char *key, const void val);key为已注册的指标键val为对应类型的值。文档中此处返回值写作ESP_OK但按仓库源码Insights.h 与 Insights.cppsetX实际返回booltrue成功、false失败。具体签名如下setBool(key, bool)、setInt(key, int32_t)、setUint(key, uint32_t)、setFloat(key, float)、setString(key, const char *)、setIPv4(key, uint32_t ip)、setMAC(key, uint8_t *mac)。Insights.metrics.remove / removeAllbool remove(const char *key)按key注销单个指标底层esp_diag_metrics_unregisterbool removeAll()注销全部已注册指标底层esp_diag_metrics_unregister_all。Insights.metrics.dumpHeap / dumpWiFi即时采集系统指标bool dumpHeap()立即采集堆内存指标并输出底层esp_diag_heap_metrics_dump()bool dumpWiFi()立即采集 Wi-Fi 指标并输出底层esp_diag_wifi_metrics_dump()Insights.cpp。两个 API 都用于在任意时刻主动获取快照返回true/false。Insights.metrics.setHeapPeriod / setWiFiPeriod调整周期采集间隔void setHeapPeriod(uint32_t period); void setWiFiPeriod(uint32_t period);默认情况下堆内存与 Wi-Fi 指标每 30 秒采集一次传入以秒为单位的period可修改该间隔设置为 0 表示停用该指标的周期采集。底层分别调用esp_diag_heap_metrics_reset_interval(seconds)与esp_diag_wifi_metrics_reset_interval(seconds)。注意文档中setWiFiPeriod的示例代码误写成了setHeapPeriod实际应调用setWiFiPeriod见 Insights.h。Variables API注册与上报设备变量Insights.variables对象类型ESPInsightsVariablesClass用于变量型数据的采集与 Metrics 的差异在于变量通常在值发生变化时上报适合温度、固件版本、运行状态等随时间变化的信息。所有方法底层对应esp_diag_variable_register与esp_diag_variable_add_*Insights.cpp。Insights.variables.addX注册变量bool addX(const char *tag, const char *key, const char *label, const char *path);参数含义与metrics.addX完全一致tag标签、key唯一键、label显示标签、path用.分隔的层级路径X同样为Bool、Int、Uint、Float、String、IPv4、MAC七种对应方法见 Insights.h。Insights.variables.setX写入变量值bool setX(const char *key, const void val);同样以key定位已注册变量并写入val返回true/false。具体类型方法为setBool/setInt(int32_t)/setUint(uint32_t)/setFloat(float)/setString(const char *)/setIPv4(uint32_t)/setMAC(uint8_t *)。Insights.variables.remove / removeAllbool remove(const char *key)按key注销单个变量bool removeAll()注销全部变量。头文件中该方法声明为removeAll()文档示例写作unregisterAll()两者指代同一功能以头文件声明为准Insights.h。实战示例一MinimalDiagnostics 最小化接入仓库自带的 MinimalDiagnostics 展示了最精简的接入流程设备连上 Wi-Fi 后调用Insights.begin此后任何错误/警告日志与崩溃都会自动上报云端并按 10 分钟周期采集堆内存与 Wi-Fi 指标、变量变化时即时上报见其 README.md。完整核心代码#include Arduino.h #include Insights.h #include WiFi.h const char insights_auth_key[] ENTER YOUR AUTH KEY; #define WIFI_SSID ENTER YOUR SSID #define WIFI_PASSPHRASE ENTER YOUR PASSWORD void setup() { Serial.begin(115200); WiFi.mode(WIFI_STA); WiFi.begin(WIFI_SSID, WIFI_PASSPHRASE); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(); Serial.println(WiFi connected); if (!Insights.begin(insights_auth_key)) { return; } Serial.println(); Serial.printf(ESP Insights enabled Node ID %s\n, Insights.nodeID()); Serial.println(); } void loop() { delay(1000); }接入步骤准备 Auth Key在设置 ESP Insights 账户时下载的认证密钥填入insights_auth_key填写 Wi-Fi 凭据修改WIFI_SSID与WIFI_PASSPHRASE两个宏获取 Node ID编译烧录后打开串口监视器设备连网并完成Insights.begin后会打印类似日志请记录 Node ID 供云端绑定I (4161) esp_insights: I (4171) esp_insights: Insights enabled for Node ID 246F2880371C I (4181) esp_insights: 云端查看登录 Insights Dashboard进入 Nodes 分区点击对应 Node ID 即可查看设备诊断信息。注意事项来自示例 README诊断数据是动态上报或缓冲区达到阈值后上报的因此日志反映到仪表盘需要一定时间若上报失败如 Wi-Fi 掉线、无网络更新的日志会被丢弃。实战示例二DiagnosticsSmokeTest 崩溃上报验证DiagnosticsSmokeTest 是一个端到端冒烟测试程序用于验证崩溃上报、错误/警告/事件日志、堆指标等全部高层特性设备每 10 秒随机打印错误/警告/事件日志并带递增计数器以 30/500 概率主动崩溃调用abort()用于验证崩溃回溯上传RTC_NOINIT_ATTR保存的s_reset_count会跨复位累计崩溃次数前 5 次启动会崩溃MAX_CRASHES为 5第 6 次启动起不再崩溃仅持续记录日志与堆指标循环中随机分配/释放内存malloc与free大小 1KB~8KB并周期性调用Insights.metrics.dumpHeap()即时上报堆指标。崩溃前串口会输出类似E (75826) diag_smoke: [count][7] [crash_count][1] [excvaddr][0x0f] Crashing...其中[crash_count][1]表示本次上电以来的首次崩溃[excvaddr][0x0f]为异常地址可用于在仪表盘核对崩溃回溯。保持设备运行 30 分钟以上后可在仪表盘按控制台打印的 Node ID 查看完整诊断数据详见其 README.md。总结从出了问题才排查到持续远程观测通过本文可以完成一套完整的 ESP Insights 集成先用Insights.begin初始化代理并自动上报错误/警告/事件与崩溃再用Insights.metrics注册堆内存、Wi-Fi 及自定义指标配合setHeapPeriod/setWiFiPeriod控制采集频率、dumpHeap/dumpWiFi按需取快照最后用Insights.variables上报实时变化的设备状态变量。结合 Insights.h 与 Insights.cpp 的源码你可以清晰理解每个 API 到 ESP-IDF 诊断组件esp_insights、esp_diagnostics等的映射关系。这套方案适用于智能开关、智能音箱、家电等需要长期部署在用户现场的 ESP32 产品把现场偶发问题转化为可追溯、可量化的云端数据。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考