New Relic の Prometheus OpenMetrics インテグレーションをインストールする前に、 要件を確認してください 。
Kubernetesへのインストール
サーバー、VM、非特権環境用の自動インストーラーを使用することをお勧めします。このインストーラーは、Kubernetesクラスターの監視設定もカバーしています。
Kubernetesインテグレーション(Prometheus OpenMetricの統合のための機能フラグを含む)をインストールする方法のドキュメントはこちら: Kubernetesインテグレーション:インストールと設定
また、Helm を使用して、 インテグレーションを展開するための完全なマニュアルを提供しています。
デフォルトでは、New Relic Prometheus OpenMetrics インテグレーションは、Prometheus と同じラベルを使用してターゲットを検出します。詳しくは、 metrics filtering のドキュメントをご覧ください。
統合が正しく構成されていることを確認します。数分待ってから、New Relic UI にアクセスし、この NRQL クエリを実行してデータが報告されたかどうかを確認します。
FROM Metric SELECT count(*) WHERE clusterName = 'YOUR_CLUSTER_NAME' since 1 hour ago
Docker
インストール
New Relic Prometheus OpenMetricsインテグレーションをDocker環境にインストールするには、以下の手順で行います。
- 構成ファイルの作成
config.yaml
。 サンプル構成ファイル を使用するか、nri-prometheus-latest.yaml
マニフェストファイルを参照してください。このマニフェストファイルには、nri-prometheus-cfg
のコンフィグマップとサンプル構成が含まれています。
- 必須: New Relic のライセンスキー と、Docker コンテナを識別するためのクラスタ名を追加します。
- スクラップするエンドポイントを追加します。例えば、
http://localhost:8080/metrics
のエンドポイントを追加して、統合自体に関するメトリクスを収集します。 - メトリクスとラベルの接頭辞に応じて、無視するメトリクスと含めるメトリクスを指定します。詳細については、 metrics filtering のドキュメントを参照してください。
バックグラウンドで統合を開始する。
docker run -d --restart unless-stopped \ --name nri-prometheus \ -e LICENSE_KEY="YOUR_LICENSE_KEY" \ -v "$(pwd)/config.yaml:/config.yaml" \ newrelic/nri-prometheus:1.5
コンテナが正常に動作していることを確認します。
docker ps -f "name=nri-prometheus"統合が正しく構成されていることを確認します。数分待ってから、New Relic UI にアクセスし、この NRQL クエリを実行してデータが報告されたかどうかを確認します。
FROM Metric SELECT count(*) WHERE clusterName = 'YOUR_CLUSTER_NAME' since 1 hour ago
インテグレーションの更新
Prometheus OpenMetricsインテグレーションをアップデートするには、必要に応じてDockerまたはKubernetesの手順に従ってください。
- Dockerコンテナを削除します。
- 標準のインストール手順 に従って、新しいDockerコンテナを起動します。
統合機能は、起動時に現在のバージョンをログに記録します。実行中のバージョンを確認するには
docker logs nri-prometheus 2>&1 | grep "Integration version"
出力例。
time="2019-02-26T09:21:21Z" level=info msg="Starting New Relic's Prometheus OpenMetrics Integration version 1.0.0"
アンインストール
Prometheus OpenMetrics integration for Docker or Kubernetesをアンインストールするには、以下のコマンドを実行します。
docker rm -f nri-prometheus