Elasticsearchの統計 🔗
Splunk Distribution of OpenTelemetry CollectorはElasticsearchモニタータイプでSmart Agentレシーバーを使用し、Elasticsearchからノード、クラスター、インデックスレベルの統計情報を収集します。
デフォルトでは、このインテグレーションはElasticsearchクラスター内の現在のプライマリからクラスターレベルとインデックスレベルの統計情報のみを収集します。それぞれ clusterHealthStatsMasterOnly
と indexStatsMasterOnly
の設定オプションでオーバーライドすることができます。
メリット 🔗
インテグレーションを設定すると、これらの機能にアクセスできるようになります:
メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、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
メトリクス 🔗
このインテグレーションでは、以下のメトリクスを使用できます:
備考 🔗
Splunk Observability Cloudで利用可能なメトリクスタイプの詳細は、メトリクスタイプ を参照してください。
ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloudのホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されず、料金が発生する場合があります。詳細については、メトリクスカテゴリ を参照してください。
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、その他のメトリクスの追加 で
extraMetrics
の設定方法を参照してください。
トラブルシューティング 🔗
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.