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

- 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