New Relic Issueアクション

このページでは、ワークフロー自動化アクションカタログで利用可能なすべてのNew Relic Issueアクションのリファレンスを提供します。これらのアクションを使用すると、集計インテリジェンスのIssueを承認、承認解除、および解決したり、Issueをクエリしてワークフローで条件付きロジックを有効にしたりできます。

前提条件

ワークフロー自動化でNew Relic Issueアクションを使用する前に、以下を確認してください：

集計インテリジェンスの問題を管理するための適切な権限を持つNew Relicアカウント。
使用を計画している特定の New Relic サービスに必要な権限。

イシューアクション

オープンなNew Relicイシュー（AI Issues）を承認し、ACKNOWLEDGEDとしてマークします。New Relicは、ミューテーションの副作用として、誰が承認したかとイシューレコード（acknowledgedBy / acknowledgedAt）のタイムスタンプを記録します。newrelic.nerdgraph.execute上に構築されています。

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

入力	オプション性	タイプ	説明	例
アカウントID	必須	Int	問題を所有するNew Relicアカウント。正の整数である必要があります。	`123456`
issueId	必須	弦	承認するAI Issuesのissue識別子。有効なUUIDである必要があります。	`"123e4567-e89b-12d3-a456-426614174000"`
selectors	オプション	リスト	レスポンスから特定の値を抽出するためのJQセレクター。	`selectors: - name: action expression: ".data.aiIssuesAckIssue.result.action"`

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

出力	タイプ	説明
success	ブール値	`true` ミューテーション自体のエラーフィールド（ `data.aiIssuesAckIssue.error` ）とは無関係に、ステップがHTTP/トランスポートエラーなしで実行された場合。
errorMessage	弦	呼び出しがHTTP/トランスポートレベルで失敗した場合にのみエラーメッセージが含まれます。これは `data.aiIssuesAckIssue.error` （ミューテーション独自のビジネスロジックエラーフィールド）とは異なります。成功時は `null` 。
データ	地図	NerdGraphレスポンス： `{ "data": { "aiIssuesAckIssue": { "error": null, "result": { "accountId": 123456, "action": "ACK", "issueId": "123e4567-e89b-12d3-a456-426614174000" } } } }` `data`から`error`、`action`、`issueId`、または`accountId`を抽出するには、`selectors`を使用します。

出力

タイプ

説明

success

ブール値

true

ミューテーション自体のエラーフィールド（

data.aiIssuesAckIssue.error

）とは無関係に、ステップがHTTP/トランスポートエラーなしで実行された場合。

errorMessage

弦

呼び出しがHTTP/トランスポートレベルで失敗した場合にのみエラーメッセージが含まれます。これは

data.aiIssuesAckIssue.error

（ミューテーション独自のビジネスロジックエラーフィールド）とは異なります。成功時は

null

。

データ

地図

NerdGraphレスポンス：

{
  "data": {
    "aiIssuesAckIssue": {
      "error": null,
      "result": {
        "accountId": 123456,
        "action": "ACK",
        "issueId": "123e4567-e89b-12d3-a456-426614174000"
      }
    }
  }
}

dataからerror、action、issueId、またはaccountIdを抽出するには、selectorsを使用します。

次の例では、このアクションの使用方法を示します。

ワークフローの例
`name: newrelic_issue_acknowledge_workflow description: acknowledge a newrelic issue steps: - name: newrelic_issue_acknowledge type: action action: newrelic.issue.acknowledge version: 1 inputs: accountId: 123456 issueId: "123e4567-e89b-12d3-a456-426614174000" next: end`

ワークフローの例

name: newrelic_issue_acknowledge_workflow
description: acknowledge a newrelic issue
steps:
  - name: newrelic_issue_acknowledge
    type: action
    action: newrelic.issue.acknowledge
    version: 1
    inputs:
      accountId: 123456
      issueId: "123e4567-e89b-12d3-a456-426614174000"
    next: end

以前に確認済みのNew Relicの問題（AI Issues）を未確認の状態に戻し、問題レコードのacknowledgedBy/acknowledgedAtフィールドをクリアします。newrelic.nerdgraph.execute上に構築されています。

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

