taskqueue

package
v4.21.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 26, 2025 License: MIT Imports: 11 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var File_temporal_api_taskqueue_v1_message_proto protoreflect.FileDescriptor

Functions

This section is empty.

Types

type BuildIdAssignmentRule added in v4.13.0

type BuildIdAssignmentRule struct {
	TargetBuildId string `protobuf:"bytes,1,opt,name=target_build_id,json=targetBuildId,proto3" json:"target_build_id,omitempty"`
	// If a ramp is provided, this rule will be applied only to a sample of
	// tasks according to the provided percentage.
	// This option can be used only on "terminal" Build IDs (the ones not used
	// as source in any redirect rules).
	//
	// Types that are valid to be assigned to Ramp:
	//
	//	*BuildIdAssignmentRule_PercentageRamp
	Ramp isBuildIdAssignmentRule_Ramp `protobuf_oneof:"ramp"`
	// contains filtered or unexported fields
}

Assignment rules are applied to *new* Workflow and Activity executions at schedule time to assign them to a Build ID.

Assignment rules will not be used in the following cases:

  • Child Workflows or Continue-As-New Executions who inherit their parent/previous Workflow's assigned Build ID (by setting the `inherit_build_id` flag - default behavior in SDKs when the same Task Queue is used.)
  • An Activity that inherits the assigned Build ID of its Workflow (by setting the `use_workflow_build_id` flag - default behavior in SDKs when the same Task Queue is used.)

In absence of (applicable) redirect rules (`CompatibleBuildIdRedirectRule`s) the task will be dispatched to Workers of the Build ID determined by the assignment rules (or inherited). Otherwise, the final Build ID will be determined by the redirect rules.

Once a Workflow completes its first Workflow Task in a particular Build ID it stays in that Build ID regardless of changes to assignment rules. Redirect rules can be used to move the workflow to another compatible Build ID.

When using Worker Versioning on a Task Queue, in the steady state, there should typically be a single assignment rule to send all new executions to the latest Build ID. Existence of at least one such "unconditional" rule at all times is enforces by the system, unless the `force` flag is used by the user when replacing/deleting these rules (for exceptional cases).

During a deployment, one or more additional rules can be added to assign a subset of the tasks to a new Build ID based on a "ramp percentage".

When there are multiple assignment rules for a Task Queue, the rules are evaluated in order, starting from index 0. The first applicable rule will be applied and the rest will be ignored.

In the event that no assignment rule is applicable on a task (or the Task Queue is simply not versioned), the tasks will be dispatched to an unversioned Worker.

func (*BuildIdAssignmentRule) Descriptor deprecated added in v4.13.0

func (*BuildIdAssignmentRule) Descriptor() ([]byte, []int)

Deprecated: Use BuildIdAssignmentRule.ProtoReflect.Descriptor instead.

func (*BuildIdAssignmentRule) GetPercentageRamp added in v4.13.0

func (x *BuildIdAssignmentRule) GetPercentageRamp() *RampByPercentage

func (*BuildIdAssignmentRule) GetRamp added in v4.13.0

func (x *BuildIdAssignmentRule) GetRamp() isBuildIdAssignmentRule_Ramp

func (*BuildIdAssignmentRule) GetTargetBuildId added in v4.13.0

func (x *BuildIdAssignmentRule) GetTargetBuildId() string

func (*BuildIdAssignmentRule) ProtoMessage added in v4.13.0

func (*BuildIdAssignmentRule) ProtoMessage()

func (*BuildIdAssignmentRule) ProtoReflect added in v4.13.0

func (x *BuildIdAssignmentRule) ProtoReflect() protoreflect.Message

func (*BuildIdAssignmentRule) Reset added in v4.13.0

func (x *BuildIdAssignmentRule) Reset()

func (*BuildIdAssignmentRule) String added in v4.13.0

func (x *BuildIdAssignmentRule) String() string

type BuildIdAssignmentRule_PercentageRamp added in v4.13.0

type BuildIdAssignmentRule_PercentageRamp struct {
	// This ramp is useful for gradual Blue/Green deployments (and similar)
	// where you want to send a certain portion of the traffic to the target
	// Build ID.
	PercentageRamp *RampByPercentage `protobuf:"bytes,3,opt,name=percentage_ramp,json=percentageRamp,proto3,oneof"`
}

type BuildIdReachability

type BuildIdReachability struct {

	// A build id or empty if unversioned.
	BuildId string `protobuf:"bytes,1,opt,name=build_id,json=buildId,proto3" json:"build_id,omitempty"`
	// Reachability per task queue.
	TaskQueueReachability []*TaskQueueReachability `` /* 126-byte string literal not displayed */
	// contains filtered or unexported fields
}

Reachability of tasks for a worker by build id, in one or more task queues.

func (*BuildIdReachability) Descriptor deprecated

func (*BuildIdReachability) Descriptor() ([]byte, []int)

Deprecated: Use BuildIdReachability.ProtoReflect.Descriptor instead.

func (*BuildIdReachability) GetBuildId

func (x *BuildIdReachability) GetBuildId() string

func (*BuildIdReachability) GetTaskQueueReachability

func (x *BuildIdReachability) GetTaskQueueReachability() []*TaskQueueReachability

func (*BuildIdReachability) ProtoMessage

func (*BuildIdReachability) ProtoMessage()

func (*BuildIdReachability) ProtoReflect

func (x *BuildIdReachability) ProtoReflect() protoreflect.Message

func (*BuildIdReachability) Reset

func (x *BuildIdReachability) Reset()

func (*BuildIdReachability) String

func (x *BuildIdReachability) String() string

type CompatibleBuildIdRedirectRule added in v4.13.0

