--- title: "Get project monitoring status" method: GET path: "/v1/integration/projects/{projectId}/monitoring/status" tags: ["Monitor Unified Integration Projects"] --- # Get project monitoring status `GET /v1/integration/projects/{projectId}/monitoring/status` ## Request - Base URL: `https://integration-adapter.connect.cloud.precisely.com` - URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/projects/{projectId}/monitoring/status` - Auth: HTTP bearer Retrieves the runtime monitoring status for a single project of any supported type, delegating to the Connect Monitoring Service's unified status endpoint. **Features:** - Returns a single, project-type-discriminated status envelope: `continuousAdvanced` for Continuous Replication and Advanced Replication projects, `mainframe` for Mainframe Replication projects. - `includeDetails` maps to table-level details for Continuous/Advanced projects and source/target details for Mainframe projects. - `latency` includes mainframe latency details and is ignored for other project types. - Works for all project types: Continuous Replication, Mainframe, and Advanced Replication. **Use Cases:** - Poll runtime pipeline health and throughput for a monitoring dashboard. - Inspect data-flow, version, and CDWH statistics for a Continuous or Advanced project. - Inspect pipeline-level and agent-level status for a Mainframe project. **Authorization:** Requires `replication-pipeline::view`. ## Path parameters - `projectId` string, required ## Query parameters - `projectType` 'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION', required: Supported project types for unified project operations - `includeDetails` boolean - `latency` boolean ## Response `200` Successfully retrieved project monitoring status - UnifiedProjectMonitoringStatusResponse: Unified project monitoring status response - `id` string: Unique identifier of the underlying monitoring status document - `projectId` string: Unique identifier of the project - `projectType` 'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION': Project type: REPLICATION | MAINFRAME_REPLICATION | ADVANCED_REPLICATION - `tenantId` string: Workspace or tenant identifier - `status` Status: Discriminated monitoring status; only one of the two fields is populated - `continuousAdvanced` ContinuousAdvanced: Monitoring status fields specific to Continuous and Advanced Replication projects - `agentId` string: Unique identifier of the agent - `name` string: Name of the project - `currentEmailRuntimeServer` string: Runtime server used for email notifications - `changes` 'UP_TO_DATE' | 'UPDATE_NEEDED': Indicates if the project is up to date or needs update - `generationTimestamp` string: Timestamp when the status was generated (RFC 3339 UTC) - `dataFlows` MonitoringDataFlowStatus[]: Data flow statuses for the project - `backlogRows` MonitoringBacklogRowStatus - `pendingRows` integer - `pendingTransactions` integer - `timestamp` string - `captureStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `copyPhase` boolean - `dataFlowType` string - `logReaderStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `monitoringRequestProcessing` boolean - `name` string - `overallStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `replicationStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `runtimeServerStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `runtimeServers` MonitoringRuntimeServerStatus[] - `dataConnections` MonitoringDataConnectionStatus[] - `connectionType` string - `logReaders` MonitoringLogReaderStatus[] - … - `name` string - `source` boolean - `stats` MonitoringStats - … - `target` boolean - `hasChange` boolean - `logReaderStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `name` string - `replicationStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `state` string - `status` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `startedAt` string - `stats` MonitoringStats - `apply` MonitoringStatsInfos - `bytes` integer - `lastReported` string - `rows` integer - `skippedRows` integer - `transactions` integer - `averageLatency` MonitoringContinuousAverageLatency - `backlog` number - `capture` number - `replication` number - `total` number - `updatedAt` string - `backlogLatency` integer - `captureLatency` integer - `replicationLatency` integer - `retrieve` MonitoringStatsInfos - `bytes` integer - `lastReported` string - `rows` integer - `skippedRows` integer - `transactions` integer - `send` MonitoringStatsInfos - `bytes` integer - `lastReported` string - `rows` integer - `skippedRows` integer - `transactions` integer - `statisticEstimationWindow` string - `totalLatency` integer - `tableMappings` MonitoringTableMappingStatus[] - `mappingDetails` MonitoringTableMappingDetails[] - `appliedStats` MonitoringTableLevelStats - … - `captureStatus` string - `retrievedStats` MonitoringTableLevelStats - … - `sentStats` MonitoringTableLevelStats - … - `source` MonitoringTableMappingDetailsTable - … - `target` MonitoringTableMappingDetailsTable - … - `source` MonitoringTableMappingsStatusDataConnection - `connectionType` string - `name` string - `target` MonitoringTableMappingsStatusDataConnection - `connectionType` string - `name` string - `versions` MonitoringProjectVersions[]: Version information for the project - `committedVersion` integer - `deployedVersion` integer - `serverName` string - `cdwhStatsAndStatusInfos` MonitoringMonitoringCDWHStatsAndStatus[]: CDWH stats and status information - `idInfo` MonitoringMonitoringCDWHPipelineIdInfo - `projectName` string - `target` string - `targetType` string - `userPPName` string - `pipelinePhase` string - `stats` MonitoringMonitoringCDWHStatsInfo - `appliedRecordCount` integer - `appliedTransactionCount` integer - `applyLatency` integer - `processedRecordCount` integer - `processedTransactionCount` integer - `readRecordCount` integer - `skipRecordCount` integer - `stagedRecordCount` integer - `stagedTransactionCount` integer - `startedAt` string - `status` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `stopReason` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `virtualId` string: Virtual identifier for the project - `overallPipelineStatuses` MonitoringOverallPipelineStatus[]: Overall pipeline statuses - `copyPhase` boolean - `pipelineName` string - `pipelineStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `replicationStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `mainframe` Mainframe: Monitoring status fields specific to Mainframe Replication projects - `pipelines` MonitoringMainframePipelineMonitoringStatus[]: Pipeline-level monitoring statuses - `agents` MonitoringMonitoringMainframeAgents[] - `allocated` integer - `cdctype` string - `flavor` integer - `git` string - `header` MonitoringAgentHeader - `active` MonitoringAgentState - … - `allocated` integer - `id` string - `lastCommitStck` string - `lastCommitTimestamp` string - `lastLogLsn` string - `pending` MonitoringAgentState - … - `status` string - `used` integer - `id` string - `internalName` string - `latency` MonitoringLatency - `avgTransactionLatency` integer - `totalBacklogLatency` integer - `totalCaptureLatency` integer - `totalReplicationLatency` integer - `transactionBacklogLatency` integer - `transactionCaptureLatency` integer - `transactionReplicationLatency` integer - `transactionsAcknowledged` integer - `message` string - `messageDetails` string[] - `name` string - `pipelineId` string - `pipelineStarted` string - `reportedAt` string - `runtimeServerName` string - `sources` MonitoringSourceInfo[] - `active` MonitoringSourceState - … - `alias` string - `bytesCaptured` integer - `datastore` string - `details` MonitoringDetails[] - … - `index` integer - `key` string - `rowsCaptured` integer - `statsLife` MonitoringSourceStat - … - `statsSession` MonitoringSourceStat - … - `status` string - `store` MonitoringStoreInfo - `cabId` string - `cabName` string - `summary` MonitoringSummary - `bytesApplied` integer - `bytesCaptured` integer - `cummulativeBytesCaptured` integer - `cummulativeRowsCaptured` integer - `rowsApplied` integer - `rowsCaptured` integer - `transactionsCaptured` integer - `targets` MonitoringTargetInfo[] - `alias` string - `bytesApplied` integer - `connected` string - `datastore` string - `details` MonitoringDetails[] - … - `index` integer - `key` string - `lastAckLsn` string - `lastConnection` string - `lastDisconnection` string - `name` string - `recordsDeleted` integer - `recordsInserted` integer - `recordsUpdated` integer - `rowsApplied` integer - `statsLife` MonitoringTargetStat - … - `statsSession` MonitoringTargetStat - … - `used` integer - `version` string - `id` string - `internalName` string - `latencyDetails` MonitoringLatencyDetails - `averageLatency` MonitoringAverageLatency - `avgBacklogLatency` integer - `avgCaptureLatency` integer - `avgReplicationLatency` integer - `transactionsAcknowledged` integer - `updatedAt` string - `cumulativeLatency` MonitoringCumulativeLatency - `cumulativeBacklogLatency` integer - `cumulativeCaptureLatency` integer - `cumulativeReplicationLatency` integer - `transactionsAcknowledged` integer - `currentLatency` MonitoringCurrentLatency - `avgTransactionLatency` integer - `transactionBacklogLatency` integer - `transactionCaptureLatency` integer - `transactionReplicationLatency` integer - `updatedAt` string - `mailSender` MonitoringMailSender - `mailSent` boolean - `timerStartedAt` string - `name` string - `pipelineId` string - `projectId` string - `reportedAt` string - `tenantId` string - `createdAt` string: Timestamp when the mainframe project status was created - `agents` MonitoringMonitoringMainframeAgents[]: Runtime agent statuses - `allocated` integer - `cdctype` string - `flavor` integer - `git` string - `header` MonitoringAgentHeader - `active` MonitoringAgentState - `database` string - `excludedPlans` string[] - `externalConfigFile` string - `flags` string - `plan` string - `storageId` string - `storageName` string - `allocated` integer - `id` string - `lastCommitStck` string - `lastCommitTimestamp` string - `lastLogLsn` string - `pending` MonitoringAgentState - `database` string - `excludedPlans` string[] - `externalConfigFile` string - `flags` string - `plan` string - `storageId` string - `storageName` string - `status` string - `used` integer - `id` string - `internalName` string - `latency` MonitoringLatency - `avgTransactionLatency` integer - `totalBacklogLatency` integer - `totalCaptureLatency` integer - `totalReplicationLatency` integer - `transactionBacklogLatency` integer - `transactionCaptureLatency` integer - `transactionReplicationLatency` integer - `transactionsAcknowledged` integer - `message` string - `messageDetails` string[] - `name` string - `pipelineId` string - `pipelineStarted` string - `reportedAt` string - `runtimeServerName` string - `sources` MonitoringSourceInfo[] - `active` MonitoringSourceState - `flags` string - `targetUrls` string[] - `alias` string - `bytesCaptured` integer - `datastore` string - `details` MonitoringDetails[] - `name` string - `rowsApplied` integer - `rowsCaptured` integer - `index` integer - `key` string - `rowsCaptured` integer - `statsLife` MonitoringSourceStat - `delete` integer - `insert` integer - `update` integer - `statsSession` MonitoringSourceStat - `delete` integer - `insert` integer - `update` integer - `status` string - `store` MonitoringStoreInfo - `cabId` string - `cabName` string - `summary` MonitoringSummary - `bytesApplied` integer - `bytesCaptured` integer - `cummulativeBytesCaptured` integer - `cummulativeRowsCaptured` integer - `rowsApplied` integer - `rowsCaptured` integer - `transactionsCaptured` integer - `targets` MonitoringTargetInfo[] - `alias` string - `bytesApplied` integer - `connected` string - `datastore` string - `details` MonitoringDetails[] - `name` string - `rowsApplied` integer - `rowsCaptured` integer - `index` integer - `key` string - `lastAckLsn` string - `lastConnection` string - `lastDisconnection` string - `name` string - `recordsDeleted` integer - `recordsInserted` integer - `recordsUpdated` integer - `rowsApplied` integer - `statsLife` MonitoringTargetStat - `bytes` integer - `records` integer - `txns` integer - `statsSession` MonitoringTargetStat - `bytes` integer - `records` integer - `txns` integer - `used` integer - `version` string - `summary` MonitoringMainframeProjectSummary - `health` string - `lastUpdated` string - `longestCurrentLatencyMs` integer - `totalRowsApplied` integer - `totalRowsCaptured` integer ## Other responses - `400`: Bad request - `401`: Unauthorized - `403`: Forbidden - `404`: Project monitoring status not found (DI-ADAPTER-STA-0002) - `500`: Project monitoring status retrieval failed (DI-ADAPTER-STA-0001) --- [API](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service.md) · [All operations](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/revisions/2d2629f4987d?raw)