ACC-V:SAM 合計使用状況メトリクスのトラブルシューティングガイドSummary<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } .kb-wrapper{font-family:Lato,sans-serif;font-size:12pt;line-height:1.7;color:#000;max-width:100%} .kb-wrapper p{margin:0 0 12px 0} ITOM ヴィジビリティコンテンツのエージェントクライアントコレクター (ACC) プラグインのソフトウェア資産管理 (SAM) ソフトウェア合計使用状況メトリクスに関する問題をトラブルシューティングします。この記事では、一般的なエラー、データ収集の失敗、ステージングパイプラインの問題について説明し、使用状況データが Windows エンドポイントから ServiceNow インスタンスに正しく流れることを確認する方法について説明します。 Facts<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } .kb-wrapper{font-family:Lato,sans-serif;font-size:12pt;line-height:1.7;color:#000;max-width:100%} .kb-wrapper p{margin:0 0 12px 0} .kb-wrapper ul{margin:0 0 12px 0;padding-left:24px} .kb-wrapper li{margin-bottom:8px} .kb-wrapper strong{font-weight:700;color:#032D42} .kb-wrapper code{background:#e6f0f5;color:#032D42;border:1px solid #b8cfd8;padding:1px 5px;border-radius:3px;font-size:11pt;font-family:'Courier New',monospace} SAM 合計使用状況メトリクスは、Windows エンドポイントデバイスからのみプロセスレベルの使用状況データを収集します。Linux エンドポイントと Windows サーバーはサポートされていません。ポリシー条件をターゲット Windows サーバーに変更しても、信頼できる結果が得られず、サポートされていません。使用状況データをステージングテーブルに保持するには、ITOM ヴィジビリティコンテンツの ACC プラグイン (com.sn_acc_vis_content) と SAM プレミアムプラグイン (com.snc.samp) が両方ともアクティブである必要があります。いずれかのプラグインが非アクティブな場合、ステージングハンドラーはエラーを記録せずにサイレントで返されます。ステージングテーブル: ソフトウェア使用率ステージング [sn_acc_vis_content_sam_software_usage_staging]最終表: ソフトウェア使用 [samp_sw_usage] Release<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } .kb-wrapper{font-family:Lato,sans-serif;font-size:12pt;line-height:1.7;color:#000;max-width:100%} .kb-wrapper p{margin:0 0 12px 0} .kb-wrapper code{background:#e6f0f5;color:#032D42;border:1px solid #b8cfd8;padding:1px 5px;border-radius:3px;font-size:11pt;font-family:'Courier New',monospace} ITOM ヴィジビリティコンテンツのエージェントクライアントコレクター (com.sn_acc_vis_content) Instructions<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } .kb-wrapper{font-family:Lato,sans-serif;font-size:12pt;line-height:1.7;color:#000;max-width:100%} .kb-wrapper p{margin:0 0 12px 0} .kb-wrapper ul,.kb-wrapper ol{margin:0 0 12px 0;padding-left:24px} .kb-wrapper li{margin-bottom:7px} .kb-wrapper strong{font-weight:700;color:#032D42} .kb-wrapper a{color:#032D42} .kb-wrapper h2{ font-size:14pt;font-weight:900;color:#032D42; border-bottom:2px solid #e8fce4;padding-bottom:5px; margin-top:32px;margin-bottom:14px } .kb-wrapper h3{ font-size:12pt;font-weight:900;color:#032D42; border-bottom:1px solid #e8fce4;padding-bottom:3px; margin-top:20px;margin-bottom:8px } .kb-wrapper code{ background:#e6f0f5;color:#032D42;border:1px solid #b8cfd8; padding:1px 5px;border-radius:3px;font-size:11pt; font-family:'Courier New',monospace } .kb-wrapper pre{ background:#e6f0f5;color:#032D42;border:1px solid #b8cfd8; padding:12px 16px;border-radius:4px;font-size:10pt; font-family:'Courier New',monospace;overflow-x:auto; margin:8px 0 16px 0;white-space:pre-wrap;word-break:break-all } .kb-wrapper ol.steps{ list-style:none;padding-left:0; counter-reset:step;margin:10px 0 16px 0 } .kb-wrapper ol.steps > li{ counter-increment:step;padding-left:38px; position:relative;margin-bottom:10px } .kb-wrapper ol.steps > li::before{ content:counter(step);background:#032D42;color:#63DF4E; font-weight:900;font-size:10pt;width:24px;height:24px; border-radius:50%;display:inline-flex;align-items:center; justify-content:center;position:absolute;left:0;top:2px;line-height:1 } .kb-wrapper .callout-warning{ background:#fff4e0;border-left:4px solid #e6a817; padding:10px 14px;margin:12px 0 18px 0;border-radius:0 4px 4px 0 } .kb-wrapper .callout-warning p{margin:0} .kb-wrapper .callout-info{ background:#e6f4ff;border-left:4px solid #52B8FF; padding:10px 14px;margin:12px 0 16px 0;border-radius:0 4px 4px 0 } .kb-wrapper .callout-info p{margin:0 0 10px 0} .kb-wrapper .callout-info p:last-child{margin-bottom:0} .kb-wrapper .callout-info ol.steps{margin:10px 0 10px 0} 目次 Windows での SAM バックグラウンドポリシーエラー MID サーバーとエージェントのステータスを確認するosqueryd がターゲットエンドポイントで実行されていることを確認osqueryd インストールパスを確認するosqueryd 構成ファイルの検証osqueryd 出力を検証 Windows での SAM ディスカバリーポリシーエラー marker.jsonファイルを確認する ステージングテーブルにデータが保持されない SAM プレミアム版プラグインがアクティブであることを確認するエージェントペイロードを確認再利用ルールを検証プロセス名が一致していることを確認するソフトウェアインストールレコードの正規化を検証するユーザーマッピングの確認ペイロードからステージングテーブルへのデータフローの理解 データが最終テーブルに保存されません スケジュール済みジョブがアクティブで実行されていることを確認しますステージングエラーのシステムログを確認する SAM フォルダーが作成されていません サービスアカウントの一貫性の検証osqueryd 構成ファイルを更新拡張ディスカバリーポリシーへのバックグラウンドログチェックの追加ホストデータ収集を実行 Windows での SAM バックグラウンドポリシーエラー SAM バックグラウンドポリシーのトラブルシューティングを行う場合は、次のことを確認してください。 MID サーバーとエージェントのステータスを確認する MID サーバーと ACC エージェントが実行されていることを確認します。いずれかが停止している場合、データ収集は続行できません。 osqueryd がターゲットエンドポイントで実行されていることを確認 osqueryd プロセスが各ターゲットエンドポイントで実行されていることを確認します。 osqueryd インストールパスを確認する デフォルトでは、osqueryd は C:\Program Files\osquery にインストールされます。osqueryd が別の場所にインストールされている場合は、そのログフォルダーへのパスを見つけて、それを SAM バックグラウンドポリシーのチェックインスタンスコマンドにパラメーターとして追加します。 sam_processor.rb --osquery_log="<ログフォルダーへのカスタムパス>" check instance コマンドを更新するには、次の手順を実行します。 [エージェントクライアントコレクター] > [ポリシー] に移動し、SAM バックグラウンドポリシーを開きます。sam_processor.rb のチェックインスタンスを選択します。カスタムログフォルダーを指す --osquery_log パラメーターでコマンドを更新します。 osqueryd 構成ファイルの検証 osquery.conf と osquery.flags が C:\Program Files\osquery に存在し、正しく構成されていることを確認します。置き換える必要がある場合は、添付の構成ファイルから osquery.conf.txt と osquery.flags.txt を抽出し、 .txt 拡張子を削除して名前を変更し、 C:\Program Files\osquery にコピーして既存のファイルを置き換えます。 必須パラメーター値については、「関連リンク」を参照してください。 osqueryd 出力を検証 上記の設定手順を完了したら、osqueryd サービスを開始します。osqueryd.snapshots.log が C:\Program Files\osquery\log で作成され、次の形式のエントリが含まれていることを確認します。 {"snapshot":[{"elapsed_time":"1097178","name":"System","pid":"4","start_time":"1656696357","system_time":"2145468","user_time":"0","username":"SYSTEM"}]} Windows での SAM ディスカバリーポリシーエラー SAM ディスカバリーポリシーのトラブルシューティングを行う際には、次のことを確認してください。 marker.jsonファイルを確認する 次の場所に marker.json が存在することを確認してください。ここで、<userprofile> は ACC 用に構成されたユーザーのプロファイルです。 <userprofile>\AppData\Local\AgentClientCollector\SAM このファイルは 5 分ごとに自動的に更新され、次の形式のデータが含まれている必要があります。 {"data": {}, "lastReadUnixTime": } marker.jsonが存在しない場合は、この記事の後半の「SAM フォルダーが作成されていないを参照してください。 ステージングテーブルにデータが保持されない 注: ステージングテーブルの名前は、2023 年 12 月に sn_acc_visibility_sam_software_usage_staging から sn_acc_vis_content_sam_software_usage_staging に変更されました。 ソフトウェア使用状況ステージング [sn_acc_vis_content_sam_software_usage_staging] テーブルに使用状況データが表示されない場合は、以下を確認してください。 SAM プレミアム版プラグインがアクティブであることを確認する SAM プレミアムプラグイン (com.snc.samp) がアクティブであることを確認します。確認するには、 [システム定義>プラグインに移動し、 SAM Premium を検索して、ステータスが アクティブであることを確認します。プラグインがアクティブでない場合、データはステージングテーブルに書き込まれず、エラーはログに記録されません。これは、チェックが正常に実行されているように見えるときに空のステージングテーブルが発生する最も一般的な原因です。 エージェントペイロードを確認 [SAM ペイロード] セクションで次のエントリーがないか、エージェントペイロードを調べます。 Marker File does not exist will retry in the next run - SAM フォルダーが作成されていませんを参照してください。"unixTime": -1 — Windows の SAM バックグラウンドポリシーエラーを参照してください。 再利用ルールを検証 タイプ 合計使用時間 の再利用ルールが存在し、使用状況データを収集するすべてのソフトウェア製品が含まれていることを確認します。 ソフトウェア資産管理>再利用ルールに移動します。再利用タイプ 合計使用時間 の少なくとも 1 つのルールがアクティブであることを確認します。関連するすべてのソフトウェア製品がルールに追加されていることを確認します。 プロセス名が一致していることを確認する エージェントペイロードのプロセス名は、次のいずれかのテーブルのエントリと一致する必要があります。 ソフトウェア製品プロセス [samp_sw_product_process]ソフトウェアインストール [cmdb_sam_sw_install] プロセス名がこれらのテーブルのどのエントリとも一致しない場合、ステージングハンドラーはエラーを記録せずにそのレコードをスキップします。 ソフトウェアインストールレコードの正規化を検証する ソフトウェアインストール [cmdb_sam_sw_install] テーブルのレコードが正規化されていることを確認します。ステージング中に正規化されていないレコードは照合されません。 ユーザーマッピングの確認 エージェントペイロードのユーザー名は、ユーザー [sys_user] テーブルのレコードと一致する必要があります。一致するユーザーレコードが存在しない場合は、そのアカウントに対して作成します。 ユーザーの解決に使用されたフィールドを確認するには、 システムプロパティ に移動し、 sn_acc_vis_content.column_name_for_user_mapping の値を確認します。 ペイロードからステージングテーブルへのデータフローの理解 ACC エージェントが SAM Advanced Discovery チェック結果を送信すると、インスタンスは EnhancedDiscoveryHandler.persistSAMAdvancedStagingData() を介して結果を処理します。ペイロード内のプロセスエントリごとに、ハンドラーは次の条件を順番に評価します。いずれかの条件が満たされない場合、エントリはサイレントにスキップされ、エラーはログに記録されません。 SAM Premium プラグイン (com.snc.samp) がアクティブである。プロセス名は、ソフトウェア製品プロセス [samp_sw_product_process] のレコードと一致します。一致した SAM 製品には、レポート CI のソフトウェアインストール [cmdb_sam_sw_install] にインストールレコードがある。プロパティ sn_acc_vis_content.disable_sam_reclamation_rules_for_licensable_softwares が true に設定されている場合を除き、再利用ルール [samp_m2m_rule_product] に当該製品の再利用ルールが存在すること。 すべてのスキップはサイレントであるため、空のステージングテーブルは必ずしもエラーを示すわけではなく、前述の 1 つ以上の条件が満たされなかったことを示します。 データが最終テーブルに保存されません データがソフトウェア使用状況ステージングテーブルに存在するが、ソフトウェア使用状況 [samp_sw_usage] テーブルに表示されていない場合は、以下を確認してください。 スケジュール済みジョブがアクティブで実行されていることを確認します SAM - ソフトウェア合計使用状況メトリクスの更新スケジュール済みジョブがアクティブで、最近実行されたことを確認します。 システムスケジューラー>スケジュール済みジョブに移動します。SAM - ソフトウェア合計使用状況メトリクスの更新 を検索します。ジョブがアクティブであることを確認し、[前回の実行] フィールドと [次回実行] フィールドを確認します。 ステージングエラーのシステムログを確認する ステージング処理中にスクリプトエラーを確認するには: [システムログ] > [システムログ] に移動します。次のプリフィックスで始まるエントリを検索します。 EnhancedDiscoveryHandler.persistSAMAdvancedStagingData() の例外 SAM フォルダーが作成されていません AgentClientCollector\SAM フォルダーが <servicenow user profile>\AppData\Local に作成されず、marker.jsonもない場合は、以下を確認してください。 サービスアカウントの一貫性の検証 osqueryd サービスと ACC サービスが同じユーザーアカウントで実行されていることを確認します。異なるアカウントで実行している場合は、両方が同じアカウントを使用するように 1 つのサービスを更新します。 osqueryd 構成ファイルを更新 osqueryd 構成ファイルに必要なパラメーターを追加します。具体的なパラメーターについては、「関連リンク」を参照してください。 拡張ディスカバリーポリシーへのバックグラウンドログチェックの追加 samadvanced-background-log-check を拡張ディスカバリーポリシーに追加します。 ホストデータ収集を実行 上記の手順を完了したら、ホストデータ収集を実行します。その後、ACC サービスアカウントユーザー用に marker.json ファイルを作成する必要があります。 Related Links<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } .kb-wrapper{font-family:Lato,sans-serif;font-size:12pt;line-height:1.7;color:#000;max-width:100%} .kb-wrapper ul{list-style:none;padding-left:0;margin:0} .kb-wrapper li{margin-bottom:10px} .kb-wrapper a{color:#032D42} .kb-wrapper .disclaimer{font-size:10pt;font-style:italic;color:#444;display:block;margin-top:2px;margin-left:0} SAM 合計使用状況メトリクスの osqueryd スケジュールの構成SAM 合計使用状況メトリクスの osqueryd ログの構成ソフトウェア資産管理でのエージェントクライアントコレクターの使用エージェントクライアントコレクターの可視化のための SAM 合計使用状況メトリクスのトラブルシューティングエージェントクライアントコレクターのヴィジビリティコンテンツのトラブルシューティング