Elasticsearchレシーバー

前提条件

このレシーバーはElasticsearchバージョン7.9以降をサポートしています。

Elasticsearch セキュリティ機能が有効になっている場合は、モニタまたはクラスターの管理権限が必要です。ロールベースアクセス制御については Elastic ドキュメントの https://www.elastic.co/guide/en/elasticsearch/reference/current/authorization.html を、セキュリティ権限については https://www.elastic.co/guide/en/elasticsearch/reference/current/security-privileges.html を参照してください。

はじめに

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

   • インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

   • インストーラ・スクリプトを使用して Collector for Windows をインストールします。

   • Helmを使用してCollector for Kubernetesをインストールする

2. 次のセクションで説明するように、Elasticsearchレシーバーを設定します。

3. Collector を再起動します。

サンプル構成

1. レシーバーをアクティブにするには、設定ファイルの elasticsearch セクションに receivers を追加します：

   CODECopy

   receivers: elasticsearch:

   receivers:
       elasticsearch:

2. 次に、設定ファイルの service セクションの metrics パイプラインに、レシーバーを含めます：

   CODECopy

   service: pipelines: metrics: receivers: - elasticsearch

   service:
     pipelines:
       metrics:
         receivers:
           - elasticsearch

高度な設定

以下の設定はオプションです：

• nodes。デフォルトでは ["_all"] です。ノードレベルおよびクラスターレベルのメトリクスをスクレイピングするノードを定義するノードフィルタを指定します。

  • 許可されたフィルタについては、Elastic ドキュメントの https://www.elastic.co/guide/en/elasticsearch/reference/7.9/cluster.html#cluster-nodes にあるクラスター API ノードの仕様を参照してください。

  • 空の場合、レシーバはノードレベルのメトリクスをスクレイピングせず、クラスターの健全性に関連するメトリクスのみがクラスターレベルでスクレイピングされます。

• skip_cluster_metrics。デフォルトでは false です。true の場合、クラスターレベルのメトリクスはスクレイピングされません。

• indices。デフォルトでは ["_all"] です。インデックスレベルのメトリクスをスクレイピングする対象となるインデックスを定義するフィルタを指定できます。

  • 対応フィルタについては、Elastic ドキュメントの https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-stats.html#index-stats-api-path-params から「Cluster API Path parameters」を参照してください。

  • 空の場合、レシーバはインデックスレベルのメトリクスをスクレイピングしません。

• endpoint。デフォルトでは http://localhost:9200 です。監視するクラスターの Elasticsearch API のベース URL です。

• usernameします。デフォルトなし基本認証を使用して Elasticsearch で認証する際に使用するユーザー名を指定します。

• passwordします。デフォルトなし基本認証を使用して Elasticsearch で認証する際に使用するパスワードを指定します。

• collection_interval。デフォルトでは 10s です。このレシーバは、この設定によって決定される間隔でメトリクスを収集します。この値は、Golang の time.ParseDuration で読み取り可能な文字列である必要があります。https://pkg.go.dev/time#ParseDuration を参照してください。

  • 大きいクラスターでは、ノードの多いクラスターでElasticsearchにメトリクスをクエリするのに時間がかかるため、間隔を伸ばす必要がある場合があります。

• initial_delay。デフォルトでは 1s です。このレシーバーが開始するまでの待ち時間を定義します。

設定例

以下の設定例を参照してください：

receivers:
  elasticsearch:
    metrics:
      elasticsearch.node.fs.disk.available:
        enabled: false
    nodes: ["_local"]
    skip_cluster_metrics: true
    indices: [".geoip_databases"]
    endpoint: http://localhost:9200
    username: otel
    password: password
    collection_interval: 10s

設定

次の表は、Elasticsearchレシーバーの設定オプションを示しています：

メトリクス

以下のメトリクス、リソース属性、および属性が利用可能です。

receivers:
  samplereceiver:
    metrics:
      metric-one:
        enabled: true
      metric-two:
        enabled: false

receivers:
  hostmetrics:
    scrapers:
      process:
        metrics:
          process.cpu.utilization:
            enabled: true

バージョンのあるメトリクス

以下のメトリクスを、以下のバージョンで利用できます。

• elasticsearch.indexing_pressure.memory.limitします。バージョン 7.10 以上で利用可能です。

• elasticsearch.node.shards.data_set.sizeします。バージョン 7.13 以上で利用可能です。

• elasticsearch.cluster.state_update.countします。バージョン 7.16.0 以上で利用可能です。

• elasticsearch.cluster.state_update.timeします。バージョン 7.16.0 以上で利用可能です。

トラブルシューティング