いくつかの簡単のステップで、New RelicでPrometheusデータフローを取得できます。このページでは、リモート書込みインテグレーションの基本的な設定や、いくつかの一般的なトラブルシューティングのトピックを取り上げます。高可用性(HA)設定でのPrometheusサーバーのインテグレーションに関する情報は、Prometheusの高可用性ドキュメントをご覧ください。
ヒント
Prometheusインテグレーションとinfrastructureモニタリング、およびその他のオブザーバビリティプラットフォームを使用するには、New Relicファミリーに参加してください。サインアップして、わずか数秒で無料アカウントを作成できます。次に、毎月最大で100GBのデータを無料で取り込みます。期間無制限です。
インテグレーションの設定
New Relic OneのPrometheusリモート書込みセットアップランチャーに移動してから、これらのステップを実行します。
接続するPrometheusサーバーの名前と
remote_write
URLを入力します。重要: サーバーに対して入力した名前によって、データに属性が作成されます。これは、New Relicにデータを送信しているPrometheusサーバーを識別する名前にもなります。新たな
remote_write
URLを、Prometheus YMLファイルに追加します。グローバル
セクションと同じインデントにあるファイル内のglobal_config
の下にこの情報を追加します。以下の構文を使用します.
remote_write: - url: https://metric-api.newrelic.com/prometheus/v1/write?prometheus_server=YOUR_DATA_SOURCE_NAME bearer_token:YOUR_LICENSE_KEY
または
remote_write: - url: https://metric-api.newrelic.com/prometheus/v1/write?X-License-Key=YOUR_LICENSE_KEY&prometheus_server=YOUR_DATA_SOURCE_NAME
EUのアカウント: EUから接続している場合は、以下のURLを使用してください.
https://metric-api.eu.newrelic.com/prometheus/v1/writeKubernetesおよびHelmリモート書き込みインテグレーション: リモート書き込みURLをHelm
values.yaml
ファイルに追加します。remoteWrite: []
を以下の例のような2行で置き換えます。リモート書き込みURLを使用し、残りのファイルに一致するインデントを使用してください。remoteWrite: - url: https://metric-api.newrelic.com/prometheus/v1/write?prometheus_server=YOUR_DATA_SOURCE_NAME bearer_token:YOUR_LICENSE_KEY
Prometheusサーバーを再起動します。
New Relic UIでデータを表示する例えば、インテグレーションをセットアップするときに自動的に作成されるリモート書き込みダッシュボードを使用します。
Prometheusメトリックタイプのマッピング
Prometheusリモート書き込みプロトコルでは、New Relicにメトリックを送信するときに、メトリックタイプの情報や、その他の有用なメトリックメタデータが含まれません。リモート書き込みプロトコルにはこの情報が含まれていないため、New RelicはPrometheusの命名規則に基づいてメトリックタイプを推測します。これらの命名規則に従わないメトリクスは、正しくマッピングされない場合があります。
New Relicは、以下に示すPrometheusメトリックの命名規則に基づいてPrometheusメトリックタイプをNewRelicメトリックタイプにマッピングします。
metricName_bucket
はNew Relicカウントメトリクスタイプとして保存されます。metricName_count
はNew Relicカウントメトリクスタイプとして保存されます。metricName_total
はNew Relicカウントメトリクスタイプとして保存されます。metricName_sum
はNew Relicサマリーメトリクスタイプとして保存されます。
それ以外はすべて、New Relicゲージメトリックタイプとして保存されます。
メトリクスタイプマッピングを上書きする
Prometheus命名規則に従っていないメトリクスがある場合、メトリクスタイプを示すnewrelic_metric_type
ラベル付きのメトリクスでリモート書き込みをタグに設定できます。このラベルは、New Relicによって受信されると無効になります。
例: my_counter
という名前のカウンターメトリクスがあります。これには、_bucket
, _count
または_total
という当社の命名規則のサフィックスがありません。この状況では、メトリクスはカウンターではなくゲージとして識別されます。これを修正するには、以下の再ラベル設定をprometheus.yml
に追加します。
- url: https://metric-api.newrelic.com/prometheus/v1/write?X-License-Key=... write_relabel_configs: - source_labels: [__name__] regex: ^my_counter$ target_label: newrelic_metric_type replacement: "counter" action: replace
このルールはmy_counter
という名前のメトリクスに一致し、そのメトリクスをカウンターとして識別するnewrelic_metric_type
ラベルを追加します。以下の(大文字と小文字を区別する)値を代替値として使用できます。
- counter
- ゲージ
- 概要
newrelic_metric_type
ラベルが受け取ったメトリクス上にあり、有効な値の1つに設定されている場合、New Relicは、データパイプライン内のダウンストリーム消費前に、示されたタイプをメトリクスに割り当てます(また、ラベルを無効化します)。上記の命名規則に従わない複数のメトリクスがある場合、複数の規則を追加でき、各規則は様々なソースラベルに一致させます。
リモート書込みの動作をカスタマイズする
New Relicで複数のアカウントに書き込みを行っている場合、または複数のPrometheusデータソースをNew Relicの同じアカウントに接続している場合、以下のパラメーターをカスタマイズできます。詳細については、リモート書き込みチューニングに関するドキュメントを参照してください。
エラーメッセージのトラブルシューティング
New Relicからインテグレーションのエラーメッセージを受信、またはPrometheusサーバーの再起動後にPrometheusサーバーログでエラーメッセージを受信した場合、リモート書き込みのトラブルシューティング ドキュメントを確認してください。これには、欠落した文字や不正な文字、不正なリクエスト、長すぎるリクエストエンティティ、レート制限エラーなど、一般的なエラーの修正方法が含まれています。
インテグレーションを削除する
Prometheusリモート書き込みインテグレーションを削除すると、新規データのフローが停止しますが、過去データのパージや削除は行われません。インテグレーションを削除するには、Prometheus YMLファイルから設定コードスニペットを削除してから、サーバーを再起動します。
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:
- Explorers Hubを参照して、コミュニティから支援を受け、ディスカッションに参加してください。
- 当社のサイトで回答を見つけ、サポートポータルの使用方法について学びます。
- Linux、Windows、およびmacOSのトラブルシューティングツールであるNew Relic Diagnosticsを実行します。
- New Relicのデータセキュリティとライセンスドキュメントを見直してください。