New Relicにメトリクスデータポイントを送信します。
前提条件については、New Relic Ingestアクションを参照してください。
New Relic にメトリクスを送信する
アクション識別子はnewrelic.ingest.sendMetricsです。
メトリクスをNew Relicに送信します。
次の表は、このアクションで利用可能なすべての入力フィールドについて説明しています。
入力 | タイプ | 説明 | 例 |
|---|---|---|---|
メトリックス | リスト | 必須。 メトリクスデータポイントのリスト。各項目の想定される構造については、「 」をご覧ください。 |
|
属性 | 地図 | オプション。 すべてのメトリクスに適用する共通属性。詳細については、「 」をご覧ください。 |
|
ライセンスキー | 弦 | オプション。New Relicアカウントのライセンスキーは、イベントのターゲットアカウントを指定します。提供されない場合、システムはワークフローを実行しているアカウントのデフォルトのライセンスキーを使用します。 New Relicアカウントのライセンスキーを作成および管理するには、APIキーの詳細をご覧ください。 認証情報をプレーンテキストで入力しないでください。例に示されているシークレットの構文を使用してください。 |
|
selectors | リスト | オプション。 指定されたパラメーターのみを出力として取得するためのセレクター。 |
|
必要なキーの値のペア metrics
metricsリスト内の各メトリクス データ ポイント マップは、次のキーの値構造を使用します。
属性 | タイプ | 説明 |
|---|---|---|
name | 弦 | 必須。 メトリクス名。値は255文字未満である必要があります。 |
value | 数字または地図 | 必須。 値は によって異なります。
と
の場合、値は単一の数値である必要があります。
の場合、値はカウント、合計、最小値、最大値を指定するキーの値のペアを持つマップである必要があります。 |
タイムスタンプ | ロング | オプション。 でのメトリクスの開始時間です。デフォルトではUTCタイムゾーンを使用します。このフィールドは、秒、マイクロ秒、ナノ秒もサポートしています。ただし、データは保存およびクエリのためにミリ秒に変換されます。報告された時点から48時間以上過去、または24時間以上未来のタイムスタンプを持つメトリクスは破棄されます。 |
インターバル.ms | 正のロング |
および
では 必須 です。タイムウィンドウの長さです。 |
type | 弦 | 推奨。
、
、
のみをサポートします。詳細については、 をご覧ください。タイプを指定しない場合、デフォルトで
になります。 |
属性 | 文字列、JSON数値、またはブール値 | 推奨。 この特定のメトリクスに関連付けられたキーの値のペアのマップです。値には、文字列、JSONの数値、またはブール値を使用できます。キーは大文字と小文字が区別され、255文字未満である必要があります。 |
重要
API 、 timestampが必須です。 アクション内では、 timestampはオプションであり、メトリクスの取り込み前に指定されていない場合はデフォルトで現在の時刻に設定されます。
メトリック間で属性を共有する common
複数のメトリクスに一連のプロパティを含める(各メトリクスに同じプロパティを追加しない)場合は、 commonブロックを使用できます。 これは、関連するすべてのメトリクス データ ポイントに適用される情報を指定するオプションのマップです。 同じキーがメトリクス データ ポイントに存在する場合、 commonセクションの値は上書きされます。
ブロックを含むことができます。
属性 | タイプ | 説明 |
|---|---|---|
タイムスタンプ | ロング | メトリックの開始時刻を で表したものです。デフォルトでは、UTCタイムゾーンの現在の時刻になります。このフィールドは、秒、マイクロ秒、およびナノ秒もサポートしています。ただし、データは保存や後のクエリのためにミリ秒に変換されます。 |
インターバル.ms | 正のロング |
および
に 必須 です。タイムウィンドウの長さ。 |
属性 | 文字列、JSON数値、またはブール値 | この特定のメトリックに関連するキーと値のペアのマップ。値には、文字列、JSONの数値、またはブーリアンを使用できます。 |
次の表は、このアクションによって返されるすべての出力フィールドについて説明しています。
出力 | タイプ | 説明 |
|---|---|---|
requestId | 弦 | メトリクスAPIによって割り当てられたリクエスト識別子。例:
。 |
success | ブール値 |
成功時は、失敗時は
。 |
errorMessage | 弦 | メッセージとしての失敗理由。成功した場合は
。 |
次の例では、タイムスタンプとステータスコード属性を持つ2つのメトリクスデータポイント — カウントとゲージ — を送信します。
ワークフローの例 |
|---|
|