• /
  • EnglishEspañolFrançais日本語한국어Português
  • ログイン今すぐ開始

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

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

問題を作成する

メトリックAPIの制限と制限された属性

本ドキュメントでは、 メトリック API のデータ要件について説明しています。

  • 最大限の制限
  • 制限された属性
  • 制限されたメトリック値

最大限の制限

すべてのMetricデータには、以下のデフォルトリミットが適用されます。

条件

制限

タイムスタンプ値の年齢範囲

報告されたタイムスタンプが48時間前よりも古い、または報告された時点から24時間よりも新しいメトリクスは削除されます。

1 日あたりアカウントあたりの最大ユニーク時系列数 (カーディナリティ)

1〜1500万(詳細)

時系列は、メトリック名と任意の属性の単一の一意の組み合わせです。

メトリクス名ごとの 1 日あたりの最大ユニーク時系列数 (カーディナリティ)

100k

最大ペイロード数/分

100k (詳細)

メトリクスごとの最大アトリビュート

150

最大のメトリック属性名の長さ

255文字

属性キーの最大文字数

255文字

最大メトリック属性値の長さ

4096文字

許可されるHTTPプロトコル

HTTPSのみ

Javaの長さの最小値または最大値から外れる数値の長さ

長さの数値が、Javaの長さの最小値または最大値から外れている場合は、拒否されます。

  • その番号が共通ブロックにある場合は、そのブロック全体が落とされます。
  • 数値がメートル法のデータポイントにある場合、その数値が存在するメートル法のデータポイントは削除されます。

Javaのダブル値の最小値または最大値から外れる数値のダブル値

Javaのダブル値の最小値または最大値から外れた数値のダブル値は拒否されます。

  • その番号が共通ブロックにある場合は、そのブロック全体が落とされます。
  • 数値がメートル法のデータポイントにある場合、その数値が存在するメートル法のデータポイントは削除されます。

倍精度浮動小数点数に変換するために丸めが必要な double 数値。

倍精度浮動小数点数に変換するために丸めが必要な double 数値は拒否されます。

この例は、 1.12345678901234567E18です。double にはこれほど大きな値を含めることができますが、それを正確に表現するには十分な精度がありません ( 1.12345678901234573E18に丸める必要があります)。

  • その番号が共通ブロックにある場合は、そのブロック全体が落とされます。
  • 数値がメートル法のデータポイントにある場合、その数値が存在するメートル法のデータポイントは削除されます。

ペイロードサイズ

合計最大サイズまたは長さ: 1MB (10^6 bytes) maximum per POST 。 圧縮を使用することを強くお勧めします。

ペイロードフォーマット

ペイロードはUTF-8としてエンコードする必要があります。

アトリビュートネーミングシンタックス

属性名は、英数字、コロン( : )、ピリオド( . )、およびアンダースコア( _ )の組み合わせにすることができます。

以下のデフォルトリミットは、Prometheus Remote Writeインテグレーションを介して収集されたデータにのみ適用されます。

条件

制限

5 分間隔ごとのアカウントあたりの最大ユニークカウントとサマリー時系列 (カーディナリティ)

1〜1500万(詳細)

時系列は、メトリック名と任意の属性の単一の一意の組み合わせです。 この制限を超えて受信された時系列は削除されます。 この制限は、標準のメトリック制限に先行して追加で適用されます。

追加アカウント条件

メトリクスAPIの制限は、個別のアカウントレベルで適用されます。デフォルトのカーディナリティ制限は、無料エディションの組織向けの3Mから、一部の有料組織向けの最大10.2Mまでの範囲です。組織の制限を理解するには、制限 UIを参照してください。有料の組織は、リクエストに応じてカーディナリティを15Mまで増やすことができます。1分あたりの最大ペイロード数は、個別に100k以上に調整できます。メトリクスレート制限の変更をご希望の場合は、New Relicのアカウント担当者にご連絡いただくか、サポートポータルをご覧ください。

レート制限インシデント

ここでは、レートの制限を超えたときのMetric APIの動作と、制限を超えた場合の対応について説明します。

制限された属性

これらの属性は、New Relic プラットフォームによって制限されています。メトリックデータポイントの属性セクションでこれらのキーを使用して送信された値は、データポイントが削除されるか、値が省略または上書きされます。

属性

説明

newrelic.source

これにより、値metricAPIにリセットされます。

metricName

これは、各データポイントに渡されたname値にリセットされます。これにより、 nameを属性キーにすることができます。

endTimestamp

timestamp interval.msはデータポイントのendTimestampに変換されます。

これらの属性は、エンティティを識別するために内部的に使用されます。メトリック・データ・ポイントの属性セクションでこれらのキーを使用して送信された値は、UIにエンティティが表示されなかったり、遠隔測定が期待したエンティティに関連付けられなかったりするなど、未定義の動作を引き起こす可能性があります。詳細については、 Entity synthesis を参照してください。

属性

説明

entity.guid

New Relic がエンティティに割り当てる一意の識別子。

entity.name

エンティティの人間が読める名前で、UIでエンティティを識別するためによく使われます。

entity.type

ホストやアプリケーションなど、異なるタイプのエンティティを区別するために使用されます。

追加の制限があります。

制限

コメントコメント

メトリクスおよびアトリビュート名

メトリック名と属性名に同じ値を渡すことはできません。

次の例では、メトリックの名前がservice.errors.allで、属性service.errors.allがあるため、メトリックは無効です。

Example: Metric value used as an attribute (invalid)

[
{
"metrics": [
{
"name": "service.errors.all",
"type": "count",
"value": 15,
"timestamp": 1531414060739,
"interval.ms": 10000,
"attributes": {
"service.response.statuscode": "400",
"service.errors.all": "test",
"service.name": "foo"
}
}
]
}
]

予約語

accountIdappIdeventTypeなどの予約語の使用は避けてください。 また、バックティック ( `` ) を使用しない限り、NRQL 構文用語の使用は避けてください。

メートル法のJSON内のキー

メトリックJSON内で使用されるすべてのキーを属性キーにすることはできません。これには、 interval.mstimestampvaluecommonminmaxcountsum 、およびmetricsが含まれます。

Exception: name属性キーとして使用できます。

制限されたメトリック値

valueNaN (数値ではない)、positive infinity、または negative infinity に等しいメトリクスAPIに送信されたメトリクス データはすべて削除されます。 非有限値の場合、 NrIntegrationErrorイベントが発生する可能性があります。

Copyright © 2026 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.