feat: Sync public protos with latests public api state. This adds support for collapsible groups, filters, labels, drilldowns, logs panels and tables (#257)

gcf-owl-bot[bot] · web-flow · commit 45747a861682 · 2022-04-08T10:21:35.000-07:00
* feat: Sync public protos with latests public api state. This adds support for collapsible groups, filters, labels, drilldowns, logs panels and tables PiperOrigin-RevId: 440139643 Source-Link: googleapis/googleapis@2bff0f3 Source-Link: googleapis/googleapis-gen@8c92aa7 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOGM5MmFhNzc0NjZhMWZlNTAxNmUyNWQ4MDZkZDRlYjQ1YjYyZTVhMiJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/alertchart.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/alertchart.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/collapsible_group.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/collapsible_group.proto
@@ -0,0 +1,32 @@
+// Copyright 2022 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+option csharp_namespace = "Google.Cloud.Monitoring.Dashboard.V1";
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option java_multiple_files = true;
+option java_outer_classname = "CollapsibleGroupProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+option php_namespace = "Google\\Cloud\\Monitoring\\Dashboard\\V1";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+
+// A widget that groups the other widgets. All widgets that are within
+// the area spanned by the grouping widget are considered member widgets.
+message CollapsibleGroup {
+  // The collapsed state of the widget on first page load.
+  bool collapsed = 1;
+}
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/common.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/dashboard.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/dashboard.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,7 @@ package google.monitoring.dashboard.v1;
 
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/monitoring/dashboard/v1/dashboard_filter.proto";
 import "google/monitoring/dashboard/v1/layouts.proto";
 
 option csharp_namespace = "Google.Cloud.Monitoring.Dashboard.V1";
@@ -69,4 +70,10 @@ message Dashboard {
     // arranged vertically.
     ColumnLayout column_layout = 9;
   }
+
+  // Filters to reduce the amount of data charted based on the filter criteria.
+  repeated DashboardFilter dashboard_filters = 11;
+
+  // Labels applied to the dashboard
+  map<string, string> labels = 12;
 }
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/dashboard_filter.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/dashboard_filter.proto
@@ -0,0 +1,68 @@
+// Copyright 2022 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/api/field_behavior.proto";
+
+option csharp_namespace = "Google.Cloud.Monitoring.Dashboard.V1";
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option java_multiple_files = true;
+option java_outer_classname = "DashboardFilterProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+option php_namespace = "Google\\Cloud\\Monitoring\\Dashboard\\V1";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+
+// A filter to reduce the amount of data charted in relevant widgets.
+message DashboardFilter {
+  // The type for the dashboard filter
+  enum FilterType {
+    // Filter type is unspecified. This is not valid in a well-formed request.
+    FILTER_TYPE_UNSPECIFIED = 0;
+
+    // Filter on a resource label value
+    RESOURCE_LABEL = 1;
+
+    // Filter on a metrics label value
+    METRIC_LABEL = 2;
+
+    // Filter on a user metadata label value
+    USER_METADATA_LABEL = 3;
+
+    // Filter on a system metadata label value
+    SYSTEM_METADATA_LABEL = 4;
+
+    // Filter on a group id
+    GROUP = 5;
+  }
+
+  // Required. The key for the label
+  string label_key = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The placeholder text that can be referenced in a filter string or MQL
+  // query. If omitted, the dashboard filter will be applied to all relevant
+  // widgets in the dashboard.
+  string template_variable = 3;
+
+  // The default value used in the filter comparison
+  oneof default_value {
+    // A variable-length string value.
+    string string_value = 4;
+  }
+
+  // The specified filter type
+  FilterType filter_type = 5;
+}
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/dashboards_service.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/dashboards_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,11 +17,11 @@ syntax = "proto3";
 package google.monitoring.dashboard.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/monitoring/dashboard/v1/dashboard.proto";
 import "google/protobuf/empty.proto";
-import "google/api/client.proto";
 
 option csharp_namespace = "Google.Cloud.Monitoring.Dashboard.V1";
 option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/drilldowns.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/drilldowns.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/layouts.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/layouts.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/logs_panel.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/logs_panel.proto
@@ -0,0 +1,38 @@
+// Copyright 2022 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+option csharp_namespace = "Google.Cloud.Monitoring.Dashboard.V1";
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option java_multiple_files = true;
+option java_outer_classname = "LogsPanelProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+option php_namespace = "Google\\Cloud\\Monitoring\\Dashboard\\V1";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+
+// A widget that displays a stream of log.
+message LogsPanel {
+  // A filter that chooses which log entries to return.  See [Advanced Logs
+  // Queries](https://cloud.google.com/logging/docs/view/advanced-queries).
+  // Only log entries that match the filter are returned.  An empty filter
+  // matches all log entries.
+  string filter = 1;
+
+  // The names of logging resources to collect logs for. Currently only projects
+  // are supported. If empty, the widget will default to the host project.
+  repeated string resource_names = 2;
+}
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/metrics.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/metrics.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -148,6 +148,18 @@ message Threshold {
     BELOW = 2;
   }
 
