# Cloud monitoring list time series request

> Cloud monitoring list time series request is an open-source agent skill for cloud and infrastructure. Builds valid Cloud Monitoring ListTimeSeries requests, filters and aggregations. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/google/skills/tree/main/skills/cloud/cloud-monitoring-list-time-series-request
- **Repository:** https://github.com/google/skills
- **GitHub stars:** 24,379
- **License:** Apache-2.0
- **Skill name:** cloud-monitoring-list-time-series-request
- **Collection:** https://github.com/google/skills
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

This skill helps an agent turn a Cloud Monitoring metric descriptor and a set of resource parameters into a ready-to-run ListTimeSeries REST query. It covers the name, filter, interval, aggregation and view parameters, and it works through the metric's kind and value type to pick a suitable per-series aligner and cross-series reducer.

The workflow reuses metric metadata already supplied by the user, looks up missing descriptors through a metric-selection companion skill or the list_metric_descriptors tool, and builds filters with the correct resource.labels and metric.labels prefixes. It sets the alignment period from the lookback window and defaults to a one-hour interval when none is given. Before returning output, the agent is told to check the request against the list_timeseries tool using the HEADERS view.

The skill expects a GCP project ID, either given directly or resolvable from the local gcloud configuration, and access to Cloud Monitoring tools or the REST API. It includes a usage attribution step for gcloud commands and bundles reference files on aggregation combinations.

## When your agent uses it

> Generates valid Cloud Monitoring ListTimeSeries requests and aggregation specifications from metric descriptors and resource parameters. Use when asked to create, generate, format, or build ListTimeSeries requests, JSON payloads, filter expressions, or aligner/reducer aggregations for Cloud Monitoring metrics and charts. Don't use for metric discovery or metric selection.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Instructions only, no scripts](https://github.com/google/skills/tree/HEAD/skills/cloud/cloud-monitoring-list-time-series-request)
- [License: Apache-2.0](https://github.com/google/skills/tree/HEAD/skills/cloud/cloud-monitoring-list-time-series-request)

## Features

- **Filter expression construction:** Builds Cloud Monitoring filters with the correct metric type, resource type and label prefixes.
- **Aligner and reducer selection:** Chooses per-series aligners and cross-series reducers based on metric kind and value type.
- **Automatic alignment period:** Derives the alignment period from the start and end times of the query window.
- **Metric descriptor lookup:** Fills in missing metric type, kind and value type details from descriptors or a companion skill.
- **Request validation step:** Checks generated parameters against the list_timeseries tool before returning them.

## Good for

- Generate a ListTimeSeries request for VM CPU utilization over the last hour
- Build a filter for a Cloud SQL database metric scoped to one instance
- Create an aggregation that groups disk usage by zone
- Format a JSON payload for a Cloud Monitoring chart query

## Install

### Claude Code

Copy the skill folder to `~/.claude/skills/cloud-monitoring-list-time-series-request` to use it in all your projects:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/cloud-monitoring-list-time-series-request &&
cp -R "$tmp/skills/cloud/cloud-monitoring-list-time-series-request" ~/.claude/skills/cloud-monitoring-list-time-series-request &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/cloud-monitoring-list-time-series-request` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/cloud-monitoring-list-time-series-request` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/cloud-monitoring-list-time-series-request &&
cp -R "$tmp/skills/cloud/cloud-monitoring-list-time-series-request" ~/.agents/skills/cloud-monitoring-list-time-series-request &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/cloud-monitoring-list-time-series-request` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/cloud-monitoring-list-time-series-request` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/cloud-monitoring-list-time-series-request &&
cp -R "$tmp/skills/cloud/cloud-monitoring-list-time-series-request" ~/.cursor/skills/cloud-monitoring-list-time-series-request &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/cloud-monitoring-list-time-series-request` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/google/skills.git --path skills/cloud/cloud-monitoring-list-time-series-request
```

Or copy the folder to `~/.gemini/skills/cloud-monitoring-list-time-series-request` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/cloud-monitoring-list-time-series-request`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/cloud-monitoring-list-time-series-request &&
cp -R "$tmp/skills/cloud/cloud-monitoring-list-time-series-request" ~/.copilot/skills/cloud-monitoring-list-time-series-request &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/cloud-monitoring-list-time-series-request` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/google/skills.git
```

Then copy `skills/skills/cloud/cloud-monitoring-list-time-series-request` into your agent's skills folder as `cloud-monitoring-list-time-series-request`. Agents that support SKILL.md read one folder per skill.

## FAQ

### Does it need a Google Cloud project ID?

Yes. The skill requires a project ID from the prompt, input or environment, and asks the user for one when it cannot be resolved.

### What happens if no time range is given?

It computes a one-hour lookback ending at the current time and uses a 60s alignment period for that window.

### Does it discover which metric to use?

No. Metric discovery and selection are excluded; for vague requests it defers to the cloud-monitoring-metric-selection skill.

### Does it run queries against Cloud Monitoring?

It calls the list_timeseries tool with the HEADERS view to validate the generated request structure.

### How do I install Cloud monitoring list time series request in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/cloud-monitoring-list-time-series-request to use it in all your projects, or to .claude/skills/cloud-monitoring-list-time-series-request in one project.

### Does Cloud monitoring list time series request run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Cloud monitoring list time series request?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to Cloud monitoring list time series request?

The closest alternatives to Cloud monitoring list time series request are AWS cloudwatch investigation, AWS resource health diagnose, Cloud monitoring metric selection, Cloud monitoring promql query and Cloud monitoring alert configuration.

## Where this comes from

- Description: from the skill's own SKILL.md.

## Alternatives

- [AWS cloudwatch investigation](https://ai-powered.com/skills/aws-cloudwatch-investigation): AWS cloudwatch investigation is an open-source agent skill for cloud and infrastructure.
- [AWS resource health diagnose](https://ai-powered.com/skills/aws-resource-health-diagnose): AWS resource health diagnose is an open-source agent skill for cloud and infrastructure.
- [Cloud monitoring metric selection](https://ai-powered.com/skills/cloud-monitoring-metric-selection): Cloud monitoring metric selection is an open-source agent skill for databases.
- [Cloud monitoring promql query](https://ai-powered.com/skills/cloud-monitoring-promql-query): Cloud monitoring promql query is an open-source agent skill for cloud and infrastructure.
- [Cloud monitoring alert configuration](https://ai-powered.com/skills/cloud-monitoring-alert-configuration): Cloud monitoring alert configuration is an open-source agent skill for cloud and infrastructure.
- [Bigquery observability](https://ai-powered.com/skills/bigquery-observability): Bigquery observability is an open-source agent skill for databases.
- [Google cloud slo alert configuration](https://ai-powered.com/skills/google-cloud-slo-alert-configuration): Google cloud slo alert configuration is an open-source agent skill for cloud and infrastructure.
- [Gke observability](https://ai-powered.com/skills/gke-observability): Gke observability is an open-source agent skill for cloud and infrastructure.

---
Source: https://ai-powered.com/skills/cloud-monitoring-list-time-series-request
