Table of Contents

Search

  1. Preface
  2. Informatica Intelligent Cloud Services REST API
  3. Platform REST API version 2 resources
  4. Platform REST API version 3 resources
  5. Data Integration REST API
  6. File Ingestion and Replication REST API
  7. Streaming Ingestion and Replication REST API
  8. Model Serve REST API
  9. RunAJob utility
  10. ParamSetCli utility
  11. REST API codes
  12. REST API resource quick references

REST API Reference

REST API Reference

Logs for running jobs

Logs for running jobs

Use this resource to request log information for running jobs from the Monitor service. To request log information for completed jobs, use the activityLog resource.

GET Request

To request log information about running jobs, use the following URI:
/api/v2/activity/activityMonitor?details=<true|false>
You can use the following attribute in the activityMonitor GET URI:
details
Optional.
Log detail to be returned from
Informatica Intelligent Cloud Services
. Use one of the following options:
  • true. Returns log information for tasks, linear taskflows, and child objects. Child objects can include tasks within linear taskflows, and objects within
    replication
    tasks.
  • false. Returns log information for tasks and linear taskflows.
Default is false. If you omit this optional attribute, Monitor does not return additional details.

GET Response

Returns an activityMonitorEntry object for each row in the log. Returns the error object if errors occur.
The activityMonitorEntry object includes the following GET response attributes:
Field
Type
Description
id
String
Log entry ID.
type
String
The type of task. Returns one of the following codes:
  • DMASK.
    Masking
    task.
  • DRS.
    Replication
    task.
  • DSS.
    Synchronization
    task.
  • MAPPING. Job type of the sub job when you run a dynamic mapping task.
  • MTT.
    Mapping
    task.
  • MTT_DP. Job type when you run data preview for a mapping.
  • MTT_DP_CDIE. Job type when you run data preview for a mapping in advanced mode.
  • MTT_TEST. Job type when you use the Run button in the Mapping Designer.
  • PCS. PowerCenter task.
  • WORKFLOW. Linear taskflow.
taskId
String
Task ID.
taskName
String
Task name.
objectName
String
Source object used in the task, or the replication object being processed.
runId
Long
ID for the task run.
startTime
Date/time
Start time for the task or linear taskflow. Uses Eastern Time Zone (ET).
endTime
Date/time
End time for the task or linear taskflow. Uses Eastern Time Zone (ET).
executionState
String
State of the task. Returns one of the following codes:
  • QUEUED
  • INITIALIZED
  • RUNNING
  • STOPPING
  • FAILED
FAILED can be returned for linear taskflow subtasks only.
failedSourceRows
Long
Number of rows that were not read from the source.
successSourceRows
Long
Number of rows that were successfully read from the source.
failedTargetRows
Long
Number of rows that were not written to the target.
successTargetRows
Long
Number of rows that were successfully written to the target.
errorMsg
String
Error message associated with the job.
entries
Indicates the start of information for a child object. A child object might be a task within a linear taskflow, or an object in a replication task.
agentId
String
Agent used for the activity.
runtimeEnvironmentId
String
Runtime environment used for the activity.
startedBy
String
User who started the task.
runContextType
String
Method through which the task was initiated. Includes the following values:
  • UI. Task was initiated through the
    Data Integration
    user interface.
  • SCHEDULER. Task was initiated through the task scheduler.
  • REST-API. Task was initiated through the REST API.
  • OUTBOUND MESSAGE. Task was initiated through an outbound message.
scheduleName
String
Schedule name, if task was initiated by a schedule.
callbackURL
String
Status of the job.

GET Example

To return log information including details about child objects in XML, you might use the following request:
GET <serverUrl>/api/v2/activity/activityMonitor?details=true Content-Type: application/xml Accept: application/xml icSessionId: <icSessionId>
A successful request returns an activityMonitorEntry object for each item returned from Monitor.
The following text is a sample return in XML:
<root> <activityMonitorEntry> <id>000001C100000000000D</id> <type>DSS</type> <objectName>dss-f2f</objectName> <runId>0</runId> <startTime>2012-07-30T13:30:00.000Z</startTime> <endTime></endTime> <executionState>RUNNING</executionState> <failedSourceRows>0</failedSourceRows> <successSourcerows>938</successSourceRows> <failedTargetRows>0</failedTargetRows> <successTargetRows>596</successTargetRows> <errorMsg> </errorMsg> <entries> </entries> <agentId>00000C08000000000003</agentId> <runtimeEnvironmentId>00000C25000000000002</runtimeEnvironmentId> </activityMonitorEntry> <activityMonitorEntry> <id>000001C500000000000L</id> <type>PCS</type> <objectName>pcs-lookup</objectName> <runId>2</runId> <startTime>2012-07-30T13:30:03.001Z</startTime> <endTime>2012-07-30T13:30:03.010Z</endTime> <executionState>COMPLETE</executionState> <failedSourceRows>0</failedSourceRows> <successSourcerows>688</successSourceRows> <failedTargetRows>0</failedTargetRows> <successTargetRows>688</successTargetRows> <errorMsg> </errorMsg> <entries> </entries> <agentId>00000C08000000000003</agentId> <runtimeEnvironmentId>00000C25000000000002</runtimeEnvironmentId> </activityMonitorEntry> </root>

0 COMMENTS

We’d like to hear from you!