この機械翻訳は、参考として提供されています。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

Elasticsearchモニタリングの統合

Elasticsearchインテグレーションは、 Elasticsearch クラスターからインベントリとメトリクスを収集し、弊社のプラットフォームへ送信します。これにより、お客様はElasticsearch環境の健全性を確認することができます。クラスタ、ノード、インデックスの各レベルでメトリックスを収集するため、問題の原因をより簡単に見つけることができます。

Elasticsearch monitoring integrationをインストールするには、以下のステップを実行します。

  1. インテグレーションのインストールとアクティブ化
  2. インテグレーションの設定
  3. データの検索と使用
  4. オプションで、 Elasticsearchの構成設定を参照してください。

互換性と要件

Elasticsearchのバージョン

この統合は、Elasticsearch 7.x から 8.X までと互換性があります。

対応するオペレーティング・システム

  • ウィンドウズWindows
  • リナックスLinux

特定のWindowsおよびLinuxバージョンの包括的なリストについては、 互換性のあるオペレーティングシステムの表を確認してください。

システム要求

インテグレーションのインストールとアクティブ化

Elasticsearch統合をインストールするには、ご使用の環境の指示に従ってください。

Linuxのインストール

  1. 統合のインストール手順に従い、 INTEGRATION_FILE_NAME変数をnri-elasticsearchに置き換えます。

  2. を実行して、integrationsのコンフィギュレーション・フォルダーにディレクトリを変更します。

    bash
    $
    cd /etc/newrelic-infra/integrations.d
  3. 以下を実行して、サンプルの設定ファイルをコピーします。

    bash
    $
    sudo cp elasticsearch-config.yml.sample elasticsearch-config.yml
  4. お気に入りのエディタで elasticsearch-config.yml 構成ファイルを編集します。構成ファイルの例をいくつか確認してください。

  5. Elasticsearchのエラーログの自動解析と転送を有効にするには、 elasticsearch-log.yml.exampleファイルをelasticsearch-log.ymlにコピー(または名前変更)します。エージェントを再起動する必要はありません。

Example

bash
$
sudo cp /etc/newrelic-infra/logging.d/elasticsearch-log.yml.example /etc/newrelic-infra/logging.d/elasticsearch-log.yml

その他の環境

その他の注意事項:

このドキュメントはインストールの役に立ちましたか?

統合を構成する

インストール方法に応じて、統合を構成する方法はいくつかあります。

  • 有効にした場合KubernetesKubernetes、Kubernetesで実行されているサービスを監視するをご覧ください
  • 有効にした場合ECSAmazon ECS 、 ECSで実行されているサービスを監視する
  • ホストにインストールされている場合は、統合のYAML構成ファイルelasticsearch-config.ymlの構成を編集します。統合のYAML形式の構成では、必要なログインクレデンシャルを配置し、データの収集方法を構成できます。どのオプションを変更するかは、設定と設定によって異なります。構成ファイルには、 intervaltimeoutinventory_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証明書の場所。 USE_SSLがtrueの場合にのみ必要です。

該当なし

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

メトリックのみの収集を有効にするには、 trueに設定します。

false

INVENTORY

インベントリのみの収集を有効にするには、 trueに設定します。

false

これらの設定の値は、いくつかの方法で定義できます。

  • 設定ファイルに直接値を追加します。これが最も一般的な方法です。

  • {{ }}表記を使用して環境変数の値を置き換えます。 オンホストインテグレーションでの環境変数パススルーの使用について詳しく読むか、 環境変数の置換の例を参照してください。

    重要

    これには、インフラストラクチャエージェント v1.14.0 以降が必要です。

  • シークレット管理の使用。これを使用して、設定ファイルのプレーンテキストで公開されないようにパスワードなどの重要な情報を保護してください。詳細については、シークレット管理を参照してください。

ラベルとカスタム属性

ラベルを使用して、メトリックをさらに装飾できます。ラベルを使用すると、キーと値のペアの属性をメトリックに追加できます。これを使用して、メトリックをクエリ、フィルタリング、またはグループ化できます。
基本構成elasticsearch-config.ymlサンプルファイルには、ラベルの使用法が含まれています。ただし、必須ではないため、選択した新しいものを削除、変更、または追加できます。

labels:
env: production
role: load_balancer

在庫データ

Elasticsearch統合は、 YAML構成ファイルで指定されているように、Elasticsearchノードの構成パラメーターをキャプチャします。また、 \_nodes/\_localエンドポイントからノード構成情報を収集します。データは、 インフラストラクチャインベントリページconfig/elasticsearchソースから入手できます。

在庫データの詳細については、 統合データを理解する方法を参照してください。