type CompatibleBuildIdRedirectRule struct {
	SourceBuildId string `protobuf:"bytes,1,opt,name=source_build_id,json=sourceBuildId,proto3" json:"source_build_id,omitempty"`
	// Target Build ID must be compatible with the Source Build ID; that is it
	// must be able to process event histories made by the Source Build ID by
	// using [Patching](https://docs.temporal.io/workflows#patching) or other
	// means.
	TargetBuildId string `protobuf:"bytes,2,opt,name=target_build_id,json=targetBuildId,proto3" json:"target_build_id,omitempty"`
	// contains filtered or unexported fields
}

These rules apply to tasks assigned to a particular Build ID (`source_build_id`) to redirect them to another *compatible* Build ID (`target_build_id`).

It is user's responsibility to ensure that the target Build ID is compatible with the source Build ID (e.g. by using the Patching API).

Most deployments are not expected to need these rules, however following situations can greatly benefit from redirects:

  • Need to move long-running Workflow Executions from an old Build ID to a newer one.
  • Need to hotfix some broken or stuck Workflow Executions.

In steady state, redirect rules are beneficial when dealing with old Executions ran on now-decommissioned Build IDs:

  • To redirecting the Workflow Queries to the current (compatible) Build ID.
  • To be able to Reset an old Execution so it can run on the current (compatible) Build ID.

Redirect rules can be chained.

func (*CompatibleBuildIdRedirectRule) Descriptor deprecated added in v4.13.0

func (*CompatibleBuildIdRedirectRule) Descriptor() ([]byte, []int)

Deprecated: Use CompatibleBuildIdRedirectRule.ProtoReflect.Descriptor instead.

func (*CompatibleBuildIdRedirectRule) GetSourceBuildId added in v4.13.0

func (x *CompatibleBuildIdRedirectRule) GetSourceBuildId() string

func (*CompatibleBuildIdRedirectRule) GetTargetBuildId added in v4.13.0

func (x *CompatibleBuildIdRedirectRule) GetTargetBuildId() string

func (*CompatibleBuildIdRedirectRule) ProtoMessage added in v4.13.0

func (*CompatibleBuildIdRedirectRule) ProtoMessage()

func (*CompatibleBuildIdRedirectRule) ProtoReflect added in v4.13.0

func (*CompatibleBuildIdRedirectRule) Reset added in v4.13.0

func (x *CompatibleBuildIdRedirectRule) Reset()

func (*CompatibleBuildIdRedirectRule) String added in v4.13.0

type CompatibleVersionSet

type CompatibleVersionSet struct {

	// All the compatible versions, unordered, except for the last element, which is considered the set "default".
	BuildIds []string `protobuf:"bytes,1,rep,name=build_ids,json=buildIds,proto3" json:"build_ids,omitempty"`
	// contains filtered or unexported fields
}

Used by the worker versioning APIs, represents an unordered set of one or more versions which are considered to be compatible with each other. Currently the versions are always worker build IDs.

func (*CompatibleVersionSet) Descriptor deprecated

func (*CompatibleVersionSet) Descriptor() ([]byte, []int)

Deprecated: Use CompatibleVersionSet.ProtoReflect.Descriptor instead.

func (*CompatibleVersionSet) GetBuildIds

func (x *CompatibleVersionSet) GetBuildIds() []string

func (*CompatibleVersionSet) ProtoMessage

func (*CompatibleVersionSet) ProtoMessage()

func (*CompatibleVersionSet) ProtoReflect

func (x *CompatibleVersionSet) ProtoReflect() protoreflect.Message

func (*CompatibleVersionSet) Reset

func (x *CompatibleVersionSet) Reset()

func (*CompatibleVersionSet) String

func (x *CompatibleVersionSet) String() string

type ConfigMetadata added in v4.21.0

type ConfigMetadata struct {

	// Reason for why the config was set.
	Reason string `protobuf:"bytes,1,opt,name=reason,proto3" json:"reason,omitempty"`
	// Identity of the last updater.
	// Set by the request's identity field.
	UpdateIdentity string `protobuf:"bytes,2,opt,name=update_identity,json=updateIdentity,proto3" json:"update_identity,omitempty"`
	// Time of the last update.
	UpdateTime *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=update_time,json=updateTime,proto3" json:"update_time,omitempty"`
	// contains filtered or unexported fields
}

func (*ConfigMetadata) Descriptor deprecated added in v4.21.0

func (*ConfigMetadata) Descriptor() ([]byte, []int)

Deprecated: Use ConfigMetadata.ProtoReflect.Descriptor instead.

func (*ConfigMetadata) GetReason added in v4.21.0

func (x *ConfigMetadata) GetReason() string

func (*ConfigMetadata) GetUpdateIdentity added in v4.21.0

func (x *ConfigMetadata) GetUpdateIdentity() string

func (*ConfigMetadata) GetUpdateTime added in v4.21.0

func (x *ConfigMetadata) GetUpdateTime() *timestamppb.Timestamp

func (*ConfigMetadata) ProtoMessage added in v4.21.0

func (*ConfigMetadata) ProtoMessage()

func (*ConfigMetadata) ProtoReflect added in v4.21.0

func (x *ConfigMetadata) ProtoReflect() protoreflect.Message

func (*ConfigMetadata) Reset added in v4.21.0

func (x *ConfigMetadata) Reset()

func (*ConfigMetadata) String added in v4.21.0

func (x *ConfigMetadata) String() string

type PollerInfo

type PollerInfo struct {
	LastAccessTime *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=last_access_time,json=lastAccessTime,proto3" json:"last_access_time,omitempty"`
	Identity       string                 `protobuf:"bytes,2,opt,name=identity,proto3" json:"identity,omitempty"`
	RatePerSecond  float64                `protobuf:"fixed64,3,opt,name=rate_per_second,json=ratePerSecond,proto3" json:"rate_per_second,omitempty"`
	// If a worker has opted into the worker versioning feature while polling, its capabilities will
	// appear here.
	// Deprecated. Replaced by deployment_options.
	//
	// Deprecated: Marked as deprecated in temporal/api/taskqueue/v1/message.proto.
	WorkerVersionCapabilities *v12.WorkerVersionCapabilities `` /* 138-byte string literal not displayed */
	// Worker deployment options that SDK sent to server.
	DeploymentOptions *v11.WorkerDeploymentOptions `protobuf:"bytes,5,opt,name=deployment_options,json=deploymentOptions,proto3" json:"deployment_options,omitempty"`
	// contains filtered or unexported fields
}

