コマンド出力の解析

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む5読むのに数分

    • 検出パターンの作成または変更の一環として、[コマンド出力を解析] 操作を使用して、コマンド出力から情報を抽出し、操作結果を変数に保存できます。コマンド出力全体を変数として保存することもできます。

    始める前に

    必要なロール：pd_admin

    関連するパターンステップに移動します。

    1. パターンフォームで、ディスカバリー の関連する識別セクションを選択します。

      または、サービスマッピング の関連する識別セクションまたは接続セクションを選択します。

    2. 関連するパターンステップを選択するか、ステップを追加するボタン をクリックしてステップを追加します。

    プログラミングの基礎知識が望ましいです。

    手順

    1. [操作] リストから [コマンド出力を解析] を選択します。
    2. [コマンド詳細の設定 (Set Command Details)] でコマンドを指定します。
      変数を使用できます。「パターンへの値と変数の入力」で説明されているように、表形式変数の特定のフィールドの値を入力することもできます。

      複数のコマンドを連結できます。

      重要:
      場所やファイルへの特定のパスの入力は、オペレーティングシステムによって異なる場合があるため、避けてください。パスには変数を使用する必要があります。
      このコマンドの実行中に Now Platform が適用可能な資格情報を適用するようにするには、次の構文を使用して資格情報のプレースホルダーを使用します。
      • $$username$$ - ユーザー名
      • $$password$$ - パスワード
      たとえば、Microsoft SQL Server の解析コマンドは、次の資格情報プレースホルダーを使用します。"su - " + $userid + " -c '" + $ExecutableDir + "mysql --user=" + "$$username$$" + " --password=" + "$$password$$"
    3. 実行モードまたは資格情報を変更するには、[詳細] をクリックし、必要に応じてフィールドに入力します。
      フィールド 説明
      実行モード このコマンドの実行に関連するオプションを選択します。
      • [デフォルト (リモート)] - リモートデバイスの場合
      • [ローカルスクリプト] - MID サーバー の場合
      • [Windows サービス] - リモート Windows サーバー上で実行されているサービスの場合
      CI タイプ

      このステップに使用する適用可能な資格情報の CI タイプの名前を入力します。システムは、このパターンが検出する CI タイプとは異なる、定義された CI タイプの適用可能な資格情報を使用します。たとえば、 Microsoft SQL Server の検出中に、Microsoft SQL インスタンスの適用可能な資格情報に切り替えることができます。

      選択した CI タイプに対して適用可能な資格情報が複数ある場合、システムは Order パラメーターに従って適用可能な資格情報を使用します。適用可能な資格情報の構成についての詳細は、「適用可能な資格情報」を参照してください。
    4. コマンド出力全体を変数として保存するには、「7」で説明されているように [解析を定義] リストから [なし] を選択し、変数を定義します。
    5. [解析を定義] リストから解析戦略を選択します。
      解析戦略 説明

      Oracle

      LDAP ファイル

      XML ファイル

      INI ファイル

      プロパティファイル

      JSON ファイル (カスタム)

      		 ホリゾンタルファイル解析戦略です (バーティカルではありません)。この解析戦略は、テキストファイルにのみ使用できます。詳細については、「ホリゾンタルファイルのテキストの解析」を参照してください。
      バーティカルファイル 各データセットが複数の行にまたがる構造化テキストファイルからテキストを取得します。詳細については、「バーティカルファイルのテキストの解析」を参照してください。

      キーワードの後

      特定のキーワードの直後にあるテキストを取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。

      コマンドライン Java スタイル

      Java スタイルのパラメーターを使用してコマンドラインパラメーターの値を取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。

      コマンドライン Unix スタイル

      標準の Unix パラメーターを使用してコマンドラインパラメーターの値を取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。

      末尾からの位置

      行の末尾からの位置で指定されたテキストを取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。

      開始からの位置

      行の開始からの位置で指定されたテキストを取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。
      正規表現 正規表現で指定されたテキストを取得します。このオプションは、正規表現の Java 構文に精通している必要があります。詳細については、「正規表現を使用したテキストの解析」を参照してください。
      区切り付きテキスト 区切り文字と行内の位置で指定されたテキストを取得します (汎用テキストファイルからテキストを取得する最も一般的な方法です)。「区切り付きテキストを使用したテキストの解析」を参照してください。
    6. デバッグモードで作業している場合は、次のステップを実行します。
      1. [コマンドを実行] をクリックして、[出力] ペインで結果を確認します。
      2. [出力] ペインで、変数に含めるテキストまたは記号をマークします。
      3. 変数名ボックスに、新しい変数の名前を入力します (例：「process_name」)。

        [出力] ペインでマークされた文字列の変数名の定義
      4. Enter キーを押します。
        新しい変数が [変数] ペインに追加されます。
    7. デバッグモードで作業していない場合は、次の手順を実行して解析基準を定義します。
      1. [変数] ペインで、[変数を追加] をクリックし、新しい変数の名前を入力します。
      2. [詳細] アイコンをクリックします。

        詳細変数ペインを表示します。
      3. [列ラベルを追加] をクリックします。
      4. 解析クエリーを入力します。
      5. 区切り文字の値を入力します。
      6. 位置の値を入力します。
    8. [キャッシュを使用] を選択して運用結果を MID サーバー 上のキャッシュに保存します。
      キャッシュを使用して検出を最適化し、ロードバランサーなどの中央共有コンポーネントに不必要な負荷を発生させないようにします。ベースシステムは、運用結果をキャッシュに 1 時間保持します。
    9. 結果が見つからない場合は、[終了] を選択して検出を停止します。
    10. デバッグモードの場合は、[テスト] をクリックしてステップをテストし、操作が期待した結果をもたらすかどうかをチェックします。

    例

    この例では、$TibcoParser 変数に格納されている Tibco パーサースクリプトがターゲットホストで実行されます。解析メソッドは、区切り文字「=」で区切られたテキストです。解析の結果は、Tibco BusinessWorks および Tibco Business Works プロセスのすべての設定ファイルを格納するディレクトリーへのパスです。このステップでは、解析の結果を保持する一時変数が作成されます。


    [コマンド出力を解析] 操作

    次のタスク