REST APIリファレンス

前へ次へ

jobLogEntries

jobLogEntriesリソースを使用して、完了した

データ統合

ジョブのログ情報を

オペレーションインサイト

から要求します。このリソースを使用する場合は、組織IDをURLに含めます。

GET要求

すべてのログの情報を要求するか、ログの応答をフィルタリングすることができます。過去33日間のデータを要求できます。応答は、適用されたフィルタに対して最大500件のレコードを返します。

ログからの情報を要求するには、次のURIを使用します。

/cdiinsights-service/api/v1/analytical/Orgs(<orgID>)/JobLogEntries

ログ応答をフィルタリングするには、次のURIを使用します:

/cdiinsights-service/api/v1/analytical/Orgs(<orgID>)/JobLogEntries?<query parameters>

URIには次のようなフィルタを含めることができます:

パラメータ	タイプ	説明
filter	文字列	クエリフィルタ。
endTime	日付	タスクが終了した日付および時刻。フィルタパラメータに含めます。
startswith	文字列	タスクを開始したランタイム環境、Secure Agent、またはアセット。フィルタパラメータに含めます。
listfilter	文字列	ジョブのステータスとアセットタイプ。
status in	文字列	タスクのステータス。次のいずれかのステータスでフィルタリングすることができます。 COMPLETED 注意（WARNING） FAILED END SUCCESS 停止
assetType in	文字列	アセットのタイプ: MTT。マッピングタスク。 TASKFLOW。高度なタスクフロー。 MI_TASK。一括取り込みタスク。 DSS。同期タスク。 WORKFLOW。リニアタスクフロー。 DRS。レプリケーションタスク。 PCS。PowerCenterタスク。 DTT. データ転送タスク。 DLT。データローダータスク。 MAPPING BATCH_MAPPING。動的マッピングタスク。 DMASK。データマスキングタスク。
count	Int	trueの場合、適用されたフィルタで使用可能なレコードの合計を返します。
上	Int	返す要素の数。例えば、値が25である場合、適用されたフィルタで使用できる最初の25件のレコードが返されます。最大値は500です。
skip	Int	スキップするレコード数。例えば、値を4に設定すると、リストの最初の4つのアセットが除外されます。
orderby	文字列	データを返すソート順序。

GET要求の例

次の例に、クエリパラメータを使用してログ情報を要求する方法を示します。

2023年10月8日午前6時から2023年10月9日午前6時の間に正常に完了した

マッピング

タスクのリストを要求するには、次のURIを使用します:

/cdiinsights-service/api/v1/analytical/Orgs(<orgID>)/JobLogEntries?$filter=(endTime%20ge%202023-10-08T06:00:00Z)%20and%20(endTime%20le%202023-10-09T06:00:00Z)&listFilter=status%20in%20(SUCCESS)%20and%20assetType%20in%20(MTT)&$count=true&$top=500&$skip=0

2023年10月1日午前6時から2023年10月31日午前6時の間に完了したすべてのジョブのリストを要求し、終了時刻の降順でジョブをソートするには、次のURIを使用します:

/cdiinsights-service/api/v1/analytical/Orgs(<orgID>)/JobLogEntries?$filter=(endTime%20ge%202023-10-01T06:00:00Z)%20and%20(endTime%20le%202023-11-31T06:00:00Z)&listFilter=status%20in%20(COMPLETED,WARNING,FAILED,END,SUCCESS,STOPPED)%20and%20assetType%20in%20(MTT,DTT,DMASK,PCS,DRS,DSS,MTT_TEST,BATCH_MAPPING,MAPPING,command,MI_TASK)&$count=true&$top=500&$skip=0&$oderby=endTime desc

GET応答

ログの各行に対してjobLogEntryオブジェクトを返します。エラーが発生した場合にエラーオブジェクトを返します。

ログの各行に関する情報を要求した場合、jobLogEntryオブジェクトには次のような属性が含まれます。

