Prometheus OpenMetricsインテグレーションのインストール、アップデート、アンインストールを行います。

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をアンインストールするには、以下のコマンドを実行します。