New Relic Ingestアクション

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。

この機能は現在、弊社のプレリリースポリシーに従ってプレビュープログラムの一部として提供されています。

このページでは、ワークフロー自動化アクションカタログで使用できる New Relic 取り込みアクションの包括的なリファレンスを提供します。これらのアクションにより、イベントとログを New Relic に送信できるようになります。

前提条件

ワークフロー自動化で New Relic アクションを使用する前に、次の点を確認してください。

適切な権限を持つ New Relic アカウント。
New Relicライセンスキー (データを別のアカウントに送信する場合)。
使用を計画している特定の New Relic サービスに必要な権限。

New Relicアカウントのライセンスキーの作成および管理方法については、「ライセンスキー」を参照してください。

データ取り込みアクション

カスタムイベントをNew Relicに報告します。

入力フィールド	オプション性	タイプ	説明	例
属性	オプション	地図	提供される場合、すべてのイベントの一部となる共通属性。必要なイベント項目が共通定義をオーバーライドする場合、各イベント項目をマージします。	`"{\"page\": \"1\", \"limit\": \"10\"}"`
イベント	必須	リスト	イベントデータのリスト。重要イベントでは、カスタムイベントタイプを表す`eventType`フィールドを使用する必要があります。リクエストごとに許可されるイベントの最大数は100です。	`"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
ライセンスキー	オプション	弦	New Relicアカウントライセンスキー(必須) は、イベントの対象アカウントを指定します。指定しない場合、システムはワークフローを実行しているアカウントのデフォルトのライセンスキーを使用します。 New Relicアカウントのライセンスキーを作成および管理するためのAPI キーについて詳しくお読みください。	`"{{ .secrets.secretName }}"` ここで、 `secretName` はライセンスキーが保存されているキーです。
セレクター	オプション	リスト	指定されたもののみを出力として取得するセレクター。	`[{\"name\": \"success\", \"expression\": \".success\"}]`

出力フィールド	タイプ
成功	ブール値
エラーメッセージ	ストリング

ワークフローの例
name: heartbeat_newrelicIngestSendEvents workflowInputs: cellName: type: String steps: - name: runAction type: action action: newrelic.ingest.sendEvents version: 1 inputs: attributes: colour: red id: 1234 events: - eventType: HeartBeat test: "OK" attributes: foo: bar - eventType: HeartBeat1234 test: "OK1234" attributes: foo: bar - eventType: HeartBeat12345 test: "OK12345" attributes: foo: bar colour: yellow - eventType: HeartBeat12345678 test: "OK12345678" selectors: - name: success expression: ".success" 期待される出力: `{ "success": true }` イベントを取得: ワークフローを正常に実行した後、ワークフローを実行したアカウントでクエリを実行して、関連付けられたイベントを取得できます。 `SELECT * FROM HeartBeat`

ワークフローの例

name: heartbeat_newrelicIngestSendEvents

workflowInputs:
cellName:
  type: String

steps:
- name: runAction
  type: action
  action: newrelic.ingest.sendEvents
  version: 1
  inputs:
    attributes:
      colour: red
      id: 1234
    events:
      - eventType: HeartBeat
        test: "OK"
        attributes:
          foo: bar
      - eventType: HeartBeat1234
        test: "OK1234"
        attributes:
          foo: bar
      - eventType: HeartBeat12345
        test: "OK12345"
        attributes:
          foo: bar
          colour: yellow
      - eventType: HeartBeat12345678
        test: "OK12345678"
    selectors:
      - name: success
        expression: ".success"

期待される出力:

{
  "success": true
}

イベントを取得:

ワークフローを正常に実行した後、ワークフローを実行したアカウントでクエリを実行して、関連付けられたイベントを取得できます。

SELECT * FROM HeartBeat

New Relicへのログ送信

入力フィールド	オプション性	タイプ	説明	例
属性	オプション	地図	共通属性は、提供される場合、すべてのログに含まれます。これらは各ログ項目と結合され、競合が発生した場合にはログ固有の値が共通属性を上書きします。	`"{\"page\": \"1\", \"limit\": \"10\"}"`
ログ	必須	リスト	ログのリスト。各ログには `message` フィールドが必要です。リクエストごとに最大 100 ログ。	`"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
ライセンスキー	オプション	弦	New Relicアカウントライセンスキー(必須) は、イベントの対象アカウントを指定します。指定しない場合、システムはワークフローを実行しているアカウントのデフォルトのライセンスキーを使用します。 New Relicアカウントのライセンスキーを作成および管理するためのAPI キーについて詳しくお読みください。	`"{{ .secrets.secretName }}"` ここで、 `secretName` はライセンスキーが保存されているキーです。
セレクター	オプション	リスト	指定されたもののみを出力として取得するセレクター。

出力フィールド	タイプ
成功	ブール値
エラーメッセージ	ストリング

ワークフローの例
`name: heartbeat_newrelicIngestSendLogs workflowInputs: cellName: type: String steps: - name: runAction type: action action: newrelic.ingest.sendLogs version: 1 inputs: attributes: colour: red id: 1234 logs: - message: 'Heartbeat sendLogs Action Test Message' attributes: foo: bar - message: 'HeartBeat1234' attributes: foo: bar - message: 'HeartBeat12345' attributes: foo: bar colour: yellow - message: 'HeartBeat12345678' selectors: - name: success expression: ".success"` 期待される出力: `{ "success": true }` ログを取得: ワークフローを正常に実行した後、ワークフローを実行したアカウントでクエリを実行して、関連するログを取得できます。 `SELECT * FROM Log`

ワークフローの例

name: heartbeat_newrelicIngestSendLogs

workflowInputs:
cellName:
  type: String

steps:
- name: runAction
  type: action
  action: newrelic.ingest.sendLogs
  version: 1
  inputs:
    attributes:
      colour: red
      id: 1234
    logs:
      - message: 'Heartbeat sendLogs Action Test Message'
        attributes:
          foo: bar
      - message: 'HeartBeat1234'
        attributes:
          foo: bar
      - message: 'HeartBeat12345'
        attributes:
          foo: bar
          colour: yellow
      - message: 'HeartBeat12345678'
    selectors:
      - name: success
        expression: ".success"

期待される出力:

{
  "success": true
}

ログを取得:

ワークフローを正常に実行した後、ワークフローを実行したアカウントでクエリを実行して、関連するログを取得できます。

SELECT * FROM Log

入力フィールド	オプション性	タイプ	例
メトリックス	必須	リスト	`[ { "name": "service.errors.all", "type": "count", "value": 9, "attributes": { "service.response.statuscode": "400" } }, { "name": "service.errors.all", "type": "gauge", "value": 4, "attributes": { "service.response.statuscode": "500" } }, { "name": "service.response.duration", "type": "summary", "value": { "count": 5, "sum": 0.004382655, "min": 0.0005093, "max": 0.001708826 }, "attributes": { "service.response.statuscode": "200" } } ]`
属性	オプション	地図	`{ "timestamp": 1531414060739, "interval.ms": 10000, "attributes": { "app.name": "foo", "host.name": "dev.server.com" } }`
ライセンスキー	オプション	弦	New Relicアカウントライセンスキー(必須) は、イベントの対象アカウントを指定します。指定しない場合、システムはワークフローを実行しているアカウントのデフォルトのライセンスキーを使用します。 New Relicアカウントのライセンスキーを作成および管理するためのAPI キーについて詳しくお読みください。 `"{{ .secrets.secretName }}"`ここで、 `secretName`はライセンスキーが保存されているキーです。
セレクター	オプション	リスト	`[{"name": "error", "expression": ".errorMessage"}]`

必要なキーの値のペア metrics

metricsリスト内の各メトリクスデータポイントマップは、次のキーの値構造を使用します。

属性	タイプ	オプション性	説明
name	弦	必須	メトリクスの名前。値は 255 文字未満にする必要があります。
value	数字または地図	必須	値はメトリクスのタイプによって異なります。 `gauge` および `count` の場合、値は単一の数値である必要があります。 `summary` の場合、値は、カウント、合計、最小値、最大値を指定するキー値のペアを含むマップである必要があります。
タイムスタンプ	ロング	オプション	Unix 時間でのメトリクスの開始時刻。デフォルトでは UTC タイムゾーンが使用されます。このフィールドは、秒、マイクロ秒、ナノ秒もサポートします。ただし、データは保存およびクエリのためにミリ秒単位に変換されます。メトリクスは、タイムスタンプが報告されてから過去 48 時間以上、または今後 24 時間以上経過した場合に削除されます。
インターバル.ms	正のロング	`count` および `summary` メトリクスタイプには必須です。	時間ウィンドウの長さ。
タイプ		推奨	`count` 、 `gauge` 、 `summary` のみをサポートします。詳細については、サポートされているメトリクスタイプを参照してください。タイプを指定しない場合は、デフォルトで `gauge` になります。
属性	文字列、JSON数値、またはブール値	推奨	この特定のメトリクスに関連付けられたキーの値ペアのマップ。値は文字列、JSON 数値、またはブール値にすることができます。キーは大文字と小文字が区別され、255 文字未満にする必要があります。

重要

API 、 timestampが必須です。アクション内では、 timestampはオプションであり、メトリクスの取り込み前に指定されていない場合はデフォルトで現在の時刻に設定されます。

メトリック間で属性を共有する common

複数のメトリクスに一連のプロパティを含める（各メトリクスに同じプロパティを追加しない）場合は、 commonブロックを使用できます。これは、関連するすべてのメトリクスデータポイントに適用される情報を指定するオプションのマップです。同じキーがメトリクスデータポイントに存在する場合、 commonセクションの値は上書きされます。

ブロックを含むことができます。

属性	タイプ	オプション性	説明
タイムスタンプ	ロング		メトリックの開始時刻を Unix時間で表したものです。デフォルトでは、UTCタイムゾーンの現在の時刻になります。このフィールドは、秒、マイクロ秒、およびナノ秒もサポートしています。ただし、データは保存や後のクエリのためにミリ秒に変換されます。
インターバル.ms	正のロング	`count` および `summary`	時間ウィンドウの長さ。
属性	文字列、JSON数値、またはブール値		この特定のメトリックに関連するキーと値のペアのマップ。値には、文字列、JSONの数値、またはブーリアンを使用できます。

属性

タイプ

オプション性

説明

タイムスタンプ

ロング

メトリックの開始時刻を

Unix時間

で表したものです。デフォルトでは、UTCタイムゾーンの現在の時刻になります。このフィールドは、秒、マイクロ秒、およびナノ秒もサポートしています。ただし、データは保存や後のクエリのためにミリ秒に変換されます。

インターバル.ms

正のロング

count

および

summary

時間ウィンドウの長さ。

属性

文字列、JSON数値、またはブール値

この特定のメトリックに関連するキーと値のペアのマップ。値には、文字列、JSONの数値、またはブーリアンを使用できます。

出力フィールド	タイプ	例
requestId	弦	`13325ef9-0001-b193-510f-019ba20b0792`
成功	ブール値	`success: true \| false`
エラーメッセージ	弦	`Failure reason as message.`

ワークフローの例
`- name: sendMetrics type: action action: newrelic.ingest.sendMetrics version: 1 inputs: metrics: - name: service.errors.all type: count value: 9 timestamp: 1531414060739 attributes: service.response.statuscode: 400 - name: service.response.duration type: guage value: 4 timestamp: 1531414060733 attributes: service.response.statuscode: 500`

ワークフローの例

- name: sendMetrics
    type: action
    action: newrelic.ingest.sendMetrics
    version: 1
    inputs:
      metrics:
        - name: service.errors.all
          type: count
          value: 9
          timestamp: 1531414060739
          attributes:
            service.response.statuscode: 400
        - name: service.response.duration
          type: guage
          value: 4
          timestamp: 1531414060733
          attributes:
            service.response.statuscode: 500

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

プレビュー

前提条件

データ取り込みアクション

New Relicにカスタムイベントを送信する

重要

New Relicへのログ送信

New Relic にメトリクスを送信する

重要

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

New Relic Ingestアクション

プレビュー

前提条件.css-21sua1{background:none;border:none;width:0;padding:0;}

データ取り込みアクション

New Relicへのログ送信

New Relic にメトリクスを送信する

前提条件