よくある質問
TaskBeacon についての簡単な回答です。設定手順は Docs を、定期実行ジョブでよくある問題はユースケースをご覧ください。
製品について
TaskBeacon とは何ですか?
スケジュールされたジョブを監視するサービスです。スクリプトは開始時と終了時に短い Web リクエスト(ping)を送ります。TaskBeacon は各実行がいつ予定されているかを把握しており、ジョブが失敗したとき、実行されなかったとき、遅れたとき、おかしなデータ(いつもよりずっと少ない行数など)を送ってきたときにアラートを送ります。ウェブサイトのチェックや、Power BI、SharePoint、dbt Cloud、Fivetran、Azure Data Factory の実行結果の読み取りもできます。
誰のためのものですか?
自分の PC やサーバーで、Windows Task Scheduler、cron、SQL Server Agent によってレポートやインポートを動かしているアナリストや小規模なデータチームです。使う言語は Python、R、Stata、SAS、SPSS、PowerShell などです。解決できる問題はユースケースをご覧ください。
Task Scheduler や cron だけでは足りないのはなぜですか?
スケジューラーが知っているのは自分が起動したものの終了コードだけで、それもジョブが実行された場合に限られます。Stata はバッチモードではエラーの後でも 0 で終了し、0 行を読み込んだジョブも 0 で終了し、始まらなかった実行はコードをまったく残しません。詳しくはTask Scheduler は 0x0 と表示するのにスクリプトは失敗しているをご覧ください。
何をインストールする必要がありますか?
何も必要ありません。スクリプトは curl、PowerShell、またはその言語の標準ライブラリで HTTP リクエストを送ります。
Failed、Missed、Late、Odd data はどういう意味ですか?
Failed(失敗):スクリプトがエラーを報告した状態です。Missed(未実行):予定の実行時刻に猶予時間を足した時刻を過ぎても ping が来なかった状態です。Late(遅延):実行は始まったものの、いつもよりかなり長くかかっている状態です。Odd data(異常データ):実行は終わったものの、数値がルールに反した状態です(例:行数が減った)。詳しくはステータスをご覧ください。
ジョブが何十個もあります。1 つずつ追加するのですか?
いいえ。Import jobs(ジョブのインポート、+ New job の横のメニュー)にリストか CSV を貼り付けるか、API でジョブを作成できます。
ウェブサイトや API もチェックできますか?
はい。当社のサーバーが 1~60 分ごとにそのアドレスにリクエストを送り、ダウンしたとき、遅いとき、SSL 証明書やドメインの期限が近いときにアラートを送ります。詳しくはウェブサイトと API のチェック、ウェブサイトのダウンアラート、SSL 証明書の期限切れアラートをご覧ください。
変更内容はどこで確認できますか?
更新情報(What's new、英語)に、すべてのリリースが日付とバージョン付きで新しい順に載っています(Atom フィードもあります)。バージョンはどのページのフッターにも表示されています。
料金
料金はいくらですか?
無料で始められます。すべてのアカウントは Free(20 ジョブ)で、有料プランが始まるまでは Pro と Team の機能もすべて誰でも使えます。今後の予定:Free は 20 ジョブ、メールと Slack のアラート、行数ルール、30 日間の履歴のまま。Pro は月 9 €(100 ジョブ、1 分ごとの ウェブサイトチェック、SSL とドメインのアラート、連携、すべてのアラートチャンネルとルール、月次レポート、ステータスリンク 1 つ、12 か月の履歴)。Team は月 29 €(500 ジョブ、何人でも同僚を招待できてロールを設定できる共有プロジェクト、プロジェクトごとのアラート、変更履歴、API、ブランド表示なしのステータスページ、24 か月の履歴)。無料プランは残り、料金が発生する少なくとも 60 日前にお知らせします。詳しくは料金をご覧ください。
始めるのにクレジットカードは必要ですか?
いいえ。メールアドレスか Google アカウントで登録できます。明示的な同意なしに請求することはありません。
返金してもらえますか?
はい。Pro または Team の初回のお支払いから 14 日以内にご依頼いただければ、理由を問わず全額を返金します。返金ポリシー(英語)をご覧ください。
ジョブ数の上限に達するとどうなりますか?
何も止まりません。ジョブはそのまま動き続け、アラートも届きます。ただし、ジョブを 1 つ削除するまで新しいジョブを追加できません。今のところ、もっと必要な場合は support@taskbeacon.io までご連絡ください。
データを持ち出したり、アカウントを削除したりできますか?
はい、どのプランでも可能です。当社が保存しているあなたのデータをすべてファイルでダウンロードすることも、アカウントを中身ごと削除することも、どちらも Settings(設定)からできます。プライバシー(英語)をご覧ください。
セキュリティとプライバシー
データはサーバーの外に出ますか?
いいえ。送られるのは ping だけです:その種類(開始、完了、失敗)、時刻、送ると決めた数値(行数など)、そして失敗時にはスクリプトが送る出力の最後の 20 行(またはエラーメッセージ)です。どの Web サーバーとも同じく、送信元の IP アドレスとユーザーエージェントも見えます。Free ではジョブごとに直近 100 件の ping を保存します(現在は 1,000 件)。プライバシー(英語)をご覧ください。
IT 部門が外向きの HTTPS をブロックしている場合は?
マシンから HTTPS で 1 つのアドレスに接続できれば十分です。その 1 つのドメインを許可するよう IT 部門に依頼してください。外から中へ接続する必要はありません。
ping アドレスは秘密ですか?
秘密の情報として扱ってください。持っている人は、その 1 つのジョブに ping を送れます。何かを読んだり、アカウントにアクセスしたりはできません。公開リポジトリには置かず、GitHub Actions ではシークレットに入れてください。
エラーメッセージやログの行はどうなりますか?
失敗したときは、Code タブのコードがエラーと出力の最後の 20 行を送るので、アラートで何がうまくいかなかったかがわかります。保存するのは ping 1 件につき最大 10 KB です。出力にパスワードや個人データが含まれる可能性がある場合は、Code タブで Send output lines(出力行を送信)のチェックを外してください。そうすると、エラーメッセージ、リターンコード、終了コードだけが送られます。
ping の仕組み
ping とは正確には何ですか?
ジョブ専用のアドレスへのリクエストです。たとえば https://taskbeacon.io/ping/<id>。アドレスの末尾に /start を付けると開始、/fail で失敗、終了コード(/0、/1 …)で結果を報告します。数値はクエリ(?rows=1520)か JSON で送ります。詳しくは報告できる内容をご覧ください。
TaskBeacon は実行が行われなかったことをどうやって知るのですか?
ジョブのスケジュール(Task Scheduler と同じく毎日、毎週、毎月、または N 時間ごと)と猶予時間から判断します。予定の実行時刻に猶予時間を足した時刻を過ぎても ping が来なければ、ジョブは Missed(未実行)になります。詳しくはスケジュールをご覧ください。
ping そのものが届かない場合は?
コードはエラーを捕まえて最大 10 秒しか待たないので、ジョブは ping がなかったかのように処理を続けます。完了の ping が届かなければ、ジョブは Missed(未実行)または Late(遅延)と表示されます。それが正しい警告です。
TaskBeacon 自体がダウンしたら?
当社のサーバーに接続できない間に送られた ping は失われますが、そのためにジョブが Missed(未実行)とされることはありません。各ジョブはそのまま次の実行に進みます。3 時間を超える障害の後には、すべてのアカウントにそのことをお知らせするメールを 1 通送ります。
ジョブが失敗したのに、cron の行が 0 で終了するのはなぜですか?
その行の最後のコマンドは失敗を報告する curl で、それ自体は成功するからです。それでも TaskBeacon には失敗が記録されます。
マシンの項目とは何ですか?
ジョブが動くコンピューターで、ジョブごとにご自分で設定します(前回使ったものが入力済みです)。コードはホスト名を送りません。1 台のマシンのジョブがすべて同時に実行されなかったときは、ジョブごとではなく、そのマシンについて 1 回だけアラートが届きます。
言語とツール
ジョブが壊れたままの間は、必要なら数時間ごとにリマインダー。
Python、R、Stata、SAS、SPSS、SQL Server Agent、Excel VBA、Windows Task Scheduler と PowerShell、Batch(.bat)、Node.js、Linux cron です。Web アドレスを呼び出せるものなら何でも使えます。SAS、SPSS、SQL Server Agent、Excel VBA は、まだ実際の環境でテストしていません。うまくいったかどうか教えてください。
Python と R:コードは何を使いますか?
標準ライブラリだけです:Python では urllib、base R では readLines。エラー時にはメッセージ(Python ではトレースバックの末尾も)を送り、これまでどおりスクリプトを停止します。詳しくはPython と R をご覧ください。
Stata:なぜ do ファイルを capture noisily で包むのですか?
Stata はバッチモードでは do ファイルがエラーで止まっても 0 で終了するため、do ファイル自身がエラーを捕まえ、r() コード付きで報告する必要があります。詳しくはバッチモードでの Stata do ファイルのエラーをご覧ください。
SAS と SPSS は?
SAS は PROC HTTP を使い、SYSCC が 4 より大きいときに失敗を報告します。SPSS Statistics は Python 3 連携を使い、spss.Submit からのエラーを報告します。詳しくはSAS と SPSS をご覧ください。
PowerShell、Batch、Task Scheduler は?
小さな PowerShell または .bat ラッパーが任意のプログラムを実行して終了コードを報告し、失敗したときは出力の最後の 20 行も送ります。詳しくはPowerShell(Task Scheduler)をご覧ください。
SQL Server Agent と Excel VBA は?
T-SQL は Web アドレスを呼び出せないため、追加の CmdExec ジョブステップ 2 つが ping を送ります。Excel マクロは MSXML2.ServerXMLHTTP を使い、実行後に Excel を閉じます。詳しくはSQL Server Agent と Excel VBA をご覧ください。
Linux cron と Node.js は?
cron なら、コマンドを包む crontab の 1 行です。Node.js 18 以降なら標準の fetch を使い、パッケージは不要です。詳しくはLinux cron と Node.js をご覧ください。
アラート
どうやって知らせてくれますか?
メールで届きます。希望すれば Slack、Microsoft Teams、Discord、Google Chat、ntfy、Webhook でも受け取れます。すぐに(ジョブが壊れたままの間はリマインダー付きで)、または 1 日 1 回です。詳しくはアラートをご覧ください。
同僚もアラートを受け取れますか?
はい。1 つのジョブに最大 10 件の追加メールアドレスを登録できます。各アドレスは、アラートを受け取る前に一度確認が必要です。または、プロジェクトを同僚と共有することもできます。詳しくはジョブを整理するをご覧ください。
アラートが大量に届きませんか?
いいえ。壊れた状態と OK を行き来し続けるジョブは「keeps changing status」(ステータスが変わり続けている)のアラートを 1 回送ってから 1 時間休止します。マシン全体が沈黙した場合のアラートも 1 回だけです。1 日 1 通のメールにまとめることもできます。
アラートを受け取らずにジョブを見守ることはできますか?
はい。ジョブの Edit(編集)ページで「Send alerts for this job」(このジョブのアラートを送信)のチェックを外してください。監視は続き、ステータスも変わり、History とレポートにも表示されますが、メール、チャットのメッセージ、Webhook は送られません。詳しくはアラートをご覧ください。
祝日はどうなりますか?
アラートなしの日を追加します。その日は何も予定されず、何も Missed(未実行)とみなされず、アラートも送られません。
上司はアカウントなしでジョブを見られますか?
はい、プロジェクトの閲覧専用ステータスリンクで共有できます(Pro と Team、現在は誰でも利用可能)。表示されるのはジョブ名、ステータス、前回の実行、90 日間の履歴だけです。詳しくはステータスリンクをご覧ください。
データのチェック
行数チェックはどのように動きますか?
完了の ping と一緒に行数を送ってください。初めて届いたとき、ジョブに 2 つのルールが付きます:行数が直近の正常な実行の平均より 40% を超えて減ったとき(正常な実行が 3 回たまってから)、または 1 未満のとき、その実行は Odd data(異常データ)になります。どちらのルールもジョブページで変更できます。詳しくは0 行、またはいつもよりずっと少ない行数をご覧ください。
データが古くなっていることを知らせてくれますか?
はい。データの最新の日付を last_date として送ってください。「1 日より古い」などのルールで、その実行は Odd data(異常データ)になります。詳しくはデータの鮮度チェックをご覧ください。
自分の数値や出力テキストをチェックできますか?
はい。任意の数値(合計、エラーの件数など)を送り、ルールを設定できます:X 未満、X より大きい、X% を超えて減少。出力ルールは、出力に ERROR などの語が含まれるとき、その実行を Failed(失敗)にします。詳しくは報告できる内容をご覧ください。
このために TaskBeacon は私のデータを見ますか?
いいえ。見えるのはスクリプトが送る数値だけです。行数を数えたり最新の日付を探したりするのは、お使いのマシン上のスクリプトの中で行われます。
ほかに質問がありますか? support@taskbeacon.io までご連絡ください。