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

sre-extension — плагин для Claude Code: что делает и как установить

Плагин sre-extension для Claude Code помогает расследовать сбои в Google Cloud, разбирать логи и создавать постмортемы.

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

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

Что делает sre-extension

Плагин добавляет агенту специализированные сценарии для работы с инфраструктурой GCP и GKE. Через скилл investigation-entrypoint агент запускает расследование аварии, сопоставляет логи Cloud Logging, выгружает метрики через Cloud Monitoring API и находит аномалии во временных рядах с помощью алгоритмов вроде Isolation Forest или Z-score.

В состав входят генератор постмортемов с графиками инцидентов на Python, модули аудита сборок Cloud Build и полуавтоматическая настройка Managed MCP серверов. Без установленных python и uv локальные скрипты аналитики и визуализации работать не смогут.

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

  • расследовать инциденты и сбои сервисов в Google Cloud Platform
  • настроить MCP-серверы для Cloud Logging, GKE и Cloud Monitoring
  • находить аномалии во временных рядах метрик с помощью алгоритмов Isolation Forest и Z-score
  • составлять структурированные постмортемы с графиками ошибок

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

  • /investigation-entrypoint расследуй падение подов в кластере GKE
  • /gcp-mcp-setup настрой доступ к Cloud Logging и Cloud Monitoring
  • /postmortem-generator собери постмортем по инциденту с превышением 5xx ошибок

Как установить sre-extension

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

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

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

Вопросы о sre-extension

Как установить sre-extension в Claude Code?

Выполните по очереди две команды в CLI: сначала /plugin marketplace add gemini-cli-extensions/sre, затем /plugin install sre-extension@sre.

Что делает этот плагин?

Он предоставляет набор скиллов для инженеров надёжности: сбор топологии GCP, поиск первопричин аварий, проверку SLO и построение графиков инцидентов.

Какие системные зависимости нужны для работы плагина?

В системе обязательно должны быть установлены интерпретатор python и пакетный менеджер uv.

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

SKILL.md · Apache-2.0
<p align="center">
  <img src="docs/sre-extension-logo.png" width="400" alt="SRE Extension Logo">
</p>

