Telegram 알람 설정

Telegram 알람 설정 (Configure Telegram for Alerting)

Grafana Alerting - Telegram 통합을 사용하면 알림이 발생할 때 Telegram으로 알림을 보낼 수 있어요. Telegram 봇 API 토큰과 chat ID를 얻어 연락처 포인트로 등록하는 과정을 안내합니다.

출처: 문서

본문

Grafana Alerting - Telegram 통합을 사용하면 알림이 발생할 때 Telegram 알림을 보낼 수 있어요.

시작하기 전에 (Before you begin)

Telegram 제한사항: Telegram 메시지는 4096 UTF-8 문자로 제한됩니다. None이 아닌 다른 parse_mode를 사용하면 잘림(truncation)으로 인해 메시지가 유효하지 않게 되어 알림 전송이 실패할 수 있어요. 긴 메시지는 대체 연락 방법을 권장합니다.

Grafana를 Telegram과 통합하려면 Telegram 봇 API 토큰(bot API token) 과 chat ID(알림을 받으려는 Telegram 채팅의 ID)가 필요해요. 통합을 완료하려면 브라우저 버전의 Telegram을 사용하세요.

Telegram 봇 설정하기 (Set up your Telegram bot)

Telegram 봇을 만드세요. 이 봇을 채팅에 연결해 Grafana의 알림을 받는 등 다양한 작업에 사용할 수 있어요.

  1. 기기에서 Telegram 앱을 엽니다.
  2. BotFather라는 이름의 Telegram 봇을 찾습니다.
  3. /newbot 을 입력하거나 누릅니다.
  4. 봇 이름을 선택합니다. 이름은 bot 또는 _bot 으로 끝나야 해요. 예: my_bot
  5. API 토큰을 복사합니다.

Chat ID 구하기

아래 단계로 그룹 채팅에 봇을 추가하면 알림을 그 그룹으로 라우팅할 수 있어요.

  1. Telegram 앱에서 그룹을 열거나 새 그룹을 시작합니다.
  2. 봇을 검색해 그룹에 추가합니다.
  3. 브라우저 주소 표시줄의 URL에서 chat ID를 복사합니다. 다음과 같은 형태예요: https://web.telegram.org/a/#-4266674385
  4. chat ID는 # 기호 뒤에 오는 숫자 시퀀스입니다. 예: -4266674385

절차 (Procedure)

Grafana Alerting에서 Telegram 통합을 만들려면:

  1. Alerts & IRM → Alerting → Notification configuration 으로 이동한 다음 Contact points 탭을 선택합니다.
  2. + Add contact point 를 클릭합니다.
  3. 연락처 포인트 이름을 입력합니다.
  4. Integration 목록에서 Telegram 을 선택합니다.
  5. BOT API Token 필드에 봇 API 토큰을 붙여넣습니다.
  6. Chat ID 필드에 chat ID를 붙여넣습니다.
  7. Test 를 클릭해 통합이 작동하는지 확인합니다. (Grafana Alertmanager 전용.)
  8. Save contact point 를 클릭합니다.

다음 단계 (Next steps)

Telegram 연락처 포인트가 알림을 받을 준비가 되었습니다. 알림에 추가하려면:

  1. Grafana에서 Alerting > Alert rules 로 이동합니다.
  2. 알림 규칙을 편집하거나 새로 만듭니다.
  3. Configure labels and notifications 섹션까지 스크롤합니다.
  4. Notifications 아래에서 Select contact point 를 클릭합니다.
  5. 드롭다운 메뉴에서 앞서 만든 연락처 포인트를 선택합니다.
  6. Save rule and exit 를 클릭합니다.

더 알아보기 (Learn more)