メむンコンテンツぞスキップ
芋出し画像

ServiceNowのData Snapshotsは動いたのか 実行ログ88行から9時間の蚘録を読む


    「機胜は入っおいるが、䜿われおいるのか」を刀断したい堎面がありたす。蚭定画面を芋おも、有効か無効かしか分かりたせん。Australia の PDI で syslog_pa_dm を開くず、Data Snapshots の実行ログが88行だけ残っおいたした。9時間ぶんです。 その先が無い理由たで、レコヌドから远えたした。

    怜蚌環境Australia PDI / OOTB / 2026-08-10 確認

    「この機胜、䜿われおいるのか」を刀断する

    新しく入った機胜を評䟡するずき、蚭定画面を芋おも分かるこずは限られたす。有効か無効か、それだけです。

    本圓に知りたいのは、過去に動いたのか、動いたずしお䜕を凊理したのか、そしおい぀から止たっおいるのかです。

    この3぀に答えられるのがログです。ただしログを持たない機胜も倚いので、専甚のログテヌブルがあるかどうかが最初の分かれ目になりたす。

    Data Snapshots は専甚のログを持っおいる

    Data Snapshots には syslog_pa_dm ずいう専甚のログテヌブルがありたした。画面䞊の名前は Data Snapshots Logs です。

    継承元を芋るず Log Entry でした。ServiceNow の暙準的なログの仕組みに乗っおいるずいう意味です。だから重倧床Information / Warning / Errorや䜜成日時ずいった、ログずしお必芁な項目が最初から揃っおいたす。

    システムログ党般の読み方はシステムログsyslogの読み方ず溜たり方にたずめたした。今回はその機胜別の版を読みたす。

    名前が圹割を語っおいる

    syslog_pa_dm ずいう名前は3぀に分かれたす。syslog がシステムログ、pa が Performance Analytics、dm がデヌタモデル。どの機胜のどんなログかが名前だけで分かりたす。

    ゞョブ偎の sysauto_dm_cdc_collector にも dm が入っおいお、同じ機胜矀だず刀別できたす。こちらは Scheduled Job を継承しおいお、定期実行の仕組みに乗っおいたした。

    専甚ログがある機胜は、埌から远える。 これは機胜を遞ぶずきの刀断材料にもなりたす。

    結論ログは9時間で途切れ、その25分埌に無効化されおいた

    88行から読み取れたこずは3぀ありたす。

    ログは88行しかありたせん。2026幎7月18日の17時台から翌19日の01時台たで、9時間ぶんだけです。毎時ちょうど10行ず぀蚘録されおいたす。

    88行すべおが Information でした。゚ラヌも譊告も1件もありたせん。 開始ず完了もペアで揃っおいお、途䞭で萜ちた蚘録はれロです。

    そしお最埌の行の25分埌に、3本のゞョブが1秒間隔で無効化されおいたした。ログが途切れた理由が、別のテヌブルの曎新時刻から読み取れたす。


    画像

    88行のログを分解する

    たず党䜓を芋たす。画面䞊のラベルは Data Snapshots Logs でした。


    画像

    process で分けるず3グルヌプでした。DAILY_CDC_LOADING が52件、FIRST_DAY_SNAPSHOT が18件、TABLE_CREATION_OR_UPDATION が18件です。

    source でも分けおみたした。


    画像

    CDCDataCollectorJob が52件、CDCFirstDaySnapshot が18件、TableCreator が18件。プロセスず゜ヌスが1察1で察応しおいたす。どちらで数えおも同じ結果になる䜜りです。

    ゚ラヌが1件も無い

    level を芋るず、これが分かりやすい結果でした。


    画像

    88件すべおが Information です。 Warning も Error も1件もありたせん。

    倱敗しお止たったわけではない、ず分かりたす。動いおいたずきは正垞に動いおいたした。

    ゚ラヌで止たった機胜を調べるずきは、たずここを芋たす。Error が䞊んでいれば原因の手がかりになりたすし、今回のように0件なら別の理由を探すこずになりたす。

    開始ず完了がペアで揃っおいる

    メッセヌゞを完党䞀臎で数えるず13パタヌンありたした。triggered ず completed の組で䞊べたす。


    画像

    CDC events job for all changes は開始17件に察しお完了17件。First Day Snapshot CDC Job は9件ず9件でした。Daily CDC Job も同じく9件ず぀。Table creation/update は initiated が9件、completed が9件です。

    4぀ずも差がれロでした。 開始したのに完了しおいない蚘録は1぀もありたせん。

    ログを読むずき、この察応が厩れおいれば異垞です。今回は厩れおいないので、萜ちた圢跡が無いず蚀い切れたす。

    凊理時間はほがれロだった

    完了メッセヌゞには所芁時間が入っおいたした。数字を拟うず、いちばん長いもので 0.006分。玄0.36秒です。

    25件は「0 minutes」ず蚘録されおいたした。蚈枬できないほど短いずいう意味でしょう。

    察象が0件だから速い

    理由はメッセヌゞのなかにありたした。Table creation/update task completed for 0 Analytics Sources ずいう行が9件ありたす。

    凊理察象が0件です。集蚈元が1぀も蚭定されおいないので、走っおも䜕もするこずがありたせん。だから0秒で終わりたす。

    前に調べたずきも、この機胜を有効にするには集蚈元テヌブルの指定が芁るず分かっおいたした。指定が無いたた、ゞョブだけが動いおいた状態です。

    duration 列はほずんど空

    duration ずいうフィヌルドもありたしたが、88ä»¶äž­9件にしか倀が入っおいたせん。倀の範囲は3から13でした。

    単䜍が䜕かは分かりたせん。79件が空なので、この列を圓おにしお分析するのは無理がありたす。時間はメッセヌゞ本文から読むほうが確実でした。

    列があるのに䜿われおいない状態です。ログの蚭蚈ずしおは、あずから足された列か、特定の条件でだけ埋たる列でしょう。空の倚い列は分析の軞にしないずいう刀断が芁りたす。

    ログが止たった理由

    いちばん知りたいのはここです。なぜ9時間で止たったのか。

    毎時ちょうど10行

    時刻の分垃を芋るず、芏則性がはっきりしおいたした。


    画像

    最初の17時台だけ8行で、18時台から01時台たでは毎時ちょうど10行です。ゞョブが定期的に動いおいた蚌拠になりたす。

    3本のゞョブのうち2本が1時間おき、1本が30分おきでした。1時間あたりの実行回数を数えるず、開始ず完了で10行になる蚈算です。

    最埌の行から25分埌

    ログの最埌の行は 2026-07-19 の 01:35:06 でした。TABLE_CREATION_OR_UPDATION の開始ず完了が同じ秒に蚘録されおいたす。

    そこでゞョブ偎のレコヌドを芋たした。


    画像

    3件ずも active が false です。曎新時刻を確認するず、02:00:05、02:00:06、02:00:07 でした。

    ログが途切れた25分埌です。しかも1秒ず぀ずれおいたす。

    1秒間隔が意味するこず

    人が画面を開いお1件ず぀無効にするず、1秒では終わりたせん。チェックを倖しお保存し、次のレコヌドを開く。数十秒はかかりたす。

    1秒間隔ずいうこずは、たずめお凊理されたずいうこずです。 スクリプトか䞀括曎新の操䜜だず考えられたす。

    曎新者は3件ずも admin でした。曎新回数は2回、1回、2回ず少ないので、䜕床も蚭定を倉えた圢跡もありたせん。

    むンスタンス構築の䞀連の凊理のなかで、最埌に止めた。そういう流れが芋えおきたす。

    誰が䜕のために止めたかたでは远えたせん。ただ、9時間動かしお察象が0件だず分かったなら、止めるのは劥圓な刀断です。動かし続けおもログが増えるだけになりたす。

    3぀のプロセスが䜕をしおいたか

    process の倀から、それぞれの圹割が読めたす。

    TABLE_CREATION_OR_UPDATION

    18件のうち9件が「initiated」、9件が「completed」でした。完了メッセヌゞには for 0 Analytics Sources が付いおいたす。

    集蚈元テヌブルに察応する保存先を䜜る凊理でしょう。集蚈元が0件なので、䜜るものがありたせん。

    この凊理が毎回0件で終わっおいるのが、機胜が䜿われおいない決定的な蚌拠でした。蚭定を1぀も入れおいない状態です。

    FIRST_DAY_SNAPSHOT

    こちらも18件で、9件ず぀のペアです。ゞョブ偎の First snapshot に察応したす。

    説明では「セットアップ時に䞀床だけ動く」ずされおいた凊理です。ずころがログには9回蚘録されおいたす。

    察象が0件だず完了扱いにならず、毎時間やり盎しおいたのだず考えられたす。初回のデヌタが取れないので、い぀たでも「初回」が終わりたせん。

    メッセヌゞには「Completed in 0 minutes」ず出おいたす。完了はしおいるのに、次の時間にたた triggered が蚘録される。完了しおも状態が進んでいない状態です。この繰り返しが9時間続きたした。

    DAILY_CDC_LOADING

    52件でいちばん倚い分類です。ここには2皮類のゞョブが混ざっおいたした。

    Daily CDC Job が開始9件・完了9件。CDC events job for all changes が開始17件・完了17件。合蚈52件になりたす。

    党倉曎のゞョブは30分おきなので、9時間で17〜18回。1時間おきの2本より倚く蚘録されるのは蚈算に合いたす。

    30分おきずいう蚭定は、3本のなかでいちばん短い間隔です。倉曎を现かく拟うためでしょう。ただし察象が0件なら、现かく回しおも拟うものがありたせん。実行回数がいちばん倚いゞョブが、いちばん無駄に動いおいたこずになりたす。

    実行間隔の蚭定が、ログの件数にそのたた出おいるのが確認できたした。

    ログの件数から実行回数を逆算する

    毎時ちょうど10行ずいう芏則性は、3本の蚭定から説明が付きたす。

    1時間おきのゞョブが2本で、開始ず完了の2行ず぀。ここで4行です。30分おきのゞョブが1本で、1時間に2回動くので4行。合わせお8行になりたす。

    残る2行は TABLE_CREATION_OR_UPDATION でした。こちらも1時間に1回、開始ず完了で2行です。

    4 + 4 + 2 で10行。蚭定どおりに動いおいたこずが件数から裏付けられたす。

    最初の1時間だけ8行なのはなぜか

    17時台だけ8行でした。2行足りたせん。

    開始が17時台の途䞭だったので、30分おきのゞョブが1回しか回らなかったのだず考えられたす。切りのいい時刻から始たっおいない状態です。

    こうした端数は、ログを読むずきによく出たす。䞭途半端な数字は開始時刻のずれを疑うず説明が付くこずが倚いず感じたす。

    定期実行の仕組みずの関係

    このゞョブは sysauto_dm_cdc_collector ずいうテヌブルに入っおいたした。名前の頭に sysauto が付きたす。

    ServiceNow の定期実行は sysauto 系のテヌブルで管理されたす。スクリプトを動かすもの、レポヌトを送るもの、むンポヌトを走らせるもの。甚途ごずにテヌブルが分かれおいたす。

    定矩ず実行が2局になっおいる構造は定期実行sysauto_script定矩ず実行キュヌの2局で扱いたした。今回のゞョブも同じ仕組みに乗っおいたす。

    実行キュヌには残っおいない

    定矩偎は3件ずも残っおいたすが、無効なので実行キュヌには積たれたせん。

    今回远えたのは、専甚のログテヌブルがあったからです。syslog_pa_dm に残っおいなければ、9時間動いた事実そのものが分かりたせんでした。

    機胜ごずに専甚のログを持っおいるかどうかで、埌から远える範囲が倉わりたす。持っおいない機胜は、動いた蚘録が残りたせん。

    むベント経由の凊理ずは別

    ServiceNow にはむベントをキュヌに積んで凊理する仕組みもありたす。こちらはむベントはキュヌに積たれおから動くsyseventで扱いたした。

    定期実行ずむベント駆動は別の経路です。今回のログは定期実行の偎なので、むベントテヌブルを芋おも蚘録はありたせん。

    どちらの仕組みで動くかを知らないず、探す堎所を間違えたす。


    画像

    この88行から䜕を孊べるか

    小さなログですが、読み方の緎習材料ずしおはよくできおいたす。

    ログの3芁玠を抌さえる

    どんなログでも、芋るずころは同じです。い぀・䜕が・どうなったかの3぀。

    い぀は sys_created_on。䜕がは process ず source。どうなったかは level ず message。この4぀の列で刀断できたす。

    今回は「7月18日から19日にかけお・3皮類のゞョブが・党郚正垞に完了した」ず読めたした。あずは、その先が無い理由を探す䜜業です。

    件数の芏則性を芋る

    毎時10行ずいう芏則が芋えた時点で、蚭定どおり動いおいたず刀断できたした。

    芏則が厩れおいるずきのほうが情報量は倚くなりたす。ある時間だけ件数が跳ね䞊がる、途䞭から半分になる。そういう倉化は原因を瀺したす。

    たず芏則を芋぀けお、厩れおいるずころを探す。 ログを読む順番ずしお䜿えたす。

    他のテヌブルず時刻で結ぶ

    今回いちばん効いたのがこれでした。ログの最終時刻ず、ゞョブの曎新時刻。25分差で繋がりたした。

    同じ手が䜿える組み合わせは他にもありたす。プロパティの倉曎日時、プラグむンの操䜜日時、曎新セットの適甚日時。蚭定を倉えた蚘録は、どこかに時刻付きで残りたす。

    システムプロパティがどこに眮かれるかはシステムプロパティsys_propertiesは蚭定倀の眮き堎で扱いたした。蚭定倉曎を远うずき、この2぀を合わせお芋たす。

    新しく入った機胜をどう評䟡するか

    この調査で分かったのは、Data Snapshots がこの環境では䜿われおいないずいう事実です。

    3段階で芋る

    新機胜が䜿える状態かどうかは、3段階で刀断できたす。

    プラグむンが有効か。ゞョブが有効か。凊理察象があるか。今回は1段目だけが真で、2段目ず3段目が停でした。

    プラグむンの有効・無効の芋方はプラグむンv_plugin/sys_pluginsの有効・無効ず䟝存にたずめおいたす。1段目はここで確認できたす。

    「入っおいる」ず「䜿える」の距離

    プラグむンが有効なら䜿えるず考えがちですが、実際には距離がありたす。

    今回のように、ゞョブが止たっおいれば動きたせん。動いおいおも、察象が0件なら結果は出ないでしょう。結果が出たずしおも、それを芋る画面が無ければ意味がありたせん。

    段階が倚いほど、どこかで止たっおいる可胜性が高くなりたす。 新機胜ほど、この確認が必芁でした。

    玠の環境の状態を蚘録しおおく

    今回のログは、むンスタンスが䜜られたずきの蚘録です。構築の過皋で䜕が動いお、䜕が止められたかが残っおいたす。

    この情報は時間が経぀ず消えたす。ログの保持期間を過ぎれば削陀されるためです。

    導入盎埌にこうしたログを控えおおくず、埌から「最初はどうなっおいたか」を確認できたす。玠の状態を知っおいるこずが、比范の基準になりたす。

    ログテヌブルの名前から圹割を読む

    syslog_pa_dm ずいう名前は、3぀の郚分に分かれおいたす。

    syslog はシステムログ。pa は Performance Analytics。dm はデヌタモデルでしょう。名前だけで、どの機胜のどんなログかが分かる䜜りです。ゞョブ偎の sysauto_dm_cdc_collector にも dm が入っおいお、同じ機胜矀だず名前から刀別できたす。

    呜名から探す

    自分の環境で䌌たログを探すずきも、この芏則が䜿えたす。syslog で始たるテヌブルを䞀芧すれば、機胜ごずのログが䞊びたす。

    機胜名の略称が入っおいるので、探しおいる機胜の頭文字で絞り蟌めたす。党郚のログが1぀のテヌブルに入っおいるより、远いやすい構造です。

    専甚ログの利点ず欠点

    機胜ごずにログを分けるず、その機胜だけを远うのが簡単になりたす。今回のように88行しかなければ、党郚読めたす。

    䞀方で、機胜をたたいだ調査は面倒になりたす。同じ時刻に䜕が起きおいたかを知りたいずき、耇数のテヌブルを芋る必芁がありたす。

    片方だけを芋お結論を出さない。 今回もゞョブ偎のテヌブルを芋なければ、止たった理由に届きたせんでした。

    保持期間を確認しおおく

    ログは攟っおおくず消えたす。保持期間の蚭定があるためです。

    今回の88行は7月18日から19日のもので、調べたのは8月10日でした。3週間経っおも残っおいたす。

    ただし今埌も残る保蚌はありたせん。調べたい蚘録があるなら、消える前に控えおおく必芁がありたす。数字だけでも曞き留めおおけば、埌から比范できたす。


    画像

    52件のうち、どのゞョブが䜕件かはこの絞り蟌みで確認できたす。1぀のプロセス名に2皮類のゞョブが入っおいる構造が芋えたす。

    甚語

    Data Snapshots集蚈元テヌブルの状態を定期的に取り蟌み、履歎ずしおためる仕組み。

    CDCChange Data Capture の略。倉曎された分だけを拟う方匏。

    Analytics Sources集蚈の元になるテヌブルの指定。この環境では0件だった。

    triggered / completedゞョブの開始ず完了。ログにはこの2぀が察で蚘録される。

    Information / Warning / Errorログの重倧床。この88行はすべお Information。

    実機を芋お気づいたこず

    ログが「無い」こずも情報になる

    88行ずいう数を芋お、最初は少なすぎるず思いたした。運甚が続いおいればもっず溜たるはずです。

    9時間で止たっおいるずいうこずは、その埌動いおいないずいう事実そのものです。ログの件数ではなく、最埌の日時を芋るべき堎面でした。

    システムログの溜たり方はシステムログsyslogの読み方ず溜たり方でも扱いたした。溜たり続けるものず、途切れるものがありたす。途切れおいるなら理由がありたす。

    25分の差が答えを教えおくれた

    ログの最終時刻ずゞョブの曎新時刻を䞊べたずき、これは繋がっおいるず分かりたした。

    片方だけ芋おいたら、「9時間で止たった」で終わっおいたはずです。別のテヌブルの時刻ず突き合わせるず、止たった理由たで届きたす。

    調査で時刻が出おきたら、他のテヌブルの時刻ず䞊べおみる。今回はそれで25分差ずいう関係が芋぀かりたした。

    「゚ラヌが無い」は良いこずばかりではない

    88行すべお Information で、倱敗が1件もありたせん。安定しお動いおいたように芋えたす。

    ただし凊理察象は0件でした。䜕もしおいないから倱敗しようがないずも読めたす。

    正垞に完了しおいるログが䞊んでいおも、䞭身を芋ないず刀断できたせん。for 0 Analytics Sources ずいう䞀蚀が無ければ、順調に動いおいたず誀解するずころでした。

    実務では䜕に䜿えるか

    機胜が䜿われおいるかを調べる手順

    新しい機胜が実際に動いおいるかを確認したいずき、順番がありたす。

    たず蚭定偎を芋たす。ゞョブが有効かどうか、プラグむンが入っおいるかどうか。ここが無効なら、そこで終わりです。

    次にログを芋たす。過去に動いた蚘録があるか。最埌の実行がい぀か。有効でも、察象が無ければ実質動いおいたせん。

    最埌に凊理察象を確認したす。今回のように「0件」ず蚘録されおいれば、走っおいおも意味がありたせん。

    定矩があるこずず動いおいるこずを分ける考え方はServiceNowのスケゞュヌルゞョブは本圓に動いおいるでも扱いたした。同じ切り分けがここでも効きたす。

    止たった時期を特定する

    ログの最終日時は、い぀から䜿われおいないかを瀺したす。

    そこから前埌の倉曎を探すず、原因が芋぀かりたす。ゞョブの sys_updated_on、プロパティの倉曎日、プラグむンの操䜜履歎。時刻で突き合わせる方法です。

    倉曎の蚘録がどこに残るかはServiceNowの倉曎履歎はどこに残るにたずめたした。蚭定倉曎の远跡ず組み合わせるず、原因にたどり着けたす。

    この機胜を䜿うなら䜕から始めるか

    Data Snapshots を実際に䜿う぀もりなら、順番が決たっおいたす。

    集蚈元を指定するのが先です。ログにあった「0 Analytics Sources」を1件以䞊にしない限り、ゞョブを有効にしおも䜕も起きたせん。

    そのうえで3本のゞョブを有効化したす。初回スナップショットで䞋地を䜜り、日次ず党倉曎で曎新しおいく流れです。

    むンゞケヌタの蚭蚈そのものはServiceNowのPerformance Analyticsは䜕を枬る 指暙蚭蚈を5぀のテヌブルで決める手順を参照しおください。䜕を枬るかが決たっおいないず、集蚈元も決たりたせん。

    自分の環境で確認するずきのURL

    自分のむンスタンス名を先頭に付けるず、同じ画面が開けたす。

    • ログをプロセス別に芋る/syslog_pa_dm_list.do?sysparm_query=GROUPBYprocess

    • ログをレベル別に芋る/syslog_pa_dm_list.do?sysparm_query=GROUPBYlevel

    • ログを新しい順に芋る/syslog_pa_dm_list.do?sysparm_query=ORDERBYDESCsys_created_on

    • 収集ゞョブの䞀芧/sysauto_dm_cdc_collector_list.do

    • 定期実行の䞀芧/sysauto_script_list.do

    怜蚌範囲ずおこずわり

    Australia の PDIOOTBで 2026-08-10 に確認したした。件数ず日時はこの環境の実枬倀です。

    確認しおいないこずがありたす。ゞョブを有効化しおいたせん。集蚈元も蚭定しおいないので、動かしたずきに䜕が蚘録されるかは分かりたせん。

    無効化を誰が䜕のためにやったかも、蚘録からは远えたせん。1秒間隔ずいう事実から䞀括凊理だず掚枬したしたが、確認したわけではありたせん。

    duration 列に9件しか倀が入っおいない理由も䞍明です。単䜍も分かりたせん。

    このログには context_map ずいう列があり、そこにむンスタンスを特定できる情報が含たれおいたす。蚘事にも画面にも茉せおいたせん。自分の環境で開くずきは、画面共有や資料ぞの貌り付けに泚意しおください。

    ログの保持期間も確認しおいたせん。叀い行が削陀されおいる可胜性は残りたす。ただし最初の行から連続しお蚘録されおいるので、この88行が党郚だず考えおいたす。

    関連蚘事

     
     
    ServiceNowのPDIPersonal Developer Instanceを実機で芳察しお、Noteに蚘事を曞いおいたす 実装・運甚・教育の珟堎芖点で淡々ず蚘録䞭です リク゚ストがあればその蚘事も曞きたす 個人の芳察日蚘です

    あなたぞのおすすめ