シートとcronジョブ用のドメインレーティングツール設定

この設定が失敗する場所

沈黙が一般的な失敗です。エラーが発生したcronジョブは、正常に動作したジョブと同じように見えます。

HTTPステータスコードを確認してください。401はキーが不足しているか間違っていることを意味し、402はクレジットが枯渇したことを意味します。どちらの場合もアラートを出し、次月のレポート提出前に修正してください。

また、ページネーションは最大50,000行まで、bulk_drは1回の呼び出しで最大2,000ドメインまでであることを覚えておいてください。より長いリストにはチャンク分けが必要で、これは1つの追加ループとなり、チャンクごとに1クレジットかかります。

まず手動でテストしてください。ターミナルでcron行を実行し、ログファイルを読み、残高が予想されたコストだけ正確に減少したことを確認します。その後、数字がスイートプランと比較する方法を確認し、実行頻度を決定してください。

ドメインリストのバージョン管理。ファイルは履歴付きのリポジトリまたは共有ドライブに保管し、3月に数字が変更された場合にリスト自体が変更されたかどうかを確認できるようにしてください。意図的に追加したドメイン（新しい競合他社やその月にサインインしたクライアントなど）用にメモ列を追加してください。リストを所有者を持つデータとして扱いましょう。なぜなら、最も安いバグは差分で見つかるものだからです。

長いリストのチャンク分け

長いリストは、整然とした設定が限界に達する場所です。一括呼び出しは最大2,000ドメインまでなので、5,000のリストには3回のリクエストが必要で、最初の呼び出しの前に分割を行う必要があります。

ドメイン列のソート順などの安定したルールで分割します。そうすれば、同じドメインが毎月同じチャンクに属し、比較が維持されます。

2,000行を超えるリスト

各チャンクをシートに独自のブロックとして書き込み、最初の列にチャンク番号を記載します。失敗したチャンクはその後見つけやすくなります。

各チャンクには1クレジットかかるため、5,000行のリストは1回の実行で3クレジット、つまり$0.0003になります。ドメインレーティングツールの有用性は、読み取るリストに依存するため、そのリストを整理してください。

リストが5,000行を超えて成長した場合、シート自体のレイアウトを再検討してください。月ごとのタブを使用すると、行が積み上がっても各実行が読みやすくなります。

失敗したチャンクの再実行

チャンク2でエラーが返された場合、チャンク2のみを再実行してください。リスト全体を再実行すると、すでに返された行に対してクレジットが消費されます。

ステータスコードとともにチャンク番号をログに記録し、再実行がログ内の1行になり、シート内を捜索する必要がないようにします。

チャンクマップの安定維持

ドメインリストの順序が変更されると、チャンクが移動し、月次比較が崩れます。分割する前に毎回リストをソートしてください。

チャンクマップをリストの隣に保存します。

簡単なテスト：任意のチャンクを選び、リストに対してその行を再カウントします。不一致があればマップがずれたことを意味し、レポート内でそれを見つけるよりもシート内で見つける方が安価です。

有用な月次ログ行に含まれる内容

okとだけ記載されたログはあまり役に立ちません。各実行では、疲れた人が10秒で読める1行を記録すべきです：日付、チャンク、ステータス、消費されたクレジット、呼び出し後の残高。

例：チャンク4、ステータス200、1クレジット消費、呼び出し後の残高を示す1行は、1ヶ月後に返信を開かずに多くの質問に答えることができます。

ログに記録する価値のあるフィールド

日付、リスト名、チャンク番号、ステータスコード、請求されたクレジット、呼び出し後の残高をログに記録します。これら6つのフィールドは、1ヶ月後のほとんどの質問をカバーします。

人が手動で変更した場合のみ、自由形式のメモを追加します。

狼を呼ぶことのないアラート

401または402が返された場合は直ちにアラートを出してください。どちらもジョブがその仕事を遂行できないことを意味します。低残高の警告は選択した閾値を使用し、1回だけ発動し、次のアクションを指示してください。

各行ではなく、1回の実行ごとに1つのアラートを送信してください。そうしないと、受信トレイがノイズになります。

ジョブが失敗したことに誰が気づくか

月次ジョブは誰も見守らずに実行されます。それが自動化する理由であり、失敗が数週間 unnoticed で放置される理由でもあります。

ログを読む人とジョブを修正する人の名前を記載してください。2人の名前が1人よりも優れています。休暇はあります。ランブックでは、リストを最初に選択する方法が説明されています。

セットアップと保守にかかる時間

最初の実行には1時間の大部分がかかります。キー、シート、テスト呼び出しすべてに注意を払う必要があるためです。その後、ルーチンは再構築ではなく、月ごとに一瞥するだけで済むはずです。

保守コストが増加する場合、通常はリストが原因です。毎週変更されるリストには、所有者、バージョン、追加のルールが必要です。

失敗を可視化する

出力での行の欠落は、サイレントエラーよりも目立ちます。各実行で、行の数をリストの長さと比較し、不一致がある場合は警告を書き込んでください。

その警告を同じログファイルに保持し、ログを読む人が最初にそれを見るようにします。

インデックス更新に合わせてスケジュールする

インデックスは約1ヶ月ごとに更新されるため、月初の実行は以前のビルドの数字を読み取ることができます。上記のステップが示すように、数日後に実行することで、更新が完了する時間を確保できます。

シリーズを比較可能にするために毎月同じ日を選択し、その日をcron行のコメントに書き込んでください。

自動化を中止すべき時

1クォーターに1回実行するジョブは、cron行の価値があるとは限りません。シートとカレンダーのリマインダーだけで十分であり、半自動化されたルーチンは明確な手動ルーチンよりも劣ります。

同じステップが複数のサイクルでクリーンに実行された後に自動化してください。