package testgrid.state

Get desktop application:
View/edit binary Protocol Buffers messages

Info on a failing test row about the failure.

Used in: api.v1.ListRowsResponse.Row, Row

• int32 fail_count = 1

  Number of results that have failed.

• string fail_build_id = 2

  The build ID the test first failed at.

• optional google.protobuf.Timestamp fail_time = 3

  The time the test first failed at.

• string fail_test_id = 4

  The test ID for the first test failure.

• string pass_build_id = 5

  The build ID the test last passed at.

• optional google.protobuf.Timestamp pass_time = 6

  The time the test last passed at.

• string failure_message = 7

  A snippet explaining the failure.

• string build_link = 8

  Link to search for build changes, internally a code-search link.

• string build_link_text = 9

  Text for option to search for build changes.

• string build_url_text = 10

  Text to display for link to search for build changes.

• string latest_fail_build_id = 11

  The build ID for the latest test failure. (Does not indicate the failure is 'over', just the latest test failure we found.)

• string latest_fail_test_id = 14

  The test ID for the latest test failure.

• map<string, string> properties = 12

  Maps (property name):(property value) for arbitrary alert properties.

• repeated string hotlist_ids = 13

  A list of IDs for issue hotlists related to this failure.

• repeated string email_addresses = 15

  Dynamic email list, route email alerts to these instead of the configured defaults.

• map<string, string> custom_column_headers = 16

  Maps (custom column headers name):(custom column headers value) for arbitrary alert properties.

A cluster of failures grouped by test status and message for a test results table.

Used in: Grid

• int32 test_status = 1

  Test status cluster grouped by.

• string message = 2

  Error message or testFailureClassification string cluster grouped by.

• repeated ClusterRow cluster_row = 3

  ClusterRows that belong to this cluster.

Cells in a TestRow that belong to a specific Cluster.

Used in: Cluster

• string display_name = 1

  Name of TestRow.

• repeated int32 index = 2

  Index within row that belongs to Cluster (refer to columns of the row).

TestGrid column headers. Does not contain the individual cells.

Used in: Grid

• string build = 1

  Unique instance of the job, typically BUILD_NUMBER from prow or a guid

• string name = 2

  Name associated with the column (such as the run/invocation ID).No two columns should have the same build_id and name. The name field allows the display of multiple columns with the same build_id.

• double started = 3

  Milliseconds since start of epoch (python time.time() * 1000) TODO(#683): Use a timestamp, not this double

• repeated string extra = 4

  Additional custom headers like commit, image used, etc.

• string hotlist_ids = 5

  Custom hotlist ids.

• string hint = 6

  An optional hint for the updater.

• repeated string email_addresses = 7

  Dynamic email list, route email alerts to these instead of the configured defaults.

• optional Stats stats = 8

  Status totals for the column. Only written in tab state, if a broken threshold is defined for columns.

A single table of test results backing a dashboard tab.

• repeated Column columns = 1

  A cycle of test results, not including the results. In the TestGrid client, the cycles define the columns.

• repeated Row rows = 2

  A test case with test results. In the TestGrid client, the cases define the rows (and the results define the individual cells).

• optional config.TestGroup config = 4

  The latest configuration used to generate this test group.

• double last_time_updated = 6

  Seconds since epoch for last time this cycle was updated.

• repeated UpdateInfo update_info = 8

  Stored info on previous timing for parts of the update cycle.

• repeated TestMetadata test_metadata = 9

  Stored info on default test metadata.

• repeated Cluster cluster = 10

  Clusters of failures for a TestResultTable instance.

• double most_recent_cluster_timestamp = 11

  Most recent timestamp that clusters have processed.

A metric and its values for each test cycle.

Used in: Row

• string name = 1

  Name of metric, such as duration

• repeated int32 indices = 2

  Sparse encoding of values. Indices is a list of pairs of <index, count> that details columns with metric values. So given: Indices: [0, 2, 6, 4] Values: [0.1,0.2,6.1,6.2,6.3,6.4] Decoded 12-value equivalent is: [0.1, 0.2, nil, nil, nil, nil, 6.1, 6.2, 6.3, 6.4, nil, nil, ...]

  n=index of first value, n+1=count of filled values

• repeated double values = 3

  only present for columns with a metric value

Used in: Row

• map<string, string> property = 1

TestGrid rows

Used in: Grid

• string name = 1

  Display name, which might process id to append/filter info.

• string id = 2

  raw id for the row, such as the bazel target or golang package.

• repeated int32 results = 3

  Results for this row, run-length encoded to reduce size/improve performance. Thus (encoded -> decoded equivalent): [0, 3, 5, 4] -> [0, 0, 0, 5, 5, 5, 5] [5, 1] -> [5] [1, 5] -> [1, 1, 1, 1, 1] The decoded values are Result enums

• repeated string cell_ids = 4

  Test IDs for each test result in this test case. Must be present on every column, regardless of status.

• repeated string messages = 5

  Short description of the result, displayed on mouseover. Present for any column with a non-empty status (not NO_RESULT).

• repeated string metric = 7

  Names of metrics associated with this test case. Stored separate from metric info (which may be omitted).

• repeated Metric metrics = 8

  Numerical performance/timing data, etc.

• repeated string icons = 9

  Short string to place inside the cell (F for fail, etc) Present for any column with a non-empty status (not NO_RESULT).

• repeated string issues = 10

  IDs for issues associated with this row.

• optional AlertInfo alert_info = 11

  An alert for the failure if there's a recent failure for this row.

• repeated string user_property = 12

  Values of a user-defined property found in cells for this row. TODO: Fold this into `properties` field.

• repeated Property properties = 13

  General key-value pairs associated with cells in this row. Present for any column with a non-empty status (not NO_RESULT).

Used in: Column

• int32 fail_count = 1

• int32 pass_count = 2

• int32 total_count = 3

• bool pending = 4

  True if this column has any in-progress runs.

• bool broken = 5

  True if a broken threshold is defined, and this column's fail/total ratio exceeds it.

Info on default test metadata for a dashboard tab.

Used in: Grid

• string test_name = 1

  Name of the test with associated test metadata.

• int32 bug_component = 2

  Default bug component.

• string owner = 3

  Default owner.

• repeated string cc = 4

  Default list of cc's.

• string error_type = 5

  When present, only file a bug for failed tests with same error type. Otherwise, always file a bug.

Info on time taken to update test results during the last update cycle.

Used in: Grid

• repeated UpdatePhaseData update_phase_data = 1

  Metrics for how long parts of the update cycle take.

Used in: UpdateInfo

• string phase_name = 1

  The name for a part of the update cycle.

• double phase_seconds = 2

  Time taken for a part of the update cycle, in seconds.