New Relic NerdGraphアクション

このページでは、ワークフロー自動化アクションカタログで利用可能なNew Relic NerdGraphアクションのリファレンスを提供します。これらのアクションを使用すると、NerdGraphのクエリとミューテーションを実行できます。

前提条件

ワークフロー自動化でNew Relic NerdGraphアクションを使用する前に、以下の準備が整っていることを確認してください：

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

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

NerdGraphリクエストを実行する

アクション識別子はnewrelic.nerdgraph.executeです。

New Relic NerdGraph APIに対してGraphQLコマンドを実行します。コマンドはクエリまたはミューテーションのいずれかです。

次の表は、このアクションで利用可能なすべての入力フィールドについて説明しています。

入力	タイプ	説明	例
グラフQL	弦	必須。 GraphQLステートメント。コマンドを構築してテストするには、 GraphiQL を使用してください。
変数	Map[string]any	必須。 GraphQLステートメントで使用する任意のキーの値のペアの変数。
selectors	リスト	オプション。指定されたパラメーターのみを出力として取得するためのセレクター。	`steps: - name: findingVar type: action action: newrelic.nerdgraph.execute version: 1 inputs: graphql: \| query GetEntity($entityGuid: EntityGuid!) { actor { entity(guid: $entityGuid) { alertSeverity } } } variables: entityGuid: ${{ .workflowInputs.entityGuid }} - name: findingInline type: action action: newrelic.nerdgraph.execute version: 1 inputs: graphql: \| { actor { entity(guid: "${{ .workflowInputs.entityGuid }}") { alertSeverity } } } selectors: - name: entities expression: '.data'`

入力

タイプ

説明

例

グラフQL

弦

必須。

GraphQLステートメント。コマンドを構築してテストするには、

GraphiQL

を使用してください。

変数

Map[string]any

必須。

GraphQLステートメントで使用する任意のキーの値のペアの変数。

selectors

リスト

オプション。

指定されたパラメーターのみを出力として取得するためのセレクター。

steps:
  - name: findingVar
    type: action
    action: newrelic.nerdgraph.execute
    version: 1
    inputs:
      graphql: |
        query GetEntity($entityGuid: EntityGuid!) {
          actor {
            entity(guid: $entityGuid) {
              alertSeverity
            }
          }
        }
      variables:
        entityGuid: ${{ .workflowInputs.entityGuid }}
  - name: findingInline
    type: action
    action: newrelic.nerdgraph.execute
    version: 1
    inputs:
      graphql: |
        {
          actor {
            entity(guid: "${{ .workflowInputs.entityGuid }}") {
              alertSeverity
            }
          }
        }
      selectors:
        - name: entities
          expression: '.data'

次の表は、このアクションによって返されるすべての出力フィールドについて説明しています。

出力	タイプ	説明
データ	`Map[string]any`	NerdGraph 応答の `data` プロパティの内容。
success	ブール値	リクエストのステータス。
errorMessage	弦	失敗の理由をメッセージとして表示します。

出力

タイプ

説明

データ

Map[string]any

NerdGraph 応答の

data

プロパティの内容。

success

ブール値

リクエストのステータス。

errorMessage

弦

失敗の理由をメッセージとして表示します。

以下の例では、NerdGraphクエリを実行して現在のユーザーIDを取得し、その結果をログに記録します。

ワークフローの例
`steps: - name: currentUserId type: action action: newrelic.nerdgraph.execute version: 1 inputs: graphql: \| query userId { currentUser { id } } - name: logResult type: action action: newrelic.ingest.sendLogs version: 1 inputs: logs: - message: "userId: ${{ .steps.currentUserId.outputs.data.currentUser.id }}"`

ワークフローの例

steps:
  - name: currentUserId
    type: action
    action: newrelic.nerdgraph.execute
    version: 1
    inputs:
      graphql: |
        query userId {
          currentUser {
            id
          }
        }

  - name: logResult
    type: action
    action: newrelic.ingest.sendLogs
    version: 1
    inputs:
      logs:
        - message: "userId: ${{ .steps.currentUserId.outputs.data.currentUser.id }}"

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

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

NerdGraphリクエストを実行する

前提条件