• /
  • ログイン
  • 無料アカウント

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

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

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

  • 最大限の制限
  • 制限された属性

最大限の制限

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

条件

リミット

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

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

最大データポイント/分(DPM)

参照 追加のアカウント条件.

1百万DPM

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

参照 追加のアカウント条件.

100万

タイムスケールは、メトリック名と任意の属性を組み合わせた単一のユニークなものです。

メトリック名ごとの1日あたりの最大ユニークタイムスケール(カーディナリティ

100k

最大ペイロード数/分

100k

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

100

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

255文字

属性キーの最大文字数

255文字

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

4096文字

許可されるHTTPプロトコル

HTTPSのみ

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

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

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

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

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

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

ペイロードサイズ

合計最大サイズまたは長さ: 投稿ごとに最大1MB (10^6バイト)。圧縮の使用を強く推奨します。

ペイロードフォーマット

ペイロードは、 UTF-8 でエンコードされている必要があります。

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

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

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

条件

リミット

5分間隔でのアカウントごとの最大ユニークカウントおよびサマリー時系列(カーディナリティ

参照 追加のアカウント条件.

100万

タイムスケールは、メトリック名と任意の属性を組み合わせた単一のユニークなものです。この制限を超えて受信したタイムスケールは削除されます。この制限は、標準的なメトリックの制限に先立って、またそれに加えて適用されます。

追加アカウント条件

Metric APIの制限は、個々のアカウントレベルで適用されます。試用版および有料版のアカウントには、試用目的で1M DPMおよび1Mカーディナリティの制限が適用されますが、アカウントに対して最大15M DPMおよび15Mカーディナリティを要求することができます。メトリックレート制限の変更をリクエストするには、New Relic のアカウント担当者にお問い合わせいただくか、 サポートポータル にアクセスしてください。

レートリミット違反

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

制限された属性

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

属性

説明

newrelic.source

値にリセットされます。 metricAPI.

metricName

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

endTimestamp

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

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

属性

説明

entity.guid

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

entity.name

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

entity.type

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

追加の制限があります。

制限

コメント

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

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

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

例アトリビュートとして使用されているメトリック値(無効)

[
  {
    "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"
        }
      }
    ]
  }
]

予約語

Metric API は New Relic Insights から accountID, appId, eventType など、いくつかの 予約語を継承しています。さらに、NRQL の構文用語は、バックティック (``) しないと制限されます。完全なリストは、 Reserved words を参照してください。NRQL の構文用語 を参照してください。

メートル法のJSON内のキー

メトリックのJSON内で使用されるすべてのキーは、属性キーではありません。これには interval.ms, timestamp, value, common, min, max, count, sum, metrics が含まれます。

例外: 名前 を属性キーとして使用することができます。

問題を作成する
Copyright © 2022 New Relic Inc.