Elasticsearchの統計 🔗

The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the Elasticsearch monitor type to collect node, cluster, and index level stats from Elasticsearch.

By default, this integration only collects cluster-level and index-level stats from the current primary in an Elasticsearch cluster. You can override this using the clusterHealthStatsMasterOnly and indexStatsMasterOnly configuration options respectively.

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、Search the Metric Finder and Metadata Catalog を参照してください。

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
- Kubernetesにインストールする
- Linuxにインストールする
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：Collectorを理解して使用するを参照してください。

例 🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/elasticsearch:
    type: elasticsearch
    ... # Additional config

例えば、デフォルト（非カスタム）のメトリクスのみを収集する場合：

monitors:
- type: elasticsearch
  host: localhost
  port: 9200

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      receivers: [smartagent/elasticsearch]

コンフィギュレーション設定 🔗

次の表に、このモニターの設定オプションを示します：

オプション	必須	タイプ	説明
`host`	はい	`string`
`port`	はい	`string`
`username`	いいえ	`string`	Elasticsearch stats APIへのアクセスに使用するユーザー名
`password`	いいえ	`string`	Elasticsearch stats API にアクセスするためのパスワード
`useHTTPS`	いいえ	`bool`	httpsを使うかどうか (デフォルト： `false` )
`httpHeaders`	いいえ	`map of strings`	HTTP ヘッダー名と値のマップ。同じメッセージ・ヘッダーに対するカンマ区切りの複数の値もサポートしています。
`skipVerify`	いいえ	`bool`	useHTTPSが `true` で、このオプションも `true` である場合、エクスポーターの TLS 証明書は検証されません。(デフォルト: `false` )
`caCertPath`	いいえ	`string`	TLS証明書に署名したCA証明書へのパス。 `skipVerify` は `false` に設定されている場合は不要です。
`clientCertPath`	いいえ	`string`	TLSが必要な接続に使用するクライアントTLS証明書へのパス
`clientKeyPath`	いいえ	`string`	TLSが必要な接続に使用するクライアントTLSキーへのパス
`cluster`	いいえ	`string`	ノードが属するクラスター名。これはノードから取得したクラスター名をオーバーライドし、plugin_instanceディメンションの入力に使用されるオプションの設定です。
`enableIndexStats`	いいえ	`bool`	インデックス統計を有効にします。`true` に設定すると、デフォルトでインデックス統計のサブセットが収集されます (収集されるデフォルトのインデックスメトリクスのリストについてはドキュメントを参照してください)。(デフォルト： `true` )
`indexes`	いいえ	`list of strings`	統計情報を収集するインデックス（デフォルトでは、すべてのインデックスから統計情報を収集します)
`indexStatsIntervalSeconds`	いいえ	`integer`	IndexStatsを報告する間隔 (デフォルト： `60` )
`indexSummaryOnly`	いいえ	`bool`	全インデックスにわたって集計されたインデックス統計情報のみを収集します (デフォルト： `false` )
`indexStatsMasterOnly`	いいえ	`bool`	Collect index stats only from primary node (default: `true` )
`enableClusterHealth`	いいえ	`bool`	クラスターの健全性に関するレポートを有効にします (デフォルト：) `true` )
`clusterHealthStatsMasterOnly`	いいえ	`bool`	Whether or not non primary nodes should report cluster health (デフォルト： `true` )
`enableEnhancedHTTPStats`	いいえ	`bool`	拡張HTTP統計を有効にします (デフォルト： `false` )
`enableEnhancedJVMStats`	いいえ	`bool`	拡張JVM統計を有効にします (デフォルト： `false` )
`enableEnhancedProcessStats`	いいえ	`bool`	拡張プロセス統計を有効にします (デフォルト： `false` )
`enableEnhancedThreadPoolStats`	いいえ	`bool`	強化されたスレッドプールの統計情報を有効にします (デフォルト： `false` )
`enableEnhancedTransportStats`	いいえ	`bool`	強化されたトランスポートのスタッツを有効にします (デフォルト： `false` )
`enableEnhancedNodeIndicesStats`	いいえ	`list of strings`	強化されたノードレベルのインデックス統計グループをアクティブにします。拡張統計を収集するインデックス統計グループのリスト
`threadPools`	いいえ	`list of strings`	スレッドプールノードの統計情報を報告するスレッドプール (デフォルト： `[search index]` )
`enableEnhancedClusterHealthStats`	いいえ	`bool`	クラスターレベルの統計を有効にします。これらの統計は primary Elasticserach nodes. (default: `false`)
`enableEnhancedIndexStatsForIndexGroups`	いいえ	`list of strings`	拡張インデックスレベルのインデックス統計グループをアクティブにします。拡張統計を収集するインデックス統計グループのリスト
`enableIndexStatsPrimaries`	いいえ	`bool`	プライマリシャードのみからインデックス統計を有効にします。デフォルトでは収集されたインデックスの統計情報は、すべてのシャードにわたって集約されます。(デフォルト： `false` )
`metadataRefreshIntervalSeconds`	いいえ	`integer`	ノードとクラスターに関するメタデータの更新頻度 (デフォルト： `30` )