> **Note:** Given the recent [deprecation of Gemini CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/), this Extension is also fully functional as a Plugin for [agy CLI](https://antigravity.google), Claude Code, and Codex.


# About

**The SRE Gemini CLI Extension** is a dedicated toolkit comprising specialized **Skills** designed to augment Site Reliability Engineers (SREs). By integrating deeply with the Gemini CLI, this extension empowers SREs to investigate outages, configure MCP servers, formulate mitigations, and detect anomalies more rapidly.

See also:
* [Reference PostMortems](https://github.com/palladius/about-sre-extension/) we've created with this tool.
* [SRE Testing Suite](https://github.com/palladius/sre-testing-suite) to test your setups (currently a work in progress) and its related **[Codelab](https://codelabs.developers.google.com/codelabs/investigate-gke-cluster-breakage-scenarios-with-postmortem#0)**.

## 📺 Demo Outage Investigation

Watch the **SRE Extension** in action as it performs a live production outage investigation and generates a detailed PostMortem:

[![SRE Extension Demo Outage Investigation](docs/sre-demo-video-thumbnail.png)](https://youtu.be/bPCznsjW8BU)


## Installation

For detailed installation and configuration instructions across all CLI environments, please refer to the [Installation Guide (INSTALL.md)](INSTALL.md).

If you have [`just`](https://github.com/casey/just) (a modern `make` clone) installed, you can quickly set up the extension. If you don't have `just` yet, you can quickly install it via `brew install just` / 
`sudo apt-get install just` (or see [casey/just](https://github.com/casey/just#installation) for more options).

Once installed:

```bash
# Google Antigravity CLI (agy)
just install-agy
# Google Gemini CLI (deprecated)
just install-gemini
# Claude Code
just install-claude
# GitHub Copilot CLI
just install-copilot-persistent
```

You also need `python` and `uv` installed.


## Available Skills

### 🛠️ Core SRE Skills
- **`investigation-entrypoint`**: Primary entrypoint for investigating production outages, orchestrating SRE response, and mitigating incidents. Start here when an incident occurs!
- **`gcp-architecture-discovery`**: Discover and map GCP infrastructure architecture including compute, networking, storage, and service dependencies.
- **`gcp-playbooks`**: Follows established SRE playbooks for GCP/GKE investigations, including infrastructure discovery and common mitigation steps.
- **`gcp-mcp-setup`**: Automates enabling services, Google Managed MCP (OneMCP) servers, generating API keys, and configuring the MCP settings file for your CLI harness (Gemini, Antigravity, or Copilot).
- **`gcp-slo-management`**: Discover Monitoring Services, list existing SLOs, or create new SLOs (Availability/Latency) via the REST API.
- **`postmortem-generator`**: Creates a generated PostMortem given enough context about a resolved incident/outage.

### ☁️ Cloud Capabilities
- **`cloud-build-investigation`**: Expert-level SRE skill for Google Cloud Build (GCB) and Cloud Run investigations. Correlates git commits with build failures and analyzes logs.
- **`cloud-logging`**: Skill for interacting with and analyzing Google Cloud Logging and Error Reporting. Processes large JSON logs or converts them to Apache format.
- **`cloud-monitoring`**: Interacts with Google Cloud Monitoring via APIs to avoid large context bloat. Exports time-series data and helps setup SLOs.

### 📊 Detection, Graphs & Mitigations
- **`generic-mitigations`**: Generic Mitigations high-level classification logic and actuation plan.
- **`monitoring-graphs`**: Generates high-quality, annotated incident graphs for post-mortems using Python to visualize outages and error rates (nice graphs visible [here](https://github.com/palladius/about-sre-extension/)).
- **`anomaly-detection`**: Detects anomalies in time-series data from various sources (Isolation Forest, KNN, Z-score).
- **`data-ingestion`**: Fetches and parses time-series data from various sources for downstream analysis.

## Compatibility & Harness Support

| Capability            | Gemini CLI | Antigravity (`agy`)                                      | Claude Code                                              | Codex                                                    | Copilot CLI                                              |
| :----------------------| :----------:| :--------------------------------------------------------:| :--------------------------------------------------------:| :--------------------------------------------------------:| :--------------------------------------------------------:|
| **Type**              | Extension  | [Plugin](https://antigravity.google/docs/plugins) | [Plugin](https://code.claude.com/docs/en/plugins-reference) | [Plugin](https://developers.openai.com/codex/plugins) | [Plugin](https://docs.github.com/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating) |
| **Install**           | ✅          | ✅                                                        | ✅                                                        | 🟢                                                        | ✅                                                        |
| **MCP Setup**         | ✅          | ✅                                                        | 🟢                                                        | 🟢                                                        | ✅                                                        |
| **SRE Skills**        | ✅          | ✅                                                        | 🟢                                                        | 🟢                                                        | ✅                                                        |
| **GKE Investigation** | ✅          | ✅                                                        | 🟢                                                        | 🟢                                                        | 🟢                                                        |

**Legend:** ✅ Works (Tested) | 🟢 Works (Untested) | 🔴 Doesn't Work (Red Flag)

## Quickstart

1. Install this extension by following the instructions in [INSTALL.md](INSTALL.md).
2. Only for the first time, use `gcp-setup` and `gcp-mcp-setup` skills to ensure your GCP project and MCP servers are set up correctly:
   ```bash
   $ agy
   /gcp-setup Setup my GCP project "foo-bar-123"
   with email `[email protected]`.
   [..]
   /gcp-mcp-setup Also set up MCP access to Cloud Logging,
   Cloud Monitoring, GKE and Documentation (Developer Knowledge). Skip
   BQ and Cloud Run for this time.
   ```
3. Invoke the entrypoint skill with your incident request. For example:
   ```bash 
   $ agy
   /investigation-entrypoint Use investigation entrypoint skill
   with this new incident: GKE cluster with frontend 1.2.3.4 is reported 
   down by numerous customers, please investigate.
   ```
4. The agent will take it from there—fetching context, querying metrics, and formulating mitigations.

For detailed instructions on setup and usage, please refer to the [User Manual](USER_MANUAL.md).


## Contributing

Check `CONTRIBUTING.md`.



## 🗺️ Public Resources Map

Here is a visual map showing how the SRE Extension codebase, testing suite, postmortems, and learning tutorials relate to each other:

![Public SRE Resources Map](docs/public-resources-map.png)

For a detailed description of the mappings, see [docs/public-resources-map.md](docs/public-resources-map.md).

## Feedback 

For feedback, please report **bugs** and **feature requests** in the issue tracker.
Any other intelligible feedback should be sent to this form: [SRE Extension Survey](https://forms.gle/eJPrbG4KKESp6GmF6)

# Thanks

Program Lead: [Riccardo](https://github.com/palladius)

Co-authors and contributors:
- [Madhavi](https://github.com/madkarra)
- [Ramón](https://github.com/rmedranollamas)
- [Szymon](https://github.com/szymonst)
<!-- add your name here -->

© Google · Apache-2.0 · gemini-cli-extensions/sre

Похожие плагины

Все плагины по теме «Облака: AWS, Azure, GCP» →
sre-postmortem paulip114 Скилл sre-postmortem для Claude Code помогает составлять и проверять безанкерные постмортемы по методологии Google SRE. Он убирает обвинительные формулировки и формулирует задачи на исправление систем. CX Codex +1 ★ 67звёзд репо sre-engineer https://github.com/Jeffallan Скилл sre-engineer помогает рассчитать бюджет ошибок, задать SLO, настроить алерты по четырём золотым сигналам и убрать рутину. Пригодится при настройке надёжности сервисов. CX Codex +1 5 700установок sre-expert personamanagmentlayer Скилл sre-expert для настройки практик SRE, расчёта SLO и организации процессов инцидент-менеджмента в проекте. CX Codex +1 205установок observability-sre majiayu000 Скилл observability-sre помогает настраивать наблюдаемость, SLO и процессы реагирования на инциденты. Подключайте его при работе с Prometheus, Grafana и OpenTelemetry. CX Codex +1 165установок sre-monitoring-and-alerting paulip114 Скилл sre-monitoring-and-alerting для Claude Code проектирует мониторинг и оповещения по практикам Google SRE. Включается при разборе SLO, метрик golden signals и расчёте burn rate. CX Codex +1 ★ 67звёзд репо azure-sre-agent Paul Yuknewicz, Deepthi Chelupati Плагин azure-sre-agent для GitHub Copilot открывает интерактивный холст для расследования инцидентов в приложениях Azure, разбора KQL-запросов и подготовки отчётов в Teams. ★ 11звёзд репо

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

Весь набор →
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звёзд репо anomaly-detection Скилл anomaly-detection находит аномалии во временных рядах из CSV, мониторинга облака и других источников. Автоматически выбирает алгоритм и параметры сглаживания, или работает по вашим настройкам. CX Codex +1 ★ 151звёзд репо investigation-entrypoint Скилл investigation-entrypoint расследования сбоев в Google Cloud Platform для Claude Code, Codex и Gemini CLI. Координирует диагностику GKE и Cloud Run при инцидентах. CX Codex +1 ★ 151звёзд репо postmortem-generator Скилл postmortem-generator для Claude Code собирает постмортем по инциденту: ведёт к таймлайну, action items и черновику Google Doc. Нужны данные расследования и root cause. CX Codex +1 ★ 151звёзд репо gcp-architecture-discovery Скилл gcp-architecture-discovery обходит GCP-проект от сбойного сервиса и собирает карту зависимостей: compute, сети, базы, бакеты. Результат кладёт в файлы, чтобы следующая сессия не начинала с нуля. CX Codex +1 ★ 151звёзд репо

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

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