GASの失敗通知をChatGPTに調べてもらった――本番に足したのはログ6行だった
音声整理を担うGoogle Apps Scriptから失敗通知が2件届きました。ChatGPTと原文8件とWord文書を照合し、実行履歴とコードから停止範囲を調査。原因を特定できなかったため、次の調査に備えて本番にログ6行を加えました。
Google Apps Script(GAS)から、音声整理の自動処理が失敗したというメールが届きました。2026年11月16日と19日の2件です。
こういうメールが来ると、私が先に知りたいのは「何か仕事が抜けたのか」です。社員への技術指導を録音し、文字に起こして、あとから探せるように整理しています。処理が抜ければ、残したはずの話が見つからなくなります。処理するものがない時間帯に一度失敗しただけなら、必要な対応は変わります。
今回は、仕事への影響を調べるところから、次の調査に必要な変更を本番のコードへ入れるところまで、ChatGPTに頼みました。
失敗通知が来た。で、何が止まったのか
Creerでは、録音を文字に起こしたあと、Googleドライブに入れています。その後を動かすのが、Googleのサービスを組み合わせて自動処理を作れるGASです。定期的に新しい原文を確認し、対象があればGPTで整理してWord文書として保存します。文字起こしの原文も残すので、設計の考え方や社員への指示を、あとから元の話に戻って確認できます。 Google Apps Scriptの概要
今回失敗したのは、定期処理を担う同じ関数でした。通知には次の違いがありました。
- 11月16日 18:55:16〜18:56:47。Googleのサーバーエラー。
- 11月19日 17:35:16〜17:46:02。JavaScriptエンジンの予期しない内部エラー
INTERNAL。
通知の開始・終了時刻の差は、16日が1分31秒、19日が10分46秒です。19日の数字を見ると、処理に時間がかかりすぎたようにも見えます。Googleが公表している通常のスクリプト実行上限は1回6分ですが、通知に出ていたのはエンジンの内部エラーでした。通知上の経過時間だけでタイムアウトと判断すると、変更する箇所を間違えるかもしれません。 Google公式の実行上限
もう一つ違うのは、16日は営業時間外で、19日は営業時間内だったことです。この仕組みは時間外にも新しい原文を確認しますが、自動でGPT整理をするのは営業時間内です。同じ関数の失敗でも、そのときにどこまで進むはずだったかは違います。
先に、原文とWordがそろっているかを見た
最初にChatGPTが確認できたのは、Gmailの通知と、Googleドライブに残っている処理済みの原文・整理済みのWord文書でした。両方の日を含む期間で、処理済みの原文を8件確認しました。日付と件名を照らし合わせると、対応するWord文書がそれぞれ1件ずつありました。
確認した8件の範囲では、対応する文書の欠けも重複も見つかりませんでした。整理済みのフォルダを開いて文書が並んでいるのを見るだけなら、もっと早く済みます。ただ、それでは欠けた文書は目に入りません。元の一覧から一件ずつ突き合わせて、初めて言えることがあります。
この8件はすでに処理済みとして残っていた原文です。失敗時にどのファイルが投入されていたかまでは、この一覧から逆算できません。翌日に別の整理済み文書ができていたことからは、仕組みがその後も動いていたところまで分かります。
このあたりは、普段の設計照査と似ています。図面と数量表で数字が一致していても、そこに載っていない範囲まで拾えているかは、元の条件や図面に戻って見ます。失敗した実行が何をしていたかを知るには、GAS側の履歴を見る必要がありました。
「パソコンを直接触っていい」と言ってから、実際に開くまで
ここで一度、作業が止まりました。ChatGPTはメールやドライブの情報を確認できましたが、GASの管理画面を開こうとすると、Googleの公開ドキュメントに移ってしまいました。私の画面では普段から開けるところです。そこで、私のパソコンを直接操作してよいと伝えました。
ところが、パソコンでChatGPTのデスクトップ版とChromeを起動しても、この会話から操作できたのはクラウド側のChromeでした。私としては、同じアカウントで同じ会話を開いているので、そこから普段のChromeも見えるような感覚がありました。
今回、作業が進んだのは、普段使っているChromeでWeb版のChatGPTを開き、入力欄に出た候補からChromeを選んで依頼を送り直したときです。先に文字で「@chrome」と打って送ったときは、手元のChromeに接続できませんでした。
接続後は、通知メールのリンクから、定期実行の設定であるトリガーが表示されました。そこから対象のプロジェクトに入り、実行履歴とコードを開けました。私が編集画面のURLを探したり、コードを全文コピーして渡したりする手間はありませんでした。
以前、文字起こしの入口を切り替えたときは、Claude CodeにGASの変更内容を用意してもらい、私が管理画面で貼り替えていました。今回は、普段のブラウザーで、調査したAIにその続きとして編集画面まで操作を任せられました。調べた場所と手を入れる場所がつながったことに、前回との違いを感じました。
コードとログを並べると、止まった範囲が見えてきた
2件の失敗ログを開くと、どちらも自動実行であること、最大処理件数、営業時間内かどうかまでは記録されていました。
前後の正常な実行では、そのあとに「整理ルールを読み込んだ」「今回の処理件数は0」と続きます。失敗した2件にはどちらの記録もなく、個別ファイルを処理するときに出る、ファイル名付きの開始ログもありませんでした。
コードでは、営業時間の判定を記録したあとに、古い処理状態の整理、前回失敗した台帳更新の再試行、整理ルールの読み込みが並び、その先で新しい原文を確認します。コードの順序とログを照らすと、個別のファイルを扱う前の段階で止まった可能性が高まりました。どの処理で止まったかを示す行番号やログは残っていませんでした。
19日の17時35分の失敗には、もう一つ気になる点がありました。通知上の終了は17時46分でしたが、次の17時45分の定期実行は、それより前に正常終了していました。その回はロック待ちで見送ったのではなく、整理ルールまで読んで処理件数0件で終了しています。17時55分の回も正常終了し、0件でした。
対象アカウントで確認したこの関数の定期トリガーは1つで、コードには処理の重複を防ぐロックも入っていました。同じ日の別の関数にもGoogleのサーバーエラーが出ていたので、Google側の一時的な問題も候補に残ります。ただ、表示上の時刻の重なりと INTERNAL という文言から、原因を一つに絞ることはできませんでした。
本番コードに加えたのは、開始と終了の6行
次に同じ通知が来ても、今のログではまた同じところまでしか分かりません。そこで、処理を組み替える前に、次に失敗したときに見る場所を増やしました。
- 古い処理状態の整理の前後
- 台帳更新の再試行の前後
- 整理ルールの読み込みの前後
それぞれに「開始」と「終了」を1行ずつ、計6行です。たとえば「台帳更新の再試行 開始」まで出て「終了」がなければ、その処理と、処理中に呼び出すサービスから調べられます。3つとも終了していれば、その先を見ます。次に同じ失敗が起きたとき、調査を始める範囲を狭めるための6行です。
どこを変えるかを確認してから、ChatGPTに本番の編集画面で追加してもらいました。変更はログ出力の6行だけです。保存後は編集画面を読み直し、6行が残っていることを確認しました。執筆時点で確認したのは保存までです。追加後の自動実行で6行が出るかは未確認で、本番の手動実行も行っていません。
一度動いた仕組みを、あとから見られるようにする
音声整理の仕組みを作り始めた頃は、録音が文字になり、整理された文書が自動で届くだけでも、ずいぶん便利になったと思いました。使い続けると、今度は「止まったときに何が残るか」が気になります。原文と成果物を突き合わせられること、実行履歴をさかのぼれること、必要ならコードを開いて手を入れられることが、運用を続けるうえで効いてきます。
今回、ChatGPTには通知の比較、原文と文書の照合、管理画面の操作、コードの変更と保存確認まで任せました。私が決めたのは、まず仕事への影響を見ることと、変更をログ追加にとどめることです。原因が分からないまま処理順や実行間隔を変えると、次に現象が起きても、何が効いたのか説明しにくくなります。
次に失敗通知が来たときは、まず対象の原文と出力を照合し、実行履歴でどの「終了」まで残っているかを見る。次に何を見ればよいかが、今回の調査で具体的になりました。