- JSON representation
- TaskConfig
- EventParameter
- FailurePolicy
- NextTask
- SuccessPolicy
- TriggerConfig
- IntegrationAlertConfig
- ThresholdValue
- IntegrationParameter
The integration version definition.
JSON representation | |
---|---|
{ "name": string, "description": string, "taskConfigs": [ { object ( |
Fields | |
---|---|
name |
Output only. Auto-generated primary key. |
description |
Optional. The integration description. |
taskConfigs[] |
Optional. Task configuration for the integration. It's optional, but the integration doesn't do anything without taskConfigs. |
triggerConfigs[] |
Optional. Trigger configurations. |
integrationParameters[] |
Optional. Parameters that are expected to be passed to the integration when an event is triggered. This consists of all the parameters that are expected in the integration execution. This gives the user the ability to provide default values, add information like PII and also provide data types of each parameter. |
state |
Output only. User should not set it as an input. |
snapshotNumber |
Optional. An increasing sequence that is set when a new snapshot is created. The last created snapshot can be identified by [workflowName, org_id latest(snapshotNumber)]. However, last created snapshot need not be same as the HEAD. So users should always use "HEAD" tag to identify the head. |
updateTime |
Output only. Auto-generated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
lockHolder |
Optional. The edit lock holder's email address. Generated based on the End User Credentials/LOAS role of the user making the call. |
createTime |
Output only. Auto-generated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
lastModifierEmail |
Optional. The last modifier's email address. Generated based on the End User Credentials/LOAS role of the user making the call. |
parentTemplateId |
Optional. The id of the template which was used to create this integrationVersion. |
TaskConfig
The task configuration details. This is not the implementation of Task. There might be multiple TaskConfigs for the same Task. Next available id: 12
JSON representation | |
---|---|
{ "task": string, "taskId": string, "parameters": { string: { object ( |
Fields | |
---|---|
task |
Optional. The name for the task. |
taskId |
Required. The identifier of this task within its parent event config, specified by the client. This should be unique among all the tasks belong to the same event config. We use this field as the identifier to find next tasks (via field |
parameters |
Optional. The customized parameters the user can pass to this task. An object containing a list of |
failurePolicy |
Optional. Determines the number of times the task will be retried on failure and with what retry strategy. This is applicable for asynchronous calls to Eventbus alone (events.post To Queue, events.schedule etc.). |
synchronousCallFailurePolicy |
Optional. Determines the number of times the task will be retried on failure and with what retry strategy. This is applicable for synchronous calls to Eventbus alone (events.post). |
nextTasks[] |
Optional. The set of tasks that are next in line to be executed as per the execution graph defined for the parent event, specified by |
nextTasksExecutionPolicy |
Optional. The policy dictating the execution of the next set of tasks for the current task. |
taskExecutionStrategy |
Optional. The policy dictating the execution strategy of this task. |
displayName |
Optional. User-provided label that is attached to this TaskConfig in the UI. |
successPolicy |
Optional. Determines what action to take upon successful task completion. |
jsonValidationOption |
Optional. If set, overrides the option configured in the Task implementation class. |
EventParameter
This message is used for processing and persisting (when applicable) key value pair parameters for each event in the event bus.
JSON representation | |
---|---|
{
"key": string,
"value": {
object ( |
Fields | |
---|---|
key |
Key is used to retrieve the corresponding parameter value. This should be unique for a given fired event. These parameters must be predefined in the integration definition. |
value |
Values for the defined keys. Each value can either be string, int, double or any proto message. |
FailurePolicy
Policy that defines the task retry logic and failure type. If no FailurePolicy is defined for a task, all its dependent tasks will not be executed (i.e, a retryStrategy
of NONE will be applied).
JSON representation | |
---|---|
{
"retryStrategy": enum ( |
Fields | |
---|---|
retryStrategy |
Defines what happens to the task upon failure. |
maxRetries |
Required if retryStrategy is FIXED_INTERVAL or LINEAR/EXPONENTIAL_BACKOFF/RESTART_INTEGRATION_WITH_BACKOFF. Defines the number of times the task will be retried if failed. |
intervalTime |
Required if retryStrategy is FIXED_INTERVAL or LINEAR/EXPONENTIAL_BACKOFF/RESTART_INTEGRATION_WITH_BACKOFF. Defines the initial interval in seconds for backoff. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
NextTask
The task that is next in line to be executed, if the condition specified evaluated to true.
JSON representation | |
---|---|
{ "taskConfigId": string, "taskId": string, "condition": string, "displayName": string } |
Fields | |
---|---|
taskConfigId |
ID of the next task. |
taskId |
Task number of the next task. |
condition |
Standard filter expression for this task to become an eligible next task. |
displayName |
User-provided label that is attached to this edge in the UI. |
SuccessPolicy
Policy that dictates the behavior for the task after it completes successfully.
JSON representation | |
---|---|
{
"finalState": enum ( |
Fields | |
---|---|
finalState |
State to which the execution snapshot status will be set if the task succeeds. |
TriggerConfig
Configuration detail of a trigger. Next available id: 9
JSON representation | |
---|---|
{ "label": string, "startTasks": [ { object ( |
Fields | |
---|---|
label |
Optional. The user created label for a particular trigger. |
startTasks[] |
Optional. Set of tasks numbers from where the integration execution is started by this trigger. If this is empty, then integration is executed with default start tasks. In the list of start tasks, none of two tasks can have direct ancestor-descendant relationships (i.e. in a same integration execution graph). |
properties |
Optional. Configurable properties of the trigger, not to be confused with integration parameters. E.g. "name" is a property for API triggers and "subscription" is a property for Pub/sub triggers. An object containing a list of |
triggerType |
Optional. Type of trigger |
triggerNumber |
Required. A number to uniquely identify each trigger config within the integration on UI. |
alertConfig[] |
Optional. An alert threshold configuration for the [trigger + client + integration] tuple. If these values are not specified in the trigger config, default values will be populated by the system. Note that there must be exactly one alert threshold configured per [client + trigger + integration] when published. |
nextTasksExecutionPolicy |
Optional. Dictates how next tasks will be executed. |
triggerId |
Optional. The backend trigger ID. |
IntegrationAlertConfig
Message to be used to configure custom alerting in the {@code EventConfig} protos for an event. Next available id: 10
JSON representation | |
---|---|
{ "displayName": string, "metricType": enum ( |
Fields | |
---|---|
displayName |
Name of the alert. This will be displayed in the alert subject. If set, this name should be unique within the scope of the integration. |
metricType |
The type of metric. |
thresholdType |
The threshold type, whether lower(expected_min) or upper(expected_max), for which this alert is being configured. If value falls below expected_min or exceeds expected_max, an alert will be fired. |
thresholdValue |
The metric value, above or below which the alert should be triggered. |
durationThreshold |
Should be specified only for *AVERAGE_DURATION and *PERCENTILE_DURATION metrics. This member should be used to specify what duration value the metrics should exceed for the alert to trigger. A duration in seconds with up to nine fractional digits, terminated by ' |
aggregationPeriod |
The period over which the metric value should be aggregated and evaluated. Format is |
alertThreshold |
For how many contiguous aggregation periods should the expected min or max be violated for the alert to be fired. |
disableAlert |
Set to false by default. When set to true, the metrics are not aggregated or pushed to Monarch for this integration alert. |
onlyFinalAttempt |
For either events or tasks, depending on the type of alert, count only final attempts, not retries. |
ThresholdValue
The threshold value of the metric, above or below which the alert should be triggered. See EventAlertConfig or TaskAlertConfig for the different alert metric types in each case.
For the *RATE metrics, one or both of these fields may be set. Zero is the default value and can be left at that.
For *PERCENTILE_DURATION metrics, one or both of these fields may be set, and also, the duration threshold value should be specified in the threshold_duration_ms member below.
For *AVERAGE_DURATION metrics, these fields should not be set at all. A different member, threshold_duration_ms, must be set in the EventAlertConfig or the TaskAlertConfig.
JSON representation | |
---|---|
{ "absolute": string, "percentage": integer } |
Fields | |
---|---|
absolute |
Absolute value threshold. |
percentage |
Percentage threshold. |
IntegrationParameter
Integration Parameter is defined in the integration config and are used to provide information about data types of the expected parameters and provide any default values if needed. They can also be used to add custom attributes. These are static in nature and should not be used for dynamic event definition. Next available id: 10
JSON representation | |
---|---|
{ "key": string, "dataType": enum ( |
Fields | |
---|---|
key |
Key is used to retrieve the corresponding parameter value. This should be unique for a given fired event. These parameters must be predefined in the integration definition. |
dataType |
Type of the parameter. |
defaultValue |
Default values for the defined keys. Each value can either be string, int, double or any proto message or a serialized object. |
searchable |
Searchable in the execution log or not. |
displayName |
The name (without prefix) to be displayed in the UI for this parameter. E.g. if the key is "foo.bar.myName", then the name would be "myName". |
inputOutputType |
Specifies the input/output type for the parameter. |
isTransient |
Whether this parameter is a transient parameter. |
producer |
The identifier of the node (TaskConfig/TriggerConfig) this parameter was produced by, if it is a transient param or a copy of an input param. |
jsonSchema |
This schema will be used to validate runtime JSON-typed values of this parameter. |