ConfigSource 構成

ConfigSources は、リソース構成ファイルにアクセス、収集、アラートを出し、変更を監視する組み込みの Groovy または PowerShell スクリプトです。 LogicMonitor ポータルの設定を使用して、独自のカスタム ConfigSource を構成できます。

構成ファイルは、LMES データ表示期間まで、リソース ページで利用できます。 後で構成ファイルを表示する場合は、API トークンを使用して、LMES データ保存期間内に構成ファイルをダウンロードする必要があります。 サポートが必要な場合は、カスタマー サクセスにお問い合わせください。

ConfigSource を構成するための要件

クラウド リソースの ConfigSource データを収集するには、ローカル コレクターでの監視を有効にする必要があります。 詳細については、次を参照してください。 Local Collector による監視を有効にする.

ConfigSource の構成

1. LogicMonitor ナビゲーション サイドバーで、 モジュール.
2. My Module Toolbox から、 Add.
3. [追加] ウィンドウで、 構成ソース.
   [新しい ConfigSource の追加] ウィンドウが表示され、情報、アクセス グループ、アクティブ検出、適用先、コレクション、および構成チェックのタブが含まれます。
   

4. [情報] タブで、次の情報を入力します。
   1. 名前: ConfigSource の一意の名前を入力します。 プラットフォームまたはアプリケーションを指定し、必要に応じてプラットフォームの特定のコンポーネントを指定します。
   2. (オプション) 説明: ConfigSource の目的を確実に判別できるように、十分な詳細を提供します。
   3. リソース ラベル: 検索を容易にするキーワード (名前、目的、スコープなどに関連するもの) で ConfigSource にタグを付けます。
   4. (オプション) グループ: ConfigSource を追加するグループを指定します。 このフィールドが空のままの場合、ConfigSource はデフォルトの「@ungrouped」グループに追加されます。 既存の ConfigSource グループに一致しないテキストを入力すると、LogicMonitor は新しいグループを作成します。
   5. (オプション) テクニカル ノートのプレビュー: マークダウンを使用してノートまたは技術情報を入力します。
   6. 収集方法: 構成データを収集するメカニズムを定義します。
      • 選択 SCRIPT スクリプトベースの構成データ収集の場合。 SCRIPT、有効または無効にすることができます マルチインスタンス トグル。
      • 選択 バッチスクリプト スクリプトを使用して多数のインスタンスから構成データを収集します。 バッチスクリプト  マルチインスタンス トグルはデフォルトで有効になっています。
   7. 収集スケジュール：1時間を選択 （デフォルト）、4 時間、8 時間、または 1 日間隔でデータを収集します。
   8. (オプション) マルチインスタンス: このオプションをオンに切り替えて、ConfigSource をマルチインスタンスにし、[Active Directory] ​​タブを有効にします (詳細については、 アクティブディスカバリーとは何ですか？):
      マルチインスタンスとは、構成ファイルが複数存在することを意味します。 たとえば、Fortigate ファイアウォール上の複数のネットワーク サーフェスの場合、それぞれに独自の構成ファイルが含まれます。
      1. (オプション) オンに切り替え 検出されたインスタンスを無効にする リソース上の ConfigSource のインスタンスを自動的に検索し、それらの表示名またはエイリアスを決定して、それらを最新の状態に保ちます。
      2. トグルオン インスタンスの自動削除 存在しなくなった ConfigSource インスタンスを自動的に削除します。
      3. インスタンス データの削除 ドロップダウンで、インスタンスをすぐに削除するかどうかを選択します (デフォルト) または 30 日後。
      4. [スクリプト タイプ] フィールドで、 埋め込み Groovy スクリプト （デフォルト）または 埋め込み PowerShell スクリプトをクリックし、テキスト フィールドに表示されたスクリプトを変更または入力します。 詳細については、次を参照してください。 コレクター属性.
      5. 現在地に最も近い テストスクリプト アイコンをクリックし、リソースを選択してから、 テストを実行.
5. [適用先] タブで、次の操作を行います。
   1. ApplyTo スクリプトを入力します。
      AppliesTo フィールドは、LogicMonitor の AppliesTo スクリプトを入力として受け入れ、この ConfigSource に関連付けられているリソースを決定します。 詳細については、次を参照してください。 AppliesToスクリプティングの概要.
   2. 現在地に最も近い テストスクリプト アイコンをクリックし、リソースを選択してから、 テストを実行.
      このテストは、一致するリソースの数を返し、それらを [AppliesTo 結果] パネルに表示します。
6. [コレクション] タブで、次の操作を行います。
   1. スクリプトタイプ ドロップダウンで、次のオプションのいずれかを選択します。
      • 埋め込み Groovy スクリプト (デフォルト)
        SSH または Telnet を介して構成にアクセスする場合は、組み込みの Groovy スクリプトを使用して、expect 構文を利用できるようにします。 詳細については、ConfigSource のカスタム Groovy および Groovy / Expectテキストベースのインタラクション. 組み込みの Groovy スクリプトを実行する前に、構成モニタリングを実装するリソースのプロパティとして SSH 認証資格情報を設定する必要があります。 詳細については、次を参照してください。 認証資格情報の定義.
      • 埋め込み PowerShell スクリプト
      • スクリプトファイルをアップロード: [スクリプトのアップロード] を選択し、ファイルを選択して、スクリプトの名前/パスと引数を入力します。 詳細については、次を参照してください。 外部スクリプト.
   2. 現在地に最も近い テストスクリプト アイコンをクリックし、リソースを選択してから、 テストを実行.
7. [構成チェック] タブで、構成チェックを ConfigSource に追加します。 詳細については、次を参照してください。 ConfigSource への構成チェックの追加.
8. 選択 Save.
9. (オプション） 選択する コミット バージョン 後でロールバックするためにこのバージョンのモジュールを保存してから、次の操作を行います。
   1. (オプション) [バージョンのコミット] ウィンドウで、バージョン ノートを入力します。
   2. (オプション) オンに切り替え このバージョンを公開する このモジュールを LM Exchange のすべての LogicMonitor ユーザーが利用できるようにします。
   3. 選択 コミット バージョン.

ConfigSource バッチスクリプトコレクター出力

スクリプトの出力は、次の JSON 形式になるはずです。

{
  "data": {
    "instance1": {
      "configuration": "Configuration data of instance1"
    },
    "instance2": {
      "configuration": "Configuration data of instance2"
    },
    "instance3": {
      "configuration": "Configuration data of instance3"
    }
  }
}

BatchScript 構成データ収集方法では、複数のインスタンスの構成を一度に収集するため、インスタンス名を渡すには、各構成データ定義で ##WILDVALUE## トークンを使用する必要があります。##WILDVALUE## に ':'、'#'、'\'、スペースなどの無効な文字が含まれている場合、システムは「NoData」を返します。

例

この例では、2つのインスタンスを持つConfigSource XYZ Version と Inventory デバイスに適用されます。ConfigSource スクリプトは次の出力を生成します。

{
  "data": {
    "Version": {
      "configuration": "Version configuration of the device"
    },
    "Inventory": {
      "configuration": "Inventory configuration of the device"
    }
  }
}

キーのJSON値 data.Version.configuration と data.Inventory.configuration 設定データを返します Version と Inventory それぞれインスタンス。