ディレクトリスキャンモニタリングのデフォルトチェックとポリシー

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：15分

    • エージェントクライアントコレクターには、ディレクトリスキャンモニタリングのための次のデフォルトのチェックとポリシーが用意されています。

    表 : 1. Windows OS イベント:拡張ポリシー
    タイプ チェック 説明 使用方法と使用例 出力
    イベント check-directory-file-count
    指定されたディレクトリーに存在するファイルの数をチェックし、指定された警告および重大のしきい値と比較します。重大および警告のしきい値に基づいて、重大、警告、または OK イベントを返します。
    注:
    • ディレクトリ内のファイルの数をカウントします。サブディレクトリ内のファイルは含まれません。
    • エージェントには、監視対象のディレクトリに対する読み取り権限と実行権限が必要です。

    check-directory-file-count.rb (オプション)

    -d, --dir:ファイルをカウントするディレクトリへの絶対パス (必須)

    -w, --warning 警告しきい値 (必須)

    -c, --critical 重大しきい値 (必須)

    -H, include_hidden_files active を true に設定して、カウント中に隠しファイルを含める (デフォルトは false)

    使用例:

    check-directory-file-count.rb -d /path/to/directory -w 50 -c 100

    DirectoryFileCount CRITICAL: <path to dir> には 165 個のファイルがあります。
    イベント check-directory-integrity
    ディレクトリーの最終変更時刻と現在の時刻を比較して、定義された時間間隔内に更新が行われたかどうかを判断します。この比較に基づいて、チェックは CRITICAL または OK イベントを返します。
    注:
    エージェントには、監視対象のディレクトリに対する読み取り権限と実行権限が必要です。

    commonchecks check-directory-integrity (オプション)

    -d, --dirpath DIRPATH:確認するディレクトリーへの絶対パス (必須)。

    -i, --interval INTERVAL:最新の更新を確認する時間間隔 (秒) (必須)。デフォルト値は 180 秒に設定できます。

    使用例:

    commonchecks check-directory-update -d /path/to/directory -i 180

    		 共通チェック 重大:ディレクトリの完全性:過去 180 秒以内に <ファイルへのパス> に対する変更が検出されました (最終変更日:2024 年 12 月 4 日水曜日 12:18:55 EST)。
    イベント check-file-age

    前回の変更時刻と現在の時刻を比較することで、指定されたファイルの経過時間を評価します。ファイルが定義された重大または警告の経過時間のしきい値を超えた場合にアラートを発生させます。

    注:
    エージェントには、監視対象のファイルに対する読み取り権限と実行権限が必要です。
    		 commonchecks check-file-age (オプション)

    -f, --filepath FILEPATH:チェックするファイルの絶対パス (必須)。

    -c, --critical CRITICAL:ファイルの重大な経過時間しきい値 (分単位) (必須)。

    -w, --warning WARNING:ファイルの警告経過時間しきい値 (分) (必須)。

    使用例:commonchecks check-file-age -f /path/to/file.txt -c 120 -w 60

    		 一般的なチェック OK: ファイル <ファイルへのパス>経過時間: 30 分。
    イベント check-file-response-time
    指定されたファイルの読み取りに必要な時間を比較し、それを重大しきい値および警告しきい値と比較します。この比較に基づいて、チェックは CRITICAL または OK イベントを返します。
    注:
    エージェントには、監視対象のファイルに対する読み取り権限と実行権限が必要です。
    		 commonchecks check-file-response-time (オプション)

    -f, --filepath FILEPATH:チェックするファイルの絶対パス (必須)。

    -c, --critical CRITICAL:ファイル応答時間の重大しきい値 (秒) (必須)。

    -w, --warning WARNING:ファイル応答時間の警告しきい値 (秒) (必須)。

    -t, --timeout TIMEOUT:ファイルコンテンツの読み取りに許可される最大時間 (秒単位)。タイムアウト値は重大しきい値より大きい値でなければなりません。

    使用例:commonchecks check-file-response-time -f /var/log/servicenow/agent-client-collector/acc.log -c 10 -w 5 -t 20

    		 一般的なチェック OK:ファイル読み取り応答時間:file_name:/var/log/servicenow/agent-client-collector/acc.log に対して 0.0020 秒。
    イベント check-file-size

    ファイルのサイズ (ファイルに含まれる実際のデータ量) を測定し、指定されたしきい値と比較します。ファイルサイズとしきい値の比較に基づいて、CRITICAL、WARNING、または OK イベントを返します。

    注:
    エージェントには、監視対象のファイルに対する読み取り権限と実行権限が必要です。
    		 commonchecks check-file-size (オプション)

    -f, --filepath FILEPATH 必要なファイルへの絶対パス (必須)。

    -c、--critical CRITICAL。重大しきい値 (KB)。単位のない数値で指定します (例:1000 KB の場合は 1000) (必須)

    -w, --warning WARNING。警告しきい値 (KB)。単位のない数値で指定します (たとえば、500 KB の場合は 500) (必須)

    使用例:commonchecks check-file-size -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

    		 一般的なチェック OK:ファイル <ファイルへのパス> サイズの場合:4.72 KB がしきい値内です
    イベント check-file-space

    指定されたしきい値に対してディスク上のファイルのサイズを測定し、しきい値に基づいて CRITICAL、WARNING、または OK イベントを返します。

    注:
    エージェントには、監視対象のファイルに対する読み取り権限と実行権限が必要です。
    		 commonchecks check-file-space (オプション)

    -f, --filepath FILEPATH:関連するファイルへの絶対パス (必須)。

    -c, --critical CRITICAL:重大しきい値 (KB)。単位なしの数値で指定します (例:1000 KB の場合は 1000) (必須)

    -w, --warning WARNING:警告しきい値 (KB)。単位なしの数値で指定されます (たとえば、500 KB の場合は 500) (必須)

    -b, --blocksize BLOCKSIZE:ブロックサイズ (バイト単位) (デフォルト = 4096) (必須)

    使用例:

    commonchecks check-file-space -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml    		 共通チェック OK:ファイル <ファイルへのパス>スペース:8.00 KB がしきい値内です
    イベント os.windows.check-directory-space ディレクトリーのコンテンツが占有しているディスクスペースを検証します。指定された重大および警告イベントの重大度しきい値との比較に基づいて、CRITICAL、WARNING、または OK イベントを返します。
    注:
    エージェントには、監視対象のディレクトリに対する読み取り権限と実行権限が必要です。
    		 winchecks check-dir-space (オプション)

    -d, --dirpath DIRPATH:チェックするディレクトリーへの絶対パス (必須)。

    -c, --critical CRITICAL:重大なディスクスペースのしきい値 (KB) (必須)。

    -w, --warning WARNING:警告ディスクスペースのしきい値 (KB 単位) (必須)。

    -t, --timeout TIMEOUT:ディレクトリーサイズの計算に許可される最大時間 (秒単位で指定) (必須)。

    使用例:winchecks check-dir-space -d /path/to/directory -c 1000 -w 500 -t 120

    		 Windows は OK をチェックします:ディレクトリ <ファイルへのパス>スペース:369.25 KB がしきい値内です
    表 : 2. Linux OS イベント:拡張ポリシー
    タイプ チェック 説明 使用方法と使用例 出力
    イベント check-directory-file-count
    指定されたディレクトリーに存在するファイルの数をチェックし、指定された警告および重大のしきい値と比較します。重大および警告のしきい値に基づいて、重大、警告、または OK イベントを返します。
    注:
    • ディレクトリ内のファイルの数をカウントします。サブディレクトリ内のファイルは含まれません。
    • エージェントには、監視対象のディレクトリに対する読み取り権限と実行権限が必要です。

    check-directory-file-count.rb (オプション)

    -d, --dir:ファイルをカウントするディレクトリへの絶対パス (必須)

    -w, --warning 警告しきい値 (必須)

    -c, --critical 重大しきい値 (必須)

    -H, include_hidden_files active を true に設定して、カウント中に隠しファイルを含める (デフォルトは false)

    使用例:

    check-directory-file-count.rb -d /path/to/directory -w 50 -c 100

    DirectoryFileCount CRITICAL: <path to dir> には 165 個のファイルがあります。
    イベント check-directory-integrity
    ディレクトリーの最終変更時刻と現在の時刻を比較して、定義された時間間隔内に更新が行われたかどうかを判断します。この比較に基づいて、チェックは CRITICAL または OK イベントを返します。
    注:
    エージェントには、監視対象のディレクトリに対する読み取り権限と実行権限が必要です。

    commonchecks check-directory-integrity (オプション)

    -d, --dirpath DIRPATH:確認するディレクトリーへの絶対パス (必須)。

    -i, --interval INTERVAL:最新の更新を確認する時間間隔 (秒) (必須)。デフォルト値は 180 秒に設定できます。

    使用例:

    commonchecks check-directory-update -d /path/to/directory -i 180

    		 共通チェック 重大:ディレクトリの完全性:過去 180 秒以内に <ファイルへのパス> に対する変更が検出されました (最終変更日:2024 年 12 月 4 日水曜日 12:18:55 EST)。
    イベント check-file-age

    前回の変更時刻と現在の時刻を比較することで、指定されたファイルの経過時間を評価します。ファイルが定義された重大または警告の経過時間のしきい値を超えた場合にアラートを発生させます。

    注:
    エージェントには、監視対象のファイルに対する読み取り権限と実行権限が必要です。
    		 commonchecks check-file-age (オプション)

    -f, --filepath FILEPATH:チェックするファイルの絶対パス (必須)。

    -c, --critical CRITICAL:ファイルの重大な経過時間しきい値 (分単位) (必須)。

    -w, --warning WARNING:ファイルの警告経過時間しきい値 (分) (必須)。

    使用例:commonchecks check-file-age -f /path/to/file.txt -c 120 -w 60

    		 一般的なチェック OK: ファイル <ファイルへのパス>経過時間: 30 分。
    イベント check-file-response-time
    指定されたファイルの読み取りに必要な時間を比較し、それを重大しきい値および警告しきい値と比較します。この比較に基づいて、チェックは CRITICAL または OK イベントを返します。
    注:
    エージェントには、監視対象のファイルに対する読み取り権限と実行権限が必要です。
    		 commonchecks check-file-response-time (オプション)

    -f, --filepath FILEPATH:チェックするファイルの絶対パス (必須)。

    -c, --critical CRITICAL:ファイル応答時間の重大しきい値 (秒) (必須)。

    -w, --warning WARNING:ファイル応答時間の警告しきい値 (秒) (必須)。

    -t, --timeout TIMEOUT:ファイルコンテンツの読み取りに許可される最大時間 (秒単位)。タイムアウト値は重大しきい値より大きい値でなければなりません。

    使用例:commonchecks check-file-response-time -f /var/log/servicenow/agent-client-collector/acc.log -c 10 -w 5 -t 20

    		 一般的なチェック OK:ファイル読み取り応答時間:file_name:/var/log/servicenow/agent-client-collector/acc.log に対して 0.0020 秒。
    イベント check-file-size

    ファイルのサイズ (ファイルに含まれる実際のデータ量) を測定し、指定されたしきい値と比較します。ファイルサイズとしきい値の比較に基づいて、CRITICAL、WARNING、または OK イベントを返します。

    注:
    エージェントには、監視対象のファイルに対する読み取り権限と実行権限が必要です。
    		 commonchecks check-file-size (オプション)

    -f, --filepath FILEPATH 必要なファイルへの絶対パス (必須)。

    -c、--critical CRITICAL。重大しきい値 (KB)。単位のない数値で指定します (例:1000 KB の場合は 1000) (必須)

    -w, --warning WARNING。警告しきい値 (KB)。単位のない数値で指定します (たとえば、500 KB の場合は 500) (必須)

    使用例:commonchecks check-file-size -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

    		 一般的なチェック OK:ファイル <ファイルへのパス> サイズの場合:4.72 KB がしきい値内です
    イベント check-file-space

    指定されたしきい値に対してディスク上のファイルのサイズを測定し、しきい値に基づいて CRITICAL、WARNING、または OK イベントを返します。

    注:
    エージェントには、監視対象のファイルに対する読み取り権限と実行権限が必要です。
    		 commonchecks check-file-space (オプション)

    -f, --filepath FILEPATH:関連するファイルへの絶対パス (必須)。

    -c, --critical CRITICAL:重大しきい値 (KB)。単位なしの数値で指定します (例:1000 KB の場合は 1000) (必須)

    -w, --warning WARNING:警告しきい値 (KB)。単位なしの数値で指定されます (たとえば、500 KB の場合は 500) (必須)

    -b, --blocksize BLOCKSIZE:ブロックサイズ (バイト単位) (デフォルト = 4096) (必須)

    使用例:

    commonchecks check-file-space -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml    		 共通チェック OK:ファイル <ファイルへのパス>スペース:8.00 KB がしきい値内です
    イベント os.linux.check-directory-size ディスクのディレクトリに割り当てられたスペースを確認し、指定された重大しきい値および警告しきい値と比較します。
    注:
    エージェントには、監視対象のディレクトリに対する読み取り権限と実行権限が必要です。
    		 linuxchecks check-directory-size (オプション)

    -d, --dirpath DIRPATH:チェックするディレクトリーへの絶対パス (必須)。

    -c, --critical CRITICAL:重大なディスクスペースのしきい値 (KB) (必須)。

    -w, --warning WARNING:警告ディスクスペースのしきい値 (KB 単位) (必須)。

    -t, --timeout TIMEOUT:ディレクトリーサイズの計算に許可される最大時間 (秒単位で指定) (必須)。

    使用例:linuxchecks check-directory-size -d path/to/directory -c 100 -w 50 -t 30

    		 Linux チェック 重大:ディレクトリ <ファイルへのパス>サイズ:500.00 KB が重大しきい値 10.00 KB を超えています
    イベント os.linux.check-directory-space ディレクトリコンテンツが占有しているディスクスペースを確認します。重大および警告のしきい値との比較に基づいて、CRITICAL、WARNING、または OK イベントを返します。
    注:
    エージェントには、監視対象のディレクトリに対する読み取り権限と実行権限が必要です。
    		 linuxchecks check-directory-space (オプション)

    -d, --dirpath DIRPATH:チェックするディレクトリーへの絶対パス (必須)。

    -c, --critical CRITICAL:重大なディスクスペースのしきい値 (KB) (必須)。

    -w, --warning WARNING:警告ディスクスペースのしきい値 (KB 単位) (必須)。

    -t, --timeout TIMEOUT:ディレクトリーサイズの計算に許可される最大時間 (秒単位で指定) (必須)。

    使用例:linuxchecks check-directory-space -d /path/to/directory -c 10 -w 5 -t 30

    		 Linux チェック 重大:ディレクトリ <ファイルへのパス>領域:374.00 KB が重大しきい値 10.00 KB を超えています