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 にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索する を参照してください。
インストール 🔗
このインテグレーションを導入するには、以下の手順に従ってください：
Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
設定のセクションで説明するように、モニターを設定します。
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]
コンフィギュレーション設定 🔗
次の表に、このモニターの設定オプションを示します：
オプション |
必須 |
タイプ |
説明 |
|---|---|---|---|
|
はい |
|
|
|
はい |
|
|
|
いいえ |
|
Elasticsearch stats APIへのアクセスに使用するユーザー名 |
|
いいえ |
|
Elasticsearch stats API にアクセスするためのパスワード |
|
いいえ |
|
httpsを使うかどうか (デフォルト： |
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
TLSが必要な接続に使用するクライアントTLS証明書へのパス |
|
いいえ |
|
TLSが必要な接続に使用するクライアントTLSキーへのパス |
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
IndexStatsを報告する間隔 (デフォルト： |
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
拡張HTTP統計を有効にします (デフォルト： |
|
いいえ |
|
拡張JVM統計を有効にします (デフォルト： |
|
いいえ |
|
拡張プロセス統計を有効にします (デフォルト： |
|
いいえ |
|
強化されたスレッドプールの統計情報を有効にします (デフォルト： |
|
いいえ |
|
強化されたトランスポートのスタッツを有効にします (デフォルト： |
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
高度な設定例 🔗
強化された（カスタム）メトリクス 🔗
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 マニュアルの チャットグループ を参照してください。