Google Cloud Query
CertifiedQuery Cloud Monitoring time series
Google Cloud Query
Query Cloud Monitoring time series
Fetches time series matching the rendered filter over the window lookback (default 5 minutes) using Cloud Monitoring. Returns the raw series list and the total count. Supports custom project, service account, and scopes.
type: io.kestra.plugin.gcp.monitoring.QueryExamples
Query CPU utilization over the last 5 minutes
id: gcp_monitoring_query
namespace: company.team
tasks:
- id: query
type: io.kestra.plugin.gcp.monitoring.Query
projectId: "my-project"
filter: metric.type="compute.googleapis.com/instance/cpu/utilization"
window: PT5M
Properties
filter *string
Filter expression
Cloud Monitoring filter string rendered before execution; required
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150impersonatedServiceAccount string
The GCP service account to impersonate
projectId string
The GCP project ID
scopes array
["https://www.googleapis.com/auth/cloud-platform"]The GCP scopes to be used
serviceAccount string
The GCP service account
window string
PT5MQuery window
Lookback duration for the time interval; defaults to 5 minutes
Outputs
count integer
Total number of time series fetched
Count of time series returned by the Cloud Monitoring query
series array
List of time series
Raw Cloud Monitoring time series in JSON form
