К основному содержанию
скилл CX Codex

cloud-monitoring — скилл для Claude Code: что делает и как установить

Скилл запрашивает метрики Google Cloud Monitoring через MCP, сжимает данные в CSV и рисует текстовые спарклайны без перегрузки контекста.

Apache-2.0 ★ 151 обновлён 2026-10-12

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sre
Открыть на GitHub

Что делает cloud-monitoring

Скилл подключает агента к API Google Cloud Monitoring через готовые инструменты MCP: чтение алертов, политик, дашбордов и выгрузку временных рядов вроде mcp_google-monitoring_query_range. Главный акцент сделан на экономии контекста нейросети. Сырые ответы Cloud Monitoring весят слишком много, поэтому скилл рекомендует делегировать сбор субагентам и сжимать ряды в компактный вид.

Внутри лежит скрипт scripts/export_timeseries_to_csv.py, который забирает метрики за период и сохраняет CSV со статистикой (AVG, Min, Max), метаданными времени в шапке и ASCII-графиком (спарклайном). Скрипт умеет сравнивать парные показатели: входящий и исходящий трафик инстанса, чтение и запись на диск, запросы и задержки в Cloud Run, а также память и процессорное время в контейнерах GKE. Второй скрипт, scripts/setup-frontend-slo.sh, настраивает SLO доступности 99.9% на основе логов фронтенд-сервиса.

Для работы скилла обязательно требуется предварительно настроенный и активный MCP-сервер google-monitoring. Без доступных инструментов этого сервера скилл данные получить не сможет.

Какие задачи решает

  • получить метрики и графики из Google Cloud Monitoring без переполнения контекста модели
  • сравнить парные метрики вроде памяти и процессора для контейнеров GKE
  • выгрузить временные ряды метрик в CSV с подсчётом минимума, максимума и среднего
  • настроить базовый SLO доступности 99.9% для сервиса через bash-скрипт

Примеры запросов агенту

  • Выгрузи через export_timeseries_to_csv.py трафик и задержки Cloud Run за последние два часа
  • Сравни использование процессора и памяти для контейнеров в GKE и выведи ASCII-спарклайн
  • Проверь активные алерты в Google Cloud Monitoring через доступные MCP-инструменты

Как установить cloud-monitoring

1Через маркетплейс плагинов

/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sre

Команда ставит плагин sre-extension целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gemini-cli-extensions/sre --skill cloud-monitoring -a claude-code

3Вручную: положить файлы

~/.claude/skills/cloud-monitoring/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cloud-monitoring/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cloud-monitoring

Как установить cloud-monitoring в Claude Code?

Установите скилл командой npx skills add gemini-cli-extensions/sre --skill cloud-monitoring -a claude-code. Также можно подключить через маркетплейс, выполнив /plugin marketplace add gemini-cli-extensions/sre, а затем /plugin install sre-extension@sre.

Что нужно подготовить перед запуском скилла?

Обязательно требуется активный MCP-сервер google-monitoring. Без зарегистрированных MCP-инструментов скилл сразу сообщит об ошибке и не сможет сделать запросы к API мониторинга.

Почему скилл выгружает метрики в CSV, а не в сырой JSON?

Ответы API Cloud Monitoring содержат тысячи строк JSON, которые забивают контекстное окно модели. Скрипт агрегирует данные, считает метрики и строит ASCII-график, передавая агенту только компактную выжимку.

Исходный текст

SKILL.md · Apache-2.0
---
name: cloud-monitoring
description: 🐉 Skill for interacting with Google Cloud Monitoring (CM) via APIs to avoid large context bloat. Produces nice short synoptic "gists" of graphs
metadata:
  author: Riccardo Carlesso
  version: 0.2.17
tools:
  - mcp_google-monitoring_get_alert
  - mcp_google-monitoring_get_alert_policy
  - mcp_google-monitoring_get_dashboard
  - mcp_google-monitoring_list_alert_policies
  - mcp_google-monitoring_list_alerts
  - mcp_google-monitoring_list_dashboards
  - mcp_google-monitoring_list_metric_descriptors
  - mcp_google-monitoring_list_timeseries
  - mcp_google-monitoring_query_range
---

# Cloud Monitoring

> **⚠️ PREREQUISITE: `google-monitoring` MCP Server**
> This skill relies on the `google-monitoring` MCP server being installed and active. Before proceeding with monitoring tasks, assert that the required MCP tools (e.g., `mcp_google-monitoring_query_range`) are available. If they are missing, immediately inform the user and recommend they enable the MCP server (they can use the `gcp-mcp-setup` skill if available).

This skill provides utilities for analyzing and extracting data from Google Cloud Monitoring (CM). 

## Best Practices

