Documentation ¶
Index ¶
- Variables
- func FileDescriptorSet() *descriptorpb.FileDescriptorSet
- func RegisterGardeningServer(s prpc.Registrar, srv GardeningServer)
- type BatchUpdateTriageStateRequest
- func (*BatchUpdateTriageStateRequest) Descriptor() ([]byte, []int)deprecated
- func (x *BatchUpdateTriageStateRequest) GetRequests() []*UpdateTriageStateRequest
- func (*BatchUpdateTriageStateRequest) ProtoMessage()
- func (x *BatchUpdateTriageStateRequest) ProtoReflect() protoreflect.Message
- func (x *BatchUpdateTriageStateRequest) Reset()
- func (x *BatchUpdateTriageStateRequest) String() string
- type BatchUpdateTriageStateResponse
- func (*BatchUpdateTriageStateResponse) Descriptor() ([]byte, []int)deprecated
- func (x *BatchUpdateTriageStateResponse) GetTriageStates() []*TriageState
- func (*BatchUpdateTriageStateResponse) ProtoMessage()
- func (x *BatchUpdateTriageStateResponse) ProtoReflect() protoreflect.Message
- func (x *BatchUpdateTriageStateResponse) Reset()
- func (x *BatchUpdateTriageStateResponse) String() string
- type Bug
- type Bug_IssueTracker
- type BuildRef
- type BuildStatus
- func (BuildStatus) Descriptor() protoreflect.EnumDescriptor
- func (x BuildStatus) Enum() *BuildStatus
- func (BuildStatus) EnumDescriptor() ([]byte, []int)deprecated
- func (x BuildStatus) Number() protoreflect.EnumNumber
- func (x BuildStatus) String() string
- func (BuildStatus) Type() protoreflect.EnumType
- type BuildSummary
- func (*BuildSummary) Descriptor() ([]byte, []int)deprecated
- func (x *BuildSummary) GetBuild() *BuildRef
- func (x *BuildSummary) GetCreationTime() *timestamppb.Timestamp
- func (x *BuildSummary) GetStatus() BuildStatus
- func (x *BuildSummary) GetSummaryMarkdown() string
- func (*BuildSummary) ProtoMessage()
- func (x *BuildSummary) ProtoReflect() protoreflect.Message
- func (x *BuildSummary) Reset()
- func (x *BuildSummary) String() string
- type BuilderID
- func (*BuilderID) Descriptor() ([]byte, []int)deprecated
- func (x *BuilderID) GetBucket() string
- func (x *BuilderID) GetBuilder() string
- func (x *BuilderID) GetProject() string
- func (*BuilderID) ProtoMessage()
- func (x *BuilderID) ProtoReflect() protoreflect.Message
- func (x *BuilderID) Reset()
- func (x *BuilderID) String() string
- type Changelist
- func (*Changelist) Descriptor() ([]byte, []int)deprecated
- func (x *Changelist) GetChange() int64
- func (x *Changelist) GetHost() string
- func (x *Changelist) GetPatchset() int32
- func (*Changelist) ProtoMessage()
- func (x *Changelist) ProtoReflect() protoreflect.Message
- func (x *Changelist) Reset()
- func (x *Changelist) String() string
- type DecoratedGardening
- func (s *DecoratedGardening) BatchUpdateTriageState(ctx context.Context, req *BatchUpdateTriageStateRequest) (rsp *BatchUpdateTriageStateResponse, err error)
- func (s *DecoratedGardening) QueryGardenedBuilders(ctx context.Context, req *QueryGardenedBuildersRequest) (rsp *QueryGardenedBuildersResponse, err error)
- type GardenedBuilder
- func (*GardenedBuilder) Descriptor() ([]byte, []int)deprecated
- func (x *GardenedBuilder) GetBuilderId() *BuilderID
- func (x *GardenedBuilder) GetFurtherResults() []*BuildSummary
- func (x *GardenedBuilder) GetLatestResults() []*BuildSummary
- func (x *GardenedBuilder) GetName() string
- func (x *GardenedBuilder) GetSteps() []*GardenedBuilderStep
- func (*GardenedBuilder) ProtoMessage()
- func (x *GardenedBuilder) ProtoReflect() protoreflect.Message
- func (x *GardenedBuilder) Reset()
- func (x *GardenedBuilder) String() string
- type GardenedBuilderStep
- func (*GardenedBuilderStep) Descriptor() ([]byte, []int)deprecated
- func (x *GardenedBuilderStep) GetFurtherResults() []GardenedBuilderStep_StepStatus
- func (x *GardenedBuilderStep) GetLastBuild() *BuildRef
- func (x *GardenedBuilderStep) GetLastRegression() *Regression
- func (x *GardenedBuilderStep) GetLatestResults() []GardenedBuilderStep_StepStatus
- func (x *GardenedBuilderStep) GetStepId() string
- func (x *GardenedBuilderStep) GetTests() []*GardenedTest
- func (x *GardenedBuilderStep) GetTriageState() *TriageState
- func (*GardenedBuilderStep) ProtoMessage()
- func (x *GardenedBuilderStep) ProtoReflect() protoreflect.Message
- func (x *GardenedBuilderStep) Reset()
- func (x *GardenedBuilderStep) String() string
- type GardenedBuilderStep_StepStatus
- func (GardenedBuilderStep_StepStatus) Descriptor() protoreflect.EnumDescriptor
- func (x GardenedBuilderStep_StepStatus) Enum() *GardenedBuilderStep_StepStatus
- func (GardenedBuilderStep_StepStatus) EnumDescriptor() ([]byte, []int)deprecated
- func (x GardenedBuilderStep_StepStatus) Number() protoreflect.EnumNumber
- func (x GardenedBuilderStep_StepStatus) String() string
- func (GardenedBuilderStep_StepStatus) Type() protoreflect.EnumType
- type GardenedTest
- func (*GardenedTest) Descriptor() ([]byte, []int)deprecated
- func (x *GardenedTest) GetFurtherResults() []GardenedTest_TestStatus
- func (x *GardenedTest) GetLastBuild() *BuildRef
- func (x *GardenedTest) GetLastRegression() *Regression
- func (x *GardenedTest) GetLatestResults() []GardenedTest_TestStatus
- func (x *GardenedTest) GetTestId() string
- func (x *GardenedTest) GetTriageState() *TriageState
- func (x *GardenedTest) GetVariantHash() string
- func (*GardenedTest) ProtoMessage()
- func (x *GardenedTest) ProtoReflect() protoreflect.Message
- func (x *GardenedTest) Reset()
- func (x *GardenedTest) String() string
- type GardenedTest_TestStatus
- func (GardenedTest_TestStatus) Descriptor() protoreflect.EnumDescriptor
- func (x GardenedTest_TestStatus) Enum() *GardenedTest_TestStatus
- func (GardenedTest_TestStatus) EnumDescriptor() ([]byte, []int)deprecated
- func (x GardenedTest_TestStatus) Number() protoreflect.EnumNumber
- func (x GardenedTest_TestStatus) String() string
- func (GardenedTest_TestStatus) Type() protoreflect.EnumType
- type GardeningClient
- type GardeningServer
- type IssueTrackerBug
- type QueryGardenedBuildersRequest
- func (*QueryGardenedBuildersRequest) Descriptor() ([]byte, []int)deprecated
- func (x *QueryGardenedBuildersRequest) GetGardeningRotation() string
- func (x *QueryGardenedBuildersRequest) GetPageSize() int32
- func (x *QueryGardenedBuildersRequest) GetPageToken() string
- func (*QueryGardenedBuildersRequest) ProtoMessage()
- func (x *QueryGardenedBuildersRequest) ProtoReflect() protoreflect.Message
- func (x *QueryGardenedBuildersRequest) Reset()
- func (x *QueryGardenedBuildersRequest) String() string
- type QueryGardenedBuildersResponse
- func (*QueryGardenedBuildersResponse) Descriptor() ([]byte, []int)deprecated
- func (x *QueryGardenedBuildersResponse) GetBuilders() []*GardenedBuilder
- func (x *QueryGardenedBuildersResponse) GetNextPageToken() string
- func (*QueryGardenedBuildersResponse) ProtoMessage()
- func (x *QueryGardenedBuildersResponse) ProtoReflect() protoreflect.Message
- func (x *QueryGardenedBuildersResponse) Reset()
- func (x *QueryGardenedBuildersResponse) String() string
- type Regression
- func (*Regression) Descriptor() ([]byte, []int)deprecated
- func (x *Regression) GetFirstFailingBuild() *BuildRef
- func (x *Regression) GetFirstResolvedBuild() *BuildRef
- func (x *Regression) GetId() string
- func (x *Regression) GetLastActualResultBuildStartTime() *timestamppb.Timestamp
- func (x *Regression) GetLastFailingBuild() *BuildRef
- func (x *Regression) GetLastPassingBuild() *BuildRef
- func (x *Regression) GetStatus() RegressionStatus
- func (x *Regression) GetTotalBuildsWithFailures() int64
- func (x *Regression) GetWasLastActualResultPass() bool
- func (*Regression) ProtoMessage()
- func (x *Regression) ProtoReflect() protoreflect.Message
- func (x *Regression) Reset()
- func (x *Regression) String() string
- type RegressionStatus
- func (RegressionStatus) Descriptor() protoreflect.EnumDescriptor
- func (x RegressionStatus) Enum() *RegressionStatus
- func (RegressionStatus) EnumDescriptor() ([]byte, []int)deprecated
- func (x RegressionStatus) Number() protoreflect.EnumNumber
- func (x RegressionStatus) String() string
- func (RegressionStatus) Type() protoreflect.EnumType
- type TriageState
- func (*TriageState) Descriptor() ([]byte, []int)deprecated
- func (x *TriageState) GetEtag() string
- func (x *TriageState) GetFixVerificationState() *TriageState_FixVerificationState
- func (x *TriageState) GetGroupAssociation() *TriageState_GroupAssociation
- func (x *TriageState) GetLastUpdated() *timestamppb.Timestamp
- func (x *TriageState) GetName() string
- func (x *TriageState) GetNote() *TriageState_Note
- func (x *TriageState) GetSnooze() *TriageState_Snooze
- func (*TriageState) ProtoMessage()
- func (x *TriageState) ProtoReflect() protoreflect.Message
- func (x *TriageState) Reset()
- func (x *TriageState) String() string
- type TriageState_FixVerificationState
- func (*TriageState_FixVerificationState) Descriptor() ([]byte, []int)deprecated
- func (x *TriageState_FixVerificationState) GetChangelist() *Changelist
- func (x *TriageState_FixVerificationState) GetRegressionId() string
- func (x *TriageState_FixVerificationState) GetTimestamp() *timestamppb.Timestamp
- func (*TriageState_FixVerificationState) ProtoMessage()
- func (x *TriageState_FixVerificationState) ProtoReflect() protoreflect.Message
- func (x *TriageState_FixVerificationState) Reset()
- func (x *TriageState_FixVerificationState) String() string
- type TriageState_GroupAssociation
- func (*TriageState_GroupAssociation) Descriptor() ([]byte, []int)deprecated
- func (x *TriageState_GroupAssociation) GetBugs() []*Bug
- func (x *TriageState_GroupAssociation) GetFreeformGroupId() string
- func (x *TriageState_GroupAssociation) GetRegressionId() string
- func (x *TriageState_GroupAssociation) GetRegressionResolvedTime() *timestamppb.Timestamp
- func (*TriageState_GroupAssociation) ProtoMessage()
- func (x *TriageState_GroupAssociation) ProtoReflect() protoreflect.Message
- func (x *TriageState_GroupAssociation) Reset()
- func (x *TriageState_GroupAssociation) String() string
- type TriageState_Note
- func (*TriageState_Note) Descriptor() ([]byte, []int)deprecated
- func (x *TriageState_Note) GetLastUpdated() *timestamppb.Timestamp
- func (x *TriageState_Note) GetMessage() string
- func (x *TriageState_Note) GetRegressionId() string
- func (*TriageState_Note) ProtoMessage()
- func (x *TriageState_Note) ProtoReflect() protoreflect.Message
- func (x *TriageState_Note) Reset()
- func (x *TriageState_Note) String() string
- type TriageState_Snooze
- func (*TriageState_Snooze) Descriptor() ([]byte, []int)deprecated
- func (x *TriageState_Snooze) GetMode() TriageState_Snooze_SnoozeMode
- func (x *TriageState_Snooze) GetSnoozedBuildbucketBuildId() int64
- func (*TriageState_Snooze) ProtoMessage()
- func (x *TriageState_Snooze) ProtoReflect() protoreflect.Message
- func (x *TriageState_Snooze) Reset()
- func (x *TriageState_Snooze) String() string
- type TriageState_Snooze_SnoozeMode
- func (TriageState_Snooze_SnoozeMode) Descriptor() protoreflect.EnumDescriptor
- func (x TriageState_Snooze_SnoozeMode) Enum() *TriageState_Snooze_SnoozeMode
- func (TriageState_Snooze_SnoozeMode) EnumDescriptor() ([]byte, []int)deprecated
- func (x TriageState_Snooze_SnoozeMode) Number() protoreflect.EnumNumber
- func (x TriageState_Snooze_SnoozeMode) String() string
- func (TriageState_Snooze_SnoozeMode) Type() protoreflect.EnumType
- type UnimplementedGardeningServer
- type UpdateTriageStateRequest
- func (*UpdateTriageStateRequest) Descriptor() ([]byte, []int)deprecated
- func (x *UpdateTriageStateRequest) GetTriageState() *TriageState
- func (x *UpdateTriageStateRequest) GetUpdateMask() *fieldmaskpb.FieldMask
- func (*UpdateTriageStateRequest) ProtoMessage()
- func (x *UpdateTriageStateRequest) ProtoReflect() protoreflect.Message
- func (x *UpdateTriageStateRequest) Reset()
- func (x *UpdateTriageStateRequest) String() string
Constants ¶
This section is empty.
Variables ¶
var ( BuildStatus_name = map[int32]string{ 0: "BUILD_STATUS_UNSPECIFIED", 1: "BUILD_STATUS_SCHEDULED", 2: "BUILD_STATUS_STARTED", 12: "BUILD_STATUS_SUCCESS", 20: "BUILD_STATUS_FAILURE", 36: "BUILD_STATUS_INFRA_FAILURE", 68: "BUILD_STATUS_CANCELED", } BuildStatus_value = map[string]int32{ "BUILD_STATUS_UNSPECIFIED": 0, "BUILD_STATUS_SCHEDULED": 1, "BUILD_STATUS_STARTED": 2, "BUILD_STATUS_SUCCESS": 12, "BUILD_STATUS_FAILURE": 20, "BUILD_STATUS_INFRA_FAILURE": 36, "BUILD_STATUS_CANCELED": 68, } )
Enum value maps for BuildStatus.
var ( RegressionStatus_name = map[int32]string{ 0: "REGRESSION_STATUS_UNSPECIFIED", 1: "REGRESSION_STATUS_NEW", 2: "REGRESSION_STATUS_CONSISTENT", 3: "REGRESSION_STATUS_RESOLVED", } RegressionStatus_value = map[string]int32{ "REGRESSION_STATUS_UNSPECIFIED": 0, "REGRESSION_STATUS_NEW": 1, "REGRESSION_STATUS_CONSISTENT": 2, "REGRESSION_STATUS_RESOLVED": 3, } )
Enum value maps for RegressionStatus.
var ( GardenedBuilderStep_StepStatus_name = map[int32]string{ 0: "STEP_STATUS_UNSPECIFIED", 1: "PENDING", 2: "NOT_RUN_BUILD_SUCCESS", 3: "NOT_RUN_BUILD_NON_SUCCESS", 4: "SUCCESS", 5: "FAILURE", 6: "INFRA_FAILURE", 7: "CANCELED", } GardenedBuilderStep_StepStatus_value = map[string]int32{ "STEP_STATUS_UNSPECIFIED": 0, "PENDING": 1, "NOT_RUN_BUILD_SUCCESS": 2, "NOT_RUN_BUILD_NON_SUCCESS": 3, "SUCCESS": 4, "FAILURE": 5, "INFRA_FAILURE": 6, "CANCELED": 7, } )
Enum value maps for GardenedBuilderStep_StepStatus.
var ( GardenedTest_TestStatus_name = map[int32]string{ 0: "TEST_STATUS_UNSPECIFIED", 1: "PENDING", 2: "NOT_RUN", 3: "EXPECTED", 4: "FLAKY", 5: "EXONERATED", 6: "UNEXPECTED", 7: "UNEXPECTEDLY_SKIPPED", } GardenedTest_TestStatus_value = map[string]int32{ "TEST_STATUS_UNSPECIFIED": 0, "PENDING": 1, "NOT_RUN": 2, "EXPECTED": 3, "FLAKY": 4, "EXONERATED": 5, "UNEXPECTED": 6, "UNEXPECTEDLY_SKIPPED": 7, } )
Enum value maps for GardenedTest_TestStatus.
var ( TriageState_Snooze_SnoozeMode_name = map[int32]string{ 0: "SNOOZE_MODE_UNSPECIFIED", 1: "ONCE", 2: "FIXED_PENDING_VERIFICATION", } TriageState_Snooze_SnoozeMode_value = map[string]int32{ "SNOOZE_MODE_UNSPECIFIED": 0, "ONCE": 1, "FIXED_PENDING_VERIFICATION": 2, } )
Enum value maps for TriageState_Snooze_SnoozeMode.
var File_go_chromium_org_luci_luci_notify_proto_v1_gardened_builder_proto protoreflect.FileDescriptor
var File_go_chromium_org_luci_luci_notify_proto_v1_gardening_proto protoreflect.FileDescriptor
var File_go_chromium_org_luci_luci_notify_proto_v1_triage_state_proto protoreflect.FileDescriptor
Functions ¶
func FileDescriptorSet ¶
func FileDescriptorSet() *descriptorpb.FileDescriptorSet
FileDescriptorSet returns a descriptor set for this proto package, which includes all defined services, and all transitive dependencies.
Will not return nil.
Do NOT modify the returned descriptor.
func RegisterGardeningServer ¶
func RegisterGardeningServer(s prpc.Registrar, srv GardeningServer)
Types ¶
type BatchUpdateTriageStateRequest ¶
type BatchUpdateTriageStateRequest struct { // The requests specifying the triage states to update. // A maximum of 100 triage states can be modified in a batch. Requests []*UpdateTriageStateRequest `protobuf:"bytes,1,rep,name=requests,proto3" json:"requests,omitempty"` // contains filtered or unexported fields }
func (*BatchUpdateTriageStateRequest) Descriptor
deprecated
func (*BatchUpdateTriageStateRequest) Descriptor() ([]byte, []int)
Deprecated: Use BatchUpdateTriageStateRequest.ProtoReflect.Descriptor instead.
func (*BatchUpdateTriageStateRequest) GetRequests ¶
func (x *BatchUpdateTriageStateRequest) GetRequests() []*UpdateTriageStateRequest
func (*BatchUpdateTriageStateRequest) ProtoMessage ¶
func (*BatchUpdateTriageStateRequest) ProtoMessage()
func (*BatchUpdateTriageStateRequest) ProtoReflect ¶
func (x *BatchUpdateTriageStateRequest) ProtoReflect() protoreflect.Message
func (*BatchUpdateTriageStateRequest) Reset ¶
func (x *BatchUpdateTriageStateRequest) Reset()
func (*BatchUpdateTriageStateRequest) String ¶
func (x *BatchUpdateTriageStateRequest) String() string
type BatchUpdateTriageStateResponse ¶
type BatchUpdateTriageStateResponse struct { // The updated triage states. TriageStates []*TriageState `protobuf:"bytes,1,rep,name=triage_states,json=triageStates,proto3" json:"triage_states,omitempty"` // contains filtered or unexported fields }
func (*BatchUpdateTriageStateResponse) Descriptor
deprecated
func (*BatchUpdateTriageStateResponse) Descriptor() ([]byte, []int)
Deprecated: Use BatchUpdateTriageStateResponse.ProtoReflect.Descriptor instead.
func (*BatchUpdateTriageStateResponse) GetTriageStates ¶
func (x *BatchUpdateTriageStateResponse) GetTriageStates() []*TriageState
func (*BatchUpdateTriageStateResponse) ProtoMessage ¶
func (*BatchUpdateTriageStateResponse) ProtoMessage()
func (*BatchUpdateTriageStateResponse) ProtoReflect ¶
func (x *BatchUpdateTriageStateResponse) ProtoReflect() protoreflect.Message
func (*BatchUpdateTriageStateResponse) Reset ¶
func (x *BatchUpdateTriageStateResponse) Reset()
func (*BatchUpdateTriageStateResponse) String ¶
func (x *BatchUpdateTriageStateResponse) String() string
type Bug ¶
type Bug struct { // Types that are assignable to System: // // *Bug_IssueTracker System isBug_System `protobuf_oneof:"system"` // contains filtered or unexported fields }
Represents a reference to a bug in a bug tracking system.
func (*Bug) Descriptor
deprecated
func (*Bug) GetIssueTracker ¶
func (x *Bug) GetIssueTracker() *IssueTrackerBug
func (*Bug) ProtoMessage ¶
func (*Bug) ProtoMessage()
func (*Bug) ProtoReflect ¶
func (x *Bug) ProtoReflect() protoreflect.Message
type Bug_IssueTracker ¶
type Bug_IssueTracker struct { // The Google Issue Tracker bug. IssueTracker *IssueTrackerBug `protobuf:"bytes,1,opt,name=issue_tracker,json=issueTracker,proto3,oneof"` }
type BuildRef ¶
type BuildRef struct { // The buildbucket build identifier. BuildbucketBuildId int64 `protobuf:"varint,1,opt,name=buildbucket_build_id,json=buildbucketBuildId,proto3" json:"buildbucket_build_id,omitempty"` // The version of sources included in the build. // May be empty if unavailable. CommitPosition int64 `protobuf:"varint,2,opt,name=commit_position,json=commitPosition,proto3" json:"commit_position,omitempty"` // contains filtered or unexported fields }
BuildRef represents a reference to a build.
func (*BuildRef) Descriptor
deprecated
func (*BuildRef) GetBuildbucketBuildId ¶
func (*BuildRef) GetCommitPosition ¶
func (*BuildRef) ProtoMessage ¶
func (*BuildRef) ProtoMessage()
func (*BuildRef) ProtoReflect ¶
func (x *BuildRef) ProtoReflect() protoreflect.Message
type BuildStatus ¶
type BuildStatus int32
BuildStatus captures the status of a build.
const ( // A build or step must not have this status. BuildStatus_BUILD_STATUS_UNSPECIFIED BuildStatus = 0 // A build was scheduled, but did not start yet. BuildStatus_BUILD_STATUS_SCHEDULED BuildStatus = 1 // A build has started. BuildStatus_BUILD_STATUS_STARTED BuildStatus = 2 // A build/step ended successfully. BuildStatus_BUILD_STATUS_SUCCESS BuildStatus = 12 // A build/step ended unsuccessfully due to its Build.Input, // e.g. tests failed, and NOT due to a build infrastructure failure. BuildStatus_BUILD_STATUS_FAILURE BuildStatus = 20 // A build ended unsuccessfully due to a failure independent of the // input, e.g. swarming failed, not enough capacity or the recipe was unable // to read the patch from gerrit. BuildStatus_BUILD_STATUS_INFRA_FAILURE BuildStatus = 36 // A build was cancelled explicitly, e.g. via an RPC. BuildStatus_BUILD_STATUS_CANCELED BuildStatus = 68 )
func (BuildStatus) Descriptor ¶
func (BuildStatus) Descriptor() protoreflect.EnumDescriptor
func (BuildStatus) Enum ¶
func (x BuildStatus) Enum() *BuildStatus
func (BuildStatus) EnumDescriptor
deprecated
func (BuildStatus) EnumDescriptor() ([]byte, []int)
Deprecated: Use BuildStatus.Descriptor instead.
func (BuildStatus) Number ¶
func (x BuildStatus) Number() protoreflect.EnumNumber
func (BuildStatus) String ¶
func (x BuildStatus) String() string
func (BuildStatus) Type ¶
func (BuildStatus) Type() protoreflect.EnumType
type BuildSummary ¶
type BuildSummary struct { // The build the result was obtained for. Build *BuildRef `protobuf:"bytes,1,opt,name=build,proto3" json:"build,omitempty"` // The status of the build or step. Status BuildStatus `protobuf:"varint,2,opt,name=status,proto3,enum=luci.notify.v1.BuildStatus" json:"status,omitempty"` // The build creation time. CreationTime *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=creation_time,json=creationTime,proto3" json:"creation_time,omitempty"` // The build summary markdown. SummaryMarkdown string `protobuf:"bytes,4,opt,name=summary_markdown,json=summaryMarkdown,proto3" json:"summary_markdown,omitempty"` // contains filtered or unexported fields }
BuildSummary captures the status of a build.
func (*BuildSummary) Descriptor
deprecated
func (*BuildSummary) Descriptor() ([]byte, []int)
Deprecated: Use BuildSummary.ProtoReflect.Descriptor instead.
func (*BuildSummary) GetBuild ¶
func (x *BuildSummary) GetBuild() *BuildRef
func (*BuildSummary) GetCreationTime ¶
func (x *BuildSummary) GetCreationTime() *timestamppb.Timestamp
func (*BuildSummary) GetStatus ¶
func (x *BuildSummary) GetStatus() BuildStatus
func (*BuildSummary) GetSummaryMarkdown ¶
func (x *BuildSummary) GetSummaryMarkdown() string
func (*BuildSummary) ProtoMessage ¶
func (*BuildSummary) ProtoMessage()
func (*BuildSummary) ProtoReflect ¶
func (x *BuildSummary) ProtoReflect() protoreflect.Message
func (*BuildSummary) Reset ¶
func (x *BuildSummary) Reset()
func (*BuildSummary) String ¶
func (x *BuildSummary) String() string
type BuilderID ¶
type BuilderID struct { // The LUCI Project of the builder. E.g. "chromium". Project string `protobuf:"bytes,1,opt,name=project,proto3" json:"project,omitempty"` // The build bucket, e.g. "try". Unique within project. Bucket string `protobuf:"bytes,2,opt,name=bucket,proto3" json:"bucket,omitempty"` // The builder name, e.g. "linux-rel". Unique within bucket. Builder string `protobuf:"bytes,3,opt,name=builder,proto3" json:"builder,omitempty"` // contains filtered or unexported fields }
BuilderID identifies a builder.
func (*BuilderID) Descriptor
deprecated
func (*BuilderID) GetBuilder ¶
func (*BuilderID) GetProject ¶
func (*BuilderID) ProtoMessage ¶
func (*BuilderID) ProtoMessage()
func (*BuilderID) ProtoReflect ¶
func (x *BuilderID) ProtoReflect() protoreflect.Message
type Changelist ¶
type Changelist struct { // Gerrit hostname, e.g. "chromium-review.googlesource.com". Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"` // Change number, e.g. 12345. Change int64 `protobuf:"varint,2,opt,name=change,proto3" json:"change,omitempty"` // Patch set number, e.g. 1. Patchset int32 `protobuf:"varint,3,opt,name=patchset,proto3" json:"patchset,omitempty"` // contains filtered or unexported fields }
A gerrit changelist.
func (*Changelist) Descriptor
deprecated
func (*Changelist) Descriptor() ([]byte, []int)
Deprecated: Use Changelist.ProtoReflect.Descriptor instead.
func (*Changelist) GetChange ¶
func (x *Changelist) GetChange() int64
func (*Changelist) GetHost ¶
func (x *Changelist) GetHost() string
func (*Changelist) GetPatchset ¶
func (x *Changelist) GetPatchset() int32
func (*Changelist) ProtoMessage ¶
func (*Changelist) ProtoMessage()
func (*Changelist) ProtoReflect ¶
func (x *Changelist) ProtoReflect() protoreflect.Message
func (*Changelist) Reset ¶
func (x *Changelist) Reset()
func (*Changelist) String ¶
func (x *Changelist) String() string
type DecoratedGardening ¶
type DecoratedGardening struct { // Service is the service to decorate. Service GardeningServer // Prelude is called for each method before forwarding the call to Service. // If Prelude returns an error, then the call is skipped and the error is // processed via the Postlude (if one is defined), or it is returned directly. Prelude func(ctx context.Context, methodName string, req proto.Message) (context.Context, error) // Postlude is called for each method after Service has processed the call, or // after the Prelude has returned an error. This takes the Service's // response proto (which may be nil) and/or any error. The decorated // service will return the response (possibly mutated) and error that Postlude // returns. Postlude func(ctx context.Context, methodName string, rsp proto.Message, err error) error }
func (*DecoratedGardening) BatchUpdateTriageState ¶
func (s *DecoratedGardening) BatchUpdateTriageState(ctx context.Context, req *BatchUpdateTriageStateRequest) (rsp *BatchUpdateTriageStateResponse, err error)
func (*DecoratedGardening) QueryGardenedBuilders ¶
func (s *DecoratedGardening) QueryGardenedBuilders(ctx context.Context, req *QueryGardenedBuildersRequest) (rsp *QueryGardenedBuildersResponse, err error)
type GardenedBuilder ¶
type GardenedBuilder struct { // Resource name of the builder. // Format: project/{PROJECT}/buckets/{BUCKET}/builder/{BUILDER}/gardening. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // Builder identifier. BuilderId *BuilderID `protobuf:"bytes,2,opt,name=builder_id,json=builderId,proto3" json:"builder_id,omitempty"` // Recent results for the builder. // Up to the last 100 commit positions. LatestResults []*BuildSummary `protobuf:"bytes,3,rep,name=latest_results,json=latestResults,proto3" json:"latest_results,omitempty"` // Up to 10 further builds after the latest_results. This may include running builds. FurtherResults []*BuildSummary `protobuf:"bytes,4,rep,name=further_results,json=furtherResults,proto3" json:"further_results,omitempty"` // Steps on the builder which are failing, or // were recently failing. I.E. "interesting" steps. // This is limited to 40 items. Steps []*GardenedBuilderStep `protobuf:"bytes,5,rep,name=steps,proto3" json:"steps,omitempty"` // contains filtered or unexported fields }
GardenedBuilder represents information needed to monitor a buildbucket Builder and return it to passing if it is failing.
func (*GardenedBuilder) Descriptor
deprecated
func (*GardenedBuilder) Descriptor() ([]byte, []int)
Deprecated: Use GardenedBuilder.ProtoReflect.Descriptor instead.
func (*GardenedBuilder) GetBuilderId ¶
func (x *GardenedBuilder) GetBuilderId() *BuilderID
func (*GardenedBuilder) GetFurtherResults ¶
func (x *GardenedBuilder) GetFurtherResults() []*BuildSummary
func (*GardenedBuilder) GetLatestResults ¶
func (x *GardenedBuilder) GetLatestResults() []*BuildSummary
func (*GardenedBuilder) GetName ¶
func (x *GardenedBuilder) GetName() string
func (*GardenedBuilder) GetSteps ¶
func (x *GardenedBuilder) GetSteps() []*GardenedBuilderStep
func (*GardenedBuilder) ProtoMessage ¶
func (*GardenedBuilder) ProtoMessage()
func (*GardenedBuilder) ProtoReflect ¶
func (x *GardenedBuilder) ProtoReflect() protoreflect.Message
func (*GardenedBuilder) Reset ¶
func (x *GardenedBuilder) Reset()
func (*GardenedBuilder) String ¶
func (x *GardenedBuilder) String() string
type GardenedBuilderStep ¶
type GardenedBuilderStep struct { // The step identifier. // Pipe character ("|") is reserved to separate parent and child step names. // For example, value "a|b" indicates step "b" under step "a". // // Pseudosteps (fake steps generated by the server) will start with the prefix // "$pseudostep-". The following psudosteps currently exist: // - "$pseudostep-build-failure": for build failures not explained // by a step. // - "$pseudostep-tests": for test failures not under an actual step. StepId string `protobuf:"bytes,1,opt,name=step_id,json=stepId,proto3" json:"step_id,omitempty"` // User-editable triage state. TriageState *TriageState `protobuf:"bytes,2,opt,name=triage_state,json=triageState,proto3" json:"triage_state,omitempty"` // Describes information about the last time the step started failing. // Includes whether the failure is consistent (or resolved), the blamelist, etc. LastRegression *Regression `protobuf:"bytes,3,opt,name=last_regression,json=lastRegression,proto3" json:"last_regression,omitempty"` // The last build with a (non-pending) result for this step. // At present, this is the same as the last completed (or cancelled) build // although if we ever started ingesting builds prior to completion this // could include running builds which already have a result for this step. // // Use in conjunction with triage_state.snooze.snoozed_buildbucket_build_id // to identify when a snooze has expired. LastBuild *BuildRef `protobuf:"bytes,4,opt,name=last_build,json=lastBuild,proto3" json:"last_build,omitempty"` // Recent builds for the step, comprising up to the last 100 commit positions. // This may include running builds. // Matches 1:1 with the list on the parent GardenedBuilder. // Build IDs and commit positions can be found on the parent. LatestResults []GardenedBuilderStep_StepStatus `` /* 159-byte string literal not displayed */ // Up to 10 further builds of running data after the latest_results. // This may include running builds. // Matches 1:1 with the list on the parent GardenedBuilder. // Build IDs and commit positions can be found on the parent. FurtherResults []GardenedBuilderStep_StepStatus `` /* 162-byte string literal not displayed */ // Failing or recently failing tests that are part of the step. This list is // limited to 40 items. Tests []*GardenedTest `protobuf:"bytes,7,rep,name=tests,proto3" json:"tests,omitempty"` // contains filtered or unexported fields }
GardenedBuilderStep represents information needed to monitor a buildbucket Builder step and return it to passing if it is failing.
func (*GardenedBuilderStep) Descriptor
deprecated
func (*GardenedBuilderStep) Descriptor() ([]byte, []int)
Deprecated: Use GardenedBuilderStep.ProtoReflect.Descriptor instead.
func (*GardenedBuilderStep) GetFurtherResults ¶
func (x *GardenedBuilderStep) GetFurtherResults() []GardenedBuilderStep_StepStatus
func (*GardenedBuilderStep) GetLastBuild ¶
func (x *GardenedBuilderStep) GetLastBuild() *BuildRef
func (*GardenedBuilderStep) GetLastRegression ¶
func (x *GardenedBuilderStep) GetLastRegression() *Regression
func (*GardenedBuilderStep) GetLatestResults ¶
func (x *GardenedBuilderStep) GetLatestResults() []GardenedBuilderStep_StepStatus
func (*GardenedBuilderStep) GetStepId ¶
func (x *GardenedBuilderStep) GetStepId() string
func (*GardenedBuilderStep) GetTests ¶
func (x *GardenedBuilderStep) GetTests() []*GardenedTest
func (*GardenedBuilderStep) GetTriageState ¶
func (x *GardenedBuilderStep) GetTriageState() *TriageState
func (*GardenedBuilderStep) ProtoMessage ¶
func (*GardenedBuilderStep) ProtoMessage()
func (*GardenedBuilderStep) ProtoReflect ¶
func (x *GardenedBuilderStep) ProtoReflect() protoreflect.Message
func (*GardenedBuilderStep) Reset ¶
func (x *GardenedBuilderStep) Reset()
func (*GardenedBuilderStep) String ¶
func (x *GardenedBuilderStep) String() string
type GardenedBuilderStep_StepStatus ¶
type GardenedBuilderStep_StepStatus int32
StepStatus captures the status of a step.
const ( // A build or step must not have this status. GardenedBuilderStep_STEP_STATUS_UNSPECIFIED GardenedBuilderStep_StepStatus = 0 // The build is still running and there is no data available // for the step yet. GardenedBuilderStep_PENDING GardenedBuilderStep_StepStatus = 1 // The step was not run in the build, but the build succeeded. // This is best treated as a type of success, as some steps // only show up to report a failure. GardenedBuilderStep_NOT_RUN_BUILD_SUCCESS GardenedBuilderStep_StepStatus = 2 // The step was not run in the build, and the build failed, // infra failed or was cancelled. In this case, it is ambiguous // if the step did not run because of the earlier failure or // the cancellation or if the step only shows up on failures and // the failure did not occur. GardenedBuilderStep_NOT_RUN_BUILD_NON_SUCCESS GardenedBuilderStep_StepStatus = 3 // The step succeeded. GardenedBuilderStep_SUCCESS GardenedBuilderStep_StepStatus = 4 // The step failed. GardenedBuilderStep_FAILURE GardenedBuilderStep_StepStatus = 5 // The step encountered an infrastructure failure. GardenedBuilderStep_INFRA_FAILURE GardenedBuilderStep_StepStatus = 6 // The step was canceled. GardenedBuilderStep_CANCELED GardenedBuilderStep_StepStatus = 7 )
func (GardenedBuilderStep_StepStatus) Descriptor ¶
func (GardenedBuilderStep_StepStatus) Descriptor() protoreflect.EnumDescriptor
func (GardenedBuilderStep_StepStatus) Enum ¶
func (x GardenedBuilderStep_StepStatus) Enum() *GardenedBuilderStep_StepStatus
func (GardenedBuilderStep_StepStatus) EnumDescriptor
deprecated
func (GardenedBuilderStep_StepStatus) EnumDescriptor() ([]byte, []int)
Deprecated: Use GardenedBuilderStep_StepStatus.Descriptor instead.
func (GardenedBuilderStep_StepStatus) Number ¶
func (x GardenedBuilderStep_StepStatus) Number() protoreflect.EnumNumber
func (GardenedBuilderStep_StepStatus) String ¶
func (x GardenedBuilderStep_StepStatus) String() string
func (GardenedBuilderStep_StepStatus) Type ¶
func (GardenedBuilderStep_StepStatus) Type() protoreflect.EnumType
type GardenedTest ¶
type GardenedTest struct { // The identifier of the test. TestId string `protobuf:"bytes,1,opt,name=test_id,json=testId,proto3" json:"test_id,omitempty"` // The test variant hash. VariantHash string `protobuf:"bytes,2,opt,name=variant_hash,json=variantHash,proto3" json:"variant_hash,omitempty"` // User-editable triage state. TriageState *TriageState `protobuf:"bytes,3,opt,name=triage_state,json=triageState,proto3" json:"triage_state,omitempty"` // Describes information about the last time the step started failing. // Includes whether the failure is consistent (or resolved), the blamelist, etc. LastRegression *Regression `protobuf:"bytes,4,opt,name=last_regression,json=lastRegression,proto3" json:"last_regression,omitempty"` // The last build with a (non-pending) result for this test. // This is the same as the last completed (or cancelled) build. // // Use in conjunction with triage_state.snooze.snoozed_buildbucket_build_id // to identify when a snooze has expired. LastBuild *BuildRef `protobuf:"bytes,5,opt,name=last_build,json=lastBuild,proto3" json:"last_build,omitempty"` // Recent results for the test, comprising up to the last 100 commit positions. // This may include running builds. // Matches 1:1 with the list on the parent GardenedBuilder. // Build ID and commit positions corresponding to each status can be // found on the parent. LatestResults []GardenedTest_TestStatus `` /* 152-byte string literal not displayed */ // Up to 10 further results of the test after the latest_results. // This may include running builds. // Matches 1:1 with the list on the parent GardenedBuilder. // Build ID and commit positions corresponding to each status can be // found on the parent. FurtherResults []GardenedTest_TestStatus `` /* 155-byte string literal not displayed */ // contains filtered or unexported fields }
func (*GardenedTest) Descriptor
deprecated
func (*GardenedTest) Descriptor() ([]byte, []int)
Deprecated: Use GardenedTest.ProtoReflect.Descriptor instead.
func (*GardenedTest) GetFurtherResults ¶
func (x *GardenedTest) GetFurtherResults() []GardenedTest_TestStatus
func (*GardenedTest) GetLastBuild ¶
func (x *GardenedTest) GetLastBuild() *BuildRef
func (*GardenedTest) GetLastRegression ¶
func (x *GardenedTest) GetLastRegression() *Regression
func (*GardenedTest) GetLatestResults ¶
func (x *GardenedTest) GetLatestResults() []GardenedTest_TestStatus
func (*GardenedTest) GetTestId ¶
func (x *GardenedTest) GetTestId() string
func (*GardenedTest) GetTriageState ¶
func (x *GardenedTest) GetTriageState() *TriageState
func (*GardenedTest) GetVariantHash ¶
func (x *GardenedTest) GetVariantHash() string
func (*GardenedTest) ProtoMessage ¶
func (*GardenedTest) ProtoMessage()
func (*GardenedTest) ProtoReflect ¶
func (x *GardenedTest) ProtoReflect() protoreflect.Message
func (*GardenedTest) Reset ¶
func (x *GardenedTest) Reset()
func (*GardenedTest) String ¶
func (x *GardenedTest) String() string
type GardenedTest_TestStatus ¶
type GardenedTest_TestStatus int32
Status of a test verdict.
const ( // This status should not be used. GardenedTest_TEST_STATUS_UNSPECIFIED GardenedTest_TestStatus = 0 // The build is still running and there is no data available // for the test yet. GardenedTest_PENDING GardenedTest_TestStatus = 1 // There is no result for the test in the build. GardenedTest_NOT_RUN GardenedTest_TestStatus = 2 // The test verdict in the build was expected. // This is considered a passing state for the purposes of regression // analysis. GardenedTest_EXPECTED GardenedTest_TestStatus = 3 // The test verdict in the build was flaky. // This is considered a passing state for the purposes of regression // analysis. GardenedTest_FLAKY GardenedTest_TestStatus = 4 // The test verdict in the build was exonerated. // This is considered a passing state for the purposes of regression // analysis. GardenedTest_EXONERATED GardenedTest_TestStatus = 5 // The test verdict in the build was unexpected. // This is considered a failing state for the purposes of regression // analysis. GardenedTest_UNEXPECTED GardenedTest_TestStatus = 6 // The test verdict in the build was unexpectedly skipped. // This is considered a failing state for the purposes of regression // analysis. GardenedTest_UNEXPECTEDLY_SKIPPED GardenedTest_TestStatus = 7 )
func (GardenedTest_TestStatus) Descriptor ¶
func (GardenedTest_TestStatus) Descriptor() protoreflect.EnumDescriptor
func (GardenedTest_TestStatus) Enum ¶
func (x GardenedTest_TestStatus) Enum() *GardenedTest_TestStatus
func (GardenedTest_TestStatus) EnumDescriptor
deprecated
func (GardenedTest_TestStatus) EnumDescriptor() ([]byte, []int)
Deprecated: Use GardenedTest_TestStatus.Descriptor instead.
func (GardenedTest_TestStatus) Number ¶
func (x GardenedTest_TestStatus) Number() protoreflect.EnumNumber
func (GardenedTest_TestStatus) String ¶
func (x GardenedTest_TestStatus) String() string
func (GardenedTest_TestStatus) Type ¶
func (GardenedTest_TestStatus) Type() protoreflect.EnumType
type GardeningClient ¶
type GardeningClient interface { // Retrieves builders in the given gardening rotation. QueryGardenedBuilders(ctx context.Context, in *QueryGardenedBuildersRequest, opts ...grpc.CallOption) (*QueryGardenedBuildersResponse, error) // Updates step and/or test triage state(s). BatchUpdateTriageState(ctx context.Context, in *BatchUpdateTriageStateRequest, opts ...grpc.CallOption) (*BatchUpdateTriageStateResponse, error) }
GardeningClient is the client API for Gardening service.
For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
func NewGardeningClient ¶
func NewGardeningClient(cc grpc.ClientConnInterface) GardeningClient
func NewGardeningPRPCClient ¶
func NewGardeningPRPCClient(client *prpc.Client) GardeningClient
type GardeningServer ¶
type GardeningServer interface { // Retrieves builders in the given gardening rotation. QueryGardenedBuilders(context.Context, *QueryGardenedBuildersRequest) (*QueryGardenedBuildersResponse, error) // Updates step and/or test triage state(s). BatchUpdateTriageState(context.Context, *BatchUpdateTriageStateRequest) (*BatchUpdateTriageStateResponse, error) }
GardeningServer is the server API for Gardening service.
type IssueTrackerBug ¶
type IssueTrackerBug struct { // The ID in the bug tracking system. Id int64 `protobuf:"varint,1,opt,name=id,proto3" json:"id,omitempty"` // contains filtered or unexported fields }
A bug in Google Issue Tracker, sometimes known as Buganizer, available at https://issuetracker.google.com.
func (*IssueTrackerBug) Descriptor
deprecated
func (*IssueTrackerBug) Descriptor() ([]byte, []int)
Deprecated: Use IssueTrackerBug.ProtoReflect.Descriptor instead.
func (*IssueTrackerBug) GetId ¶
func (x *IssueTrackerBug) GetId() int64
func (*IssueTrackerBug) ProtoMessage ¶
func (*IssueTrackerBug) ProtoMessage()
func (*IssueTrackerBug) ProtoReflect ¶
func (x *IssueTrackerBug) ProtoReflect() protoreflect.Message
func (*IssueTrackerBug) Reset ¶
func (x *IssueTrackerBug) Reset()
func (*IssueTrackerBug) String ¶
func (x *IssueTrackerBug) String() string
type QueryGardenedBuildersRequest ¶
type QueryGardenedBuildersRequest struct { // The name of the gardening rotation to retrieve builders for. // E.g. 'gardeningRotations/chromium.gpu'. // Format: gardeningRotations/{GARDENING_ROTATION_ID}. GardeningRotation string `protobuf:"bytes,1,opt,name=gardening_rotation,json=gardeningRotation,proto3" json:"gardening_rotation,omitempty"` // The maximum number of gardened builders to return. The service may // return fewer than this value (e.g. to avoid hitting response size limits). // If unspecified, at most 1000 builders will be returned. // The maximum value is 1000; values above 1000 will be coerced to 1000. PageSize int32 `protobuf:"varint,2,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"` // A page token, received from a previous `QueryGardeningRotationRequest` call. // Provide this to retrieve the subsequent page. // // When paginating, all other parameters provided to `QueryGardenedBuildersRequest` // must match the call that provided the page token. PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"` // contains filtered or unexported fields }
func (*QueryGardenedBuildersRequest) Descriptor
deprecated
func (*QueryGardenedBuildersRequest) Descriptor() ([]byte, []int)
Deprecated: Use QueryGardenedBuildersRequest.ProtoReflect.Descriptor instead.
func (*QueryGardenedBuildersRequest) GetGardeningRotation ¶
func (x *QueryGardenedBuildersRequest) GetGardeningRotation() string
func (*QueryGardenedBuildersRequest) GetPageSize ¶
func (x *QueryGardenedBuildersRequest) GetPageSize() int32
func (*QueryGardenedBuildersRequest) GetPageToken ¶
func (x *QueryGardenedBuildersRequest) GetPageToken() string
func (*QueryGardenedBuildersRequest) ProtoMessage ¶
func (*QueryGardenedBuildersRequest) ProtoMessage()
func (*QueryGardenedBuildersRequest) ProtoReflect ¶
func (x *QueryGardenedBuildersRequest) ProtoReflect() protoreflect.Message
func (*QueryGardenedBuildersRequest) Reset ¶
func (x *QueryGardenedBuildersRequest) Reset()
func (*QueryGardenedBuildersRequest) String ¶
func (x *QueryGardenedBuildersRequest) String() string
type QueryGardenedBuildersResponse ¶
type QueryGardenedBuildersResponse struct { // The gardened builders which are part of the rotation. Builders []*GardenedBuilder `protobuf:"bytes,1,rep,name=builders,proto3" json:"builders,omitempty"` // A token that can be sent as `page_token` to retrieve the next page. // If this field is omitted, there are no subsequent pages. NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"` // contains filtered or unexported fields }
func (*QueryGardenedBuildersResponse) Descriptor
deprecated
func (*QueryGardenedBuildersResponse) Descriptor() ([]byte, []int)
Deprecated: Use QueryGardenedBuildersResponse.ProtoReflect.Descriptor instead.
func (*QueryGardenedBuildersResponse) GetBuilders ¶
func (x *QueryGardenedBuildersResponse) GetBuilders() []*GardenedBuilder
func (*QueryGardenedBuildersResponse) GetNextPageToken ¶
func (x *QueryGardenedBuildersResponse) GetNextPageToken() string
func (*QueryGardenedBuildersResponse) ProtoMessage ¶
func (*QueryGardenedBuildersResponse) ProtoMessage()
func (*QueryGardenedBuildersResponse) ProtoReflect ¶
func (x *QueryGardenedBuildersResponse) ProtoReflect() protoreflect.Message
func (*QueryGardenedBuildersResponse) Reset ¶
func (x *QueryGardenedBuildersResponse) Reset()
func (*QueryGardenedBuildersResponse) String ¶
func (x *QueryGardenedBuildersResponse) String() string
type Regression ¶
type Regression struct { // A unique identifier the last regression (unique only within // the context of the containing step or test). // Use in conjunction with triage_state.bug_regression_id to identify stale // bug associations. Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"` // Whether the alert is new, consistent or resolved. // The following invariants hold: // If first_resolved_build is set, the state will be RESOLVED. // Otherwise, if total_failing_builds >= 2, the state will be CONSISTENT. // Otherwise, the state will be NEW. Status RegressionStatus `protobuf:"varint,2,opt,name=status,proto3,enum=luci.notify.v1.RegressionStatus" json:"status,omitempty"` // The last build the step passed on prior to the first failure covered by // this alert. This may not be set if, e.g. the builder was failing since // its inception. // For the purposes of this field, a step passes on a build it passed on // or a build that passes, even if it did not contain the step. LastPassingBuild *BuildRef `protobuf:"bytes,3,opt,name=last_passing_build,json=lastPassingBuild,proto3" json:"last_passing_build,omitempty"` // The first failing build. Note this may // not be the build immediately consecutive to the last passing build, as // there may be intervening canceled builds. FirstFailingBuild *BuildRef `protobuf:"bytes,4,opt,name=first_failing_build,json=firstFailingBuild,proto3" json:"first_failing_build,omitempty"` // The last failing build. This may be the same as the first failing build. LastFailingBuild *BuildRef `protobuf:"bytes,5,opt,name=last_failing_build,json=lastFailingBuild,proto3" json:"last_failing_build,omitempty"` // The total number of failing builds between the first and last failing // build. This is different to the number of builds between the first and // last failing build as it excludes builds with an ignored result // for this step/test. See Regression message for details of what statuses // are ignored. TotalBuildsWithFailures int64 `` /* 135-byte string literal not displayed */ // The first build in which the issue was resolved. Set for resolved alerts only. FirstResolvedBuild *BuildRef `protobuf:"bytes,7,opt,name=first_resolved_build,json=firstResolvedBuild,proto3" json:"first_resolved_build,omitempty"` // The start time of the last build with a passing or failing result for this step/test. // See comments on `Regression` message for definition of passing and failing. // Supports verification of fixes. LastActualResultBuildStartTime *timestamppb.Timestamp `` /* 159-byte string literal not displayed */ // Whether the last passing or failing result (i.e. non-ignored result) // for this step/test was a passing result. // See comments on `Regression` message for definition of passing and failing. // Supports verification of fixes. WasLastActualResultPass bool `` /* 137-byte string literal not displayed */ // contains filtered or unexported fields }
Regression contains information about a time a step or test encountered a sequence of one or more failures.
A sequence of failures is only broken by a pass. There are also ignored states, which capture cases where a build does not produce a result for a step/test. As the name suggests, these states are ignored and do not break a run of failures.
Passing, failing and ignored states are defined as follows: - Steps (see StepStatus):
- Passing: SUCCESS, NOT_RUN_BUILD_SUCCESS.
- Failing: FAILURE, INFRA_FAILURE
- Ignored: NOT_RUN_BUILD_NON_SUCCESS, CANCELED
- Tests (see TestStatus):
- Passing: Expected, Flaky, Exonerated
- Failing: Unexpected, Unexpectedly Skipped.
- Ignored: Not run, Pending.
A sequence typically starts when a step or test transitions from a passing state to a failing state. A sequence may also start if the step or test fails and that is the first non-ignored result for the step or test.
func (*Regression) Descriptor
deprecated
func (*Regression) Descriptor() ([]byte, []int)
Deprecated: Use Regression.ProtoReflect.Descriptor instead.
func (*Regression) GetFirstFailingBuild ¶
func (x *Regression) GetFirstFailingBuild() *BuildRef
func (*Regression) GetFirstResolvedBuild ¶
func (x *Regression) GetFirstResolvedBuild() *BuildRef
func (*Regression) GetId ¶
func (x *Regression) GetId() string
func (*Regression) GetLastActualResultBuildStartTime ¶
func (x *Regression) GetLastActualResultBuildStartTime() *timestamppb.Timestamp
func (*Regression) GetLastFailingBuild ¶
func (x *Regression) GetLastFailingBuild() *BuildRef
func (*Regression) GetLastPassingBuild ¶
func (x *Regression) GetLastPassingBuild() *BuildRef
func (*Regression) GetStatus ¶
func (x *Regression) GetStatus() RegressionStatus
func (*Regression) GetTotalBuildsWithFailures ¶
func (x *Regression) GetTotalBuildsWithFailures() int64
func (*Regression) GetWasLastActualResultPass ¶
func (x *Regression) GetWasLastActualResultPass() bool
func (*Regression) ProtoMessage ¶
func (*Regression) ProtoMessage()
func (*Regression) ProtoReflect ¶
func (x *Regression) ProtoReflect() protoreflect.Message
func (*Regression) Reset ¶
func (x *Regression) Reset()
func (*Regression) String ¶
func (x *Regression) String() string
type RegressionStatus ¶
type RegressionStatus int32
const ( // This value should not be used. RegressionStatus_REGRESSION_STATUS_UNSPECIFIED RegressionStatus = 0 // There has been one occurrence of the failure so far. RegressionStatus_REGRESSION_STATUS_NEW RegressionStatus = 1 // There are two or more occurrences of the failure and the regression appears // consistent. RegressionStatus_REGRESSION_STATUS_CONSISTENT RegressionStatus = 2 // The regression has been resolved. RegressionStatus_REGRESSION_STATUS_RESOLVED RegressionStatus = 3 )
func (RegressionStatus) Descriptor ¶
func (RegressionStatus) Descriptor() protoreflect.EnumDescriptor
func (RegressionStatus) Enum ¶
func (x RegressionStatus) Enum() *RegressionStatus
func (RegressionStatus) EnumDescriptor
deprecated
func (RegressionStatus) EnumDescriptor() ([]byte, []int)
Deprecated: Use RegressionStatus.Descriptor instead.
func (RegressionStatus) Number ¶
func (x RegressionStatus) Number() protoreflect.EnumNumber
func (RegressionStatus) String ¶
func (x RegressionStatus) String() string
func (RegressionStatus) Type ¶
func (RegressionStatus) Type() protoreflect.EnumType
type TriageState ¶
type TriageState struct { // The resource name of the gardened build triage state. // For steps: // Format: project/{PROJECT}/buckets/{BUCKET}/builder/{BUILDER}/gardening/steps/{URL_ENCODED_STEP_ID}/triage. // For tests: // Format: project/{PROJECT}/buckets/{BUCKET}/builder/{BUILDER}/gardening/steps/{URL_ENCODED_STEP_ID}/tests/{URL_ENCODED_TEST_ID}/variants/{VARIANT_HASH}/triage. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // The associated bug or free-form group. GroupAssociation *TriageState_GroupAssociation `protobuf:"bytes,2,opt,name=group_association,json=groupAssociation,proto3" json:"group_association,omitempty"` // The snooze. Only set if snooze has been requested. // // This is a client-controlled field and will not be reset once the snooze // expires. Snooze *TriageState_Snooze `protobuf:"bytes,3,opt,name=snooze,proto3" json:"snooze,omitempty"` // Controls verification for hypothesised fixes. // Can be used standalone or in conjunction with the // FIXED_PENDING_VERIFICATION snooze mode. // // Verification: // - Check fix_verification_state.regression_id to verify the fix // verification relates to the current regression and is not stale. // - Compare fix_verification_state.timestamp against the // last_actual_result_build_start_time on the step or test. If the // fix timestamp is later than this timestamp or there is no such // timestamp, the verification is pending. // If the fix timestamp is before or equal to // last_actual_result_build_start_time, and the step or test passed // (i.e. was_last_actual_result_pass) the fix is validated. // Else the fix is invalidated. // // In the event the step or test is not seen again (e.g. because the step // or test is only in failing builds), verification will never occur and snooze // will continue indefinitely. This is by design and represents a // trade-off between erronously verifying fixes (e.g. to test failures when a // later compile failure occors) and leaving actual fixes in snoozed ( // not verified) state. FixVerificationState *TriageState_FixVerificationState `protobuf:"bytes,4,opt,name=fix_verification_state,json=fixVerificationState,proto3" json:"fix_verification_state,omitempty"` // A human-editable note about the regression affecting this step or test. Note *TriageState_Note `protobuf:"bytes,5,opt,name=note,proto3" json:"note,omitempty"` // The timestamp the triage state was last updated. LastUpdated *timestamppb.Timestamp `protobuf:"bytes,6,opt,name=last_updated,json=lastUpdated,proto3" json:"last_updated,omitempty"` // This checksum is computed by the server based on the value of other // fields, and may be sent on update requests to ensure the client has // an up-to-date value before proceeding. // See https://google.aip.dev/154. Etag string `protobuf:"bytes,7,opt,name=etag,proto3" json:"etag,omitempty"` // contains filtered or unexported fields }
TriageState is the user-editable triage state.
func (*TriageState) Descriptor
deprecated
func (*TriageState) Descriptor() ([]byte, []int)
Deprecated: Use TriageState.ProtoReflect.Descriptor instead.
func (*TriageState) GetEtag ¶
func (x *TriageState) GetEtag() string
func (*TriageState) GetFixVerificationState ¶
func (x *TriageState) GetFixVerificationState() *TriageState_FixVerificationState
func (*TriageState) GetGroupAssociation ¶
func (x *TriageState) GetGroupAssociation() *TriageState_GroupAssociation
func (*TriageState) GetLastUpdated ¶
func (x *TriageState) GetLastUpdated() *timestamppb.Timestamp
func (*TriageState) GetName ¶
func (x *TriageState) GetName() string
func (*TriageState) GetNote ¶
func (x *TriageState) GetNote() *TriageState_Note
func (*TriageState) GetSnooze ¶
func (x *TriageState) GetSnooze() *TriageState_Snooze
func (*TriageState) ProtoMessage ¶
func (*TriageState) ProtoMessage()
func (*TriageState) ProtoReflect ¶
func (x *TriageState) ProtoReflect() protoreflect.Message
func (*TriageState) Reset ¶
func (x *TriageState) Reset()
func (*TriageState) String ¶
func (x *TriageState) String() string
type TriageState_FixVerificationState ¶
type TriageState_FixVerificationState struct { // The regression ID the fix verification pertains to. Should be set // whenever trying to verify a new fix. // // If this differs from the current regression ID, the fix verification // pertains to an earlier regression and its apparent validation or // invalidation (i.e. by the latest build failing) should be ignored. RegressionId string `protobuf:"bytes,1,opt,name=regression_id,json=regressionId,proto3" json:"regression_id,omitempty"` // The timestamp at which the user expects the fix to have already landed. // A failing build which started after this time will lead to // time_falsified being set. // Setting this field to zero means no expectation. // Changing this field resets the corresponding _falsified field. Timestamp *timestamppb.Timestamp `protobuf:"bytes,2,opt,name=timestamp,proto3" json:"timestamp,omitempty"` // At present, this information is an optional context to the fix timestamp. // In future, a commit-position based verification may be implemented for // changelists, or the server may lookup the changelist landing time and // provide this to support verification. Changelist *Changelist `protobuf:"bytes,3,opt,name=changelist,proto3" json:"changelist,omitempty"` // contains filtered or unexported fields }
FixVerificationState captures the state of verifying the fix for this alert. In future, changelist-based verification may be offered in addition to timestamp-based verification.
func (*TriageState_FixVerificationState) Descriptor
deprecated
func (*TriageState_FixVerificationState) Descriptor() ([]byte, []int)
Deprecated: Use TriageState_FixVerificationState.ProtoReflect.Descriptor instead.
func (*TriageState_FixVerificationState) GetChangelist ¶
func (x *TriageState_FixVerificationState) GetChangelist() *Changelist
func (*TriageState_FixVerificationState) GetRegressionId ¶
func (x *TriageState_FixVerificationState) GetRegressionId() string
func (*TriageState_FixVerificationState) GetTimestamp ¶
func (x *TriageState_FixVerificationState) GetTimestamp() *timestamppb.Timestamp
func (*TriageState_FixVerificationState) ProtoMessage ¶
func (*TriageState_FixVerificationState) ProtoMessage()
func (*TriageState_FixVerificationState) ProtoReflect ¶
func (x *TriageState_FixVerificationState) ProtoReflect() protoreflect.Message
func (*TriageState_FixVerificationState) Reset ¶
func (x *TriageState_FixVerificationState) Reset()
func (*TriageState_FixVerificationState) String ¶
func (x *TriageState_FixVerificationState) String() string
type TriageState_GroupAssociation ¶
type TriageState_GroupAssociation struct { // The regression ID this association was current at. Should be set // to the current regression ID whenever setting bugs or freefrom_group_id. // // If this differs from the current regression sequence number, it indicates // the bug/group may be stale and in the (keep|ignore) buttons should be // displayed next to the bug/group in the UI. // // This is a client owned field (see https://google.aip.dev/129). RegressionId string `protobuf:"bytes,1,opt,name=regression_id,json=regressionId,proto3" json:"regression_id,omitempty"` // The associated bug(s). Bugs []*Bug `protobuf:"bytes,2,rep,name=bugs,proto3" json:"bugs,omitempty"` // The associated free-form group. This is a human-readable string. // Limited to 255 bytes of printable ASCII. // Either this or bugs should be set, not both. FreeformGroupId string `protobuf:"bytes,3,opt,name=freeform_group_id,json=freeformGroupId,proto3" json:"freeform_group_id,omitempty"` // Indicates the time the regression the bug associated with // (regression_id) was resolved. Unset if regression_id is unset // or the regression is not yet resolved. // Useful for hiding bugs completely once they become sufficiently stale // and/or showing how stale they are in the UI. RegressionResolvedTime *timestamppb.Timestamp `` /* 129-byte string literal not displayed */ // contains filtered or unexported fields }
func (*TriageState_GroupAssociation) Descriptor
deprecated
func (*TriageState_GroupAssociation) Descriptor() ([]byte, []int)
Deprecated: Use TriageState_GroupAssociation.ProtoReflect.Descriptor instead.
func (*TriageState_GroupAssociation) GetBugs ¶
func (x *TriageState_GroupAssociation) GetBugs() []*Bug
func (*TriageState_GroupAssociation) GetFreeformGroupId ¶
func (x *TriageState_GroupAssociation) GetFreeformGroupId() string
func (*TriageState_GroupAssociation) GetRegressionId ¶
func (x *TriageState_GroupAssociation) GetRegressionId() string
func (*TriageState_GroupAssociation) GetRegressionResolvedTime ¶
func (x *TriageState_GroupAssociation) GetRegressionResolvedTime() *timestamppb.Timestamp
func (*TriageState_GroupAssociation) ProtoMessage ¶
func (*TriageState_GroupAssociation) ProtoMessage()
func (*TriageState_GroupAssociation) ProtoReflect ¶
func (x *TriageState_GroupAssociation) ProtoReflect() protoreflect.Message
func (*TriageState_GroupAssociation) Reset ¶
func (x *TriageState_GroupAssociation) Reset()
func (*TriageState_GroupAssociation) String ¶
func (x *TriageState_GroupAssociation) String() string
type TriageState_Note ¶
type TriageState_Note struct { // The human-readable note. Limited to 10,000 bytes of printable ASCII. Message string `protobuf:"bytes,1,opt,name=message,proto3" json:"message,omitempty"` // The regression ID the note pertains to. Should be set // whenever setting a new note. // // If this differs from the current regression ID, the note // pertains to an earlier regression and may be treated as stale. RegressionId string `protobuf:"bytes,2,opt,name=regression_id,json=regressionId,proto3" json:"regression_id,omitempty"` // The timestamp the note was last updated. LastUpdated *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=last_updated,json=lastUpdated,proto3" json:"last_updated,omitempty"` // contains filtered or unexported fields }
func (*TriageState_Note) Descriptor
deprecated
func (*TriageState_Note) Descriptor() ([]byte, []int)
Deprecated: Use TriageState_Note.ProtoReflect.Descriptor instead.
func (*TriageState_Note) GetLastUpdated ¶
func (x *TriageState_Note) GetLastUpdated() *timestamppb.Timestamp
func (*TriageState_Note) GetMessage ¶
func (x *TriageState_Note) GetMessage() string
func (*TriageState_Note) GetRegressionId ¶
func (x *TriageState_Note) GetRegressionId() string
func (*TriageState_Note) ProtoMessage ¶
func (*TriageState_Note) ProtoMessage()
func (*TriageState_Note) ProtoReflect ¶
func (x *TriageState_Note) ProtoReflect() protoreflect.Message
func (*TriageState_Note) Reset ¶
func (x *TriageState_Note) Reset()
func (*TriageState_Note) String ¶
func (x *TriageState_Note) String() string
type TriageState_Snooze ¶
type TriageState_Snooze struct { // The requested alert snooze mode. // // Clients must monitor whether the snooze has expired by using the following logic: // - If snooze mode is ONCE, compare snooze_build_id against // the latest_completed_build_id on the step. // - If snooze mode is FIXED_PENDING_VERIFICATION, only treat // the snooze as active if fix_verification_state_regression_id matches // the current regression_id (as the snooze may have set at an earlier // regression that was fixed). The snooze shall remain active // only until the fix can be validated using the steps documented on // fix_verification_state. // If the snooze was active but was invalidated using // fix_verification_state, then the UI may consider raising an alert // (i.e. fix failed to verify). Mode TriageState_Snooze_SnoozeMode `protobuf:"varint,1,opt,name=mode,proto3,enum=luci.notify.v1.TriageState_Snooze_SnoozeMode" json:"mode,omitempty"` // The identifier of the build being snoozed. Use in conjunction with the ONCE // snooze mode to record the build that was snoozed. SnoozedBuildbucketBuildId int64 `` /* 141-byte string literal not displayed */ // contains filtered or unexported fields }
func (*TriageState_Snooze) Descriptor
deprecated
func (*TriageState_Snooze) Descriptor() ([]byte, []int)
Deprecated: Use TriageState_Snooze.ProtoReflect.Descriptor instead.
func (*TriageState_Snooze) GetMode ¶
func (x *TriageState_Snooze) GetMode() TriageState_Snooze_SnoozeMode
func (*TriageState_Snooze) GetSnoozedBuildbucketBuildId ¶
func (x *TriageState_Snooze) GetSnoozedBuildbucketBuildId() int64
func (*TriageState_Snooze) ProtoMessage ¶
func (*TriageState_Snooze) ProtoMessage()
func (*TriageState_Snooze) ProtoReflect ¶
func (x *TriageState_Snooze) ProtoReflect() protoreflect.Message
func (*TriageState_Snooze) Reset ¶
func (x *TriageState_Snooze) Reset()
func (*TriageState_Snooze) String ¶
func (x *TriageState_Snooze) String() string
type TriageState_Snooze_SnoozeMode ¶
type TriageState_Snooze_SnoozeMode int32
The alert snooze status.
const ( TriageState_Snooze_SNOOZE_MODE_UNSPECIFIED TriageState_Snooze_SnoozeMode = 0 // Snoozes until the next build result. When setting this option, // also populate the snoozed_build_id option to the most recent // failing build (not necessarily the most recent build, as that may // be running). TriageState_Snooze_ONCE TriageState_Snooze_SnoozeMode = 1 // Snoozes until the fix hypothesis in the fix_verification_state is // either verified or falsified. // When this mode is set, the alert will remain snoozed until one of: // - The fix hypothesis is cleared. // - The fix hypothesis is falsified. TriageState_Snooze_FIXED_PENDING_VERIFICATION TriageState_Snooze_SnoozeMode = 2 )
func (TriageState_Snooze_SnoozeMode) Descriptor ¶
func (TriageState_Snooze_SnoozeMode) Descriptor() protoreflect.EnumDescriptor
func (TriageState_Snooze_SnoozeMode) Enum ¶
func (x TriageState_Snooze_SnoozeMode) Enum() *TriageState_Snooze_SnoozeMode
func (TriageState_Snooze_SnoozeMode) EnumDescriptor
deprecated
func (TriageState_Snooze_SnoozeMode) EnumDescriptor() ([]byte, []int)
Deprecated: Use TriageState_Snooze_SnoozeMode.Descriptor instead.
func (TriageState_Snooze_SnoozeMode) Number ¶
func (x TriageState_Snooze_SnoozeMode) Number() protoreflect.EnumNumber
func (TriageState_Snooze_SnoozeMode) String ¶
func (x TriageState_Snooze_SnoozeMode) String() string
func (TriageState_Snooze_SnoozeMode) Type ¶
func (TriageState_Snooze_SnoozeMode) Type() protoreflect.EnumType
type UnimplementedGardeningServer ¶
type UnimplementedGardeningServer struct { }
UnimplementedGardeningServer can be embedded to have forward compatible implementations.
func (*UnimplementedGardeningServer) BatchUpdateTriageState ¶
func (*UnimplementedGardeningServer) BatchUpdateTriageState(context.Context, *BatchUpdateTriageStateRequest) (*BatchUpdateTriageStateResponse, error)
func (*UnimplementedGardeningServer) QueryGardenedBuilders ¶
func (*UnimplementedGardeningServer) QueryGardenedBuilders(context.Context, *QueryGardenedBuildersRequest) (*QueryGardenedBuildersResponse, error)
type UpdateTriageStateRequest ¶
type UpdateTriageStateRequest struct { // The triage state to update. // // The triage states's `name` field is used to identify the triage state to update. // Format: project/{PROJECT}/buckets/{BUCKET}/builder/{BUILDER}/gardening/steps/{STEP_ID}/triage. // // Set the `etag` on the TriageState to conditionally update the resource conditioned on the // resource not having been updated since it was last read. TriageState *TriageState `protobuf:"bytes,1,opt,name=triage_state,json=triageState,proto3" json:"triage_state,omitempty"` // The list of fields to update. UpdateMask *fieldmaskpb.FieldMask `protobuf:"bytes,2,opt,name=update_mask,json=updateMask,proto3" json:"update_mask,omitempty"` // contains filtered or unexported fields }
func (*UpdateTriageStateRequest) Descriptor
deprecated
func (*UpdateTriageStateRequest) Descriptor() ([]byte, []int)
Deprecated: Use UpdateTriageStateRequest.ProtoReflect.Descriptor instead.
func (*UpdateTriageStateRequest) GetTriageState ¶
func (x *UpdateTriageStateRequest) GetTriageState() *TriageState
func (*UpdateTriageStateRequest) GetUpdateMask ¶
func (x *UpdateTriageStateRequest) GetUpdateMask() *fieldmaskpb.FieldMask
func (*UpdateTriageStateRequest) ProtoMessage ¶
func (*UpdateTriageStateRequest) ProtoMessage()
func (*UpdateTriageStateRequest) ProtoReflect ¶
func (x *UpdateTriageStateRequest) ProtoReflect() protoreflect.Message
func (*UpdateTriageStateRequest) Reset ¶
func (x *UpdateTriageStateRequest) Reset()
func (*UpdateTriageStateRequest) String ¶
func (x *UpdateTriageStateRequest) String() string