- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization Scopes
- TimeSeriesView
- Try it!
Lists time series that match a filter. This method does not require a Stackdriver account.
HTTP request
GET https://monitoring.googleapis.com/v3/{name}/timeSeries
Path parameters
Parameters | |
---|---|
name |
The project on which to execute the request. The format is "projects/{project_id_or_number}". |
Query parameters
Parameters | |
---|---|
filter |
A monitoring filter that specifies which time series should be returned. The filter must specify a single metric type, and can additionally specify metric labels and other information. For example:
|
interval |
The time interval for which results should be returned. Only time series that contain data points in the specified interval are included in the response. |
aggregation |
Specifies the alignment of data points in individual time series as well as how to combine the retrieved time series across specified labels. By default (if no |
orderBy |
Unsupported: must be left blank. The points in each time series are currently returned in reverse time order (most recent to oldest). |
view |
Specifies which information is returned about the time series. |
pageSize |
A positive number that is the maximum number of results to return. If |
pageToken |
If this field is not empty then it must contain the |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
The timeSeries.list
response.
JSON representation | |
---|---|
{ "timeSeries": [ { object ( |
Fields | |
---|---|
timeSeries[] |
One or more time series that match the filter included in the request. |
nextPageToken |
If there are more results than have been returned, then this field is set to a non-empty value. To see the additional results, use that value as |
executionErrors[] |
Query execution errors that may have caused the time series data returned to be incomplete. |
Authorization Scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/monitoring
https://www.googleapis.com/auth/monitoring.read
For more information, see the Authentication Overview.
TimeSeriesView
Controls which fields are returned by timeSeries.list
.
Enums | |
---|---|
FULL |
Returns the identity of the metric(s), the time series, and the time series data. |
HEADERS |
Returns the identity of the metric and the time series resource, but not the time series data. |