Update errorreporting proto (#160)

google/devtools/clouderrorreporting/v1beta1/error_stats_service.proto

@@ -56,8 +56,6 @@ message ListGroupStatsRequest {
   string project_name = 1;
 
   // [Optional] List all <code>ErrorGroupStats</code> with these IDs.
-  // If not specified, all error group stats with a non-zero error count
-  // for the given selection criteria are returned.
   repeated string group_id = 2;
 
   // [Optional] List only <code>ErrorGroupStats</code> which belong to a service
@@ -66,9 +64,10 @@ message ListGroupStatsRequest {
   ServiceContextFilter service_filter = 3;
 
   // [Required] List data for the given time range.
-  // The service is tuned for retrieving data up to (approximately) 'now'.
-  // Retrieving data for arbitrary time periods in the past can result in
-  // higher response times or in returning incomplete results.
+  // Only <code>ErrorGroupStats</code> with a non-zero count in the given time
+  // range are returned, unless the request contains an explicit group_id list.
+  // If a group_id list is given, also <code>ErrorGroupStats</code> with zero
+  // occurrences are returned.
   QueryTimeRange time_range = 5;
 
   // [Optional] The preferred duration for a single returned `TimedCount`.
@@ -108,18 +107,18 @@ message ListGroupStatsResponse {
   string next_page_token = 2;
 }
 
-// Data extracted for a specific group based on certain selection criteria,
+// Data extracted for a specific group based on certain filter criteria,
 // such as a given time period and/or service filter.
 message ErrorGroupStats {
-  // Group data that is independent of the selection criteria.
+  // Group data that is independent of the filter criteria.
   ErrorGroup group = 1;
 
   // Approximate total number of events in the given group that match
-  // the selection criteria.
+  // the filter criteria.
   int64 count = 2;
 
   // Approximate number of affected users in the given group that
-  // match the selection criteria.
+  // match the filter criteria.
   // Users are distinguished by data in the `ErrorContext` of the
   // individual error events, such as their login name or their remote
   // IP address in case of HTTP requests.
@@ -140,21 +139,23 @@ message ErrorGroupStats {
   // - Ordered by ascending time.
   repeated TimedCount timed_counts = 4;
 
-  // Approximate first occurrence that was seen for this group and
-  // which matches the given selection criteria.
+  // Approximate first occurrence that was ever seen for this group
+  // and which matches the given filter criteria, ignoring the
+  // time_range that was specified in the request.
   google.protobuf.Timestamp first_seen_time = 5;
 
-  // Approximate last occurrence that was seen for this group
-  // and which matches the given selection criteria.
+  // Approximate last occurrence that was ever seen for this group and
+  // which matches the given filter criteria, ignoring the time_range
+  // that was specified in the request.
   google.protobuf.Timestamp last_seen_time = 6;
 
-  // Service contexts with a non-zero error count for the given selection
+  // Service contexts with a non-zero error count for the given filter
   // criteria. This list can be truncated if multiple services are affected.
   // Refer to `num_affected_services` for the total count.
   repeated ServiceContext affected_services = 7;
 
   // The total number of services with a non-zero error count for the given
-  // selection criteria.
+  // filter criteria.
   int32 num_affected_services = 8;
 
   // An arbitrary event that is chosen as representative for the whole group.
@@ -196,10 +197,6 @@ message ListEventsRequest {
   ServiceContextFilter service_filter = 3;
 
   // [Optional] List only data for the given time range.
-  // The service is tuned for retrieving data up to (approximately) 'now'.
-  // Retrieving data for arbitrary time periods in the past can result in
-  // higher response times or in returning incomplete results.
-  // Data for the last hour until now is returned if not specified.
   QueryTimeRange time_range = 4;
 
   // [Optional] The maximum number of results to return per response.