すべてのプロダクト
Search

このプロダクト

    Elasticsearch:Elastic Agent を使用したカスタムログデータの収集

    ドキュメントセンター

    Elasticsearch:Elastic Agent を使用したカスタムログデータの収集

    最終更新日:May 22, 2026

    Fleet は、複数のノードとサービスを管理するための Elasticsearch の強力な一元管理ソリューションです。 Fleet は、Fleet サーバーと Fleet エージェントという 2 つの主要コンポーネントで構成されています。 Fleet エージェントは、ソースサーバーからデータを収集する軽量のデータ収集エージェントです。 Fleet サーバーは Fleet の中央ノードであり、すべての Fleet エージェントを管理および監視し、データを Elasticsearch に転送します。

    用語

    用語

    説明

    Fleet

    エージェントサービスを管理するための Elasticsearch の強力な一元管理ソリューションです。

    Fleet エージェント

    ソースサーバーからデータを収集する軽量のデータ収集エージェントです。

    Fleet エージェントは、複数のオペレーティングシステムで実行でき、さまざまな種類のデータを収集できます。

    Fleet サーバー

    エージェントによって収集されたデータを Elasticsearch に転送します。

    前提条件

    • Alibaba Cloud Elasticsearch クラスターを作成しておきます。 詳細については、「Alibaba Cloud Elasticsearch クラスターの作成」をご参照ください。 このトピックでは、Elasticsearch 8.5 クラスターを例として使用します。

      説明

      Alibaba Cloud Elasticsearch クラスターは、バージョン 7.16 および 8.5 のみに対応しています。

    • Elasticsearch クラスターと同じ VPC 内に Elastic Compute Service (ECS) インスタンスを作成しておきます。 詳細については、「インスタンスの作成」をご参照ください。

      説明

      ECS インスタンスはソースサーバーとして機能します。 Elastic Agent は、この ECS インスタンスからデータを収集します。

    エージェントポリシーの作成とインテグレーションの追加

    ステップ 1： エージェントポリシーの作成

    1. Kibana コンソールにログインします。 詳細については、「Kibana コンソールへのログイン」をご参照ください。

    2. image.png アイコンをクリックし、 [Management] > [Fleet] に移動します。

    3. [Fleet] ページで、 [Agent policies] タブをクリックします。

    4. [Create agent policy] をクリックし、パネルでポリシーを設定します。

      1. 名前 には、custom-log を入力します。

      2. [Collect system logs and metrics] チェックボックスをオフにします。

      3. 詳細設定 をクリックします。[エージェントモニタリング] セクションで、[エージェントログの収集] と [エージェントメトリックの収集] のチェックボックスをオフにします。

        image.png

        説明

        このシナリオでは、Custom Logs のデータのみを収集する必要があります。 したがって、システムログ、システムメトリクス、またはエージェント自体のデータを収集する必要はありません。

    5. [Create agent policy] をクリックします。

    ステップ 2： Fleet サーバー インテグレーションの作成

    1. [Fleet] ページで、 [Agent policies] タブをクリックし、 custom-log エージェントポリシーをクリックします。

    2. 統合 タブで、[統合の追加] をクリックします。

    3. [Browse integrations] タブで、 [Fleet Server] を検索してクリックします。

    4. Fleet サーバー インテグレーションをインストールします。

      1. Fleet Server ページで、設定 タブをクリックします。

      2. [Install Fleet Server assets] をクリックします。 表示されたダイアログボックスで、 [Install Fleet Server] をクリックします。

        説明

        インストール後、インテグレーションのバージョンが [設定] タブに表示されます。

    5. ページの右上隅にある [Add Fleet Server] をクリックします。

    6. [Add Fleet Server integration] ページで、インテグレーションの名前を入力し、custom-log エージェントポリシーを選択します。

    7. [Save and continue] をクリックし、ダイアログボックスで [Add Elastic Agent later] をクリックします。

    ステップ 3： カスタムログ インテグレーションの作成

    1. custom-log エージェントポリシーの 統合 タブで、[統合の追加] をクリックします。

    2. [Browse integrations] タブで、 [Custom Logs] を検索してクリックします。

    3. カスタムログ インテグレーションをインストールします。

      1. [カスタムログ] ページで、設定 タブをクリックします。

      2. [Install Custom Logs assets] をクリックします。 表示されたダイアログボックスで、 [Install Custom Logs] をクリックします。

        説明

        インストール後、インテグレーションのバージョンが [設定] タブに表示されます。

    4. ページの右上隅にある [Add Custom Logs] をクリックします。

    5. [Add Custom Logs integration] ページで、インテグレーションを設定します。

      1. Integration Configuration セクションで、[統合名] を入力します。

      2. [Custom log file] セクションで、ECS インスタンス上のログファイルへのパスを入力します (例： /var/log/a2.log)。

      3. 詳細設定 をクリックし、カスタムデータセット名を指定します。

        説明

        • データセット名は Elasticsearch のインデックス名を決定します。 新しいデータセット名を指定すると、データが新しいインデックスに送信され、データ処理の柔軟性と管理性が向上します。

        • データセット名は Elasticsearch のインデックス命名要件に準拠する必要があります。 使用できるのは、文字、数字、アンダースコア (_) のみです。

        image.png

      4. [Where to add this integration] セクションの [Existing hosts] タブで、custom-log エージェントポリシーを選択します。

    6. [Save and continue] をクリックし、ダイアログボックスで [Add Elastic Agent later] をクリックします。

    エージェントの追加

    ステップ 1： Fleet サーバー ホストの設定

    1. Kibana コンソールにログインします。 詳細については、「Kibana コンソールへのログイン」をご参照ください。

    2. image.png アイコンをクリックし、 [Management] > [Fleet] に移動します。

    3. Fleet ページで、設定 タブをクリックします。

      1. Fleet サーバーホストセクションで、ホストの編集 をクリックします。

      2. [Fleet サーバーホスト] パネルに、ソースサーバーのプライベート IP アドレスを https://<private IP address>:<port> の形式で入力します。例: https://172.16.*.***:8220。

        説明

        このトピックでは、ECS インスタンスのプライマリプライベート IP アドレスを使用します。 設定の詳細については、「Fleet Server hosts」をご参照ください。

      3. 出力 セクションの Actions 列で、image.png アイコンをクリックします。

      4. [出力の編集] パネルに、Alibaba Cloud Elasticsearch クラスターのプライベートエンドポイントを http://<private endpoint>:<port> 形式で入力します。たとえば、http://es-cn-uqm3auln80001****.elasticsearch.aliyuncs.com:9200 です。

      5. [設定を保存して適用] をクリックします。表示されるダイアログボックスで、保存とデプロイ をクリックします。

    ステップ 2： Elastic Agent の追加

    Elastic Agent を Fleet サーバーに追加します。

    説明

    複数のサーバーからデータを収集するには、これらの手順を繰り返してエージェントを追加します。 1 つの Fleet サーバーで複数のエージェントを管理でき、各エージェントはそれぞれのサーバーからデータを収集します。

    1. [Fleet] ページで、 [Agent policies] タブをクリックします。

    2. custom-log エージェントポリシーのActions列で、します。

    3. [Add agent] パネルの [Select a policy for Fleet Server] で、エージェントポリシーが custom-log であることを確認します。

    4. [Choose a deployment mode for security] で、デフォルトの [Quick start] を選択したままにします。

    5. Fleet Server ホストの追加で、モニターホストを追加 をクリックします。

    6. [Generate a service token] セクションで、 [Generate a service token] をクリックします。

    7. [Install Fleet Server to a centralized host] セクションで、自動生成されたコードブロックをコピーし、ECS インスタンスで実行します。

      image.png

      Successfully メッセージは、Elastic Agent が ECS インスタンス上でインストールされ、実行されていることを示します。

    データの表示

    このセクションでは、ECS ログパス (/var/log/a2.log) とデータセット名 (generic) を例に、ログデータを表示する方法を説明します。

    説明

    ECS インスタンスの指定されたログパスにデータが含まれていることを確認してください。

    1. インデックスの管理でデータストリーム名を確認します。

      1. image.png アイコンをクリックし、 [Management] > [スタック管理] に移動します。

      2. 左側のナビゲーションペインで、Data > インデックスの管理 をクリックします。

      3. インデックスの管理 ページで、データストリーム タブをクリックし、データセット名 generic を含むデータストリーム (例: logs-generic-default) を探します。

    2. Kibana コンソールで、データストリームに対応するインデックス名を表示します。

      1. image.png アイコンをクリックし、 [Management] > [開発ツール] に移動します。

      2. 次のコマンドを実行して、データストリームのインデックス名を取得します。

        GET _data_stream/logs-generic-default

        出力のindex_nameの値がインデックス名です。

    3. 次のコマンドを実行して、インデックス内のログデータを表示します。

      GET <index_name>/_search
{
  "query":{
    "match":{
      "log.file.path":"/var/log/a2.log"
    }
  }
}