Integrate monday.com Monitoring
개요
파일 전송 작업의 상태 변화를 monday.com 보드 항목으로 자동 생성하려면 monday.com 연동을 설정할 수 있습니다.
연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 지정한 monday.com 보드에 항목(Item)이 자동으로 생성됩니다.
전체 과정은 ① monday.com API Token 발급 → ② 대상 Board ID 확인 → ③ 제품에서 연동 설정 순으로 진행됩니다.
준비 사항
시작하기 전에 다음 사항을 확인하세요.
| 항목 | 설명 |
|---|---|
| monday.com 계정 | 대상 보드에 접근 및 편집할 수 있는 monday.com 계정이 필요합니다. API Token은 계정의 권한을 그대로 가집니다. |
| 대상 보드 | 항목(Item)을 생성할 monday.com 보드를 미리 준비합니다. |
| 네트워크 | 제품이 설치된 환경에서 api.monday.com(443)으로의 외부 HTTPS 통신이 허용되어야 합니다. |
monday.com API Token 발급
monday.com으로 항목을 생성하려면 개인 API Token을 발급받습니다.
Step 1. Developer Center 열기
우측 상단의 프로필 사진을 클릭하고 Developers를 선택합니다.
Developer Center가 새 탭으로 열립니다.

Step 2. API Token 복사
My Access Tokens(또는 API Token)에서 Show를 클릭하고 표시된 토큰을 복사합니다.
토큰은 일반적으로 eyJ로 시작하는 JWT 형식입니다.
이 토큰은 계정의 권한을 그대로 가지므로 비밀번호처럼 취급하여 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다.
유출된 경우 Developer Center에서 Regenerate를 실행하면 기존 토큰이 무효화됩니다.

확인 사항
✔ Developer Center에서 API Token을 확인했습니다.
✔ API Token을 안전하게 복사했습니다.
대상 Board ID 확인
항목을 생성할 대상 보드의 ID를 확인합니다.
Step 1. Board ID 확인
대상 보드를 열면 브라우저 주소창 URL의 /boards/ 다음에 오는 숫자가 Board ID입니다.

확인 사항
✔ 대상 Board ID를 확인했습니다.
monday.com 연동 설정
발급받은 API Token과 Board ID를 제품의 설정에 입력합니다.
Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Monday API Token 입력
Monday API Token 항목에 복사한 API Token을 입력합니다.
Step 2. Board ID 입력
Board ID 항목에 확인한 Board ID를 입력합니다.
Step 3. 이벤트 선택
Events 항목에서 모니터링할 이벤트를 선택합니다.
여러 개를 선택할 수 있으며, 선택한 이벤트가 발생할 때만 monday.com에 항목이 생성됩니다.
| 이벤트 | 발생 시점 |
|---|---|
| Transfer Started | 전송 작업이 시작되었을 때 |
| Transfer Completed | 전송이 정상적으로 완료되었을 때 |
| Transfer Paused | 전송이 일시 중지되었을 때 |
| Transfer Recovered | 중단 또는 오류 후 전송이 자동 복구되어 재개되었을 때 |
| Device Connected | 기기가 연결되었을 때 |
| Device Disconnected | 기기 연결이 해제되었을 때 |
Step 4. 설정 저장
입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.
확인 사항
✔ Monday API Token이 입력되었습니다.
✔ Board ID가 입력되었습니다.
✔ 모니터링할 이벤트가 선택되었습니다.
연동 확인
설정이 정상적으로 동작하는지 확인합니다.
Step 1. 테스트 이벤트 발생
실제 전송 작업을 실행하거나 선택한 이벤트를 발생시킵니다.

Step 2. monday.com 보드 확인
지정한 monday.com 보드에 새로운 항목(Item)이 생성되었는지 확인합니다.

확인 사항
✔ monday.com 보드에 항목이 생성되었습니다.
✔ 발생한 이벤트가 정상적으로 기록되었습니다.
설정 완료
설정을 저장하면 연동이 적용됩니다.
이후 선택한 이벤트가 발생할 때마다 지정한 monday.com 보드에 항목이 자동으로 생성됩니다.
문제 해결 (Troubleshooting)
| 문제 | 확인 사항 |
|---|---|
| 항목이 생성되지 않음 | Monday API Token과 Board ID가 정확한지, 앞뒤 공백이나 누락이 없는지 확인 |
| 인증 오류(401)가 발생함 | API Token이 유효한지, Regenerate로 무효화되지 않았는지 확인 |
| 권한 오류가 발생함 | API Token을 발급한 계정에 대상 보드의 접근 및 편집 권한이 있는지 확인 |
| 보드를 찾을 수 없음 | Board ID가 대상 보드의 /boards/ 뒤에 있는 숫자인지 확인 |
| 폐쇄망에서 연동 실패 | api.monday.com(443)으로의 아웃바운드 HTTPS 통신이 방화벽 또는 프록시에서 허용되는지 확인 |