入力	オプション性	タイプ	説明	例
アカウントID	必須	Int	問題を所有するNew Relicアカウント。正の整数である必要があります。	`123456`
issueId	必須	弦	未承認に戻すAI Issuesの課題識別子。有効なUUIDである必要があります。	`"123e4567-e89b-12d3-a456-426614174000"`
selectors	オプション	リスト	レスポンスから特定の値を抽出するためのJQセレクター。	`selectors: - name: action expression: ".data.aiIssuesUnackIssue.result.action"`

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

出力	タイプ	説明
success	ブール値	`true` ミューテーション自体のエラーフィールド（ `data.aiIssuesUnackIssue.error` ）とは無関係に、ステップがHTTP/トランスポートエラーなしで実行された場合。
errorMessage	弦	呼び出しがHTTP/トランスポートレベルで失敗した場合にのみエラーメッセージが含まれます。これは `data.aiIssuesUnackIssue.error` （ミューテーション独自のビジネスロジックエラーフィールド）とは異なります。成功時は `null` 。
データ	地図	NerdGraphレスポンス： `{ "data": { "aiIssuesUnackIssue": { "error": null, "result": { "accountId": 123456, "action": "UNACK", "issueId": "123e4567-e89b-12d3-a456-426614174000" } } } }` `data`から`error`、`action`、`issueId`、または`accountId`を抽出するには、`selectors`を使用します。

出力

タイプ

説明

success

ブール値

true

ミューテーション自体のエラーフィールド（

data.aiIssuesUnackIssue.error

）とは無関係に、ステップがHTTP/トランスポートエラーなしで実行された場合。

errorMessage

弦

呼び出しがHTTP/トランスポートレベルで失敗した場合にのみエラーメッセージが含まれます。これは

data.aiIssuesUnackIssue.error

（ミューテーション独自のビジネスロジックエラーフィールド）とは異なります。成功時は

null

。

データ

地図

NerdGraphレスポンス：

{
  "data": {
    "aiIssuesUnackIssue": {
      "error": null,
      "result": {
        "accountId": 123456,
        "action": "UNACK",
        "issueId": "123e4567-e89b-12d3-a456-426614174000"
      }
    }
  }
}

dataからerror、action、issueId、またはaccountIdを抽出するには、selectorsを使用します。

次の例では、このアクションの使用方法を示します。

ワークフローの例
`name: newrelic_issue_unacknowledge_workflow description: revert an acknowledged newrelic issue steps: - name: newrelic_issue_unacknowledge type: action action: newrelic.issue.unacknowledge version: 1 inputs: accountId: 123456 issueId: "123e4567-e89b-12d3-a456-426614174000" next: end`

ワークフローの例

name: newrelic_issue_unacknowledge_workflow
description: revert an acknowledged newrelic issue
steps:
  - name: newrelic_issue_unacknowledge
    type: action
    action: newrelic.issue.unacknowledge
    version: 1
    inputs:
      accountId: 123456
      issueId: "123e4567-e89b-12d3-a456-426614174000"
    next: end

オープンなNew Relicのイシュー（AI Issues）を解決し、修復手順が完了した時点でクローズします。イシューの状態はCLOSEDに移行し、New Relicはイシューレコードに解決を記録します。newrelic.nerdgraph.executeで構築されています。

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

入力	オプション性	タイプ	説明	例
アカウントID	必須	Int	問題を所有するNew Relicアカウント。正の整数である必要があります。	`123456`
issueId	必須	弦	解決するAI Issuesの課題識別子。有効なUUIDである必要があります。	`"123e4567-e89b-12d3-a456-426614174000"`
selectors	オプション	リスト	レスポンスから特定の値を抽出するためのJQセレクター。	`selectors: - name: action expression: ".data.aiIssuesResolveIssue.result.action"`

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

出力	タイプ	説明
success	ブール値	`true` ミューテーション自体のエラーフィールド（ `data.aiIssuesResolveIssue.error` ）とは無関係に、ステップがHTTP/トランスポートエラーなしで実行された場合。
errorMessage	弦	呼び出しがHTTP/トランスポートレベルで失敗した場合にのみエラーメッセージが含まれます。これは `data.aiIssuesResolveIssue.error` （ミューテーション独自のビジネスロジックエラーフィールド）とは異なります。成功時は `null` 。
データ	地図	NerdGraphレスポンス： `{ "data": { "aiIssuesResolveIssue": { "error": null, "result": { "accountId": 123456, "action": "RESOLVE", "issueId": "123e4567-e89b-12d3-a456-426614174000" } } } }` `data`から`error`、`action`、`issueId`、または`accountId`を抽出するには、`selectors`を使用します。

