Apache Tomcat のログを収集する

このドキュメントでは、Bindplane を使用して Apache Tomcat ログを Google Security Operations に取り込む方法について説明します。パーサーは、JSON 形式のログからフィールドを抽出し、Unified Data Model（UDM）に変換します。デフォルト値を初期化し、JSON ペイロードを解析して、JSON 解析エラーの可能性を処理します。また、メタデータ、プリンシパル、オブザーバー、セキュリティ結果情報など、未加工ログのさまざまなフィールドを対応する UDM フィールドにマッピングし、環境コンテキストのカスタムラベルも追加します。

始める前に

次の前提条件を満たしていることを確認してください。

• Google SecOps インスタンス
• Windows 2016 以降、または systemd を使用する Linux ホスト
• プロキシの背後で実行されている場合、ファイアウォール ポートが開いている
• Apache Tomcat バージョン 9.0.70 以降
• $CATALINA_BASE/conf と $CATALINA_BASE/logs への書き込みアクセス権

Google SecOps の取り込み認証ファイルを取得する

1. Google SecOps コンソールにログインします。
2. [SIEM 設定] > [コレクション エージェント] に移動します。
3. Ingestion Authentication File をダウンロードします。Bindplane をインストールするシステムにファイルを安全に保存します。

Google SecOps のお客様 ID を取得する

1. Google SecOps コンソールにログインします。
2. [SIEM 設定] > [プロファイル] に移動します。
3. [組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。

Tomcat サーバーに Bindplane エージェントをインストールしてログファイルを収集する

次の手順に沿って、Windows または Linux オペレーティング システムに Bindplane エージェントをインストールします。

Windows のインストール

1. 管理者として コマンド プロンプトまたは PowerShell を開きます。

2. 次のコマンドを実行します。

   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
   

Linux のインストール

1. root 権限または sudo 権限でターミナルを開きます。

2. 次のコマンドを実行します。

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

その他のインストール リソース

その他のインストール オプションについては、インストール ガイドをご覧ください。

Syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する

1. 構成ファイルにアクセスします。
   • config.yaml ファイルを見つけます。通常、Linux では /etc/bindplane-agent/ ディレクトリに、Windows ではインストール ディレクトリにあります。
   • テキスト エディタ（nano、vi、メモ帳など）を使用してファイルを開きます。

2. config.yaml ファイルを次のように編集します。

   receivers:
       filelog/tomcat:
       include: [ /path/to/tomcat/logs/access-log.*.json ]
       start_at: beginning
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the path to the credentials file you downloaded in Step 1
           creds_file_path: '/path/to/ingestion-authentication-file.json'
           # Replace with your actual customer ID from Step 2
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # Add optional ingestion labels for better organization
           log_type: 'TOMCAT'
           raw_log_field: body
           ingestion_labels:
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - filelog/tomcat
               exporters:
                   - chronicle/chronicle_w_labels
   

   • /path/to/tomcat/logs を置き換えます。
   • <customer_id> は、実際の顧客 ID に置き換えます。
   • /path/to/ingestion-authentication-file.json の値を、Google SecOps の取り込み認証ファイルを取得するで認証ファイルを保存したパスに更新します。

Bindplane エージェントを再起動して変更を適用する

• Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。

  sudo systemctl restart bindplane-agent
  

• Windows で Bindplane エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。

  net stop BindPlaneAgent && net start BindPlaneAgent
  

Tomcat で JSON アクセスログを構成する

1. $CATALINA_BASE/conf/server.xml にある Tomcat ファイルを開きます。

2. <Host> タグを見つけて、その中に以下を追加します。

   <Valve className="org.apache.catalina.valves.JsonAccessLogValve"
         directory="logs"
         prefix="access-log"
         suffix=".json"
         rotatable="true"
         maxDays="7"/>
   

3. Tomcat を再起動して変更を適用します。

   cd /path/to/tomcat
   bin/catalina.sh stop
   bin/catalina.sh start
   

4. 新しい JSON ログファイルが毎日表示されます（例: logs/access-log.2025-07-02.json）。

UDM マッピング テーブル

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。