* **Avoid Context Bloat:** Cloud Monitoring API responses can be massive. Do not try to read raw JSON responses directly into the LLM context. Try to delegate to a SubAgent anything which pulls monitoring data as they tend to bloat the context.
* **Use Export Scripts:** If you pull monitoring data, make sure to surface this final data (in CSV format) using the `scripts/export_timeseries_to_csv.py` Python script to surface important stats like AVG, Max, Min and a simplified text-graph of the system (see `references/sample_output_dual_metrics.csv`) . Also report back that stats header to the main agent, together with any interesting insights you might have found.
* **Metadata Headers:** Exported data should contain metadata (time ranges, metric names) at the top of the file so that the context of "when" the data was pulled is never lost, as `now()` changes over time.
* **Target Workloads:** Focus your monitoring extractions primarily on GKE and Cloud Run environments. Generic time-series extractions should still allow filtering by specific resources.
* **Paired Metrics Comparison:** The extraction script supports querying multiple metrics simultaneously. For apples-to-apples comparisons, try these recommended pairs:
  * **Network I/O:** `compute.googleapis.com/instance/network/received_bytes_count` vs `compute.googleapis.com/instance/network/sent_bytes_count`
  * **Disk I/O:** `compute.googleapis.com/instance/disk/read_bytes_count` vs `compute.googleapis.com/instance/disk/write_bytes_count`
  * **Cloud Run Traffic:** `run.googleapis.com/request_count` vs `run.googleapis.com/response_latencies`
  * **GKE Memory vs CPU:** `kubernetes.io/container/memory/used_bytes` vs `kubernetes.io/container/cpu/core_usage_time`

## Available Tools

* `scripts/export_timeseries_to_csv.py`: Fetches time-series data for specified metric(s) and time range, outputting a CSV file with metadata headers. Supports extracting two or more variables for direct correlation and comparison. This is an amazing synoptic you can surface to the user
    * It's very effective particularly to share the "**Sparkline**" / **ASCII Art** part showing in TEXT the graphical shape of the curve (e.g., `|█▇▆▇ ▂▃   ▂ ▂|`). This is very useful for humans for rapid visual feedback! Use `csv_to_sparkline.py` from `monitoring-graphs` to recreate it for arbitrary CSVs.
* `scripts/setup-frontend-slo.sh`: A bash script to automatically set up a 99.9% availability SLO using Log-based Metrics for a 'frontend' service. (See `scripts/README.md` for full manual).

© Riccardo Carlesso · Apache-2.0 · gemini-cli-extensions/sre

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
cloud-monitoring-promql-query официальный google Скилл cloud-monitoring-promql-query для Cloud Monitoring на Claude Code, Gemini CLI и Codex. Генерирует валидные PromQL-запросы из дескрипторов метрик и параметров ресурсов Google Cloud. CX Codex +1 3 700установок cloud-monitoring-list-time-series-request официальный google Скилл cloud-monitoring-list-time-series-request для Claude Code собирает запросы ListTimeSeries и настройки агрегации Cloud Monitoring. Вызывается для подготовки JSON, фильтров и параметров графиков по метрикам. CX Codex +1 4 100установок huawei-cloud-monitoring-query huaweicloud Скилл huawei-cloud-monitoring-query читает состояние мониторинга Huawei Cloud: правила алертов, историю срабатываний, дашборды и данные enterprise-проектов. Только чтение, без изменений. CX Codex +1 18 300установок huawei-cloud-ces-ecs-monitoring huaweicloud Скилл huawei-cloud-ces-ecs-monitoring для Claude Code и Codex запрашивает метрики ECS через Cloud Eye Service. Помогает смотреть загрузку ресурсов и разбирать динамику показателей. CX Codex +1 239установок monitoring-and-alerting rampstackco Скилл monitoring-and-alerting помогает спроектировать систему мониторинга для веб-приложений: задать SLO, распределить алерты по уровням важности и настроить дежурства без лишнего шума. CX Codex +1 308установок Cloudflare Digital Experience Monitoring docker MCP-сервер Cloudflare Digital Experience Monitoring даёт агенту доступ к данным мониторинга приложений организации через Cloudflare DEM. CX Codex +1

Из того же набора17

Весь набор →
gcp-slo-management Скилл gcp-slo-management находит сервисы в Google Cloud Monitoring и заводит SLO на доступность или задержку через REST API там, где в gcloud нет команды для создания цели. CX Codex +1 ★ 151звёзд репо gcp-playbooks Скилл gcp-playbooks с SRE-плейбуками для расследования инцидентов и восстановления сервисов в GCP и GKE. CX Codex +1 ★ 151звёзд репо pre-publish-checker Скилл pre-publish-checker проверяет проект перед публикацией: ищет ругань, внутренние ссылки и пути, а затем помогает пройти ручную проверку качества. Пригодится перед открытым релизом кода или расширения. CX Codex +1 ★ 151звёзд репо safe-sre-investigator Скилл safe-sre-investigator заводит отдельные read-only сервисные аккаунты для GCP и Kubernetes и подсказывает команды gcloud/kubectl вместе с оценкой риска. CX Codex +1 ★ 151звёзд репо postmortem-aggregator Скилл postmortem-aggregator для Claude Code разбирает Post Mortem в папке, рассчитывает показатели сбоев и обновляет POMO_AGGREGATED.md. Помогает находить повторяющиеся причины инцидентов. CX Codex +1 ★ 151звёзд репо gcp-mcp-setup Скилл gcp-mcp-setup для Claude Code, Codex и Gemini CLI автоматизирует подключение Google Managed MCP-серверов (OneMCP) к CLI-окружению. Включает нужные API, генерирует ключи и записывает конфигурацию в нужный файл настроек. CX Codex +1 ★ 151звёзд репо generic-mitigations Скилл generic-mitigations учит ИИ-агента купировать сбои в продакшене типовыми мерами SRE вместо долгих раскопок причин во время аварии. CX Codex +1 ★ 151звёзд репо monitoring-graphs Скилл monitoring-graphs для Claude Code, Codex и Gemini CLI генерирует аннотированные графики инцидентов на Python. Запускается, когда нужно визуализировать сбой, показать скачки ошибок или соотнести метрики с этапами инцидента. CX Codex +1 ★ 151звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой