# cloudflare-workers-observability

Скилл для наблюдаемости Cloudflare Workers: структурированные логи, Analytics Engine, Tail Workers, метрики и алерты. Пригодится, когда воркер падает в проде, а логов не видно.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 302 установки · ★ 236
- Автор: secondsky
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/secondsky/claude-skills/tree/HEAD/plugins/cloudflare-workers/skills/cloudflare-workers-observability/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/cloudflare-workers-observability

## Что делает

Скилл описывает, как настроить наблюдаемость воркера целиком: от `console.log` до Tail Workers, Analytics Engine, Logpush и трассировки событий. Внутри — готовые шаблоны кода на TypeScript: фабрика логгера с `requestId`, класс `Logger` с уровнями и редактированием чувствительных полей, запись точек в Analytics Engine, обработчик `tail()` для приёма логов от других воркеров.

Отдельная таблица разбирает восемь типовых ошибок: логи не появляются в дашборде, сообщения обрезаются на 128KB, Tail Worker молчит из-за несовпадения имени биндинга, запись в Analytics Engine не проходит. Есть и правила: писать JSON, а не простой текст, добавлять контекст запроса в каждую запись, вырезать токены и PII, сэмплировать частые логи в проде.

Важная деталь: чтобы логи вообще пошли, в `wrangler.jsonc` нужно включить `observability.enabled` и задать `head_sampling_rate`. Без этого дашборд будет пустым, и вы решите, что воркер работает нормально. Скилл ставится в шесть платформ, но конфигурация и примеры кода рассчитаны на Workers.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-observability -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/cloudflare-workers-observability/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/cloudflare-workers-observability/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-observability -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/cloudflare-workers-observability/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-observability -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/cloudflare-workers-observability/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install secondsky/claude-skills cloudflare-workers-observability
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/cloudflare-workers-observability/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-observability -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/secondsky/claude-skills --path plugins/cloudflare-workers/skills/cloudflare-workers-observability
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/cloudflare-workers-observability/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill cloudflare-workers-observability -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/secondsky/claude-skills/tree/HEAD/plugins/cloudflare-workers/skills/cloudflare-workers-observability/SKILL.md

## Когда брать
- включить структурированное логирование в воркере с requestId в каждой записи
- настроить Tail Worker для сбора логов из продакшена
- записать бизнес-метрики в Analytics Engine через writeDataPoint
- вырезать токены и PII из логов перед отправкой
- разобраться, почему логи не видны в дашборде Cloudflare

## Примеры запросов агенту
- добавь структурированное логирование в мой Cloudflare Worker с requestId и редактированием токенов
- настрой Tail Worker, который принимает логи от воркера и фильтрует ошибки
- запиши метрику времени ответа в Analytics Engine через биндинг ANALYTICS

## Похожие
- [cloudflare-workers](https://affpapa.org/nevibecode/skills/cloudflare-workers.md) — скилл · 314 установок
- [cloudflare-development](https://affpapa.org/nevibecode/skills/cloudflare-development.md) — скилл · 689 установок
- [observability-and-instrumentation](https://affpapa.org/nevibecode/skills/observability-and-instrumentation.md) — скилл · 54800 установок
- [cloudflare-email-service](https://affpapa.org/nevibecode/skills/cloudflare-email-service.md) — скилл · 102300 установок
- [Observability taste](https://affpapa.org/nevibecode/prompts/observability-taste.md) — промпт · ★ 174597
- [python-observability](https://affpapa.org/nevibecode/skills/python-observability.md) — скилл · 11547 установок

Из того же набора: [secondsky/claude-skills](https://affpapa.org/nevibecode/by/secondsky/claude-skills.md) — 94 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md