MoleAPIMoleAPI
문서빠른 시작사이트 내 기본 튜토리얼

알림 설정 및 Quota 경고

잔액 부족이나 이상 징후 알림은 서비스에 문제가 생긴 뒤에 점검하는 것보다 미리 받는 것이 더 중요합니다

많은 운영 환경의 장애는 모델이 실제로 사용 불가능해서가 아니라, 다음과 같은 이유로 발생합니다.

  • 잔액 부족
  • Key 제한 도달
  • 비정상 요청 급증
  • 오류율 상승을 제때 발견하지 못함

따라서 알림 설정은 “고급 기능”이 아니라, 매우 실용적인 기본 기능입니다.

알림 설정 위치

콘솔에서 다음 경로로 이동합니다.

개인 설정 페이지는 대략 다음과 같습니다.

MoleAPI 개인 설정의 알림 설정 페이지로, 알림 방식, Quota 임계값, 이메일 등의 설정을 보여줍니다

현재 페이지에서 설정할 수 있는 항목

현재 알림 설정에는 다음이 포함됩니다.

  • 알림 방식
  • Quota 경고 임계값
  • 알림 이메일

선택 가능한 알림 방식은 다음과 같습니다.

  • 이메일 알림
  • Webhook 알림
  • Bark 알림
  • Gotify 알림

처음 사용하는 경우 가장 먼저 켜야 할 알림

아직 자체 알림 시스템이 없다면, 우선 다음을 권장합니다.

  1. 먼저 이메일 알림을 활성화합니다
  2. 반드시 확인하는 이메일 주소를 입력합니다
  3. 제때 확인할 수 있는 낮은 잔액 임계값을 설정합니다

이유는 매우 간단합니다.

  • 가장 설정하기 쉽습니다
  • 정상 동작 여부를 확인하기 가장 쉽습니다
  • 개인 사용자나 소규모 팀이 먼저 사용하기에 가장 적합합니다

Quota 경고 임계값 이해하기

이 임계값의 역할은 다음과 같습니다.

사용 가능한 Quota가 특정 수준 이하로 떨어지면, 시스템이 자동으로 알려줍니다.

본질적으로 이는 문제를 “서비스에 이미 영향이 발생한 상태”가 아니라 “아직 대응할 시간이 있는 경고”로 앞당겨 주는 기능입니다.

더 합리적으로 설정하는 방법

다음과 같은 시나리오로 이해할 수 있습니다.

  • 개인 테스트: 임계값을 더 낮게 설정해도 됩니다
  • 일상적인 안정적 사용: 대응 시간을 확보할 수 있는 수준으로 설정하는 것을 권장합니다
  • 프로덕션 환경: 지나치게 낮은 단일 임계값 하나에만 의존하지 않는 것이 좋습니다

정식 서비스에 사용 중이라면, 기준은 “낮을수록 절약된다”가 아니라 “문제가 생겨도 처리할 시간이 남아 있어야 한다”입니다.

언제 Webhook / Bark / Gotify를 고려해야 하나요

다음과 같은 요구사항이 있다면, 이메일보다 자동화된 알림 방식을 고려할 수 있습니다.

  • 경고를 팀 봇에 연동하고 싶을 때
  • 알림을 휴대폰으로 직접 푸시하고 싶을 때
  • 잔액 경고와 다른 운영 경고를 함께 관리하고 싶을 때

즉, 다음과 같이 이해하면 됩니다.

  • 개인 사용: 먼저 이메일
  • 반자동 운영: Bark / Gotify
  • 팀 단위 연동: Webhook

권장 사항

  • 최소 하나 이상의 알림 방식을 활성화하세요
  • 임계값을 지나치게 공격적으로 낮게 설정하지 말고, 대응할 시간을 확보하세요
  • 정식 프로젝트에서는 “잔액 부족 알림”과 “Key 보안 정책”을 함께 고려하는 것을 권장합니다
  • 알림 설정을 변경한 후에는, 실제로 알림이 수신되는지 간단한 자체 테스트를 해보는 것이 좋습니다

매우 실용적인 습관 하나

잔액, Key, 모델, 오류 코드는 서로 연결되어 있습니다. 장애 대응을 효율적으로 하는 사람들은 대부분 문제가 발생한 뒤 수동으로 확인하기보다, 먼저 알림부터 제대로 설정해 둡니다.

다음으로 보면 좋은 문서

이 문서가 도움이 되었나요?

마지막 업데이트

홈으로 돌아가기게이트웨이