gcp.service
GCP Service Usage Management
By default only enabled services are listed. To check specific
services regardless of their state, pass their names with query.
They are fetched directly, so disabled services are included.
- example:
Find projects where the Cloud Asset API is disabled
policies:
- name: gcp-cloud-asset-api-disabled
resource: gcp.service
query:
- names:
- cloudasset.googleapis.com
filters:
- state: DISABLED
https://cloud.google.com/service-usage/docs/reference/rest https://cloud.google.com/service-infrastructure/docs/service-management/reference/rest/v1/services
Filters
metrics
Supports metrics filters on resources.
All resources that have cloud watch metrics are supported.
Docs on cloud watch metrics
Google Supported Metrics https://cloud.google.com/monitoring/api/metrics_gcp
Custom Metrics https://cloud.google.com/monitoring/api/v3/metric-model#intro-custom-metrics
- name: firewall-hit-count
resource: gcp.firewall
filters:
- type: metrics
name: firewallinsights.googleapis.com/subnet/firewall_hit_count
aligner: ALIGN_COUNT
days: 14
value: 1
op: greater-than
The period-start key allows you to align the metric window in two ways.
By default, using auto, the window is computed relative to the current time.
Alternatively, setting it to start-of-day aligns the window to full UTC calendar days,
beginning at 00:00:00 UTC and ending at current day 00:00:00 UTC.
- name: instance-low-cpu-last-full-day
resource: gcp.instance
filters:
- type: metrics
name: compute.googleapis.com/instance/cpu/utilization
aligner: ALIGN_MEAN
days: 1
value: 0.05
op: less-than
period-start: start-of-day
Cloud Monitoring returns a DISTRIBUTION-typed metric as a histogram rather
than a number. The distribution key chooses how to reduce one to a scalar:
count, mean, or sum (the default), reconstructed as count * mean
since a histogram carries no total. Scalar metrics ignore the key. Either way
the filter compares the most recent point in the window, so a metric left on
the default ALIGN_NONE is read on its latest sample, not its total.
- name: tuned-model-chatty-responses
resource: gcp.vertex-ai-endpoint
filters:
- type: metrics
name: aiplatform.googleapis.com/tuned_model/online_serving/tokens
aligner: ALIGN_SUM
reducer: REDUCE_SUM
group-by-fields: ["resource.labels.endpoint_id"]
distribution: mean
days: 1
value: 100
op: greater-than
properties:
aligner:
enum:
- ALIGN_NONE
- ALIGN_DELTA
- ALIGN_RATE
- ALIGN_INTERPOLATE
- ALIGN_MIN
- ALIGN_MAX
- ALIGN_MEAN
- ALIGN_COUNT
- ALIGN_SUM
- REDUCE_COUNT_FALSE
- ALIGN_STDDEV
- ALIGN_COUNT_TRUE
- ALIGN_COUNT_FALSE
- ALIGN_FRACTION_TRUE
- ALIGN_PERCENTILE_99
- ALIGN_PERCENTILE_95
- ALIGN_PERCENTILE_50
- ALIGN_PERCENTILE_05
- ALIGN_PERCENT_CHANG
type: string
days:
type: number
distribution:
enum:
- count
- mean
- sum
type: string
filter:
type: string
group-by-fields:
items:
type: string
type: array
metric-key:
type: string
missing-value:
type: number
name:
type: string
op:
enum:
- eq
- equal
- ne
- not-equal
- gt
- greater-than
- ge
- gte
- le
- lte
- lt
- less-than
- glob
- regex
- regex-case
- in
- ni
- not-in
- contains
- difference
- intersect
- mod
type: string
period-start:
enum:
- auto
- start-of-day
type: string
reducer:
enum:
- REDUCE_NONE
- REDUCE_MEAN
- REDUCE_MIN
- REDUCE_MAX
- REDUCE_MEAN
- REDUCE_SUM
- REDUCE_STDDEV
- REDUCE_COUNT
- REDUCE_COUNT_TRUE
- REDUCE_COUNT_FALSE
- REDUCE_FRACTION_TRUE
- REDUCE_PERCENTILE_99
- REDUCE_PERCENTILE_95
- REDUCE_PERCENTILE_50
- REDUCE_PERCENTILE_05
type: string
type:
enum:
- metrics
value:
type: number
required:
- value
- name
- op
Permissions - monitoring.timeSeries.list
Actions
disable
Disable a service for the current project
Example:
policies:
- name: disable-disallowed-services
resource: gcp.service
mode:
type: gcp-audit
methods:
- google.api.servicemanagement.v1.ServiceManagerV1.ActivateServices
filters:
- config.name: translate.googleapis.com
actions:
- disable
properties:
dependents:
default: false
type: boolean
type:
enum:
- disable
usage:
enum:
- SKIP
- CHECK
required:
- type
Permissions - serviceusage.services.disable
enable
Enable a service for the current project
Example:
policies:
- name: enable-cloud-asset-api
resource: gcp.service
query:
- names:
- cloudasset.googleapis.com
filters:
- state: DISABLED
actions:
- enable
properties:
type:
enum:
- enable
required:
- type
Permissions - serviceusage.services.enable