ワークフローの実行をモニターする

この記事では、オブザーバビリティデータを使用してワークフローの実行とスケジュールの実行をモニターする方法について説明します。

監査

すべてのNerdGraphミューテーション呼び出しは、顧客アカウントのNrAuditEventでクエリできる監査レコードを生成します。

SELECT actionIdentifier, actorId, actorType, description
FROM NrAuditEvent 
WHERE targetType = 'workflow_run'
SINCE 1 hour ago

SELECT actionIdentifier, actorId, actorType, description
FROM NrAuditEvent 
WHERE targetType = 'workflow_schedule'
SINCE 1 hour ago

すべてのワークフローの実行は、ワークフローを開始またはスケジュールした顧客アカウントのNRDBにWorkflowAutomationEventデータを出力します。

ワークフローの実行は、WorkflowAutomationネームスペースにイベントデータを保存します。

次の表は、各WorkflowAutomationEventイベントの属性について説明しています。

属性	タイプ	説明
`timestamp`	EpochMillisecond	イベントタイムスタンプ
`type`	ワークフロー \| ステップ	イベントの種類
`status`	STARTED \| COMPLETED \| FAILED \| TIMED_OUT \| STOPPED	イベントに関連するステータス
`definitionName`	弦	このワークフローの実行に関連付けられたワークフロー定義名
`definitionVersion`	弦	このワークフローの実行に関連付けられたワークフロー定義バージョン
`definitionScopeType`	グローバル \| 組織 \| アカウント	このワークフローの実行に関連付けられたワークフロー定義のスコープタイプ
`definitionScopeId`	弦	このワークフロー実行に関連付けられたワークフロー定義スコープID
`definitionEntityGuid`	弦	このワークフローの実行に関連付けられたワークフロー定義のentityGuid
`userId`	Int	ワークフローを開始したNew RelicのユーザーID
`runId`	UUID	ワークフロー実行のユニークID
`durationMillisecond`	EpochMillisecond	COMPLETED、FAILED、またはTIMED_OUTイベントの期間
`stepName`	弦	ワークフロー内の顧客が指定したステップ名
`stepType`	アクション \| ループ \| スイッチ \| 状態	このイベントを生成したステップのタイプ
`stepActionName`	弦	アクションの完全修飾名
`stepActionVersion`	Int	アクションのバージョン

stepType属性には次の値があります：

次のクエリは、特定のワークフロー実行のすべてのイベントを返します：

SELECT *
FROM WorkflowAutomationEvent
where definitionName = 'json-parsing' and runId = '31c973d2-c669-4bd7-9b15-7e3a70a4a074'
SINCE 1 month ago

オプションで、logLevelの詳細度オプションを使用してワークフローを開始またはスケジュールできます。ログは、ワークフローを開始またはスケジュールしたアカウントに送信されます。

ログには次の属性が含まれます：

スケジュールの発生によってワークフローが開始された場合、ログエントリにはworkflowAutomation.scheduleIdも含まれます。

アクションステップタイプの場合、DEBUGを使用すると、各アクション入力はworkflowAutomation.inputs.<inputName>: <inputValue>の形式でログエントリに追加の属性を追加します。

アクションステップタイプの場合、TRACEを使用すると、各アクション出力はworkflowAutomation.outputs.<outputName>: <outputValue>の形式でログエントリに追加の属性を追加します。

以下のNRQLクエリを使用してログをクエリできます：

SELECT message FROM Log WHERE workflowAutomation.runId = '{run_id}' SINCE 3 hours ago

workflowAutomation.runIdの他に、ログデータのクエリに役立つその他のログ属性は次のとおりです：

スケジュールされた実行の場合、ログエントリにはworkflowAutomation.scheduleId属性も含まれます。