出力

タイプ

説明

success

ブール値

true

ミューテーション自体のエラーフィールド（

data.aiIssuesResolveIssue.error

）とは無関係に、ステップがHTTP/トランスポートエラーなしで実行された場合。

errorMessage

弦

呼び出しがHTTP/トランスポートレベルで失敗した場合にのみエラーメッセージが含まれます。これは

data.aiIssuesResolveIssue.error

（ミューテーション独自のビジネスロジックエラーフィールド）とは異なります。成功時は

null

。

データ

地図

NerdGraphレスポンス：

{
  "data": {
    "aiIssuesResolveIssue": {
      "error": null,
      "result": {
        "accountId": 123456,
        "action": "RESOLVE",
        "issueId": "123e4567-e89b-12d3-a456-426614174000"
      }
    }
  }
}

dataからerror、action、issueId、またはaccountIdを抽出するには、selectorsを使用します。

次の例では、このアクションの使用方法を示します。

ワークフローの例
`name: newrelic_issue_resolve_workflow description: resolve a newrelic issue steps: - name: newrelic_issue_resolve type: action action: newrelic.issue.resolve version: 1 inputs: accountId: 123456 issueId: "123e4567-e89b-12d3-a456-426614174000" next: end`

ワークフローの例

name: newrelic_issue_resolve_workflow
description: resolve a newrelic issue
steps:
  - name: newrelic_issue_resolve
    type: action
    action: newrelic.issue.resolve
    version: 1
    inputs:
      accountId: 123456
      issueId: "123e4567-e89b-12d3-a456-426614174000"
    next: end

アカウントのNew Relicの問題（AI Issues）をクエリして一覧表示し、アクティブな問題または過去の問題のリアルタイムのステータス、タイムライン、相関エンティティ、および影響の詳細を返します。状態、優先度、ソース、エンティティ、条件、ポリシー、相関および承認ステータス、時間枠、およびカーソルベースのページネーションによるフィルタリングをサポートします。newrelic.nerdgraph.execute上に構築されています。

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

入力	オプション性	タイプ	説明	例
アカウントID	必須	Int	issueを一覧表示するNew Relicアカウント。正の整数である必要があります。	`123456`
issueIds	オプション	リスト	含めるIssue ID。UUID文字列のJSON配列である必要があります。	`["123e4567-e89b-12d3-a456-426614174000"]`
状態	オプション	リスト	`ACTIVATED` 、 `CLOSED` 、 `CREATED` 、 `DEACTIVATED` の1つ以上。	`["ACTIVATED", "CREATED"]`
プライオリティ	オプション	リスト	`CRITICAL` 、 `HIGH` 、 `MEDIUM` 、 `LOW` の1つ以上。	`["CRITICAL", "HIGH"]`
ソース	オプション	リスト	`newrelic` （New Relicのアラートエンジンによって発生）または `rest` （REST APIを介して外部で作成）の1つ以上。	`["newrelic"]`
エンティティガイド	オプション	リスト	フィルタリングするエンティティのGUID。	`["MTIzNDU2..."]`
エンティティタイプ	オプション	リスト	フィルタリングするエンティティタイプ。	`["APPLICATION"]`
conditionIds	オプション	リスト	フィルタリングするアラート条件ID。整数のJSON配列である必要があります。	`[10001, 10002]`
ポリシー ID	オプション	リスト	フィルタリングするアラートポリシーIDです。整数のJSON配列である必要があります。	`[5001]`
認められている	オプション	ブール値	確認ステータスフィルターです。確認済みの問題のみの場合は `true` を指定します。未確認の問題のみの場合は `false` を指定します。	`false`
isCorrelated	オプション	ブール値	ノイズを減らすために、New Relicのアプライドインテリジェンスがこの問題を他の関連する問題とマージしたかどうかを示します。	`false`
mutingStates	オプション	リスト	通知の抑制ステータス。 `NOT_MUTED` 、 `FULLY_MUTED` 、 `PARTIALLY_MUTED` のいずれか1つ以上。	`["NOT_MUTED"]`
含む	オプション	弦	主要な問題の属性に対する、大文字と小文字を区別するフリーテキストの一致。	`"checkout-service"`
開始時間	オプション	Int	タイムウィンドウの開始、エポックミリ秒。負でない必要があります。 `endTime` が必要です — タイムウィンドウフィルターを適用するには、両方のフィールドが存在する必要があります。	`1785900000000`
エンドタイム	オプション	Int	タイムウィンドウの終了、エポックミリ秒。負でない必要があります。 `startTime` が必要です — タイムウィンドウフィルターを適用するには、両方のフィールドが存在する必要があります。	`1785998400000`
カーソル	オプション	弦	以前の呼び出しの `nextCursor` 出力からの不透明なページネーショントークン。結果の次のページを取得します。	`"eyJpZCI6IjE..."`
selectors	オプション	リスト	レスポンスから特定の値を抽出するためのJQセレクター。	`selectors: - name: issues expression: ".data.actor.account.aiIssues.issues.issues" - name: nextCursor expression: ".data.actor.account.aiIssues.issues.nextCursor"`

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

