New Relic の Metric API は、様々なソースから メトリクスデータ を New Relic に送信するために使用できます。この API は、いくつかの統合やエクスポーターからのメトリクスを New Relic に取り込むためのものです。
Metric API を試してみませんか？ New Relic アカウントを作成 無料でご利用いただけます。クレジットカードは必要ありません。
Metric APIとは何ですか？
Metric API は、メトリックデータを New Relic に取り込むための手段です。この API は、メトリックデータを含む JSON ペイロードを持った POST リクエストを私たちの HTTP エンドポイントに送信することで動作します。
Metric API は、 インテグレーション や、 オープンソース エクスポーター （DropWizard や Prometheus など）からメトリクスを取り込むためのものです。Metric API は、 Telemetry SDKs でも使用されています。これは、私たちのデータ取り込み API の使用を容易にする言語固有のツールです。
Metric APIは以下のように使用できます。
- New Relic のエージェントを使用せずに、メトリックデータを New Relic に報告します。
- オープンソースまたは自社開発のツール、ライブラリ、フレームワークからメトリックデータを統合する。
- 解像度や関連する寸法など、送信するメトリックデータを完全にコントロールすることができます。
- NRQL 、New Relic のクエリ言語の力を活用して、 メトリックデータ を照会します。
- Set up Alert for your metric data.
要件
TCPポート443のアウトバウンド接続が、地域に一致するCIDR範囲に使用できることを確認します。推奨される設定方法は、DNS名metric-api.newrelic.comまたはmetric-api.eu.newrelic.comを使用することです。
データを送信する New Relic アカウントには New Relic が必要です。 制限と制限された属性の詳細については、 「メトリクスAPI要件と制限」を参照してください。
始めましょう
お客様のメトリクス・レポーティングのニーズを満たす既存の インテグレーションやクイックスタート がない場合、2つのオプションがあります。
- Telemetry SDKをご利用ください これは言語ごとに用意されたツールで、メトリクスやその他のデータを当社に送信するのに役立ちます。
- Metric API を直接使用する.
データを探す、使う
Metric APIを介して送信されたデータ（このAPIを使用しているインテグレーションからのデータも含む）は、これらの場所で見ることができます。
one.newrelic.comからExplorerを選択し、サービスを探します。
Metricデータ型を照会する。たとえば、 NRQLを使用して以下を実行できます。SELECT * FROM Metricクエリの詳細については、 Metric query examples を参照してください。一般的なクエリーについては、 クエリーデータ を参照してください。
メートル法データのアラート
メトリクスAPIで作成されたメトリクスを集計するには、 NRQLアラート条件を使用します。条件を定義するときにNRQLカテゴリを選択し、FROM Metric ... NRQLクエリ構文を使用して条件を表現します。 これらのアラート条件を作成すると、 、利用可能な最も細かい粒度のデータ (生のメトリックス データ ポイント) を自動的に使用してアラートを評価します。
データ保持
すべての生のメトリックデータポイントは、30日間保持されます。生のメトリックデータポイントから派生したすべての追加集計データ（例えば、1分間のロールアップ）は、13ヶ月間保持されます。これらの期間を超えて保存期間を変更すると、お客様に料金が発生する場合があります。
トラブルシューティング
NrIntegrationErrorイベントのトラブルシューティングを参照してください。