Docs » Splunk Observability Cloud でサポートされているインテグレーション » ホストとサーバーのアプリケーション・レシーバーの設定 » Elasticsearchの統計

Elasticsearchの統計 🔗

Splunk Distribution of OpenTelemetry Collector は Elasticsearch モニタータイプで Smart Agent レシーバー を使用し、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.

メリット 🔗

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

インストール 🔗

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

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

  2. 設定のセクションで説明するように、モニターを設定します。

  3. Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

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

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、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証明書へのパス。

skipVerifyfalse に設定されている場合は不要です。

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をご利用のお客様

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

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

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

This page was last updated on 2024年05月29日.