タスクフローのログファイル
タスクフローのログファイルをダウンロードして、必要に応じてオフラインで確認し、問題のトラブルシューティングを行うことができます。ダウンロードしたログファイル名には、タスクフローの名前、実行ID、およびタスクフローをトリガしたユーザーの組織IDが含まれます。
注: タスクフロー名にスペースが含まれている場合、ログファイル名には+記号が含まれます。
タスクフローログファイルのダウンロード
タスクフローログファイルをダウンロードして、オフラインで確認し、問題のトラブルシューティングを行うことができます。
1[マイジョブ]ページを開きます。
2[インスタンス名]カラムのタスクフロー名をクリックして、対応するタスクフローの詳細ページを開きます。
3[結果]領域で、[ログのダウンロード]アイコンをクリックしてタスクフローログファイルをダウンロードします。
ログリソースを使用したタスクフローログファイルのダウンロード
タスクフローをサービスとしてパブリッシュした後に、タスクフローを実行し、ログリソースを使用してタスクフローログファイルのログファイルをダウンロードできます。
次のいずれかの方法を使用して、PostmanなどのRESTクライアントを通じて要求を呼び出すことができます。
- •基本認証を使用し、ユーザー名とパスワードを入力します。
- •HTTPヘッダーのセッションIDを使用して、ユーザー名とパスワードを指定せずにタスクフローを呼び出します。
例えば、次のいずれかの方法でGET要求を認証できます。
- • 基本認証を使用し、Informatica Intelligent Cloud Servicesのユーザー名およびパスワードを指定します。
例:
GET<Informatica Intelligent Cloud Services URL>/active-bpel/services/tf/log/<run ID>
Accept: application/octet-stream
Authorization : Basic Auth
username: <Informatica Intelligent Cloud Services username>
password: <<Informatica Intelligent Cloud Services password>
- •HTTPヘッダーのIDS-SESSION-IDを使用します。
例:
GET<Informatica Intelligent Cloud Services URL>/active-bpel/services/tf/log/<run ID>
Accept: application/octet-stream
IDS-SESSION-ID : <sessionId>
SESSION-IDを取得するには、Platform REST APIバージョン3ログインリソースを使用します。ログインリソースの詳細については、『REST APIリファレンス』を参照してください。
GET要求
タスクフローのログファイルをダウンロードするには、次のURIを使用します。
GET<Informatica Intelligent Cloud Services URL>/active-bpel/services/tf/log/<run ID>
以下に例を示します。
https://na4.dm.us.informaticacloud.com/active-bpel/services/tf/log/20262247166322413568
タスクフローログファイルの内容
ログファイルのヘッダーには、ファイルがダウンロードされたときのタイムスタンプ、ユーザーID、ログファイルのダウンロード時のタスクフローのステータスなどの情報が表示されます。ログファイルの本文には次のような情報が含まれます。
フィールド | タイプ | 説明 |
---|
assetName | String | タスクフローの名前。APIまたはRunAJobユーティリティを使用してタスクフローにカスタム名を追加した場合、タスクフロー名にはカスタム名も含まれます。 |
assetType | String | オブジェクトのタイプ。TASKFLOW値が返されます。 |
duration | String | タスクフローが完了、中断、失敗、または停止するまでの実行時間(秒)。 |
endTime | Date/Time | タスクフローの実行が終了した時刻。協定世界時(UTC)を使用します。 |
location | String | タスクフローが保存されたプロジェクトおよびフォルダパス。 |
runId | Long | タスクフローの実行ID。 |
URL | String | データ統合によって生成されたログリソースのURL。ログファイルには、タスクフローに対応する1つのURLと、タスクフロー内のサブタスクと同数のURLが含まれます。 |
runtimeEnv | String | タスクフローを実行するアプリケーションノードの名前。 |
runtimeEnvName | String | タスクフローが実行するランタイム環境の名前。 |
startTime | Date/Time | タスクフローの実行が開始した時刻。協定世界時(UTC)を使用します。 |
startedBy | String | タスクフローを最初に開始したユーザーの名前。 |
status | String | タスクフローの実行ステータス。 次のいずれかの値を返します。 - - RUNNING。タスクフローは実行中です。
- - SUCCESS。タスクフローは正常に完了しました。
- - FAILED。エラーが発生したため、タスクフローは完了しませんでした。
- - SUSPENDED。タスクフローの実行は中断しました。
|
サブタスク | String | タスクフローに含まれるサブタスクの数。 |
updateTime | Date/Time | タスクフローの実行ステータスが更新された最終時刻。協定世界時(UTC)を使用します。 |
statusCode | String | タスクフローのステータスコード。ステータスコードは、次のいずれかの値になります。 - - 1 - 実行中またはCHILD_SUSPENDED
- - 2 - 中断
- - 3 - 成功
- - 4 - 失敗
- - -1 - デフォルト
|
errorMessage | String | エラーメッセージの文字列。 |
subtaskDetails | String | タスクフロー内のすべてのサブタスクのステータスの詳細を含むオブジェクト。 |
詳細 | String | ステータスの詳細。タスクオブジェクト内の各サブタスクのステータス情報を含みます。 |
タスク | Collection | タスクフローが含むすべてのサブタスクのステータス情報。 |
サンプルのタスクフローログファイル
ログファイルの内容はoctet-streamタイプです。次のスニペットに、タスクフロー用にダウンロードされたログファイルのサンプルを示します。
{
[Tue Aug 29 09:49:11 UTC 2023] [sadityaRelPod1] - TASKFLOW TaskflowRelease15467983 FAILED.
Details:
{
"assetName" : "TaskflowRelease15467983",
"assetType" : "TASKFLOW",
"duration" : 795,
"endTime" : "2023-08-29T06:05:44Z",
"errorMessage" : "{\"reason\":\"Unknown\",\"code\":\"Unknown\",\"details\":\"Unknown\"}",
"location" : "Default", "runId" : 881053605371789312,
"URL" : "https://qa-pod1.rel.infaqa.com/active-bpel/services/tf/log/881053605371789312",
"runtimeEnv" : "taskflow-qa-release-pod1-r41-app02.infacloudops.net:4430",
"runtimeEnvName" : "",
"startedBy" : "sadityaRelPod1",
"startTime" : "2023-08-29T05:52:29Z",
"status" : "FAILED",
"subtasks" : 1,
"updateTime" : "2023-08-29T06:05:44Z",
"statusCode" : 4,
"subtaskDetails" : {
"details" : {
"tasks" : [ {
"assetName" : "MappingTask2",
"assetType" : "MTT",
"duration" : 13,
"endTime" : "2023-08-29T05:52:43Z",
"errorMessage" : "",
"errorRows" : 0,
"location" : "Shivendra",
"rowsProcessed" : 6,
"runId" : 5,
"runtimeEnv" : "01589925000000000002",
"runtimeEnvName" : "INWPG02P31F-AAD",
"startedBy" : "sadityarelpod1",
"startTime" : "2023-08-29T05:52:30Z",
"status" : "COMPLETED",
"subtasks" : 0,
"successRows" : 6,
"updateTime" : "2023-08-29T05:52:44Z" } ] } }}
}
}