+  // An axis identifier.
+  enum TargetAxis {
+    // The target axis was not specified. Defaults to Y1.
+    TARGET_AXIS_UNSPECIFIED = 0;
+
+    // The y_axis (the right axis of chart).
+    Y1 = 1;
+
+    // The y2_axis (the left axis of chart).
+    Y2 = 2;
+  }
+
   // A label for the threshold.
   string label = 1;
 
@@ -161,6 +173,10 @@ message Threshold {
   // The direction for the current threshold. Direction is not allowed in a
   // XyChart.
   Direction direction = 4;
+
+  // The target axis to use for plotting the threshold. Target axis is not
+  // allowed in a Scorecard.
+  TargetAxis target_axis = 5;
 }
 
 // Defines the possible types of spark chart supported by the `Scorecard`.
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/scorecard.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/scorecard.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/service.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/service.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/table.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/table.proto
@@ -0,0 +1,59 @@
+// Copyright 2022 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/api/field_behavior.proto";
+import "google/monitoring/dashboard/v1/metrics.proto";
+import "google/monitoring/dashboard/v1/table_display_options.proto";
+import "google/protobuf/duration.proto";
+
+option csharp_namespace = "Google.Cloud.Monitoring.Dashboard.V1";
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option java_multiple_files = true;
+option java_outer_classname = "TableProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+option php_namespace = "Google\\Cloud\\Monitoring\\Dashboard\\V1";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+
+// A table that displays time series data.
+message TimeSeriesTable {
+  // Groups a time series query definition with table options.
+  message TableDataSet {
+    // Required. Fields for querying time series data from the
+    // Stackdriver metrics API.
+    TimeSeriesQuery time_series_query = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Optional. A template string for naming `TimeSeries` in the resulting data set.
+    // This should be a string with interpolations of the form `${label_name}`,
+    // which will resolve to the label's value i.e.
+    // "${resource.labels.project_id}."
+    string table_template = 2 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The lower bound on data point frequency for this data set, implemented by
+    // specifying the minimum alignment period to use in a time series query
+    // For example, if the data is published once every 10 minutes, the
+    // `min_alignment_period` should be at least 10 minutes. It would not
+    // make sense to fetch and align data at one minute intervals.
+    google.protobuf.Duration min_alignment_period = 3 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Table display options for configuring how the table is rendered.
+    TableDisplayOptions table_display_options = 4 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Required. The data displayed in this table.
+  repeated TableDataSet data_sets = 1 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/table_display_options.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/table_display_options.proto
@@ -0,0 +1,34 @@
+// Copyright 2022 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/api/field_behavior.proto";
+
+option csharp_namespace = "Google.Cloud.Monitoring.Dashboard.V1";
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option java_multiple_files = true;
+option java_outer_classname = "TableDisplayOptionsProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+option php_namespace = "Google\\Cloud\\Monitoring\\Dashboard\\V1";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+
+// Table display options that can be reused.
+message TableDisplayOptions {
+  // Optional. Columns to display in the table. Leave empty to display all available
+  // columns. Note: This field is for future features and is not currently used.
+  repeated string shown_columns = 1 [(google.api.field_behavior) = OPTIONAL];
+}
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/text.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/text.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/widget.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/widget.proto
@@ -1,4 +1,4 @@
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,7 +18,10 @@ package google.monitoring.dashboard.v1;
 
 import "google/api/field_behavior.proto";
 import "google/monitoring/dashboard/v1/alertchart.proto";
+import "google/monitoring/dashboard/v1/collapsible_group.proto";
+import "google/monitoring/dashboard/v1/logs_panel.proto";
 import "google/monitoring/dashboard/v1/scorecard.proto";
+import "google/monitoring/dashboard/v1/table.proto";
 import "google/monitoring/dashboard/v1/text.proto";
 import "google/monitoring/dashboard/v1/xychart.proto";
 import "google/protobuf/empty.proto";
@@ -53,5 +56,15 @@ message Widget {
 
     // A chart of alert policy data.
     AlertChart alert_chart = 7;
+
+    // A widget that displays time series data in a tabular format.
+    TimeSeriesTable time_series_table = 8;
+
+    // A widget that groups the other widgets. All widgets that are within
+    // the area spanned by the grouping widget are considered member widgets.
+    CollapsibleGroup collapsible_group = 9;
+
+    // A widget that shows a stream of logs.
+    LogsPanel logs_panel = 10;
   }
 }
diff --git a/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/xychart.proto b/packages/google-monitoring-dashboard/protos/google/monitoring/dashboard/v1/xychart.proto
diff --git a/packages/google-monitoring-dashboard/protos/protos.d.ts b/packages/google-monitoring-dashboard/protos/protos.d.ts
diff --git a/packages/google-monitoring-dashboard/protos/protos.js b/packages/google-monitoring-dashboard/protos/protos.js
diff --git a/packages/google-monitoring-dashboard/protos/protos.json b/packages/google-monitoring-dashboard/protos/protos.json
diff --git a/packages/google-monitoring-dashboard/src/v1/dashboards_service_proto_list.json b/packages/google-monitoring-dashboard/src/v1/dashboards_service_proto_list.json

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Copyright 2021 Google LLC`
	`1`	`+// Copyright 2022 Google LLC`
`2`	`2`	`//`
`3`	`3`	`// Licensed under the Apache License, Version 2.0 (the "License");`
`4`	`4`	`// you may not use this file except in compliance with the License.`