---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# 処理前の生のログデータの編集

# 処理前の生のログデータの編集 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分

ログデータが MID サーバー で処理される前 (つまり ヘルスログアナリティクス でマッピングされビルドされる前に) に、生ログデータを変更してドロップしたり、ログメッセージを分割したりすることができます。たとえば、ユーザー名とパスワードをアスタリスク (\*) に置き換えて、機密データがシステムに到達しないようにすることができます。

## 始める前に

必要なロール：evt_mgmt_admin

## 手順

1. 移動先 すべてHealth Log Analytics (ヘルスログアナリティクス)データ入力データ入力プリプロセッサ.
2. レコードを開きます。  
   注:  
   前処理フォームが初めて表示される際には、ヘルスログアナリティクス がログサンプルを自動的にフェッチします。後続のセッションで、新しいサンプルをフェッチします 手動 \[サンプルをリフレッシュ\] を選択します。
3. **オプション:** 組織の生のログからのログサンプルが表示されないようにするには、\[生のログサンプルを無効化 (Disable raw log samples)\] を選択します。  
   ログが ヘルスログアナリティクス に公開されないようにするには、このオプションを選択します。
4. **オプション:** 既存の JavaScript 関数がログ行にどのように作用するかに注意してください。
   1. サンプルメッセージを \[手動サンプルのテスト (Test manual sample)\] フィールドに追加します。
   2. \[移動 (Go)\] を選択します。
   3. 既存の JavaScript 関数がログ行にどのように作用するかに注意してください。
   {#hla-data-input-preprocess__substeps_mxw_ptm_f4b}
5. \[生の入力サンプル (Raw input samples)\] フィールドでは、テスト用のログサンプルを選択します。これにより、新しい JavaScript 関数がログ行に及ぼす影響が示されます。
6. 生のログデータが ヘルスログアナリティクス でマッピングおよび構造化される前にそのデータを変更する JavaScript 関数を定義します。  
   注:  
   (ACC データ入力のみ) フェイルオーバー保護の提供のために エージェントクライアントコレクター が別の MID サーバー に切り替わる場合は、別の ACC データ入力に切り替える必要があります。そのため、すべての ACC データ入力には同じ JavaScript 関数が必要です。ヘルスログアナリティクス は、既存および将来のすべての ACC データ入力に公開されている最新の JavaScript 関数を提供し、以前のスクリプトを置き換えます。この機能は、ヘルスログアナリティクス アプリケーション (バージョン 22.0.12 - 2021 年 12 月以降、[ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) から入手可能) でサポートされています。エージェントクライアントコレクター ログアナリティクス (ACC-L) のフェイルオーバー保護の詳細については、「[エージェントクライアントコレクター ログアナリティクス](https://servicenow-prod.fluidtopics.net/gvhtpSDQeKJUdS2Ih0P5tg "エージェントクライアントコレクター ログアナリティクス (ACC-L) を使用すると、エージェントクライアントコレクター を使用して、Linux および Windows ホストから ServiceNow インスタンスにログデータをストリーミングできます。")」を参照してください。
   1. JavaScript コンソールで、用意されているデフォルトの JavaScript 関数を変更するか、既存のカスタム JavaScript 関数を変更する、あるいは新しい関数を定義します。  
      注:  
      データ前処理用のデフォルトの JavaScript 関数に加えて、ヘルスログアナリティクス は Scrubbing という名前の JavaScript 関数テンプレートを提供しています。この JavaScript 関数は、メールアドレス、社会保障番号、パスワードなどの個人を特定できる情報を生のログデータから削除します。このテンプレートは、カスタムスクリプトコードの開始点として機能します。 この機能は、ヘルスログアナリティクス アプリケーション (バージョン 20.0.11 - July 2021、[ServiceNow ストア](https://store.servicenow.com/sn_appstore_store.do#!/store/home)から入手可能) でサポートされています。  
      注:  
      (ACC データ入力のみ) すべての ACC データ入力によってストリーミングされたデータを、JavaScript 関数を使って処理できることを確認してください。  
      生のログデータを前処理するための JavaScript 関数では、次のオブジェクトを使用します。
      * シグネチャ：function process (sample, metadata)  
        {#hla-data-input-preprocess__table_krp_n31_24b__entry__2}

        | オブジェクト | 説明 |
        |-|-|
        | sample | 現在のログサンプル。 |
        | metadata | イベントストリームを含むオブジェクト。 イベントストリームにアクセスするには、metadata.eventStream 関数を呼び出します。イベントストリームはオブジェクトであるため、その各プロパティにアクセスするには、metadata.eventStream.origin または metadata.eventStream.LocalPort 関数を呼び出します。 利用可能なイベントストリームプロパティのリストには、\[イベントストリーム：メタデータを介したアクセス (Event Stream: access via metadata)\] タブでアクセスできます。 |
        [ ]

        {#hla-data-input-preprocess__table_krp_n31_24b}
      * 戻り値のタイプと構造  
        注:  
        JavaScript 関数は、2 つのエントリーのマップを返します。この戻り値の構造は変更しないでください。  
        {#hla-data-input-preprocess__table_vtl_t31_24b__entry__2}

        | オブジェクト | 説明 |
        |-|-|
        | modifiedInput | 元のメッセージが JavaScript 関数で変更された後の、現在のログメッセージ。null の場合は、元のログメッセージが使用されます。 |
        | splitEvents | 元のメッセージが JavaScript 関数で分割された後の、ログメッセージのアレイ。 |
        [ ]

        {#hla-data-input-preprocess__table_vtl_t31_24b}
      * ログメッセージを破棄するには、`return drop()` を呼び出します。
      {#hla-data-input-preprocess__ul_c4p_1fl_vnb}
   2. JavaScript 関数をテストします。\[テスト\] を選択し、関連リストのログサンプルに対する結果を表示します。  
      {#hla-data-input-preprocess__table_ojy_xht_f4b__entry__2}

      | タブ | 説明 |
      |-|-|
      | 結果 | ログサンプルに対して JavaScript 関数を実行した結果。 |
      | イベントストリーム：メタデータを介したアクセス (Event Stream: access via metadata) | イベントストリームメタデータを提示するキーと値のペア。 |
      | 失敗 (Failures) | JavaScript 関数が正常に実行されなかったログサンプル。 |
      [ ]

      {#hla-data-input-preprocess__table_ojy_xht_f4b}  
      注:  
      新しい JavaScript 関数が思うように動作しない場合は、\[JS 関数を元に戻す (Revert JS Function)\] 関連リンクを選択することで、公開されている最新の関数に戻すことができます。
   3. **オプション:** 必要な調整を行い、JavaScript 関数をもう一度テストします。
   {#hla-data-input-preprocess__substeps_h3k_vnc_4mb}
7. \[テンプレートを保存\] オプションを選択して、JavaScript 関数を保存します。  
   JavaScript 関数を新しいテンプレートとして保存するか、現在選択されているテンプレートを上書きすることができます。
   * JavaScript 関数を新しいテンプレートとして保存するには、\[テンプレート名\] フィールドに新しい名前を入力します。
   * \[JS 関数テンプレート (JS function templates)\] フィールドで現在選択されているテンプレートを上書きするには、\[テンプレート名\] フィールドを空のままにします。
   {#hla-data-input-preprocess__ul_lbs_f3n_f4b}
8. \[公開\] を選択して、JavaScript 関数をデータベースに保存します。

## タスクの結果

JavaScript 関数が公開されると、 ヘルスログアナリティクス は、その関数を使用して、生のログデータを前処理してからマッピングおよび構造化します。

新しいスクリプトが、選択可能な JS 関数テンプレートのリストに自動的に追加されます。 この機能は、ヘルスログアナリティクス アプリケーション (バージョン 20.0.11 - July 2021、[ServiceNow ストア](https://store.servicenow.com/sn_appstore_store.do#!/store/home)から入手可能) でサポートされています。

(ACC データ入力のみ) ヘルスログアナリティクス は、既存および今後のすべての ACC データ入力に対して、公開済みの Javascript 関数を提供します。以前のスクリプトは新しい JavaScript 関数に置き換わります。

## 次のタスク

\[マッピングに移動 (Go to Mapping)\] 関連リンクを選択して、\[データ入力マッピング (Data Input Mapping)\] ページに進みます。インスタンスにストリーミングする[生のデータをマッピング](https://servicenow-prod.fluidtopics.net/GjF02LwUwQNLucVCrOdGfw "インスタンスにストリーミングされる生のログデータをマッピングすることで、データの処理方法が決まります。 ヘルスログアナリティクス は、ログを自動的に構造化し、例外検出のメトリクスを作成して、データのタグ付け方法に基づいてアラートを表示します。")して、ヘルスログアナリティクス でのデータの処理方法を決定します。