MoleAPIMoleAPI
ドキュメントクイックスタートサイト内の基本チュートリアル

通知設定とクォータ警告

残高不足や異常の通知は、サービスに問題が起きてから調査するより前に受け取ることが重要です

多くの本番障害は、実際にモデルが利用不可になったことが原因ではなく、次のような要因で発生します。

  • 残高不足
  • Key が制限に達した
  • 異常なリクエストが急増した
  • エラー率が上昇しているのに誰もすぐに気づかなかった

そのため、通知設定は「高度な機能」ではなく、実用性の高い基本機能です。

通知設定はどこにあるか

コンソールで次へ進みます。

個人設定ページはおおよそ次のような構成です。

MoleAPI の個人設定にある通知設定ページ。通知方法、クォータしきい値、メールアドレスなどの設定を表示

このページで現在設定できる内容

現在の通知設定には、以下が含まれます。

  • 通知方法
  • クォータ警告しきい値
  • 通知メールアドレス

選択できる通知方法は以下のとおりです。

  • メール通知
  • Webhook 通知
  • Bark 通知
  • Gotify 通知

初心者に最もおすすめの通知方法

まだ独自の通知システムがない場合は、まず次をおすすめします。

  1. メール通知 を有効化する
  2. 必ず確認するメールアドレスを入力する
  3. 低残高を早めに把握できるしきい値を設定する

理由はシンプルです。

  • 最も設定しやすい
  • 正常に機能しているか確認しやすい
  • 個人利用や小規模チームで使い始めるのに最適

クォータ警告しきい値の考え方

このしきい値の役割は次のとおりです。

利用可能なクォータが一定水準まで下がったときに、システムが自動的に通知します。

本質的には、「すでにサービスへ影響が出ている問題」を「まだ対処が間に合う段階の通知」へ前倒しするための仕組みです。

より適切なしきい値の設定方法

利用シーンごとに次のように考えるとわかりやすいです。

  • 個人テスト:しきい値は低めでも可
  • 日常的で安定した利用:対応までの時間を確保できる水準に設定するのがおすすめ
  • 本番環境:極端に低い単一しきい値だけに依存しないことをおすすめします

正式な業務で使う場合の原則は、「低いほど節約できる」ではなく、「対処する時間を確保できること」です。

どんなときに Webhook / Bark / Gotify を検討すべきか

次のような要件がある場合は、メールより自動化しやすい通知方法を検討できます。

  • アラートをチームの bot に連携したい
  • 通知を直接スマートフォンにプッシュしたい
  • 残高アラートを他の運用アラートと一元管理したい

言い換えると、次の使い分けです。

  • 個人利用:まずはメール
  • 半自動運用:Bark / Gotify
  • チームでの連携:Webhook

推奨プラクティス

  • 少なくとも 1 つの通知方法を有効にする
  • しきい値を攻めすぎないようにし、対応が間に合わなくなるのを避ける
  • 正式なプロジェクトでは、「低残高通知」と「Key のセキュリティ戦略」をあわせて検討する
  • 通知設定を変更した後は、小規模なセルフテストを行い、通知を受信できることを確認する

実用的な習慣のひとつ

残高、Key、モデル、エラーコードは相互に関連しています。トラブルシューティングの効率が高い人ほど、問題が起きてから手作業で調べるのではなく、先に通知を適切に設定しています。

次に読むとよいページ

このガイドはいかがですか?

最終更新日

ホームへ戻るゲートウェイ