A collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series.
The associated monitored resource. Custom metrics can use only certain monitored resource types in their time series data. For more information, see Monitored resources for custom metrics.
Output only. The associated monitored resource metadata. When reading a time series, this field will include metadata labels that are explicitly named in the reduction. When creating a time series, this field is ignored.
The metric kind of the time series. When listing time series, this metric kind might be different from the metric kind of the associated metric if this time series is an alignment or reduction of other time series.
When creating a time series, this field is optional. If present, it must be the same as the metric kind of the associated metric. If the associated metric's descriptor must be auto-created, then this field specifies the metric kind of the new descriptor and must be either GAUGE (the default) or CUMULATIVE.
The value type of the time series. When listing time series, this value type might be different from the value type of the associated metric if this time series is an alignment or reduction of other time series.
When creating a time series, this field is optional. If present, it must be the same as the type of the data in the points field.
The data points of this time series. When listing time series, points are returned in reverse time order.
When creating a time series, this field must contain exactly one point and the point's type must be the same as the value type of the associated metric. If the associated metric's descriptor must be auto-created, then the value type of the descriptor is determined by the point's type, which must be BOOL, INT64, DOUBLE, or DISTRIBUTION.
unit
string
The units in which the metric value is reported. It is only applicable if the valueType is INT64, DOUBLE, or DISTRIBUTION. The unit defines the representation of the stored metric values. This field can only be changed through CreateTimeSeries when it is empty.
description
string
Input only. A detailed description of the time series that will be associated with the google.api.MetricDescriptor for the metric. Once set, this field cannot be changed through CreateTimeSeries.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eTime series data represents the time-varying values of a metric, identified by a specific monitored resource and metric combination.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a time series includes fields for \u003ccode\u003emetric\u003c/code\u003e, \u003ccode\u003eresource\u003c/code\u003e, \u003ccode\u003emetadata\u003c/code\u003e, \u003ccode\u003emetricKind\u003c/code\u003e, \u003ccode\u003evalueType\u003c/code\u003e, \u003ccode\u003epoints\u003c/code\u003e, \u003ccode\u003eunit\u003c/code\u003e, and \u003ccode\u003edescription\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach time series includes data \u003ccode\u003epoints\u003c/code\u003e, which are the time-ordered data values that make up the series, and when creating a time series this must be exactly one point.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003emetricKind\u003c/code\u003e and \u003ccode\u003evalueType\u003c/code\u003e can differ from the associated metric's properties when a time series is an alignment or reduction of other time series.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eunit\u003c/code\u003e field describes the unit in which the metric's value is presented, while the \u003ccode\u003edescription\u003c/code\u003e field offers a detailed description of the time series.\u003c/p\u003e\n"]]],[],null,["# TimeSeries\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nA collection of data points that describes the time-varying values of a metric. A time series is identified by a combination of a fully-specified monitored resource and a fully-specified metric. This type is used for both listing and creating time series."]]