Method: projects.collectdTimeSeries.create

Stackdriver Monitoring Agent only: Creates a new time series.

HTTP request

POST https://monitoring.googleapis.com/v3/{name}/collectdTimeSeries

Path parameters

Parameters
name

string

The project in which to create the time series. The format is "projects/PROJECT_ID_OR_NUMBER".

Request body

The request body contains data with the following structure:

JSON representation
{
  "resource": {
    object(MonitoredResource)
  },
  "collectdVersion": string,
  "collectdPayloads": [
    {
      object(CollectdPayload)
    }
  ],
}
Fields
resource

object(MonitoredResource)

The monitored resource associated with the time series.

collectdVersion

string

The version of collectd that collected the data. Example: "5.3.0-192.el6".

collectdPayloads[]

object(CollectdPayload)

The collectd payloads representing the time series data. You must not include more than a single point for each time series, so no two payloads can have the same values for all of the fields plugin, pluginInstance, type, and typeInstance.

Response body

If successful, the response body will be empty.

Authorization

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.write

For more information, see the Auth Guide.

CollectdPayload

A collection of data points sent from a collectd-based plugin. See the collectd documentation for more information.

JSON representation
{
  "values": [
    {
      object(CollectdValue)
    }
  ],
  "startTime": string,
  "endTime": string,
  "plugin": string,
  "pluginInstance": string,
  "type": string,
  "typeInstance": string,
  "metadata": {
    string: {
      object(TypedValue)
    },
    ...
  },
}
Fields
values[]

object(CollectdValue)

The measured values during this time interval. Each value must have a different dataSourceName.

startTime

string (Timestamp format)

The start time of the interval.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

The end time of the interval.

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

plugin

string

The name of the plugin. Example: "disk".

pluginInstance

string

The instance name of the plugin Example: "hdcl".

type

string

The measurement type. Example: "memory".

typeInstance

string

The measurement type instance. Example: "used".

metadata

map (key: string, value: object(TypedValue))

The measurement metadata. Example: "process_id" -> 12345

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CollectdValue

A single data point from a collectd-based plugin.

JSON representation
{
  "dataSourceName": string,
  "dataSourceType": enum(DataSourceType),
  "value": {
    object(TypedValue)
  },
}
Fields
dataSourceName

string

The data source for the collectd value. For example there are two data sources for network measurements: "rx" and "tx".

dataSourceType

enum(DataSourceType)

The type of measurement.

value

object(TypedValue)

The measurement value.

DataSourceType

The type of measurement for the data source.

Enums
UNSPECIFIED_DATA_SOURCE_TYPE An unspecified data source type. This corresponds to google.api.MetricDescriptor.MetricKind.METRIC_KIND_UNSPECIFIED.
GAUGE An instantaneous measurement of a varying quantity. This corresponds to google.api.MetricDescriptor.MetricKind.GAUGE.
COUNTER A cumulative value over time. This corresponds to google.api.MetricDescriptor.MetricKind.CUMULATIVE.
DERIVE A rate of change of the measurement.
ABSOLUTE An amount of change since the last measurement interval. This corresponds to google.api.MetricDescriptor.MetricKind.DELTA.

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Stackdriver Monitoring