링크비온 게이트웨이의 알람을 텔레그램으로 받는 순서를 요약합니다. 그림이 든 전체 설명은 네이버 카페 글에 있습니다.
0.1.0.24 다음 버전부터 해당합니다. 0.1.0.24 까지는 화면에서 넣은 설정이 바로 먹지 않거나 재시작하면 사라지는 결함이 있었고, 맥 설치본에는 텔레그램 모듈이 없었습니다.
1. 텔레그램에서 봇 만들기
- 텔레그램에서 BotFather 와 대화를 열고
/newbot을 보내 봇을 만듭니다. 비용은 없습니다. - BotFather 가 알려 주는 봇 토큰은 남에게 보이지 않게 보관합니다.
- 알림을 받을 사람(또는 봇을 넣은 그룹)이 봇에게 메시지를 한 번 보냅니다. 봇은 먼저 말을 건 대화에만 보낼 수 있습니다.
https://api.telegram.org/bot<봇 토큰>/getUpdates에서"chat":{"id": …}숫자를 찾습니다. 이것이 Chat ID 입니다(그룹 · 채널은-100으로 시작).
게이트웨이 장비가 인터넷으로 api.telegram.org(HTTPS) 에 나갈 수 있어야 합니다. 폐쇄망에서는 보낼 수 없습니다.
2. 게이트웨이에 넣기
- 메뉴 감시 › 알람 › 알림 설정 의 Telegram 설정 칸에서 켜고, 봇 토큰과 Chat ID 를 넣고 저장합니다. 저장하면 재시작 없이 바로 적용됩니다.
- 이 설정은 관리자(admin)만 바꿀 수 있습니다. 다른 계정은 시험 발송만 할 수 있습니다.
- 저장한 토큰은 화면 · 설정 내보내기에 다시 보이지 않고 가림표로만 나옵니다.
- 재시작 뒤에도 남기려면 프로젝트도 저장합니다(텔레그램 설정은 프로젝트에 들어 있습니다).
3. 시험 발송
테스트 발송 으로 시험 메시지 한 통을 보냅니다. 실패하면 텔레그램이 돌려준 까닭이 그대로 나옵니다 — 예: 401 Unauthorized 는 토큰이 틀림, chat not found 는 Chat ID 가 틀렸거나 봇에게 먼저 말을 걸지 않음.
4. 알람 규칙에서 Telegram 고르기
규칙마다 알림 채널에서 Telegram 을 골라야 보냅니다. 새 규칙의 기본은 '화면' 만입니다. 알람이 발생할 때만 보내고, 해제 · 확인은 보내지 않습니다.
메시지 기본 모양은 [{severity}] {tagId} = {value} ({condition} {threshold}) 이고, 알림 문장 서식에서 바꿀 수 있습니다. 스크립트에서도 텔레그램 메시지를 보낼 수 있습니다.
막히는 곳이 있으면 화면의 상태 줄 문구와 함께 메일이나 카페로 알려 주십시오.