func (*PollerInfo) Descriptor deprecated

func (*PollerInfo) Descriptor() ([]byte, []int)

Deprecated: Use PollerInfo.ProtoReflect.Descriptor instead.

func (*PollerInfo) GetDeploymentOptions added in v4.19.0

func (x *PollerInfo) GetDeploymentOptions() *v11.WorkerDeploymentOptions

func (*PollerInfo) GetIdentity

func (x *PollerInfo) GetIdentity() string

func (*PollerInfo) GetLastAccessTime

func (x *PollerInfo) GetLastAccessTime() *timestamppb.Timestamp

func (*PollerInfo) GetRatePerSecond

func (x *PollerInfo) GetRatePerSecond() float64

func (*PollerInfo) GetWorkerVersionCapabilities deprecated

func (x *PollerInfo) GetWorkerVersionCapabilities() *v12.WorkerVersionCapabilities

Deprecated: Marked as deprecated in temporal/api/taskqueue/v1/message.proto.

func (*PollerInfo) ProtoMessage

func (*PollerInfo) ProtoMessage()

func (*PollerInfo) ProtoReflect

func (x *PollerInfo) ProtoReflect() protoreflect.Message

func (*PollerInfo) Reset

func (x *PollerInfo) Reset()

func (*PollerInfo) String

func (x *PollerInfo) String() string

type PollerScalingDecision added in v4.19.0

type PollerScalingDecision struct {

	// How many poll requests to suggest should be added or removed, if any. As of now, server only
	// scales up or down by 1. However, SDKs should allow for other values (while staying within
	// defined min/max).
	//
	// The SDK is free to ignore this suggestion, EX: making more polls would not make sense because
	// all slots are already occupied.
	PollRequestDeltaSuggestion int32 `` /* 144-byte string literal not displayed */
	// contains filtered or unexported fields
}

Attached to task responses to give hints to the SDK about how it may adjust its number of pollers.

func (*PollerScalingDecision) Descriptor deprecated added in v4.19.0

func (*PollerScalingDecision) Descriptor() ([]byte, []int)

Deprecated: Use PollerScalingDecision.ProtoReflect.Descriptor instead.

func (*PollerScalingDecision) GetPollRequestDeltaSuggestion added in v4.19.0

func (x *PollerScalingDecision) GetPollRequestDeltaSuggestion() int32

func (*PollerScalingDecision) ProtoMessage added in v4.19.0

func (*PollerScalingDecision) ProtoMessage()

func (*PollerScalingDecision) ProtoReflect added in v4.19.0

func (x *PollerScalingDecision) ProtoReflect() protoreflect.Message

func (*PollerScalingDecision) Reset added in v4.19.0

func (x *PollerScalingDecision) Reset()

func (*PollerScalingDecision) String added in v4.19.0

func (x *PollerScalingDecision) String() string

type RampByPercentage added in v4.13.0

type RampByPercentage struct {

	// Acceptable range is [0,100).
	RampPercentage float32 `protobuf:"fixed32,1,opt,name=ramp_percentage,json=rampPercentage,proto3" json:"ramp_percentage,omitempty"`
	// contains filtered or unexported fields
}

func (*RampByPercentage) Descriptor deprecated added in v4.13.0

func (*RampByPercentage) Descriptor() ([]byte, []int)

Deprecated: Use RampByPercentage.ProtoReflect.Descriptor instead.

func (*RampByPercentage) GetRampPercentage added in v4.13.0

func (x *RampByPercentage) GetRampPercentage() float32

func (*RampByPercentage) ProtoMessage added in v4.13.0

func (*RampByPercentage) ProtoMessage()

func (*RampByPercentage) ProtoReflect added in v4.13.0

func (x *RampByPercentage) ProtoReflect() protoreflect.Message

func (*RampByPercentage) Reset added in v4.13.0

func (x *RampByPercentage) Reset()

func (*RampByPercentage) String added in v4.13.0

func (x *RampByPercentage) String() string

type RateLimit added in v4.21.0

type RateLimit struct {

	// Zero is a valid rate limit.
	RequestsPerSecond float32 `protobuf:"fixed32,1,opt,name=requests_per_second,json=requestsPerSecond,proto3" json:"requests_per_second,omitempty"`
	// contains filtered or unexported fields
}

func (*RateLimit) Descriptor deprecated added in v4.21.0

func (*RateLimit) Descriptor() ([]byte, []int)

Deprecated: Use RateLimit.ProtoReflect.Descriptor instead.

func (*RateLimit) GetRequestsPerSecond added in v4.21.0

func (x *RateLimit) GetRequestsPerSecond() float32

func (*RateLimit) ProtoMessage added in v4.21.0

func (*RateLimit) ProtoMessage()

func (*RateLimit) ProtoReflect added in v4.21.0

func (x *RateLimit) ProtoReflect() protoreflect.Message

func (*RateLimit) Reset added in v4.21.0

func (x *RateLimit) Reset()

func (*RateLimit) String added in v4.21.0

func (x *RateLimit) String() string

type RateLimitConfig added in v4.21.0