出力	タイプ	説明
success	ブール値	`true` ステップがHTTP/トランスポートエラーなしで実行された場合。
errorMessage	弦	呼び出しがHTTP/トランスポートレベルで失敗した場合にのみ、エラーメッセージが含まれます。成功した場合は `null` 。
データ	地図	NerdGraphのレスポンス。`data.actor.account.aiIssues.issues.issues`（issueオブジェクトの配列）および`data.actor.account.aiIssues.issues.nextCursor`（これ以上ページが存在しない場合は`null`）が含まれます。以下はレスポンスの代表的なサブセットです — 各issueには完全な`AiIssuesIssue`フィールドセットが含まれます：`issueId`、`title`、`description`、`priority`、`state`、`createdAt`、`updatedAt`、`closedAt`、`activatedAt`、`acknowledgedAt/By/ByChannel`、`closedBy/ByChannel`、`investigatedAt/By/ByChannel`、`unAcknowledgedAt/By/ByChannel`、`sources`、`origins`、`entityGuids/Names/Types`、`conditionName/FamilyId/Product`、`policyIds/Name`、`correlationRuleIds/Names/Descriptions`、`correlationStatus`、`correlatedBy`、`isCorrelated`、`isIdle`、`mutingState`、`totalIncidents`、`incidentIds`、`deepLinkUrl`、`accountIds`、`parentMergeId`、`mergeReason`、`eventType`、`wildcard`、`dataMlModules`（キーの値ペアのリスト）、および`realIssueCount`。特定の値を抽出するには、`selectors`を使用します。 `{ "data": { "actor": { "account": { "aiIssues": { "issues": { "issues": [ { "issueId": "123e4567-e89b-12d3-a456-426614174000", "title": ["Example issue title"], "state": "ACTIVATED", "priority": "CRITICAL", "entityNames": ["example-entity"] } ], "nextCursor": null } } } } } }`

出力

タイプ

説明

success

ブール値

true

ステップがHTTP/トランスポートエラーなしで実行された場合。

errorMessage

弦

呼び出しがHTTP/トランスポートレベルで失敗した場合にのみ、エラーメッセージが含まれます。成功した場合は

null

。

データ

地図

NerdGraphのレスポンス。data.actor.account.aiIssues.issues.issues（issueオブジェクトの配列）およびdata.actor.account.aiIssues.issues.nextCursor（これ以上ページが存在しない場合はnull）が含まれます。以下はレスポンスの代表的なサブセットです — 各issueには完全なAiIssuesIssueフィールドセットが含まれます：issueId、title、description、priority、state、createdAt、updatedAt、closedAt、activatedAt、acknowledgedAt/By/ByChannel、closedBy/ByChannel、investigatedAt/By/ByChannel、unAcknowledgedAt/By/ByChannel、sources、origins、entityGuids/Names/Types、conditionName/FamilyId/Product、policyIds/Name、correlationRuleIds/Names/Descriptions、correlationStatus、correlatedBy、isCorrelated、isIdle、mutingState、totalIncidents、incidentIds、deepLinkUrl、accountIds、parentMergeId、mergeReason、eventType、wildcard、dataMlModules（キーの値ペアのリスト）、およびrealIssueCount。特定の値を抽出するには、selectorsを使用します。

