Elasticsearchレシーバー 🔗

Elasticsearchレシーバーは、Elasticsearchノード統計、クラスター健全性、インデックス統計のエンドポイントに問い合わせ、稼働中のElasticsearchクラスターからメトリクスをスクレイピングします。サポートされているパイプラインタイプは metrics です。詳細はパイプラインでデータを処理するを参照してください。

注釈

すぐに使えるダッシュボードとナビゲーターはまだElasticsearchレシーバーではサポートされていませんが、将来のリリースではサポートされる予定です。

クエリ対象のエンドポイントについて詳しく学ぶには、次を参照してください：

前提条件 🔗

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

Elasticsearchのセキュリティ機能が有効になっている場合、monitor権限かmanage cluster権限のどちらかが必要です。権限とセキュリティ権限の詳細についてはElasticsearchのロールベースのアクセス制御とセキュリティ権限を参照してください。

はじめに 🔗

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

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

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

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

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

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

サンプル構成 🔗

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

receivers:
    elasticsearch:

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

service:
  pipelines:
    metrics:
      receivers:
        - elasticsearch

高度な設定 🔗

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

nodes。デフォルトでは ["_all"] です。ノードレベルおよびクラスターレベルのメトリクスをスクレイピングするノードを定義するノードフィルターを指定できます。
- 許可されるフィルターについては、ElasticsearchのクラスターAPIノード仕様を参照してください。
- 空の場合、レシーバーはノードレベルのメトリクスをスクレイピングせず、クラスターの健全性に関連するメトリクスのみがクラスターレベルでスクレイピングされます。
skip_cluster_metrics。デフォルトでは false。true の場合、クラスターレベルのメトリクスはスクレイピングされません。
indices。デフォルトでは ["_all"] です。どのインデックスがインデックスレベルのメトリクスをスクレイピングするかを定義するインデックスフィルターを指定できます。
- 許可されるフィルターについては、ElasticsearchのクラスターAPIパスパラメータを参照してください。
- 空の場合、レシーバーはインデックスレベルのメトリクスをスクレイピングしません。
endpoint。デフォルトでは http://localhost:9200 です。監視するクラスターのElasticsearch APIのベース URL。
username。デフォルトはありません。基本認証を使用してElasticsearchで認証する際に使用するユーザー名を指定します。
password。デフォルトはありません。基本認証を使用してElasticsearchで認証に使用するパスワードを指定します。
collection_interval。デフォルトでは 10s です。このレシーバーは、この設定で決定された間隔でメトリクスを収集します。この値は、Golangの 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レシーバーの設定オプションを示しています：

メトリクス 🔗

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

特定のメトリクスをアクティブまたは非アクティブにする 🔗

各メトリクスの metrics セクションの enabled フィールドを設定することで、特定のメトリクスをアクティブまたは非アクティブにできます。例：

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

以下は、アクティブ化されたメトリクスを持つホスト・メトリクス・レシーバーの構成例です：

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

注釈

無効化されたメトリクスは Splunk Observability Cloud に送信されません。

請求 🔗

MTSベースのサブスクリプションでは、すべてのメトリクスがメトリクスの使用量にカウントされます。
ホストベースのプランに加入している場合、このドキュメントでアクティブ（Active: Yes）と記載されているメトリクスはデフォルトとみなされ、無料で含まれます。

詳しくは Infrastructure Monitoringのサブスクリプション使用状況（ホストとメトリクスのプラン）を参照してください。

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

以下のメトリクスが利用可能なバージョン：

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以上で利用可能です。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Splunkサポートに連絡する

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年02月11日に最終更新されました。

Related Topics