Skip to main content

Interface: IActivityExecutionInfo

activity.v1.IActivityExecutionInfo

Properties of an ActivityExecutionInfo.

Implemented by​

Properties​

activityId​

• Optional activityId: null | string

Unique identifier of this activity within its namespace along with run ID (below).

activityType​

• Optional activityType: null | IActivityType

The type of the activity, a string that maps to a registered activity on a worker.

attempt​

• Optional attempt: null | number

The attempt this activity is currently on. Incremented each time a new attempt is scheduled.

canceledReason​

• Optional canceledReason: null | string

Set if activity cancelation was requested.

closeTime​

• Optional closeTime: null | ITimestamp

Time when the activity transitioned to a closed state.

currentRetryInterval​

• Optional currentRetryInterval: null | IDuration

Time from the last attempt failure to the next activity retry. If the activity is currently running, this represents the next retry interval in case the attempt fails. If activity is currently backing off between attempt, this represents the current retry interval. If there is no next retry allowed, this field will be null. This interval is typically calculated from the specified retry policy, but may be modified if an activity fails with a retryable application failure specifying a retry delay.

executionDuration​

• Optional executionDuration: null | IDuration

How long this activity has been running for, including all attempts and backoff between attempts.

expirationTime​

• Optional expirationTime: null | ITimestamp

Scheduled time + schedule to close timeout.

• Optional header: null | IHeader

ActivityExecutionInfo header

heartbeatDetails​

• Optional heartbeatDetails: null | IPayloads

Details provided in the last recorded activity heartbeat. DescribeActivityExecution does not set this field unless include_heartbeat_details was true in the request.

heartbeatTimeout​

• Optional heartbeatTimeout: null | IDuration

Maximum permitted time between successful worker heartbeats.

lastAttemptCompleteTime​

• Optional lastAttemptCompleteTime: null | ITimestamp

The time when the last activity attempt completed. If activity has not been completed yet, it will be null.

lastDeploymentVersion​

• Optional lastDeploymentVersion: null | IWorkerDeploymentVersion

The Worker Deployment Version this activity was dispatched to most recently. If nil, the activity has not yet been dispatched or was last dispatched to an unversioned worker.

lastFailure​

• Optional lastFailure: null | IFailure

Failure details from the last failed attempt. DescribeActivityExecution does not set this field unless include_last_failure was true in the request.

lastHeartbeatTime​

• Optional lastHeartbeatTime: null | ITimestamp

Time the last heartbeat was recorded.

lastStartedTime​

• Optional lastStartedTime: null | ITimestamp

Time the last attempt was started.

lastWorkerIdentity​

• Optional lastWorkerIdentity: null | string

ActivityExecutionInfo lastWorkerIdentity

• Optional links: null | ILink[]

Links to related entities, such as the entity that started this activity.

nextAttemptScheduleTime​

• Optional nextAttemptScheduleTime: null | ITimestamp

The time when the next activity attempt will be scheduled. If activity is currently scheduled or started, this field will be null.

priority​

• Optional priority: null | IPriority

Priority metadata.

retryPolicy​

• Optional retryPolicy: null | IRetryPolicy

The retry policy for the activity. Will never exceed schedule_to_close_timeout.

runId​

• Optional runId: null | string

ActivityExecutionInfo runId

runState​

• Optional runState: null | PendingActivityState

More detailed breakdown of ACTIVITY_EXECUTION_STATUS_RUNNING.

scheduleTime​

• Optional scheduleTime: null | ITimestamp

Time the activity was originally scheduled via a StartActivityExecution request.

scheduleToCloseTimeout​

• Optional scheduleToCloseTimeout: null | IDuration

Indicates how long the caller is willing to wait for an activity completion. Limits how long retries will be attempted.

(-- api-linter: core::0140::prepositions=disabled aip.dev/not-precedent: "to" is used to indicate interval. --)

scheduleToStartTimeout​

• Optional scheduleToStartTimeout: null | IDuration

Limits time an activity task can stay in a task queue before a worker picks it up. This timeout is always non retryable, as all a retry would achieve is to put it back into the same queue. Defaults to schedule_to_close_timeout.

(-- api-linter: core::0140::prepositions=disabled aip.dev/not-precedent: "to" is used to indicate interval. --)

sdkName​

• Optional sdkName: null | string

The name of the SDK of the worker that most recently picked up an attempt of this activity. Overwritten on each new attempt. Empty if unknown.

sdkVersion​

• Optional sdkVersion: null | string

The version of the SDK of the worker that most recently picked up an attempt of this activity. Overwritten on each new attempt. Empty if unknown.

searchAttributes​

• Optional searchAttributes: null | ISearchAttributes

ActivityExecutionInfo searchAttributes

startDelay​

• Optional startDelay: null | IDuration

Time to wait before dispatching the first activity task. This delay is not applied to retry attempts.

startToCloseTimeout​

• Optional startToCloseTimeout: null | IDuration

Maximum time a single activity attempt is allowed to execute after being picked up by a worker. This timeout is always retryable.

(-- api-linter: core::0140::prepositions=disabled aip.dev/not-precedent: "to" is used to indicate interval. --)

stateSizeBytes​

• Optional stateSizeBytes: null | Long

Updated once on scheduled and once on terminal status.

stateTransitionCount​

• Optional stateTransitionCount: null | Long

Incremented each time the activity's state is mutated in persistence.

status​

• Optional status: null | ActivityExecutionStatus

A general status for this activity, indicates whether it is currently running or in one of the terminal statuses.

taskQueue​

• Optional taskQueue: null | string

ActivityExecutionInfo taskQueue

totalHeartbeatCount​

• Optional totalHeartbeatCount: null | Long

Total number of heartbeats recorded across all attempts of this activity, including retries.

userMetadata​

• Optional userMetadata: null | IUserMetadata

Metadata for use by user interfaces to display the fixed as-of-start summary and details of the activity.