MENU

GASトリガー失敗をメール通知する運用テンプレ

当ページのリンクには広告(PR)が含まれていることがあります。
GASトリガー失敗をメール通知する運用テンプレのアイキャッチ

GASの定期処理が失敗しても、作成者の受信箱に通知が届くだけでは、業務の担当者が気づかない場合があります。通知を受ける人と、出力を確認する人、再実行する人を決めておくと、失敗した後の動きがそろいます。

ここでは、毎日の集計処理を例に、標準の失敗通知から状況の共有までを整理します。トリガーの登録、メール送信、実際の集計は行っていません。

目次

標準の失敗通知を確認する

Googleのインストール型トリガーの説明では、トリガーで動いた処理が例外を出すなどして失敗すると、作成者へ失敗の概要が通知されるとされています。

まず、誰のアカウントでトリガーを作ったかを調べます。共有シートの所有者や、普段操作する人と同じとは限りません。通知を確認する受信箱と、担当交代時の連絡先を運用メモへ書いておきます。

メールを待つだけでなく、Apps Scriptの実行履歴で、関数名、失敗した時刻、エラーを見ます。最終成功日時も出力側へ残せば、通知を見落とした日でも、更新が止まっているかを確認できます。

記録する処理の区切り

集計なら、入力取得、入力検査、計算、保存、通知のように段階を分けます。失敗時には「月次処理が失敗」だけでなく、最後にどこまで終わったかを残します。

スクロールできます
段階 確認する情報
入力取得 対象の期間と件数
入力検査 不備の種類と対象行
保存 出力先と保存結果
通知 宛先の種別と送信結果

件数や処理IDを残す目的は、再実行する範囲を決めることです。入力の原文やAPIキーを丸ごとログへ出す必要はありません。ログに保存してよい項目を先に選びます。

失敗を隠さず記録する例

次の関数は処理名とエラーの種類を記録し、元のエラーを返して失敗を呼び出し元へ伝えます。説明用のJavaScriptで、実際のトリガーでは動かしていません。

function runWithFailureRecord(jobName, work) {
  try {
    return work();
  } catch (error) {
    console.error(JSON.stringify({
      job: jobName,
      errorType: error && error.name ? error.name : 'UnknownError'
    }));
    throw error;
  }
}

catchでログを書いた後に正常終了してしまうと、処理の結果と、運用側が見る成功・失敗が食い違う場合があります。例外をどう扱うかを決め、失敗を確認できる形にします。ログの種類や保存先は公式のロギングガイドでも確認できます。

担当者へ共有する通知メモ

標準通知を受けた担当者が、次の書式で状況を共有します。未確認の欄を、推測で「未送信」「未保存」と埋めないことが大切です。

処理名:
失敗した実行時刻:
最後に確認できた完了段階:
出力の保存: 確認済み / 未確認
外部への送信: 確認済み / 未確認
確認先: 実行履歴と対象の出力
再実行: 保留 / 対象を限定して実施可能
次の確認担当:

エラー本文をそのまま転送するより、必要な実行情報と確認先を共有した方が、担当者は次の操作を選べます。個人情報や認証情報を含む場合は、共有してよい範囲を確認してください。

再実行へ進む条件

保存済みの行と通知済みの対象を照合し、同じ処理が二度動かないかを見ます。保存後の通知だけ失敗しているなら、集計からやり直す必要があるかを判断します。完了した範囲が不明な場合は、再実行を保留して実物を確認します。

通知のメール経路そのものが失敗することも考え、実行履歴や最終成功日時を見る担当を決めます。通知が届かないことを、処理が正常だった証拠にはしません。

処理を分けて確認する方法はGASコードの分割、入力の異常を止める例はデータの欠損検知で確認できます。

この記事を書いた人

Watanabeのアバター Watanabe サイト運営者

2020年よりブログ開始。
SEOが思いのほか性にあっていたようで現在に至る。
モットーは「勝率の高い選択をする」
AIは活用するが吉、最後は人間が息を吹き込む。
アートと科学を追求し、日々精進。
―――
収益:6~7桁をウゴウゴ。
サイト:ペラサイト~中規模サイトまで運営中。
案件:1000円以上の案件をメインに取組中。
打ち手:ブラックSEO~ホワイトSEOまで
―――

目次