フィールド	タイプ	説明
logEntryId	文字列	ログのエントリID。
assetId	文字列	タスクのID。
runId	長整数型	タスクの実行に必要なID。
assetName	文字列	アセットの名前。
instanceName	文字列	ジョブの名前を次の形式で指定します。 <asset name>-<instance number>
orgId	文字列	組織ID。
ステータス	文字列	ジョブが正常に完了したかどうかを示します。
assetType	文字列	タスクのタイプ。データ統合ジョブの場合は、次のいずれかのコードを返します。 MTT。マッピングタスク。 TASKFLOW。高度なタスクフロー。 MI_TASK。一括取り込みタスク。 DSS。同期タスク。 WORKFLOW。リニアタスクフロー。 DRS。レプリケーションタスク。 PCS。PowerCenterタスク。 DTT. データ転送タスク。 DLT。データローダータスク。 MAPPING。 BATCH_MAPPING。動的マッピングタスク。 DMASK。データマスキングタスク。
startTime	日付/時刻	タスクまたはリニアタスクフローの開始時刻。東部標準時（ET）を使用します。
endTime	日付/時刻	タスクまたはリニアタスクフローの終了時刻。東部標準時（ET）を使用します。
updateTime	文字列	タスクの最終更新時刻。
duration	ストリング	タスクが実行された時間（秒単位）。
errorMessage	String	ジョブに関連付けられているエラーメッセージ。
location	文字列	アセットの場所。
rowsProcessed	文字列	タスクによって処理された行の合計数。
successRows	文字列	タスクによって正常に処理された行の数。
errorRows	文字列	タスクによって処理されなかった行の数。
runtimeEnv	文字列	タスクを実行するランタイム環境。
runtimeEnvName	文字列	タスクが実行されているランタイム環境の名前。
startedBy	文字列	タスクを開始したユーザーまたはスケジュール。
サブタスク	文字列	タスクに含まれるサブタスクの数。
runContext	文字列	タスクの開始時に使用されたメソッド。次の値が含まれます。 UI。タスクがユーザーインタフェースを使用して開始されました。 SCHEDULER。タスクがタスクスケジューラを使用して開始されました。 REST API。タスクがREST APIを使用して開始されました。 OUTBOUND MESSAGE。タスクが送信メッセージを使用して開始されました。
extraData	文字列	saasLogIdやsaasTaskIdなどの追加情報。
parentEntityId	文字列	親タスクのID。
updateDayHour	日付/時刻	タスクの最終更新時刻。
taskId	文字列	タスクのID。
stopOnError	Boolean	致命的ではないエラーの発生時にランタイム環境でタスクを停止させるかどうかを示します。
isAtScale	Boolean	タスクに関連付けられたマッピングが詳細モードかどうかを示します。
parAssetName	文字列	親アセットの名前。
parRunId	文字列	親アセットの実行ID。
parLocation	文字列	親アセットの場所。
parAssetType	文字列	親アセットのタイプ。
agentId	文字列	タスクを実行しているSecure Agent。
agentName	文字列	タスクを実行しているエージェントの名前。
projectName	文字列	アセットが存在するプロジェクト。

GET応答の例

マッピングタスクのジョブログ情報を要求すると、次の応答が返されることがあります:

{
  "@odata.context": "$metadata#JobLogEntries",
  "@odata.count": 2,
  "value": [
    {
      "logEntryId": "9hQOSzOu0GSeG0r73CzK8L",
      "assetId": "jn94HPOUK4zlEoO07eGfEq",
      "runId": "148201",
      "assetName": "CDI_9102",
      "instanceName": "CDI_9102-148201",
      "orgId": "010cdi",
      "status": "COMPLETED",
      "assetType": "MTT",
      "correlationId": "ZGVmN2E3ZDEtMTE2MC00NT",
      "startTime": "2023-07-20T07:55:52Z",
      "endTime": "2023-07-20T07:56:09Z",
      "updateTime": null,
      "duration": 17,
      "errorMessage": "",
      "location": "9102",
      "rowsProcessed": 2,
      "successRows": 2,
      "errorRows": 0,
      "runtimeEnv": "runtime environment",
      "runtimeEnvName": "ASH0001",
      "startedBy": "every_day",
      "subtasks": 0,
      "runContext": "SCHEDULER",
      "extraData": "{\"saasLogId\":\"010AXYC100000000RC5Q\", \"runtimeType\":\"\", \"isServerless\":\"false\", \"releaseVersion\":\"4400\", \"saasTaskId\":\"010AXY0Z0000000005EM\"}",
      "parentEntityId": null,
      "statusDisplayName": "SUCCESS",
      "updateDayHour": "2023-07-20T07:00:00Z",
      "taskId": "010AXY0Z0000000005EM",
      "stopOnError": "0",
      "requestId": null,
      "isAtScale": 0,
      "parAssetName": null,
      "parRunId": null,
      "parLocation": "n/a",
      "parAssetType": null,
      "agentId": "010AXY08000000000003",
      "agentName": "ASH0001",
      "projectName": "9102"
    } 
{
      "logEntryId": "7gQRt15YPsBcdK6RsozzSJ",
      "assetId": "iwm48QrytmidcBrdpMElu6",
      "runId": "145708",
      "assetName": "CDI-9845_test2",
      "instanceName": "CDI-9845_test2-145708",
      "orgId": "010cdi",
      "status": "COMPLETED",
      "assetType": "MTT",
      "correlationId": "NjNlNGFhY2QtYzFjZC00MT",
      "startTime": "2023-07-20T07:55:52Z",
      "endTime": "2023-07-20T07:56:03Z",
      "updateTime": null,
      "duration": 11,
      "errorMessage": "",
      "location": "Default",
      "rowsProcessed": 1000,
      "successRows": 1000,
      "errorRows": 0,
      "runtimeEnv": "runtime environment",
      "runtimeEnvName": "ASH0001",
      "startedBy": "CDI-9845_scheduler",
      "subtasks": 0,
      "runContext": "SCHEDULER",
      "extraData": "{\"saasLogId\":\"010AXYC100000000RC5P\", \"runtimeType\":\"\", \"isServerless\":\"false\", \"releaseVersion\":\"4400\", \"saasTaskId\":\"010AXY0Z0000000005N4\"}",
      "parentEntityId": null,
      "statusDisplayName": "SUCCESS",
      "updateDayHour": "2023-07-20T07:00:00Z",
      "taskId": "010AXY0Z0000000005N4",
      "stopOnError": "0",
      "requestId": null,
      "isAtScale": 0,
      "parAssetName": null,
      "parRunId": null,
      "parLocation": "n/a",
      "parAssetType": null,
      "agentId": "agentID",
      "agentName": "ASH0001",
      "projectName": "Default"
    }

データ統合ジョブログファイル

ガイドをダウンロード

ページをウォッチ

フィードバックを送信

コミュニティ

Knowledge Base

Success Portal