--- title: "向应用中添加机器小部件" slug: "how-to-add-a-machine-widget-to-an-app" updated: 2026-10-22T10:43:37Z published: 2026-10-22T10:43:37Z canonical: "support.tulip.co/how-to-add-a-machine-widget-to-an-app" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # 向应用中添加机器小部件 ## 目的 *了解如何通过 3 种不同的可视化方式在应用程序中显示实时机器数据* **在本文中,您将学习……** - **如何在应用程序中实时查看机器数据** 在“设备”页面[添加设备并创建属性](/r230/docs/how-to-add-machine-attributes-downtime-reasons-and-states)后,您即可开始跟踪实时设备数据。 NOTE Many of the concepts in this article are also covered in detail on [Tulip University](https://university.tulip.co/learn/courses/33/machine-monitoring-in-tulip). ## 如何将设备小部件添加到应用中 有三种专门为设备监控设计的组件,可显示设备属性或设备状态: - 设备属性 - 设备状态 - 设备时间线 ## 常见配置 所有设备小部件的第一步都是选择数据源和设备。这将小部件与特定设备或变量建立连接。 1. 在*“数据源”*下*,*选择*“静态值”*或*“变量”。* *“静态值”*允许您选择要显示的特定机器*,“变量”*则允许您在运行应用时根据变量来切换机器。 2. 根据您在第 1 步中的选择,您可以从设备列表或设备变量列表中进行选择。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313487180.png) ## 设备属性 此控件可显示单个机器属性的当前值。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313488048.png) 要使用此小部件,只需从侧边面板中选择所需的属性即可。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_119733675.png) ## 机器状态 此小部件可实时显示机器的“状态”,以及其任意属性的最新输出值。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313490071.png) 选择后,您可以确定希望在小工具上查看哪些[设备活动字段和设备属性](https://support.tulip.co/docs/how-to-set-up-machine-types)。 选定设备类型和属性后,您可以将任何活动历史记录字段添加到小部件中。通常包括停机原因和状态。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_303049541.png) ## 设备时间轴 设备时间轴显示设备在选定时间段内的状态变化。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313491407.png) 您可以选择时间范围,或手动设置开始和结束时间。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313491744.png) *注意:时间轴上仅显示 300 个数据点。若所选时间范围内的数据点超过此数量,时间轴将提示已达到上限。* ### 其他配置选项 您可以在“机器时间轴”上切换以下选项: - 显示键 - 显示运行时间百分比 - 显示标题 **启用停机时间审查** 启用此选项后,将出现一个按钮,允许操作员针对机器的任何停机时间更新“停机原因”。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Add%20a%20Machine%20Widget%20to%20an%20App_313493540.png) ## 进一步阅读 - [如何在分析构建器中使用机器数据](https://support.tulip.co/docs/using-machine-data-in-the-analytics-editor) --- 您找到想要的内容了吗? 您也可以访问[community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all)发布问题,或查看其他人是否遇到过类似问题!