高度な設定例 🔗

強化された（カスタム）メトリクス 🔗

elasticsearch インテグレーションは、JVM、プロセス、HTTP、トランスポート、インデックス、およびスレッドプールの統計のノード統計のサブセットを収集します。各統計グループに対して個別に拡張統計情報を有効にすることも可能です。ホスト・ベースの価格設定を使用している場合、これらのメトリクスは*custom*グループに分類されることに注意してください。これは、拡張（カスタム）メトリクスを収集する構成の例です：

monitors:
- type: elasticsearch
  host: localhost
  port: 9200
  enableEnhancedHTTPStats: true
  enableEnhancedJVMStats: true
  enableEnhancedProcessStats: true
  enableEnhancedThreadPoolStats: true
  enableEnhancedTransportStats: true
  enableEnhancedNodeIndicesStats:
   - indexing
   - warmer
   - get

enableEnhancedNodeIndicesStats オプションは、拡張統計を収集するインデックス統計グループのリストを取ります。利用可能なグループの一覧は Nodes stats API を参照してください。

enableEnhancedIndexStatsForIndexGroups コンフィギュレーション・オプションは enableEnhancedNodeIndicesStats コンフィギュレーション・オプションと似ていますが、インデックス・レベルの統計情報であることに注意してください。

スレッドプール 🔗

デフォルトでは、「search」および「index」スレッド・プールからのスレッド・プール統計が収集されます。他のスレッド・プールの統計情報を収集するには、次の例に示すように、threadPools 構成オプションを指定します：

monitors:
- type: elasticsearch
  host: localhost
  port: 9200
  threadPools:
  - bulk
  - warmer
  - listener

以下は Elasticsearch のバージョン別に有効なスレッドプールのリストです：

スレッドプール名	ES 1.x	ES 2.0	ES 2.1+
merge	✓
optimize	✓
bulk	✓	✓	✓
flush	✓	✓	✓
generic	✓	✓	✓
get	✓	✓	✓
snapshot	✓	✓	✓
warmer	✓	✓	✓
refresh	✓	✓	✓
fetch_shard_started		✓	✓
fetch_shard_store		✓	✓
listener		✓	✓
management		✓	✓
percolate		✓	✓
suggest		✓	✓
force_merge			✓

インデックス統計の収集 🔗

デフォルトでは、設定パラメータ indexes は空です。これは、すべてのインデックスで統計情報が収集されることを意味します。インデックスのサブセットから統計情報を収集するには、設定パラメータ indexes に統計情報を収集したいインデックス名のリストを設定します。

インデックス統計を収集する呼び出しは、CPUを多用する場合があります。このため、indexStatsIntervalSeconds 構成パラメータを使用して、インデックス統計を報告するノードの報告間隔を短くします。

プライマリと合計の比較 🔗

デフォルトでは、インテグレーションは合計集約タイプのインデックス統計のサブセットを収集します。インデックス統計の合計は全シャードにわたって集約されますが、プライマリではプライマリシャードの統計のみが反映されます。プライマリ集計タイプのインデックス統計のみを有効にすることも可能です。以下は、プライマリシャードからのインデックス統計の作成方法を示す構成例です：

monitors:
- type: elasticsearch
  host: localhost
  port: 9200
  enableIndexStatsPrimaries: true

メトリクス 🔗

このインテグレーションでは、以下のメトリクスを使用できます：

備考 🔗

To learn more about the available in Splunk Observability Cloud see メトリクスタイプ
In host-based subscription plans, default metrics are those metrics included in host-based subscriptions in Splunk Observability Cloud, such as host, container, or bundled metrics. Custom metrics are not provided by default and might be subject to charges. See メトリクスカテゴリ for more information.
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、その他のメトリクスの追加で extraMetrics の設定方法を参照してください。

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

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

Splunk Observability Cloudをご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

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

Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルのチャットグループを参照してください。

このページは 2024年12月09日に最終更新されました。

Related Topics