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

cloud-logging — скилл для Claude Code: анализ логов GCP

Скилл для работы с Google Cloud Logging и Error Reporting. Помогает обрабатывать большие JSON-логи из GCP и переводить их в Apache-формат для удобного анализа.

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

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

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

Скилл предоставляет инструменты для анализа логов, ошибок и здоровья систем на Google Cloud. Основная фишка — скрипт cloudlogging2apachelogs.py, который конвертирует экспорты Cloud Logging в формат, похожий на Apache Combined Log. Это намного экономнее по токенам, чем тащить в контекст большие JSON-файлы целиком.

В комплекте есть готовый скрипт для конвертации и тестовый набор логов. Скилл советует фильтровать логи по severity (ERROR и выше менее многословны) и временным рамкам, чтобы не перегружать контекст. Для долгих операций вроде gcloud logging read рекомендуется использовать timeout или запускать в фоне с периодической проверкой результатов.

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

  • обработать большой JSON-файл логов из GCP без перегруза контекста
  • конвертировать Cloud Logging в формат Apache для анализа
  • найти ошибки в логах, отфильтровав по severity и времени
  • автоматизировать анализ Error Reporting из Google Cloud

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

  • Конвертируй логи из access_logs_raw.json в Apache-формат для анализа
  • Найди все ошибки со статусом ERROR в логах за последние 6 часов
  • Обработай GCP-логи скриптом cloudlogging2apachelogs.py и покажи статусы запросов

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

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-logging -a claude-code

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

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

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

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

Вопросы о cloud-logging

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

Выполни по порядку: /plugin marketplace add gemini-cli-extensions/sre, потом /plugin install sre-extension@sre, затем npx skills add gemini-cli-extensions/sre --skill cloud-logging -a claude-code. После этого скилл будет доступен по пути ~/.claude/skills/cloud-logging/SKILL.md.

Что делает скилл cloud-logging?

Помогает анализировать логи Google Cloud, переводит JSON-логи в Apache-формат для более эффективного использования контекста. В комплекте скрипт cloudlogging2apachelogs.py для конвертации и примеры работы с фильтрацией по severity и времени.

Почему нельзя просто загрузить большой файл логов?

Потому что большие файлы быстро заполняют контекстное окно. Лучше использовать jq или скрипт для фильтрации нужных данных перед анализом.

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

SKILL.md · Apache-2.0
---
name: cloud-logging
description: 🐉 Skill for interacting with and analyzing Google Cloud Logging and Error Reporting. Use this when you need to process large JSON logs from GCP or convert them to Apache format for easier analysis.
metadata:
  author: Riccardo Carlesso
  version: 0.3.0
  status: published
---

# Cloud Logging 

This skill provides utilities for analyzing logs, errors, and system health across Google Cloud deployments.

* Prioritize Logs with `severity` >= "ERROR" as they tend to be less verbose.
* Constrain logs around the time of investigation (possibly going back a few hours/days to find smoking guns).


## Logs DOs and DONT's

Ingesting Logs into an LMM memory can easily saturate your context.

* [BAD] **DO NOT** ingest big files. Antipattern:  `ReadFile path/to/access_logs_raw.json`.
    * It's ok to get raw logs, but also use `jq` or scripts to read them without polluting your context window.
    * [GOOD] Use simple maniuplation like: `jq -r '.[] | .httpRequest.status'` to get a list of statuses.
    * [GOOD] Reduce size with scripts such as `scripts/cloudlogging2apachelogs.py <big_logfile.json>` (provided in the skill)
* [BAD] Do not call **long**-running calls without precautions, eg `gcloud logging read`
    * [GOOD] Rather prepend some reasonable `timeout 60 gcloud logging read ...`, or
    * [BEST] Use the `run_shell_command` tool with `is_background: true` and poll the results being dumped to file periodically.


## Bundled Scripts

### cloudlogging2apachelogs.py

Converts GCP Cloud Logging JSON exports into a format loosely resembling Apache Combined Log format. This is much more token-efficient for the LLM.

**Usage**:
```bash
python3 scripts/cloudlogging2apachelogs.py path/to/logs.json
```

**Testing**:
You can verify the script works by running its test:
```bash
python3 scripts/cloudlogging2apachelogs_test.py
```

## Bundled Assets

* `assets/sample_logs.json`: A small sample of GCP Cloud Logging JSON for testing conversion scripts.

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

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

Все скиллы по теме «DevOps и инфраструктура» →
sap-btp-cloud-logging secondsky Скилл sap-btp-cloud-logging помогает настраивать сервис SAP Cloud Logging на платформе BTP, передавать телеметрию и строить дашборды в OpenSearch. CX Codex +1 1 000установок logging-and-error-reporting dominikmartn Скилл logging-and-error-reporting для Claude Code помогает выбрать уровень логирования и настроить отправку ошибок в Sentry. Запускается при добавлении или ревью кода в проекте Warp. CX Codex +1 ★ 720звёзд репо cloud-logging-query-generation официальный google Скилл cloud-logging-query-generation для Claude Code и Gemini CLI превращает запрос на обычном языке в фильтр для Cloud Logging на Google Cloud. Составляет запросы на Logging Query Language, сверяя типы ресурсов со справочником сервиса. CX Codex +1 5 885установок logging-best-practices boristane Скилл logging-best-practices обучает агента практикам структурированного логирования wide events (канонических строк лога). Помогает отказаться от разрозненных console.log в пользу единого JSON-события на запрос. CX Codex +1 5 000установок cloud-logging-configuration-basics официальный google Скилл cloud-logging-configuration-basics для Claude Code настраивает Cloud Logging в проекте Google Cloud: региональные бакеты, фильтры и маршрутизацию логов, метрики на основе логов и управление доступом через IAM. CX Codex +1 5 000установок using-cloud-cli julianobarbosa Скилл using-cloud-cli для Claude Code задаёт правила работы с bq, gcloud и aws. Описывает запросы BigQuery, облачные CLI-команды и решения по сервисам AWS и GCP. CX Codex +1 108установок

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

Весь набор →
gcp-setup Скилл gcp-setup для Claude Code проверяет и синхронизирует identities в gcloud, ADC и kubectl в начале сессии. Сверяет, чтобы все три системы видели одного пользователя. CX Codex +1 ★ 151звёзд репо data-ingestion Скилл data-ingestion загружает временные ряды из CSV-файлов или внешних источников и преобразует их в единый JSON для анализа. CX Codex +1 ★ 151звёзд репо 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звёзд репо cloud-monitoring Скилл запрашивает метрики Google Cloud Monitoring через MCP, сжимает данные в CSV и рисует текстовые спарклайны без перегрузки контекста. CX Codex +1 ★ 151звёзд репо postmortem-aggregator Скилл postmortem-aggregator для Claude Code разбирает Post Mortem в папке, рассчитывает показатели сбоев и обновляет POMO_AGGREGATED.md. Помогает находить повторяющиеся причины инцидентов. CX Codex +1 ★ 151звёзд репо

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

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