Elasticsearchインテグレーションは、 Elasticsearch クラスターからインベントリとメトリクスを収集し、弊社のプラットフォームへ送信します。これにより、お客様はElasticsearch環境の健全性を確認することができます。クラスタ、ノード、インデックスの各レベルでメトリックスを収集するため、問題の原因をより簡単に見つけることができます。
Elasticsearch monitoring integrationをインストールするには、以下のステップを実行します。
- インテグレーションのインストールとアクティブ化。
- インテグレーションの設定。
- データの検索と使用。
- オプションで、 Elasticsearchの構成設定を参照してください。
互換性と要件
Elasticsearchのバージョン
この統合は、Elasticsearch 7.x から 8.X までと互換性があります。
対応するオペレーティング・システム
- ウィンドウズ
- リナックス
特定のWindowsおよびLinuxバージョンの包括的なリストについては、 互換性のあるオペレーティングシステムの表を確認してください。
システム要求
NewRelicアカウント。持っていませんか?無料でお申し込み頂けます!クレジットカードは必要ありません。
ElasticsearchがKubernetesやAmazon ECS上で稼働していない場合、 Elasticsearchが稼働しているホストにインフラストラクチャエージェント をインストールします。それ以外の場合は
インテグレーションのインストールとアクティブ化
Elasticsearch統合をインストールするには、ご使用の環境の指示に従ってください。
Linuxのインストール
統合のインストール手順に従い、
INTEGRATION_FILE_NAME
変数をnri-elasticsearch
に置き換えます。を実行して、integrationsのコンフィギュレーション・フォルダーにディレクトリを変更します。
bash$cd /etc/newrelic-infra/integrations.d以下を実行して、サンプルの設定ファイルをコピーします。
bash$sudo cp elasticsearch-config.yml.sample elasticsearch-config.ymlお気に入りのエディタで
elasticsearch-config.yml
構成ファイルを編集します。構成ファイルの例をいくつか確認してください。Elasticsearchのエラーログの自動解析と転送を有効にするには、
elasticsearch-log.yml.example
ファイルをelasticsearch-log.yml
にコピー(または名前変更)します。エージェントを再起動する必要はありません。
Example
$sudo cp /etc/newrelic-infra/logging.d/elasticsearch-log.yml.example /etc/newrelic-infra/logging.d/elasticsearch-log.yml
その他の環境
その他の注意事項:
- Advanced: インテグレーションは、パッケージマネージャの外部にインストールできるように、 tarball 形式でも利用できます。
- On-host integrations do not automatically update. 最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。
このドキュメントはインストールの役に立ちましたか?
統合を構成する
インストール方法に応じて、統合を構成する方法はいくつかあります。
- 有効にした場合Kubernetes、Kubernetesで実行されているサービスを監視するをご覧ください。
- 有効にした場合Amazon ECS 、 ECSで実行されているサービスを監視する。
- ホストにインストールされている場合は、統合のYAML構成ファイル
elasticsearch-config.yml
の構成を編集します。統合のYAML形式の構成では、必要なログインクレデンシャルを配置し、データの収集方法を構成できます。どのオプションを変更するかは、設定と設定によって異なります。構成ファイルには、interval
、timeout
、inventory_source
など、すべての統合に適用できる共通の設定があります。これらの一般的な設定についてすべて読むには、 構成フォーマットのドキュメントを参照してください。
重要
従来の設定ファイルや定義ファイルをお使いの場合は、 標準設定フォーマット をご確認ください。
elasticsearch-config.yml サンプルファイル
統合のための構成オプション
データを検索して使用する方法の詳細については、 Elasticsearchの構成設定を参照してください。
データを見つけて使用する
このサービスからのデータは、 統合ダッシュボードに報告されます。
Elasticsearchデータは、次のイベントタイプに添付されます。
トラブルシューティングの目的で、またはカスタムチャートとダッシュボードを作成するために、このデータをクエリできます。
データを検索して使用する方法の詳細については、統合データを理解する方法を参照してください。
統合によって収集されたメトリック
Elasticsearch統合は、次のメトリックを収集します。各メトリック名の前には、カテゴリインジケーターとピリオド( cluster.
やshards.
など)が付いています。
Elasticsearch 統合はオープン ソース ソフトウェアです。つまり、ソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。
Elasticsearchインスタンスの設定
elasticsearch-config.yml
ファイルのenv
セクションを使用して、Elasticsearchに関連する特定の設定を定義できます。これらの設定は、Elasticsearchインスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。
Elasticsearch インテグレーションは、メトリックスとインベントリ情報の両方を収集します。 表では、各コレクションで使用可能な設定についてはApplies to列を使用します。
'' '' '' '' '' '' '' '' '' '' '' '' '' '' '' '' '' ''
設定 | 説明 | デフォルト | に適用されます |
---|---|---|---|
HOSTNAME | Elasticsearchが実行されているホスト名またはIP。 | ローカルホスト | M / I |
LOCAL_HOSTNAME | インベントリデータの収集元となるElasticsearchノードのホスト名またはIP。ローカルホストに対してインベントリデータを収集したくない場合にのみ設定する必要があります。 | ローカルホスト | M |
PORT | Elasticsearchがリッスンしているポート。 | 9200 | M / I |
USERNAME | ElasticsearchNodeにアクセスするためのユーザー名。 | 該当なし | M / I |
PASSWORD | 指定されたユーザーのパスワード。 | 該当なし | M / I |
CLUSTER_ENVIRONMENT | データを収集するクラスターをさらに指定する方法。例:「ステージング」。 | 該当なし | M / I |
USE_SSL | Elasticsearchノードと通信するときにSSLを使用します。 | false | M / I |
CA_BUNDLE_FILE | ホスト上のSSL証明書の場所。 | 該当なし | M / I |
CA_BUNDLE_DIR | 代替認証局バンドルディレクトリ。 | 該当なし | M / I |
SSL_ALTERNATIVE_HOSTNAME | 統合がSSLネゴシエーションの目的で有効として受け入れる代替サーバーのホスト名。 | 該当なし | M / I |
TLS_INSECURE_SKIP_VERIFY | サーバーの証明書チェーンとホスト名の検証をスキップします。 | false | M / I |
CONFIG_PATH | Elasticsearch構成ファイルへのパス。 | /etc/elasticsearch/ エラスティックサーチ.yml | 私 |
TIMEOUT | APIリクエストのタイムアウト(秒単位)。 | 30 | M / I |
COLLECT_INDICES | インデックスメトリックを収集するかどうかを通知します。 | true | M |
COLLECT_PRIMARIES | プライマリメトリックを収集するかどうかを通知します。 | true | M |
INDICES_REGEX | 収集されるインデックスをフィルタリングします。 | 該当なし | M |
MASTER_ONLY | 選出されたマスターでのみクラスターメトリックを収集します。 | false | M |
METRICS | メトリックのみの収集を有効にするには、 | false | |
INVENTORY | インベントリのみの収集を有効にするには、 | false |
これらの設定の値は、いくつかの方法で定義できます。
設定ファイルに直接値を追加します。これが最も一般的な方法です。
{{ }}
表記を使用して環境変数の値を置き換えます。 オンホストインテグレーションでの環境変数パススルーの使用について詳しく読むか、 環境変数の置換の例を参照してください。重要
これには、インフラストラクチャエージェント v1.14.0 以降が必要です。シークレット管理の使用。これを使用して、設定ファイルのプレーンテキストで公開されないようにパスワードなどの重要な情報を保護してください。詳細については、シークレット管理を参照してください。
ラベルとカスタム属性
ラベルを使用して、メトリックをさらに装飾できます。ラベルを使用すると、キーと値のペアの属性をメトリックに追加できます。これを使用して、メトリックをクエリ、フィルタリング、またはグループ化できます。
基本構成elasticsearch-config.ymlサンプルファイルには、ラベルの使用法が含まれています。ただし、必須ではないため、選択した新しいものを削除、変更、または追加できます。
labels: env: production role: load_balancer
在庫データ
Elasticsearch統合は、 YAML構成ファイルで指定されているように、Elasticsearchノードの構成パラメーターをキャプチャします。また、 \_nodes/\_local
エンドポイントからノード構成情報を収集します。データは、 インフラストラクチャインベントリページのconfig/elasticsearch
ソースから入手できます。
在庫データの詳細については、 統合データを理解する方法を参照してください。