--- title: "앱에 머신 위젯 추가하기" slug: "how-to-add-a-machine-widget-to-an-app" tags: ["Machine Widget", "Machine Monitoring", "Machine Attribute", "Machine State"] updated: 2026-10-22T10:43:47Z published: 2026-10-22T10:43:47Z 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) 방문하여 질문을 게시하거나 다른 사용자들이 비슷한 질문을 올렸는지 확인해 보세요!