type RateLimitConfig struct {
	RateLimit *RateLimit      `protobuf:"bytes,1,opt,name=rate_limit,json=rateLimit,proto3" json:"rate_limit,omitempty"`
	Metadata  *ConfigMetadata `protobuf:"bytes,2,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

func (*RateLimitConfig) Descriptor deprecated added in v4.21.0

func (*RateLimitConfig) Descriptor() ([]byte, []int)

Deprecated: Use RateLimitConfig.ProtoReflect.Descriptor instead.

func (*RateLimitConfig) GetMetadata added in v4.21.0

func (x *RateLimitConfig) GetMetadata() *ConfigMetadata

func (*RateLimitConfig) GetRateLimit added in v4.21.0

func (x *RateLimitConfig) GetRateLimit() *RateLimit

func (*RateLimitConfig) ProtoMessage added in v4.21.0

func (*RateLimitConfig) ProtoMessage()

func (*RateLimitConfig) ProtoReflect added in v4.21.0

func (x *RateLimitConfig) ProtoReflect() protoreflect.Message

func (*RateLimitConfig) Reset added in v4.21.0

func (x *RateLimitConfig) Reset()

func (*RateLimitConfig) String added in v4.21.0

func (x *RateLimitConfig) String() string

type StickyExecutionAttributes

type StickyExecutionAttributes struct {
	WorkerTaskQueue *TaskQueue `protobuf:"bytes,1,opt,name=worker_task_queue,json=workerTaskQueue,proto3" json:"worker_task_queue,omitempty"`
	// (-- api-linter: core::0140::prepositions=disabled
	//
	//	aip.dev/not-precedent: "to" is used to indicate interval. --)
	ScheduleToStartTimeout *durationpb.Duration `` /* 131-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*StickyExecutionAttributes) Descriptor deprecated

func (*StickyExecutionAttributes) Descriptor() ([]byte, []int)

Deprecated: Use StickyExecutionAttributes.ProtoReflect.Descriptor instead.

func (*StickyExecutionAttributes) GetScheduleToStartTimeout

func (x *StickyExecutionAttributes) GetScheduleToStartTimeout() *durationpb.Duration

func (*StickyExecutionAttributes) GetWorkerTaskQueue

func (x *StickyExecutionAttributes) GetWorkerTaskQueue() *TaskQueue

func (*StickyExecutionAttributes) ProtoMessage

func (*StickyExecutionAttributes) ProtoMessage()

func (*StickyExecutionAttributes) ProtoReflect

func (*StickyExecutionAttributes) Reset

func (x *StickyExecutionAttributes) Reset()

func (*StickyExecutionAttributes) String

func (x *StickyExecutionAttributes) String() string

type TaskIdBlock

type TaskIdBlock struct {
	StartId int64 `protobuf:"varint,1,opt,name=start_id,json=startId,proto3" json:"start_id,omitempty"`
	EndId   int64 `protobuf:"varint,2,opt,name=end_id,json=endId,proto3" json:"end_id,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskIdBlock) Descriptor deprecated

func (*TaskIdBlock) Descriptor() ([]byte, []int)

Deprecated: Use TaskIdBlock.ProtoReflect.Descriptor instead.

func (*TaskIdBlock) GetEndId

func (x *TaskIdBlock) GetEndId() int64

func (*TaskIdBlock) GetStartId

func (x *TaskIdBlock) GetStartId() int64

func (*TaskIdBlock) ProtoMessage

func (*TaskIdBlock) ProtoMessage()

func (*TaskIdBlock) ProtoReflect

func (x *TaskIdBlock) ProtoReflect() protoreflect.Message

func (*TaskIdBlock) Reset

func (x *TaskIdBlock) Reset()

func (*TaskIdBlock) String

func (x *TaskIdBlock) String() string

type TaskQueue

type TaskQueue struct {
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Default: TASK_QUEUE_KIND_NORMAL.
	Kind v1.TaskQueueKind `protobuf:"varint,2,opt,name=kind,proto3,enum=temporal.api.enums.v1.TaskQueueKind" json:"kind,omitempty"`
	// Iff kind == TASK_QUEUE_KIND_STICKY, then this field contains the name of
	// the normal task queue that the sticky worker is running on.
	NormalName string `protobuf:"bytes,3,opt,name=normal_name,json=normalName,proto3" json:"normal_name,omitempty"`
	// contains filtered or unexported fields
}

See https://docs.temporal.io/docs/concepts/task-queues/

func (*TaskQueue) Descriptor deprecated

func (*TaskQueue) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueue.ProtoReflect.Descriptor instead.

func (*TaskQueue) GetKind

func (x *TaskQueue) GetKind() v1.TaskQueueKind

func (*TaskQueue) GetName

func (x *TaskQueue) GetName() string

func (*TaskQueue) GetNormalName

func (x *TaskQueue) GetNormalName() string

func (*TaskQueue) ProtoMessage

func (*TaskQueue) ProtoMessage()

func (*TaskQueue) ProtoReflect

func (x *TaskQueue) ProtoReflect() protoreflect.Message

func (*TaskQueue) Reset

func (x *TaskQueue) Reset()

func (*TaskQueue) String

func (x *TaskQueue) String() string

type TaskQueueConfig added in v4.21.0

type TaskQueueConfig struct {

	// Unless modified, this is the system-defined rate limit.
	QueueRateLimit *RateLimitConfig `protobuf:"bytes,1,opt,name=queue_rate_limit,json=queueRateLimit,proto3" json:"queue_rate_limit,omitempty"`
	// If set, each individual fairness key will be limited to this rate, scaled by the weight of the fairness key.
	FairnessKeysRateLimitDefault *RateLimitConfig `` /* 151-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*TaskQueueConfig) Descriptor deprecated added in v4.21.0

func (*TaskQueueConfig) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueConfig.ProtoReflect.Descriptor instead.

func (*TaskQueueConfig) GetFairnessKeysRateLimitDefault added in v4.21.0

func (x *TaskQueueConfig) GetFairnessKeysRateLimitDefault() *RateLimitConfig

func (*TaskQueueConfig) GetQueueRateLimit added in v4.21.0

func (x *TaskQueueConfig) GetQueueRateLimit() *RateLimitConfig

func (*TaskQueueConfig) ProtoMessage added in v4.21.0

func (*TaskQueueConfig) ProtoMessage()

func (*TaskQueueConfig) ProtoReflect added in v4.21.0

func (x *TaskQueueConfig) ProtoReflect() protoreflect.Message

func (*TaskQueueConfig) Reset added in v4.21.0

func (x *TaskQueueConfig) Reset()

func (*TaskQueueConfig) String added in v4.21.0

func (x *TaskQueueConfig) String() string

type TaskQueueMetadata

type TaskQueueMetadata struct {

	// Allows throttling dispatch of tasks from this queue
	MaxTasksPerSecond *wrapperspb.DoubleValue `protobuf:"bytes,1,opt,name=max_tasks_per_second,json=maxTasksPerSecond,proto3" json:"max_tasks_per_second,omitempty"`
	// contains filtered or unexported fields
}

Only applies to activity task queues

func (*TaskQueueMetadata) Descriptor deprecated

func (*TaskQueueMetadata) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueMetadata.ProtoReflect.Descriptor instead.

func (*TaskQueueMetadata) GetMaxTasksPerSecond

func (x *TaskQueueMetadata) GetMaxTasksPerSecond() *wrapperspb.DoubleValue

func (*TaskQueueMetadata) ProtoMessage

func (*TaskQueueMetadata) ProtoMessage()

func (*TaskQueueMetadata) ProtoReflect

func (x *TaskQueueMetadata) ProtoReflect() protoreflect.Message

func (*TaskQueueMetadata) Reset

func (x *TaskQueueMetadata) Reset()

func (*TaskQueueMetadata) String

func (x *TaskQueueMetadata) String() string

type TaskQueuePartitionMetadata

type TaskQueuePartitionMetadata struct {
	Key           string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
	OwnerHostName string `protobuf:"bytes,2,opt,name=owner_host_name,json=ownerHostName,proto3" json:"owner_host_name,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskQueuePartitionMetadata) Descriptor deprecated

func (*TaskQueuePartitionMetadata) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueuePartitionMetadata.ProtoReflect.Descriptor instead.

func (*TaskQueuePartitionMetadata) GetKey

func (x *TaskQueuePartitionMetadata) GetKey() string

func (*TaskQueuePartitionMetadata) GetOwnerHostName

func (x *TaskQueuePartitionMetadata) GetOwnerHostName() string

func (*TaskQueuePartitionMetadata) ProtoMessage

func (*TaskQueuePartitionMetadata) ProtoMessage()

func (*TaskQueuePartitionMetadata) ProtoReflect

func (*TaskQueuePartitionMetadata) Reset

func (x *TaskQueuePartitionMetadata) Reset()

func (*TaskQueuePartitionMetadata) String

func (x *TaskQueuePartitionMetadata) String() string

type TaskQueueReachability

type TaskQueueReachability struct {
	TaskQueue string `protobuf:"bytes,1,opt,name=task_queue,json=taskQueue,proto3" json:"task_queue,omitempty"`
	// Task reachability for a worker in a single task queue.
	// See the TaskReachability docstring for information about each enum variant.
	// If reachability is empty, this worker is considered unreachable in this task queue.
	Reachability []v1.TaskReachability `` /* 129-byte string literal not displayed */
	// contains filtered or unexported fields
}

Reachability of tasks for a worker on a single task queue.

func (*TaskQueueReachability) Descriptor deprecated

func (*TaskQueueReachability) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueReachability.ProtoReflect.Descriptor instead.

func (*TaskQueueReachability) GetReachability

func (x *TaskQueueReachability) GetReachability() []v1.TaskReachability

func (*TaskQueueReachability) GetTaskQueue

func (x *TaskQueueReachability) GetTaskQueue() string

func (*TaskQueueReachability) ProtoMessage

func (*TaskQueueReachability) ProtoMessage()

func (*TaskQueueReachability) ProtoReflect

func (x *TaskQueueReachability) ProtoReflect() protoreflect.Message

func (*TaskQueueReachability) Reset

func (x *TaskQueueReachability) Reset()

func (*TaskQueueReachability) String

func (x *TaskQueueReachability) String() string

type TaskQueueStats added in v4.15.0

type TaskQueueStats struct {

	// The approximate number of tasks backlogged in this task queue. May count expired tasks but eventually
	// converges to the right value. Can be relied upon for scaling decisions.
	//
	// Special note for workflow task queue type: this metric does not count sticky queue tasks. However, because
	// those tasks only remain valid for a few seconds, the inaccuracy becomes less significant as the backlog size
	// grows.
	ApproximateBacklogCount int64 `` /* 133-byte string literal not displayed */
	// Approximate age of the oldest task in the backlog based on the creation time of the task at the head of
	// the queue. Can be relied upon for scaling decisions.
	//
	// Special note for workflow task queue type: this metric does not count sticky queue tasks. However, because
	// those tasks only remain valid for a few seconds, they should not affect the result when backlog is older than
	// few seconds.
	ApproximateBacklogAge *durationpb.Duration `` /* 126-byte string literal not displayed */
	// The approximate tasks per second added to the task queue, averaging the last 30 seconds. These includes tasks
	// whether or not they were added to/dispatched from the backlog or they were dispatched immediately without going
	// to the backlog (sync-matched).
	//
	// The difference between `tasks_add_rate` and `tasks_dispatch_rate` is a reliable metric for the rate at which
	// backlog grows/shrinks.
	//
	// Note: the actual tasks delivered to the workers may significantly be higher than the numbers reported by
	// tasks_add_rate, because:
	//   - Tasks can be sent to workers without going to the task queue. This is called Eager dispatch. Eager dispatch is
	//     enable for activities by default in the latest SDKs.
	//   - Tasks going to Sticky queue are not accounted for. Note that, typically, only the first workflow task of each
	//     workflow goes to a normal queue, and the rest workflow tasks go to the Sticky queue associated with a specific
	//     worker instance.
	TasksAddRate float32 `protobuf:"fixed32,3,opt,name=tasks_add_rate,json=tasksAddRate,proto3" json:"tasks_add_rate,omitempty"`
	// The approximate tasks per second dispatched from the task queue, averaging the last 30 seconds. These includes
	// tasks whether or not they were added to/dispatched from the backlog or they were dispatched immediately without
	// going to the backlog (sync-matched).
	//
	// The difference between `tasks_add_rate` and `tasks_dispatch_rate` is a reliable metric for the rate at which
	// backlog grows/shrinks.
	//
	// Note: the actual tasks delivered to the workers may significantly be higher than the numbers reported by
	// tasks_dispatch_rate, because:
	//   - Tasks can be sent to workers without going to the task queue. This is called Eager dispatch. Eager dispatch is
	//     enable for activities by default in the latest SDKs.
	//   - Tasks going to Sticky queue are not accounted for. Note that, typically, only the first workflow task of each
	//     workflow goes to a normal queue, and the rest workflow tasks go to the Sticky queue associated with a specific
	//     worker instance.
	TasksDispatchRate float32 `protobuf:"fixed32,4,opt,name=tasks_dispatch_rate,json=tasksDispatchRate,proto3" json:"tasks_dispatch_rate,omitempty"`
	// contains filtered or unexported fields
}

TaskQueueStats contains statistics about task queue backlog and activity.

For workflow task queue type, this result is partial because tasks sent to sticky queues are not included. Read comments above each metric to understand the impact of sticky queue exclusion on that metric accuracy.

func (*TaskQueueStats) Descriptor deprecated added in v4.15.0

func (*TaskQueueStats) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueStats.ProtoReflect.Descriptor instead.

func (*TaskQueueStats) GetApproximateBacklogAge added in v4.15.0

func (x *TaskQueueStats) GetApproximateBacklogAge() *durationpb.Duration

func (*TaskQueueStats) GetApproximateBacklogCount added in v4.15.0

func (x *TaskQueueStats) GetApproximateBacklogCount() int64

func (*TaskQueueStats) GetTasksAddRate added in v4.15.0

func (x *TaskQueueStats) GetTasksAddRate() float32

func (*TaskQueueStats) GetTasksDispatchRate added in v4.15.0

func (x *TaskQueueStats) GetTasksDispatchRate() float32

func (*TaskQueueStats) ProtoMessage added in v4.15.0

func (*TaskQueueStats) ProtoMessage()

func (*TaskQueueStats) ProtoReflect added in v4.15.0

func (x *TaskQueueStats) ProtoReflect() protoreflect.Message

func (*TaskQueueStats) Reset added in v4.15.0

func (x *TaskQueueStats) Reset()

func (*TaskQueueStats) String added in v4.15.0

func (x *TaskQueueStats) String() string

type TaskQueueStatus

type TaskQueueStatus struct {
	BacklogCountHint int64        `protobuf:"varint,1,opt,name=backlog_count_hint,json=backlogCountHint,proto3" json:"backlog_count_hint,omitempty"`
	ReadLevel        int64        `protobuf:"varint,2,opt,name=read_level,json=readLevel,proto3" json:"read_level,omitempty"`
	AckLevel         int64        `protobuf:"varint,3,opt,name=ack_level,json=ackLevel,proto3" json:"ack_level,omitempty"`
	RatePerSecond    float64      `protobuf:"fixed64,4,opt,name=rate_per_second,json=ratePerSecond,proto3" json:"rate_per_second,omitempty"`
	TaskIdBlock      *TaskIdBlock `protobuf:"bytes,5,opt,name=task_id_block,json=taskIdBlock,proto3" json:"task_id_block,omitempty"`
	// contains filtered or unexported fields
}

Deprecated. Use `InternalTaskQueueStatus`. This is kept until `DescribeTaskQueue` supports legacy behavior.

func (*TaskQueueStatus) Descriptor deprecated

func (*TaskQueueStatus) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueStatus.ProtoReflect.Descriptor instead.

func (*TaskQueueStatus) GetAckLevel

func (x *TaskQueueStatus) GetAckLevel() int64

func (*TaskQueueStatus) GetBacklogCountHint

func (x *TaskQueueStatus) GetBacklogCountHint() int64

func (*TaskQueueStatus) GetRatePerSecond

func (x *TaskQueueStatus) GetRatePerSecond() float64

func (*TaskQueueStatus) GetReadLevel

func (x *TaskQueueStatus) GetReadLevel() int64

func (*TaskQueueStatus) GetTaskIdBlock

func (x *TaskQueueStatus) GetTaskIdBlock() *TaskIdBlock

func (*TaskQueueStatus) ProtoMessage

func (*TaskQueueStatus) ProtoMessage()

func (*TaskQueueStatus) ProtoReflect

func (x *TaskQueueStatus) ProtoReflect() protoreflect.Message

func (*TaskQueueStatus) Reset

func (x *TaskQueueStatus) Reset()

func (*TaskQueueStatus) String

func (x *TaskQueueStatus) String() string

type TaskQueueTypeInfo added in v4.13.0

type TaskQueueTypeInfo struct {

	// Unversioned workers (with `useVersioning=false`) are reported in unversioned result even if they set a Build ID.
	Pollers []*PollerInfo   `protobuf:"bytes,1,rep,name=pollers,proto3" json:"pollers,omitempty"`
	Stats   *TaskQueueStats `protobuf:"bytes,2,opt,name=stats,proto3" json:"stats,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskQueueTypeInfo) Descriptor deprecated added in v4.13.0

func (*TaskQueueTypeInfo) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueTypeInfo.ProtoReflect.Descriptor instead.

func (*TaskQueueTypeInfo) GetPollers added in v4.13.0

func (x *TaskQueueTypeInfo) GetPollers() []*PollerInfo

func (*TaskQueueTypeInfo) GetStats added in v4.15.0

func (x *TaskQueueTypeInfo) GetStats() *TaskQueueStats

func (*TaskQueueTypeInfo) ProtoMessage added in v4.13.0

func (*TaskQueueTypeInfo) ProtoMessage()

func (*TaskQueueTypeInfo) ProtoReflect added in v4.13.0

func (x *TaskQueueTypeInfo) ProtoReflect() protoreflect.Message

func (*TaskQueueTypeInfo) Reset added in v4.13.0

func (x *TaskQueueTypeInfo) Reset()

func (*TaskQueueTypeInfo) String added in v4.13.0

func (x *TaskQueueTypeInfo) String() string

type TaskQueueVersionInfo added in v4.13.0

type TaskQueueVersionInfo struct {

	// Task Queue info per Task Type. Key is the numerical value of the temporal.api.enums.v1.TaskQueueType enum.
	TypesInfo map[int32]*TaskQueueTypeInfo `` /* 163-byte string literal not displayed */
	// Task Reachability is eventually consistent; there may be a delay until it converges to the most
	// accurate value but it is designed in a way to take the more conservative side until it converges.
	// For example REACHABLE is more conservative than CLOSED_WORKFLOWS_ONLY.
	//
	// Note: future activities who inherit their workflow's Build ID but not its Task Queue will not be
	// accounted for reachability as server cannot know if they'll happen as they do not use
	// assignment rules of their Task Queue. Same goes for Child Workflows or Continue-As-New Workflows
	// who inherit the parent/previous workflow's Build ID but not its Task Queue. In those cases, make
	// sure to query reachability for the parent/previous workflow's Task Queue as well.
	TaskReachability v1.BuildIdTaskReachability `` /* 161-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*TaskQueueVersionInfo) Descriptor deprecated added in v4.13.0

func (*TaskQueueVersionInfo) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueVersionInfo.ProtoReflect.Descriptor instead.

func (*TaskQueueVersionInfo) GetTaskReachability added in v4.13.0

func (x *TaskQueueVersionInfo) GetTaskReachability() v1.BuildIdTaskReachability

func (*TaskQueueVersionInfo) GetTypesInfo added in v4.13.0

func (x *TaskQueueVersionInfo) GetTypesInfo() map[int32]*TaskQueueTypeInfo

func (*TaskQueueVersionInfo) ProtoMessage added in v4.13.0

func (*TaskQueueVersionInfo) ProtoMessage()

func (*TaskQueueVersionInfo) ProtoReflect added in v4.13.0

func (x *TaskQueueVersionInfo) ProtoReflect() protoreflect.Message

func (*TaskQueueVersionInfo) Reset added in v4.13.0

func (x *TaskQueueVersionInfo) Reset()

func (*TaskQueueVersionInfo) String added in v4.13.0

func (x *TaskQueueVersionInfo) String() string

type TaskQueueVersionSelection added in v4.13.0

type TaskQueueVersionSelection struct {

	// Include specific Build IDs.
	BuildIds []string `protobuf:"bytes,1,rep,name=build_ids,json=buildIds,proto3" json:"build_ids,omitempty"`
	// Include the unversioned queue.
	Unversioned bool `protobuf:"varint,2,opt,name=unversioned,proto3" json:"unversioned,omitempty"`
	// Include all active versions. A version is considered active if, in the last few minutes,
	// it has had new tasks or polls, or it has been the subject of certain task queue API calls.
	AllActive bool `protobuf:"varint,3,opt,name=all_active,json=allActive,proto3" json:"all_active,omitempty"`
	// contains filtered or unexported fields
}

Used for specifying versions the caller is interested in.

func (*TaskQueueVersionSelection) Descriptor deprecated added in v4.13.0

func (*TaskQueueVersionSelection) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueVersionSelection.ProtoReflect.Descriptor instead.

func (*TaskQueueVersionSelection) GetAllActive added in v4.13.0

func (x *TaskQueueVersionSelection) GetAllActive() bool

func (*TaskQueueVersionSelection) GetBuildIds added in v4.13.0

func (x *TaskQueueVersionSelection) GetBuildIds() []string

func (*TaskQueueVersionSelection) GetUnversioned added in v4.13.0

func (x *TaskQueueVersionSelection) GetUnversioned() bool

func (*TaskQueueVersionSelection) ProtoMessage added in v4.13.0

func (*TaskQueueVersionSelection) ProtoMessage()

func (*TaskQueueVersionSelection) ProtoReflect added in v4.13.0

func (*TaskQueueVersionSelection) Reset added in v4.13.0

func (x *TaskQueueVersionSelection) Reset()

func (*TaskQueueVersionSelection) String added in v4.13.0

func (x *TaskQueueVersionSelection) String() string

type TaskQueueVersioningInfo added in v4.19.0

type TaskQueueVersioningInfo struct {

	// Specifies which Deployment Version should receive new workflow executions and tasks of
	// existing unversioned or AutoUpgrade workflows.
	// Nil value represents all the unversioned workers (those with `UNVERSIONED` (or unspecified) `WorkerVersioningMode`.)
	// Note: Current Version is overridden by the Ramping Version for a portion of traffic when ramp percentage
	// is non-zero (see `ramping_deployment_version` and `ramping_version_percentage`).
	CurrentDeploymentVersion *v11.WorkerDeploymentVersion `` /* 135-byte string literal not displayed */
	// Deprecated. Use `current_deployment_version`.
	//
	// Deprecated: Marked as deprecated in temporal/api/taskqueue/v1/message.proto.
	CurrentVersion string `protobuf:"bytes,1,opt,name=current_version,json=currentVersion,proto3" json:"current_version,omitempty"`
	// When ramp percentage is non-zero, that portion of traffic is shifted from the Current Version to the Ramping Version.
	// Must always be different from `current_deployment_version` unless both are nil.
	// Nil value represents all the unversioned workers (those with `UNVERSIONED` (or unspecified) `WorkerVersioningMode`.)
	// Note that it is possible to ramp from one Version to another Version, or from unversioned
	// workers to a particular Version, or from a particular Version to unversioned workers.
	RampingDeploymentVersion *v11.WorkerDeploymentVersion `` /* 135-byte string literal not displayed */
	// Deprecated. Use `ramping_deployment_version`.
	//
	// Deprecated: Marked as deprecated in temporal/api/taskqueue/v1/message.proto.
	RampingVersion string `protobuf:"bytes,2,opt,name=ramping_version,json=rampingVersion,proto3" json:"ramping_version,omitempty"`
	// Percentage of tasks that are routed to the Ramping Version instead of the Current Version.
	// Valid range: [0, 100]. A 100% value means the Ramping Version is receiving full traffic but
	// not yet "promoted" to be the Current Version, likely due to pending validations.
	// A 0% value means the Ramping Version is receiving no traffic.
	RampingVersionPercentage float32 `` /* 137-byte string literal not displayed */
	// Last time versioning information of this Task Queue changed.
	UpdateTime *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=update_time,json=updateTime,proto3" json:"update_time,omitempty"`
	// contains filtered or unexported fields
}

Experimental. Worker Deployments are experimental and might significantly change in the future.

func (*TaskQueueVersioningInfo) Descriptor deprecated added in v4.19.0

func (*TaskQueueVersioningInfo) Descriptor() ([]byte, []int)

Deprecated: Use TaskQueueVersioningInfo.ProtoReflect.Descriptor instead.

func (*TaskQueueVersioningInfo) GetCurrentDeploymentVersion added in v4.21.0

func (x *TaskQueueVersioningInfo) GetCurrentDeploymentVersion() *v11.WorkerDeploymentVersion

func (*TaskQueueVersioningInfo) GetCurrentVersion deprecated added in v4.19.0

func (x *TaskQueueVersioningInfo) GetCurrentVersion() string

Deprecated: Marked as deprecated in temporal/api/taskqueue/v1/message.proto.

func (*TaskQueueVersioningInfo) GetRampingDeploymentVersion added in v4.21.0

func (x *TaskQueueVersioningInfo) GetRampingDeploymentVersion() *v11.WorkerDeploymentVersion

func (*TaskQueueVersioningInfo) GetRampingVersion deprecated added in v4.19.0

func (x *TaskQueueVersioningInfo) GetRampingVersion() string

Deprecated: Marked as deprecated in temporal/api/taskqueue/v1/message.proto.

func (*TaskQueueVersioningInfo) GetRampingVersionPercentage added in v4.19.0

func (x *TaskQueueVersioningInfo) GetRampingVersionPercentage() float32

func (*TaskQueueVersioningInfo) GetUpdateTime added in v4.19.0

func (x *TaskQueueVersioningInfo) GetUpdateTime() *timestamppb.Timestamp

func (*TaskQueueVersioningInfo) ProtoMessage added in v4.19.0

func (*TaskQueueVersioningInfo) ProtoMessage()

func (*TaskQueueVersioningInfo) ProtoReflect added in v4.19.0

func (x *TaskQueueVersioningInfo) ProtoReflect() protoreflect.Message

func (*TaskQueueVersioningInfo) Reset added in v4.19.0

func (x *TaskQueueVersioningInfo) Reset()

func (*TaskQueueVersioningInfo) String added in v4.19.0

func (x *TaskQueueVersioningInfo) String() string

type TimestampedBuildIdAssignmentRule added in v4.13.0

type TimestampedBuildIdAssignmentRule struct {
	Rule       *BuildIdAssignmentRule `protobuf:"bytes,1,opt,name=rule,proto3" json:"rule,omitempty"`
	CreateTime *timestamppb.Timestamp `protobuf:"bytes,2,opt,name=create_time,json=createTime,proto3" json:"create_time,omitempty"`
	// contains filtered or unexported fields
}

func (*TimestampedBuildIdAssignmentRule) Descriptor deprecated added in v4.13.0

func (*TimestampedBuildIdAssignmentRule) Descriptor() ([]byte, []int)

Deprecated: Use TimestampedBuildIdAssignmentRule.ProtoReflect.Descriptor instead.

func (*TimestampedBuildIdAssignmentRule) GetCreateTime added in v4.13.0

func (*TimestampedBuildIdAssignmentRule) GetRule added in v4.13.0

func (*TimestampedBuildIdAssignmentRule) ProtoMessage added in v4.13.0

func (*TimestampedBuildIdAssignmentRule) ProtoMessage()

func (*TimestampedBuildIdAssignmentRule) ProtoReflect added in v4.13.0

func (*TimestampedBuildIdAssignmentRule) Reset added in v4.13.0

func (*TimestampedBuildIdAssignmentRule) String added in v4.13.0

type TimestampedCompatibleBuildIdRedirectRule added in v4.13.0

type TimestampedCompatibleBuildIdRedirectRule struct {
	Rule       *CompatibleBuildIdRedirectRule `protobuf:"bytes,1,opt,name=rule,proto3" json:"rule,omitempty"`
	CreateTime *timestamppb.Timestamp         `protobuf:"bytes,2,opt,name=create_time,json=createTime,proto3" json:"create_time,omitempty"`
	// contains filtered or unexported fields
}

func (*TimestampedCompatibleBuildIdRedirectRule) Descriptor deprecated added in v4.13.0

func (*TimestampedCompatibleBuildIdRedirectRule) Descriptor() ([]byte, []int)

Deprecated: Use TimestampedCompatibleBuildIdRedirectRule.ProtoReflect.Descriptor instead.

func (*TimestampedCompatibleBuildIdRedirectRule) GetCreateTime added in v4.13.0

func (*TimestampedCompatibleBuildIdRedirectRule) GetRule added in v4.13.0

func (*TimestampedCompatibleBuildIdRedirectRule) ProtoMessage added in v4.13.0

func (*TimestampedCompatibleBuildIdRedirectRule) ProtoReflect added in v4.13.0

func (*TimestampedCompatibleBuildIdRedirectRule) Reset added in v4.13.0

func (*TimestampedCompatibleBuildIdRedirectRule) String added in v4.13.0

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL