cloud-logging — скилл для Claude Code: анализ логов GCP
Скилл для работы с Google Cloud Logging и Error Reporting. Помогает обрабатывать большие JSON-логи из GCP и переводить их в Apache-формат для удобного анализа.
Apache-2.0 ★ 151 обновлён 2026-10-12
/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sreЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/cloud-logging/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cloud-logging/
1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill cloud-logging -a codex2Вручную: положить файлы
.agents/skills/cloud-logging/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill cloud-logging -a cursor2Вручную: положить файлы
.cursor/skills/cloud-logging/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gemini-cli-extensions/sre skills/cloud-logging2Вручную: положить файлы
.github/skills/cloud-logging/SKILL.md1Через Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill cloud-logging -a gemini-cli2Командой платформы
gemini skills install https://github.com/gemini-cli-extensions/sre --path skills/cloud-loggingВручную: положить файлы
.devin/skills/cloud-logging/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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