{
  "data": {
    "actor": {
      "account": {
        "aiIssues": {
          "issues": {
            "issues": [
              {
                "issueId": "123e4567-e89b-12d3-a456-426614174000",
                "title": ["Example issue title"],
                "state": "ACTIVATED",
                "priority": "CRITICAL",
                "entityNames": ["example-entity"]
              }
            ],
            "nextCursor": null
          }
        }
      }
    }
  }
}

以下の例では、さまざまなフィルター設定でこのアクションを使用する方法を示します。

ワークフローの例
フィルターなし — 状態、優先度、またはその他のフィルターに関係なく、アカウント上のすべての問題をリストします。`accountId`のみ必須です： `name: newrelic_issue_list_all description: list all issues for an account with no filters steps: - name: newrelic_issue_list type: action action: newrelic.issue.list version: 1 inputs: accountId: 123456 next: end` 以下の例では、基本的なフィルターを使用して、アカウントのアクティブで優先度の高い問題をリストします： `name: newrelic_issue_list_workflow description: list newrelic issues steps: - name: newrelic_issue_list type: action action: newrelic.issue.list version: 1 inputs: accountId: 123456 states: ["ACTIVATED", "CREATED"] priority: ["CRITICAL", "HIGH"] next: end` 以下の例では、特定の時間枠内の未承認、ミュートされていない、クリティカルな問題に対して複数のフィルターを使用し、セレクタを使用してページネーション用にレスポンスをフラット化しています： name: newrelic_issue_list_advanced description: list unacknowledged critical issues in a time window steps: - name: newrelic_issue_list type: action action: newrelic.issue.list version: 1 inputs: accountId: 123456 states: ["ACTIVATED"] priority: ["CRITICAL"] isAcknowledged: false mutingStates: ["NOT_MUTED"] startTime: 1785900000000 endTime: 1785998400000 selectors: - name: issues expression: ".data.actor.account.aiIssues.issues.issues" - name: nextCursor expression: ".data.actor.account.aiIssues.issues.nextCursor" next: end 例3の追加結果をページ送りするには、`nextCursor`の出力を取得し、後続の呼び出しで`cursor`の入力として再度渡します。

ワークフローの例

フィルターなし — 状態、優先度、またはその他のフィルターに関係なく、アカウント上のすべての問題をリストします。accountIdのみ必須です：

name: newrelic_issue_list_all
description: list all issues for an account with no filters
steps:
  - name: newrelic_issue_list
    type: action
    action: newrelic.issue.list
    version: 1
    inputs:
      accountId: 123456
    next: end

以下の例では、基本的なフィルターを使用して、アカウントのアクティブで優先度の高い問題をリストします：

name: newrelic_issue_list_workflow
description: list newrelic issues
steps:
  - name: newrelic_issue_list
    type: action
    action: newrelic.issue.list
    version: 1
    inputs:
      accountId: 123456
      states: ["ACTIVATED", "CREATED"]
      priority: ["CRITICAL", "HIGH"]
    next: end

以下の例では、特定の時間枠内の未承認、ミュートされていない、クリティカルな問題に対して複数のフィルターを使用し、セレクタを使用してページネーション用にレスポンスをフラット化しています：

name: newrelic_issue_list_advanced
description: list unacknowledged critical issues in a time window
steps:
  - name: newrelic_issue_list
    type: action
    action: newrelic.issue.list
    version: 1
    inputs:
      accountId: 123456
      states: ["ACTIVATED"]
      priority: ["CRITICAL"]
      isAcknowledged: false
      mutingStates: ["NOT_MUTED"]
      startTime: 1785900000000
      endTime: 1785998400000
      selectors:
        - name: issues
          expression: ".data.actor.account.aiIssues.issues.issues"
        - name: nextCursor
          expression: ".data.actor.account.aiIssues.issues.nextCursor"
    next: end

例3の追加結果をページ送りするには、nextCursorの出力を取得し、後続の呼び出しでcursorの入力として再度渡します。

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

前提条件

イシューアクション

問題の認識

Issueの承認解除

問題の解決

問題の一覧表示

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

New Relic Issueアクション

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

イシューアクション

Issueの承認解除

問題の解決

問題の一覧表示

前提条件