proto

package
v0.0.0-...-fb8dd36 Latest Latest
Warning

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

 Go to latest Published: Dec 19, 2024 License: BSD-3-Clause Imports: 10 Imported by: 0

README

CABE Protocol buffer definitions

This directory contains .pb.go and _grpc.pb.go files generated from the .proto files in //cabe/proto/...

How to update cabe's protos

To update any of cabe's protobuf definitions:

  • make your edits to the .proto files(s) in //cabe/proto/...
  • run go generate from this directory to update the generated .go files
  • test and send your changes for review

Gotchas

Do not use the optional keyword.

optional is no longer a keyword in proto3, since fields are optional by default now.

The go generate step here appears to be perfectly fine if .proto files contain the optional keyword, but these files all use proto3 syntax. Other protoc invocations (such as the ones used to generate the python stubs for cabe in chromeperf's codebase) have had problems with optional and fail with error messages about it.

So optional is unnecessary in proto3, and it breaks things elsewhere if you include it here, so please don't.

Documentation

Index

Constants

View Source 
const (
	Analysis_GetAnalysis_FullMethodName = "/cabe.v1.Analysis/GetAnalysis"
)

Variables

View Source 
var Analysis_ServiceDesc = grpc.ServiceDesc{
	ServiceName: "cabe.v1.Analysis",
	HandlerType: (*AnalysisServer)(nil),
	Methods: []grpc.MethodDesc{
		{
			MethodName: "GetAnalysis",
			Handler:    _Analysis_GetAnalysis_Handler,
		},
	},
	Streams:  []grpc.StreamDesc{},
	Metadata: "cabe/proto/v1/service.proto",
}

Analysis_ServiceDesc is the grpc.ServiceDesc for Analysis service. It's only intended for direct use with grpc.RegisterService, and not to be introspected or modified (even as a copy)

View Source 
var File_cabe_proto_v1_analysis_proto protoreflect.FileDescriptor
View Source 
var File_cabe_proto_v1_service_proto protoreflect.FileDescriptor
View Source 
var File_cabe_proto_v1_spec_proto protoreflect.FileDescriptor

Functions

func RegisterAnalysisServer 

func RegisterAnalysisServer(s grpc.ServiceRegistrar, srv AnalysisServer)

Types

type AnalysisClient 

type AnalysisClient interface {
	// Get results of a performance experiment analysis.
	GetAnalysis(ctx context.Context, in *GetAnalysisRequest, opts ...grpc.CallOption) (*GetAnalysisResponse, error)
}

AnalysisClient is the client API for Analysis service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.

func NewAnalysisClient 

func NewAnalysisClient(cc grpc.ClientConnInterface) AnalysisClient

type AnalysisDiagnostics 

type AnalysisDiagnostics struct {

	// Things that had to be excluded from the analysis, and why.
	ExcludedSwarmingTasks []*SwarmingTaskDiagnostics `` /* 126-byte string literal not displayed */
	ExcludedReplicas      []*ReplicaDiagnostics      `protobuf:"bytes,2,rep,name=excluded_replicas,json=excludedReplicas,proto3" json:"excluded_replicas,omitempty"`
	// Things that were included in the analysis as expected.
	IncludedSwarmingTasks []*SwarmingTaskDiagnostics `` /* 126-byte string literal not displayed */
	IncludedReplicas      []*ReplicaDiagnostics      `protobuf:"bytes,4,rep,name=included_replicas,json=includedReplicas,proto3" json:"included_replicas,omitempty"`
	// contains filtered or unexported fields
}

AnalysisDiagnostics contains diagnostic messages generated by the Analyzer about the replica task pairs and individual tasks during its analysis.

func (*AnalysisDiagnostics) Descriptor deprecated 

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

Deprecated: Use AnalysisDiagnostics.ProtoReflect.Descriptor instead.

func (*AnalysisDiagnostics) GetExcludedReplicas 

func (x *AnalysisDiagnostics) GetExcludedReplicas() []*ReplicaDiagnostics

func (*AnalysisDiagnostics) GetExcludedSwarmingTasks 

func (x *AnalysisDiagnostics) GetExcludedSwarmingTasks() []*SwarmingTaskDiagnostics

func (*AnalysisDiagnostics) GetIncludedReplicas 

func (x *AnalysisDiagnostics) GetIncludedReplicas() []*ReplicaDiagnostics

func (*AnalysisDiagnostics) GetIncludedSwarmingTasks 

func (x *AnalysisDiagnostics) GetIncludedSwarmingTasks() []*SwarmingTaskDiagnostics

func (*AnalysisDiagnostics) ProtoMessage 

func (*AnalysisDiagnostics) ProtoMessage()

func (*AnalysisDiagnostics) ProtoReflect 

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

func (*AnalysisDiagnostics) Reset 

func (x *AnalysisDiagnostics) Reset()

func (*AnalysisDiagnostics) String 

func (x *AnalysisDiagnostics) String() string

type AnalysisMetadata 

type AnalysisMetadata struct {

	// The report_id of an analysis
	ReportId    string               `protobuf:"bytes,1,opt,name=report_id,json=reportId,proto3" json:"report_id,omitempty"`
	Diagnostics *AnalysisDiagnostics `protobuf:"bytes,2,opt,name=diagnostics,proto3" json:"diagnostics,omitempty"`
	// contains filtered or unexported fields
}

AnalysisMetadata defines the metadata of an analysis.

func (*AnalysisMetadata) Descriptor deprecated 

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

Deprecated: Use AnalysisMetadata.ProtoReflect.Descriptor instead.

func (*AnalysisMetadata) GetDiagnostics 

func (x *AnalysisMetadata) GetDiagnostics() *AnalysisDiagnostics

func (*AnalysisMetadata) GetReportId 

func (x *AnalysisMetadata) GetReportId() string

func (*AnalysisMetadata) ProtoMessage 

func (*AnalysisMetadata) ProtoMessage()

func (*AnalysisMetadata) ProtoReflect 

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

func (*AnalysisMetadata) Reset 

func (x *AnalysisMetadata) Reset()

func (*AnalysisMetadata) String 

func (x *AnalysisMetadata) String() string

type AnalysisResult 

type AnalysisResult struct {

	// Analysis result id (PK)
	ResultId string `protobuf:"bytes,1,opt,name=result_id,json=resultId,proto3" json:"result_id,omitempty"`
	// Analysis experiment spec
	ExperimentSpec *ExperimentSpec `protobuf:"bytes,2,opt,name=experiment_spec,json=experimentSpec,proto3" json:"experiment_spec,omitempty"`
	// The metadata of the analysis
	AnalysisMetadata *AnalysisMetadata `protobuf:"bytes,3,opt,name=analysis_metadata,json=analysisMetadata,proto3" json:"analysis_metadata,omitempty"`
	// The calculated statistic of the analysis
	Statistic *Statistic `protobuf:"bytes,4,opt,name=statistic,proto3" json:"statistic,omitempty"`
	// contains filtered or unexported fields
}

AnalysisResult defines the result of an analysis

func (*AnalysisResult) Descriptor deprecated 

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

Deprecated: Use AnalysisResult.ProtoReflect.Descriptor instead.

func (*AnalysisResult) GetAnalysisMetadata 

func (x *AnalysisResult) GetAnalysisMetadata() *AnalysisMetadata

func (*AnalysisResult) GetExperimentSpec 

func (x *AnalysisResult) GetExperimentSpec() *ExperimentSpec

func (*AnalysisResult) GetResultId 

func (x *AnalysisResult) GetResultId() string

func (*AnalysisResult) GetStatistic 

func (x *AnalysisResult) GetStatistic() *Statistic

func (*AnalysisResult) ProtoMessage 

func (*AnalysisResult) ProtoMessage()

func (*AnalysisResult) ProtoReflect 

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

func (*AnalysisResult) Reset 

func (x *AnalysisResult) Reset()

func (*AnalysisResult) String 

func (x *AnalysisResult) String() string

type AnalysisServer 

type AnalysisServer interface {
	// Get results of a performance experiment analysis.
	GetAnalysis(context.Context, *GetAnalysisRequest) (*GetAnalysisResponse, error)
	// contains filtered or unexported methods
}

AnalysisServer is the server API for Analysis service. All implementations must embed UnimplementedAnalysisServer for forward compatibility

type AnalysisSpec 

type AnalysisSpec struct {

	// List of benchmarks, stories, metrics. CABE ETL will use this as sort of
	// a manifest for results data - it will check to make sure all of these
	// are actually present in the benchmark jobs' collected output.
	Benchmark []*Benchmark `protobuf:"bytes,1,rep,name=benchmark,proto3" json:"benchmark,omitempty"`
	// contains filtered or unexported fields
}

AnalysisSpec defines what benchmarks and measurements we expect to analyze from a set of RunSpecs. This type should include all observed potential response variables for the experiment.

func (*AnalysisSpec) Descriptor deprecated 

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

Deprecated: Use AnalysisSpec.ProtoReflect.Descriptor instead.

func (*AnalysisSpec) GetBenchmark 

func (x *AnalysisSpec) GetBenchmark() []*Benchmark

func (*AnalysisSpec) ProtoMessage 

func (*AnalysisSpec) ProtoMessage()

func (*AnalysisSpec) ProtoReflect 

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

func (*AnalysisSpec) Reset 

func (x *AnalysisSpec) Reset()

func (*AnalysisSpec) String 

func (x *AnalysisSpec) String() string

type ArmSpec 

type ArmSpec struct {
	BuildSpec []*BuildSpec `protobuf:"bytes,1,rep,name=build_spec,json=buildSpec,proto3" json:"build_spec,omitempty"`
	RunSpec   []*RunSpec   `protobuf:"bytes,2,rep,name=run_spec,json=runSpec,proto3" json:"run_spec,omitempty"`
	// contains filtered or unexported fields
}

ArmSpec defines how to build and execute one arm of a performance benchmark A/B test. This type should include all observed potential explanatory variables for the experiment.

func (*ArmSpec) Descriptor deprecated 

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

Deprecated: Use ArmSpec.ProtoReflect.Descriptor instead.

func (*ArmSpec) GetBuildSpec 

func (x *ArmSpec) GetBuildSpec() []*BuildSpec

func (*ArmSpec) GetRunSpec 

func (x *ArmSpec) GetRunSpec() []*RunSpec

func (*ArmSpec) ProtoMessage 

func (*ArmSpec) ProtoMessage()

func (*ArmSpec) ProtoReflect 

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

func (*ArmSpec) Reset 

func (x *ArmSpec) Reset()

func (*ArmSpec) String 

func (x *ArmSpec) String() string

type Benchmark 

type Benchmark struct {
	Name     string   `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`         // e.g. "Speedometer2"
	Workload []string `protobuf:"bytes,2,rep,name=workload,proto3" json:"workload,omitempty"` // e.g. "React-TodoMVC"
	// contains filtered or unexported fields
}

Benchmark encapsulates both the coarse grained benchmark suite name and all of the more specific workloads (or "stories", to use older terminology) that generate measurements.

func (*Benchmark) Descriptor deprecated 

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

Deprecated: Use Benchmark.ProtoReflect.Descriptor instead.

func (*Benchmark) GetName 

func (x *Benchmark) GetName() string

func (*Benchmark) GetWorkload 

func (x *Benchmark) GetWorkload() []string

func (*Benchmark) ProtoMessage 

func (*Benchmark) ProtoMessage()

func (*Benchmark) ProtoReflect 

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

func (*Benchmark) Reset 

func (x *Benchmark) Reset()

func (*Benchmark) String 

func (x *Benchmark) String() string

type BuildSpec 

type BuildSpec struct {

	// Source checkout (git repo, branch, commit position)
	GitilesCommit *GitilesCommit `protobuf:"bytes,1,opt,name=gitiles_commit,json=gitilesCommit,proto3" json:"gitiles_commit,omitempty"`
	// Applied patches (get repos, branches, commit positions)
	GerritChanges []*GerritChange `protobuf:"bytes,2,rep,name=gerrit_changes,json=gerritChanges,proto3" json:"gerrit_changes,omitempty"`
	// For binaries that use a pre-built installer for CBB experiments.
	InstalledBrowser *InstalledBrowser `protobuf:"bytes,3,opt,name=installed_browser,json=installedBrowser,proto3" json:"installed_browser,omitempty"`
	// contains filtered or unexported fields
}

BuildSpec defines what set of executable bits we ship to test machines. It should include enough information to tell chrome build infrastructure how build the executable from scratch, or how to identify an exact version of a pre-built installation (e.g. 3rd party browser other than chrome)

func (*BuildSpec) Descriptor deprecated 

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

Deprecated: Use BuildSpec.ProtoReflect.Descriptor instead.

func (*BuildSpec) GetGerritChanges 

func (x *BuildSpec) GetGerritChanges() []*GerritChange

func (*BuildSpec) GetGitilesCommit 

func (x *BuildSpec) GetGitilesCommit() *GitilesCommit

func (*BuildSpec) GetInstalledBrowser 

func (x *BuildSpec) GetInstalledBrowser() *InstalledBrowser

func (*BuildSpec) ProtoMessage 

func (*BuildSpec) ProtoMessage()

func (*BuildSpec) ProtoReflect 

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

func (*BuildSpec) Reset 

func (x *BuildSpec) Reset()

func (*BuildSpec) String 

func (x *BuildSpec) String() string

type ExperimentSpec 

type ExperimentSpec struct {

	// common contains all of the build/run details that are common to all
	// arms of an experiment. For instance, if you are comparing two different
	// browser build versions across mac, windows and linux, then the mac, windows
	// and linux details would go in the common ArmSpec.  The control and
	// treatment armspecs wouldn't mention mac, windows or linux details since
	// the are implied by the common armspec.
	// Any details specified in both the common ArmSpec and any other arms'
	// ArmSpecs should indicate an unsresolved, invalid ExperimentSpec.
	Common *ArmSpec `protobuf:"bytes,1,opt,name=common,proto3" json:"common,omitempty"`
	// Control and Treatment are somewhat arbitrary distinctions and their meaning
	// is use-case dependent. Values in their ArmSpecs should not conflict
	// with anything in the common ArmSpec.
	Control *ArmSpec `protobuf:"bytes,2,opt,name=control,proto3" json:"control,omitempty"`
	// Treatment may change in the future to be a repeated field to better
	// represent multi-arm trials but for now we'll limit it to a single value.
	Treatment *ArmSpec `protobuf:"bytes,3,opt,name=treatment,proto3" json:"treatment,omitempty"`
	// Analysis describes how we expect CABE to compare the arms of the
	// experiment.
	Analysis *AnalysisSpec `protobuf:"bytes,4,opt,name=analysis,proto3" json:"analysis,omitempty"`
	// contains filtered or unexported fields
}

ExperimentSpec contains all of the necessary information to build, execute and analyze a set of benchmark metrics for a controlled experiment.

func (*ExperimentSpec) Descriptor deprecated 

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

Deprecated: Use ExperimentSpec.ProtoReflect.Descriptor instead.

func (*ExperimentSpec) GetAnalysis 

func (x *ExperimentSpec) GetAnalysis() *AnalysisSpec

func (*ExperimentSpec) GetCommon 

func (x *ExperimentSpec) GetCommon() *ArmSpec

func (*ExperimentSpec) GetControl 

func (x *ExperimentSpec) GetControl() *ArmSpec

func (*ExperimentSpec) GetTreatment 

func (x *ExperimentSpec) GetTreatment() *ArmSpec

func (*ExperimentSpec) ProtoMessage 

func (*ExperimentSpec) ProtoMessage()

func (*ExperimentSpec) ProtoReflect 

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

func (*ExperimentSpec) Reset 

func (x *ExperimentSpec) Reset()

func (*ExperimentSpec) String 

func (x *ExperimentSpec) String() string

type FinchConfig 

type FinchConfig struct {

	// e.g. seed hash, seed change list, and seed timestamp.
	SeedHash       string                 `protobuf:"bytes,1,opt,name=seed_hash,json=seedHash,proto3" json:"seed_hash,omitempty"`
	SeedChangelist uint64                 `protobuf:"varint,2,opt,name=seed_changelist,json=seedChangelist,proto3" json:"seed_changelist,omitempty"`
	SeedTimestamp  *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=seed_timestamp,json=seedTimestamp,proto3" json:"seed_timestamp,omitempty"`
	// contains filtered or unexported fields
}

Finch config for Chrome.

func (*FinchConfig) Descriptor deprecated 

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

Deprecated: Use FinchConfig.ProtoReflect.Descriptor instead.

func (*FinchConfig) GetSeedChangelist 

func (x *FinchConfig) GetSeedChangelist() uint64

func (*FinchConfig) GetSeedHash 

func (x *FinchConfig) GetSeedHash() string

func (*FinchConfig) GetSeedTimestamp 

func (x *FinchConfig) GetSeedTimestamp() *timestamppb.Timestamp

func (*FinchConfig) ProtoMessage 

func (*FinchConfig) ProtoMessage()

func (*FinchConfig) ProtoReflect 

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

func (*FinchConfig) Reset 

func (x *FinchConfig) Reset()

func (*FinchConfig) String 

func (x *FinchConfig) String() string

type GerritChange 

type GerritChange struct {

	// Gerrit hostname, e.g. "chromium-review.googlesource.com".
	Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"`
	// Gerrit project, e.g. "chromium/src".
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// Change number, e.g. 12345.
	Change int64 `protobuf:"varint,3,opt,name=change,proto3" json:"change,omitempty"`
	// Patch set number, e.g. 1.
	Patchset int64 `protobuf:"varint,4,opt,name=patchset,proto3" json:"patchset,omitempty"`
	// Git hash for patchset
	PatchsetHash string `protobuf:"bytes,5,opt,name=patchset_hash,json=patchsetHash,proto3" json:"patchset_hash,omitempty"`
	// contains filtered or unexported fields
}

A Gerrit patchset.

func (*GerritChange) Descriptor deprecated 

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

Deprecated: Use GerritChange.ProtoReflect.Descriptor instead.

func (*GerritChange) GetChange 

func (x *GerritChange) GetChange() int64

func (*GerritChange) GetHost 

func (x *GerritChange) GetHost() string

func (*GerritChange) GetPatchset 

func (x *GerritChange) GetPatchset() int64

func (*GerritChange) GetPatchsetHash 

func (x *GerritChange) GetPatchsetHash() string

func (*GerritChange) GetProject 

func (x *GerritChange) GetProject() string

func (*GerritChange) ProtoMessage 

func (*GerritChange) ProtoMessage()

func (*GerritChange) ProtoReflect 

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

func (*GerritChange) Reset 

func (x *GerritChange) Reset()

func (*GerritChange) String 

func (x *GerritChange) String() string

type GetAnalysisRequest 

type GetAnalysisRequest struct {
	PinpointJobId string `protobuf:"bytes,1,opt,name=pinpoint_job_id,json=pinpointJobId,proto3" json:"pinpoint_job_id,omitempty"`
	// experiment_spec defines the experiment arms as well as which specific
	// benchmarks and workloads it should expect to find in task result output
	// files.  If reality doesn't match the spec, CABE returns an error with
	// some information about what didn't match the provided ExperimentSpec.
	//
	// If experiment_spec isn't set, CABE will infer one based on heuristics*
	// and data available from Swarming and RBE-CAS at the time of the request.
	// Note that this is best-effort and not guaranteed to do what the caller
	// expects. If you have specific benchmarks and workloads that need to be
	// either analyzed or cause errors if they are missing, you should specify an
	// explicit experiment_spec value.
	//
	// *See infer_specs.go and infer_specs_test.go for implementation details.
	ExperimentSpec *ExperimentSpec `protobuf:"bytes,2,opt,name=experiment_spec,json=experimentSpec,proto3" json:"experiment_spec,omitempty"`
	// contains filtered or unexported fields
}

func (*GetAnalysisRequest) Descriptor deprecated 

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

Deprecated: Use GetAnalysisRequest.ProtoReflect.Descriptor instead.

func (*GetAnalysisRequest) GetExperimentSpec 

func (x *GetAnalysisRequest) GetExperimentSpec() *ExperimentSpec

func (*GetAnalysisRequest) GetPinpointJobId 

func (x *GetAnalysisRequest) GetPinpointJobId() string

func (*GetAnalysisRequest) ProtoMessage 

func (*GetAnalysisRequest) ProtoMessage()

func (*GetAnalysisRequest) ProtoReflect 

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

func (*GetAnalysisRequest) Reset 

func (x *GetAnalysisRequest) Reset()

func (*GetAnalysisRequest) String 

func (x *GetAnalysisRequest) String() string

type GetAnalysisResponse 

type GetAnalysisResponse struct {
	Results []*AnalysisResult `protobuf:"bytes,1,rep,name=results,proto3" json:"results,omitempty"`
	// If an experiment_spec was not included in the GetAnalysisRequest,
	// cabe will apply some best-effort heuristics to infer an experiment
	// specification based on swarming task metadata and contents of task
	// output json files. The GetAnalysis method will attach whatever
	// it was able to infer the experiment to this field.
	InferredExperimentSpec *ExperimentSpec `` /* 129-byte string literal not displayed */
	// Extra information about the analysis and/or the process of generating
	// the results.
	Metadata *AnalysisMetadata `protobuf:"bytes,3,opt,name=metadata,proto3" json:"metadata,omitempty"`
	// contains filtered or unexported fields
}

func (*GetAnalysisResponse) Descriptor deprecated 

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

Deprecated: Use GetAnalysisResponse.ProtoReflect.Descriptor instead.

func (*GetAnalysisResponse) GetInferredExperimentSpec 

func (x *GetAnalysisResponse) GetInferredExperimentSpec() *ExperimentSpec

func (*GetAnalysisResponse) GetMetadata 

func (x *GetAnalysisResponse) GetMetadata() *AnalysisMetadata

func (*GetAnalysisResponse) GetResults 

func (x *GetAnalysisResponse) GetResults() []*AnalysisResult

func (*GetAnalysisResponse) ProtoMessage 

func (*GetAnalysisResponse) ProtoMessage()

func (*GetAnalysisResponse) ProtoReflect 

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

func (*GetAnalysisResponse) Reset 

func (x *GetAnalysisResponse) Reset()

func (*GetAnalysisResponse) String 

func (x *GetAnalysisResponse) String() string

type GitilesCommit 

type GitilesCommit struct {

	// Gitiles hostname, e.g. "chromium.googlesource.com".
	Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"`
	// Repository name on the host, e.g. "chromium/src".
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// Commit HEX SHA1.
	Id string `protobuf:"bytes,3,opt,name=id,proto3" json:"id,omitempty"`
	// Commit ref, e.g. "refs/heads/master".
	// NOT a branch name: if specified, must start with "refs/".
	// If id is set, ref SHOULD also be set, so that git clients can
	// know how to obtain the commit by id.
	Ref string `protobuf:"bytes,4,opt,name=ref,proto3" json:"ref,omitempty"`
	// Defines a total order of commits on the ref. Requires ref field.
	// Typically 1-based, monotonically increasing, contiguous integer
	// defined by a Gerrit plugin, goto.google.com/git-numberer.
	Position uint32 `protobuf:"varint,5,opt,name=position,proto3" json:"position,omitempty"`
	// contains filtered or unexported fields
}

A landed Git commit hosted on Gitiles.

func (*GitilesCommit) Descriptor deprecated 

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

Deprecated: Use GitilesCommit.ProtoReflect.Descriptor instead.

func (*GitilesCommit) GetHost 

func (x *GitilesCommit) GetHost() string

func (*GitilesCommit) GetId 

func (x *GitilesCommit) GetId() string

func (*GitilesCommit) GetPosition 

func (x *GitilesCommit) GetPosition() uint32

func (*GitilesCommit) GetProject 

func (x *GitilesCommit) GetProject() string

func (*GitilesCommit) GetRef 

func (x *GitilesCommit) GetRef() string

func (*GitilesCommit) ProtoMessage 

func (*GitilesCommit) ProtoMessage()

func (*GitilesCommit) ProtoReflect 

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

func (*GitilesCommit) Reset 

func (x *GitilesCommit) Reset()

func (*GitilesCommit) String 

func (x *GitilesCommit) String() string

type InstalledBrowser 

type InstalledBrowser struct {

	// e.g. "chrome" or "safari"
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// e.g. "104.0.5112.101" or "15.5"
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

Third-party browser builds, not necessarily Chrome. These are primarily intended for use by CBB, since it needs to compare Chrome to Safari, Edge etc. These obviously aren't built from source but we still need to describe what set of executable bits the benchmark exercised.

func (*InstalledBrowser) Descriptor deprecated 

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

Deprecated: Use InstalledBrowser.ProtoReflect.Descriptor instead.

func (*InstalledBrowser) GetName 

func (x *InstalledBrowser) GetName() string

func (*InstalledBrowser) GetVersion 

func (x *InstalledBrowser) GetVersion() string

func (*InstalledBrowser) ProtoMessage 

func (*InstalledBrowser) ProtoMessage()

func (*InstalledBrowser) ProtoReflect 

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

func (*InstalledBrowser) Reset 

func (x *InstalledBrowser) Reset()

func (*InstalledBrowser) String 

func (x *InstalledBrowser) String() string

type ReplicaDiagnostics 

type ReplicaDiagnostics struct {
	ReplicaNumber int32           `protobuf:"varint,1,opt,name=replica_number,json=replicaNumber,proto3" json:"replica_number,omitempty"`
	ControlTask   *SwarmingTaskId `protobuf:"bytes,2,opt,name=control_task,json=controlTask,proto3" json:"control_task,omitempty"`
	TreatmentTask *SwarmingTaskId `protobuf:"bytes,3,opt,name=treatment_task,json=treatmentTask,proto3" json:"treatment_task,omitempty"`
	Message       []string        `protobuf:"bytes,4,rep,name=message,proto3" json:"message,omitempty"`
	// contains filtered or unexported fields
}

ReplicaDiagnostics contains replica, or task pair-specific diagnostic messages generated by the Analyzer.

func (*ReplicaDiagnostics) Descriptor deprecated 

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

Deprecated: Use ReplicaDiagnostics.ProtoReflect.Descriptor instead.

func (*ReplicaDiagnostics) GetControlTask 

func (x *ReplicaDiagnostics) GetControlTask() *SwarmingTaskId

func (*ReplicaDiagnostics) GetMessage 

func (x *ReplicaDiagnostics) GetMessage() []string

func (*ReplicaDiagnostics) GetReplicaNumber 

func (x *ReplicaDiagnostics) GetReplicaNumber() int32

func (*ReplicaDiagnostics) GetTreatmentTask 

func (x *ReplicaDiagnostics) GetTreatmentTask() *SwarmingTaskId

func (*ReplicaDiagnostics) ProtoMessage 

func (*ReplicaDiagnostics) ProtoMessage()

func (*ReplicaDiagnostics) ProtoReflect 

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

func (*ReplicaDiagnostics) Reset 

func (x *ReplicaDiagnostics) Reset()

func (*ReplicaDiagnostics) String 

func (x *ReplicaDiagnostics) String() string

type RunSpec 

type RunSpec struct {

	// OS strings will contain both the OS name and any OS-specific version
	// details.
	Os string `protobuf:"bytes,1,opt,name=os,proto3" json:"os,omitempty"`
	// Synthetic product names come from Swarming, and uniquely identify specific
	// hardware device configurations.
	SyntheticProductName string `protobuf:"bytes,2,opt,name=synthetic_product_name,json=syntheticProductName,proto3" json:"synthetic_product_name,omitempty"`
	// Finch config (seed hash, change list, and timestamp).
	FinchConfig *FinchConfig `protobuf:"bytes,3,opt,name=finch_config,json=finchConfig,proto3" json:"finch_config,omitempty"`
	// contains filtered or unexported fields
}

RunSpec defines where and how to execute the executable bits from a BuildSpec. It should include enough information to schedule or locate a set of Swarming tasks for a given BuildSpec and AnalysisSpec.

func (*RunSpec) Descriptor deprecated 

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

Deprecated: Use RunSpec.ProtoReflect.Descriptor instead.

func (*RunSpec) GetFinchConfig 

func (x *RunSpec) GetFinchConfig() *FinchConfig

func (*RunSpec) GetOs 

func (x *RunSpec) GetOs() string

func (*RunSpec) GetSyntheticProductName 

func (x *RunSpec) GetSyntheticProductName() string

func (*RunSpec) ProtoMessage 

func (*RunSpec) ProtoMessage()

func (*RunSpec) ProtoReflect 

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

func (*RunSpec) Reset 

func (x *RunSpec) Reset()

func (*RunSpec) String 

func (x *RunSpec) String() string

type Statistic 

type Statistic struct {

	// The lower bound of the analysis result
	Lower float64 `protobuf:"fixed64,1,opt,name=lower,proto3" json:"lower,omitempty"`
	// The upper bound of the analysis result
	Upper float64 `protobuf:"fixed64,2,opt,name=upper,proto3" json:"upper,omitempty"`
	// The P value of the analysis result
	PValue float64 `protobuf:"fixed64,3,opt,name=p_value,json=pValue,proto3" json:"p_value,omitempty"`
	// The defined significance level to calculate the lower and upper bound
	SignificanceLevel float64 `protobuf:"fixed64,4,opt,name=significance_level,json=significanceLevel,proto3" json:"significance_level,omitempty"`
	// The point estimate of the analysis result
	PointEstimate float64 `protobuf:"fixed64,6,opt,name=point_estimate,json=pointEstimate,proto3" json:"point_estimate,omitempty"`
	// The median of control arm of the analysis result
	ControlMedian float64 `protobuf:"fixed64,7,opt,name=control_median,json=controlMedian,proto3" json:"control_median,omitempty"`
	// The median of treatment arm of the analysis result
	TreatmentMedian float64 `protobuf:"fixed64,8,opt,name=treatment_median,json=treatmentMedian,proto3" json:"treatment_median,omitempty"`
	// contains filtered or unexported fields
}

Statistic defines the statistic of an analysis

func (*Statistic) Descriptor deprecated 

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

Deprecated: Use Statistic.ProtoReflect.Descriptor instead.

func (*Statistic) GetControlMedian 

func (x *Statistic) GetControlMedian() float64

func (*Statistic) GetLower 

func (x *Statistic) GetLower() float64

func (*Statistic) GetPValue 

func (x *Statistic) GetPValue() float64

func (*Statistic) GetPointEstimate 

func (x *Statistic) GetPointEstimate() float64

func (*Statistic) GetSignificanceLevel 

func (x *Statistic) GetSignificanceLevel() float64

func (*Statistic) GetTreatmentMedian 

func (x *Statistic) GetTreatmentMedian() float64

func (*Statistic) GetUpper 

func (x *Statistic) GetUpper() float64

func (*Statistic) ProtoMessage 

func (*Statistic) ProtoMessage()

func (*Statistic) ProtoReflect 

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

func (*Statistic) Reset 

func (x *Statistic) Reset()

func (*Statistic) String 

func (x *Statistic) String() string

type SwarmingTaskDiagnostics 

type SwarmingTaskDiagnostics struct {
	Id      *SwarmingTaskId `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	Message []string        `protobuf:"bytes,2,rep,name=message,proto3" json:"message,omitempty"`
	// contains filtered or unexported fields
}

SwarmingTaskDiagnostics contains task-specific diagnostic messages generated by the Analyzer.

func (*SwarmingTaskDiagnostics) Descriptor deprecated 

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

Deprecated: Use SwarmingTaskDiagnostics.ProtoReflect.Descriptor instead.

func (*SwarmingTaskDiagnostics) GetId 

func (x *SwarmingTaskDiagnostics) GetId() *SwarmingTaskId

func (*SwarmingTaskDiagnostics) GetMessage 

func (x *SwarmingTaskDiagnostics) GetMessage() []string

func (*SwarmingTaskDiagnostics) ProtoMessage 

func (*SwarmingTaskDiagnostics) ProtoMessage()

func (*SwarmingTaskDiagnostics) ProtoReflect 

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

func (*SwarmingTaskDiagnostics) Reset 

func (x *SwarmingTaskDiagnostics) Reset()

func (*SwarmingTaskDiagnostics) String 

func (x *SwarmingTaskDiagnostics) String() string

type SwarmingTaskId 

type SwarmingTaskId struct {
	TaskId  string `protobuf:"bytes,1,opt,name=task_id,json=taskId,proto3" json:"task_id,omitempty"`
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// contains filtered or unexported fields
}

func (*SwarmingTaskId) Descriptor deprecated 

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

Deprecated: Use SwarmingTaskId.ProtoReflect.Descriptor instead.

func (*SwarmingTaskId) GetProject 

func (x *SwarmingTaskId) GetProject() string

func (*SwarmingTaskId) GetTaskId 

func (x *SwarmingTaskId) GetTaskId() string

func (*SwarmingTaskId) ProtoMessage 

func (*SwarmingTaskId) ProtoMessage()

func (*SwarmingTaskId) ProtoReflect 

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

func (*SwarmingTaskId) Reset 

func (x *SwarmingTaskId) Reset()

func (*SwarmingTaskId) String 

func (x *SwarmingTaskId) String() string

type UnimplementedAnalysisServer 

type UnimplementedAnalysisServer struct {
}

UnimplementedAnalysisServer must be embedded to have forward compatible implementations.

func (UnimplementedAnalysisServer) GetAnalysis 

func (UnimplementedAnalysisServer) GetAnalysis(context.Context, *GetAnalysisRequest) (*GetAnalysisResponse, error)

type UnsafeAnalysisServer 

type UnsafeAnalysisServer interface {
	// contains filtered or unexported methods
}

UnsafeAnalysisServer may be embedded to opt out of forward compatibility for this service. Use of this interface is not recommended, as added methods to AnalysisServer will result in compilation errors.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.