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

exploring-endpoint-execution-logs — скилл для Claude Code: обзор

Скилл exploring-endpoint-execution-logs для Claude Code разбирает сбои и поведение эндпоинтов PostHog по записям в хранилище логов. Находит причины ошибок и ответов без строк.

MIT 318 установок ★ 80 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add PostHog/skills --skill exploring-endpoint-execution-logs -a claude-code
Открыть на GitHub

Что делает exploring-endpoint-execution-logs

Скилл читает таблицу log_entries для отдельного эндпоинта и помогает понять причину сбоя выполнения. Каждый вызов генерирует ровно одну запись со статусом INFO или ERROR. Внутри сообщения сохранены токены key=value: путь выполнения (materialized, inline или ducklake), факт попадания в кэш, длительность duration_ms, число строк и версия эндпоинта. При сбое строка содержит класс ошибки вроде ResolutionError или HogVMException.

Для диагностики агент использует три инструмента. Основной из них — endpoint-logs. Он фильтрует записи по уровню, ищет подстроки токенов и выдаёт выборку до 500 строк. Параллельно endpoint-get возвращает параметры конфигурации, а через execute-sql выполняются прямые агрегации по log_source_id.

Хранилище log_entries держит логи около 90 дней, поэтому поднять историю за прошлые периоды не выйдет. Запись лога происходит по принципу best-effort и не блокирует выполнение запроса. Если вызов отработал штатно, но записи в логах нет, был пропущен только лог. Пошаговых трассировок здесь тоже нет: одна операция формирует ровно одну итоговую строку.

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

  • Найти причину сбоя вроде ResolutionError при запуске эндпоинта
  • Проверить факт попадания недавних вызовов в кэш
  • Сравнить количество возвращаемых строк между версиями эндпоинта
  • Посчитать динамику ошибок через SQL-запрос к таблице логов

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

  • Покажи последние логи для эндпоинта weekly_signups с уровнем ERROR
  • Почему эндпоинт revenue_metrics вернул ноль строк при последнем запуске?
  • Проверь, попадает ли эндпоинт active_users в кэш за последние сутки

Как установить exploring-endpoint-execution-logs

1Через Skills CLI (Vercel)

npx skills add PostHog/skills --skill exploring-endpoint-execution-logs -a claude-code

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

~/.claude/skills/exploring-endpoint-execution-logs/SKILL.md

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

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

Вопросы об exploring-endpoint-execution-logs

Как установить exploring-endpoint-execution-logs в Claude Code?

Выполните команду npx skills add PostHog/skills --skill exploring-endpoint-execution-logs -a claude-code. Агент загрузит скилл в локальную конфигурацию Claude Code.

Что делает exploring-endpoint-execution-logs?

Скилл запрашивает и анализирует журнал выполнения конкретного эндпоинта PostHog из таблицы log_entries. Он показывает статус кэша, время выполнения, код ошибки и число строк.

Чем этот скилл отличается от diagnosing-endpoint-performance?

Этот инструмент разбирает конкретные ошибки и журнал одиночного эндпоинта. Вопросы оптимизации материализации и стоимости запросов по query_log решает diagnosing-endpoint-performance.

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

SKILL.md · MIT
---
name: exploring-endpoint-execution-logs
description: >
  Explore and diagnose a PostHog endpoint's execution logs — error messages, failed runs, cache
  misses, slow runs, or unexpected row counts during endpoint invocations. Use when the user says
  "my endpoint is failing", "show me the logs for endpoint X", "what error did endpoint Y produce",
  "why did endpoint Z return no rows", "is this endpoint hitting cache", or "check the last N runs".
  Focused on a single named endpoint's runtime log entries, not project-wide auditing or query
  performance profiling.
---

# Exploring endpoint execution logs

Every endpoint run emits one execution log entry to PostHog's `log_entries` store. This skill
reads those entries for a specific endpoint to answer "what happened when it ran?". It is the
log-level counterpart to `diagnosing-endpoint-performance` (which reasons about cache/materialisation
strategy from config and `query_log`).

## When to use this skill

- "Why is my endpoint failing / erroring?"
- "Show me the logs / recent runs for endpoint X"
- "Did the last run hit cache? How many rows did it return?"
- "What happened the last time endpoint Y ran?"

If the question is "this endpoint is slow, what should I change?", use
`diagnosing-endpoint-performance`. If it's project-wide ("what can I clean up?"), use
`auditing-endpoints`.

## What an execution log entry looks like

Each run produces exactly one entry. The level is `INFO` on success and `ERROR` on failure, and the
message carries the extra data as searchable `key=value` tokens:

```text
Endpoint executed · path=materialized cache=hit duration_ms=142 rows=1024 version=3
Endpoint execution failed · path=inline error=ResolutionError version=3
```

Token meanings:

| Token         | Values                                                       | Meaning                                                        |
| ------------- | ------------------------------------------------------------ | -------------------------------------------------------------- |
| `path`        | `materialized` / `inline` / `ducklake` / `ducklake_fallback` | Which execution path ran                                       |
| `cache`       | `hit` / `miss`                                               | Whether the query result cache was used (omitted for ducklake) |
| `duration_ms` | integer                                                      | Wall-clock execution time                                      |
| `rows`        | integer                                                      | Number of result rows returned                                 |
| `version`     | integer                                                      | Which endpoint version ran                                     |
| `error`       | e.g. `ResolutionError`, `HogVMException`                     | Error class / HogQL code name (failures only)                  |

Each run gets a distinct `instance_id`, so logs group one-per-execution in the viewer.

## Available tools

| Tool            | Purpose                                                                                                                       |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `endpoint-logs` | Primary. Execution log entries for one endpoint by name. Filter by level, search, time range, instance_id; `limit` up to 500. |
| `endpoint-get`  | Endpoint config for context (current version, materialisation, query kind)                                                    |
| `execute-sql`   | Fallback / aggregation directly against `log_entries` (`log_source='endpoints'`)                                              |

## Filtering

`endpoint-logs` exposes the standard log filters:

- **level** — comma-separated, e.g. `ERROR` to see only failed runs, or `INFO,ERROR` for all.
- **search** — case-insensitive substring over the message. Because the extra data is in
  `key=value` tokens, you can search `cache=miss`, `path=inline`, `error=ResolutionError`, or a
  specific `version=3`.
- **after / before** — ISO timestamps to bound the time range.
- **instance_id** — pin a single execution.
- **limit** — 1–500 (default 50).

## Workflow

1. Identify the endpoint by name. If given a URL, parse it from
   `/api/projects/{team_id}/endpoints/{name}/run`.
2. Start broad: `endpoint-logs` for the endpoint with a recent time range. Skim levels and tokens.
3. Narrow to the symptom:
   - Failures → `level=ERROR`; read the `error=` token and `path=` to see where it broke.
   - Cache concerns → `search=cache=miss` to see how often runs miss cache.
   - Wrong results → compare `rows=` across runs, and `version=` to spot a regression after a
     version bump.
4. For counts/trends across many runs (e.g. error rate over a week), drop to `execute-sql` against
   `log_entries`:

   ```sql
   SELECT toDate(timestamp) AS day, upper(level) AS level, count() AS runs
   FROM log_entries
   WHERE log_source = 'endpoints' AND log_source_id = '<endpoint_uuid>'
   GROUP BY day, level ORDER BY day DESC
   ```

   Get the endpoint UUID from `endpoint-get` (the `log_source_id` is the endpoint id, not its name).

5. Summarize: what's failing, since when, on which version/path, and whether it's a config issue
   (hand off to `diagnosing-endpoint-performance`) or a query bug.

## Example interaction

```text
User: "weekly_signups started erroring this morning"

Agent steps:
- endpoint-logs weekly_signups, level=ERROR, after=<this morning>
  → several "Endpoint execution failed · path=inline error=ResolutionError version=5"
- endpoint-get weekly_signups → current version is v5 (bumped today)
- endpoint-logs weekly_signups, level=INFO, before=<this morning>
  → prior runs: "path=inline cache=hit ... version=4" succeeded

- "v5 (created this morning) is failing with a ResolutionError on the inline path — it can't
   resolve a table or field reference. v4 ran fine. This looks like a bad query in the new
   version. Want me to pull the v5 query (endpoint-versions) so we can fix it, or roll back to v4?"
```

## Important notes

- **One entry per run.** Don't expect step-by-step traces — endpoints log a single completion line.
  The detail lives in the tokens, not in multiple lines.
- **`log_source_id` is the endpoint UUID**, not the name. For `execute-sql`, fetch it via
  `endpoint-get` first.
- **Logs are retained ~90 days** (the `log_entries` TTL). Older runs won't appear.
- **Execution logs ≠ query performance.** `endpoint-logs` tells you what happened and why a run
  failed; for "should I materialise / bump cache TTL?" use `diagnosing-endpoint-performance`, which
  reasons over config and `query_log` cost metrics.
- **Best-effort emission.** A log line is emitted after each run but never blocks it — if a run
  succeeded for the caller but no log shows, the emit was dropped, not the query.

© PostHog · MIT · PostHog/skills

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

Все скиллы по теме «Бэкенд и API» →
exploring-mcp-tool-quality PostHog Скилл exploring-mcp-tool-quality разбирает качество вызовов MCP-инструментов в PostHog: долю ошибок, задержки, охват и самые проблемные тулы. CX Codex +1 202установок exploring-mcp-sessions PostHog Скилл exploring-mcp-sessions разбирает сессии PostHog MCP: порядок вызова инструментов агентом, его намерения и ошибки при выполнении. CX Codex +1 202установок analyze-logs HugoRCD Скилл analyze-logs читает структурированные логи evlog из папки .evlog/logs/ в формате NDJSON. Помогает находить сбои, медленные запросы и изучать поведение бэкенда при отладке. CX Codex +1 256установок agent-platform-endpoint-management официальный google Скилл agent-platform-endpoint-management управляет serving endpoints в Agent Platform: создаёт, показывает, обновляет и удаляет ресурсы. Помогает разбирать ошибки прав, квот и занятых ресурсов. CX Codex +1 8 086установок dd-logs datadog-labs Скилл dd-logs помогает искать и обрабатывать логи Datadog, настраивать архивы и метрики. Используйте его для разбора ошибок и контроля затрат на индексацию. CX Codex +1 2 300установок platform-apex-logs-debug forcedotcom Скилл platform-apex-logs-debug разбирает debug-логи Salesforce: находит причину падения, ловит превышение governor limits и объясняет стек вызовов. CX Codex +1 7 200установок

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

Весь набор →
signals-scout-csp-violations Скилл signals-scout-csp-violations анализирует поток событий $csp_violation в PostHog, отслеживает всплески директив и находит подозрительные сторонние домены. CX Codex +1 320установок signals-scout-error-tracking Скилл signals-scout-error-tracking для Claude Code отслеживает всплески ошибок PostHog, зациклившиеся сбои и регрессии статусов. Регулярно проверяет поток $exception. CX Codex +1 319установок signals-scout-experiments Скилл signals-scout-experiments находит технические сбои в A/B-тестах PostHog: смещение выборки SRM, поломки метрик, зависшие показы и мутации флагов на ходу. Защищает данные от скрытых искажений при принятии решений. CX Codex +1 319установок signals-scout-surveys Скилл signals-scout-surveys отслеживает аномалии в опросах PostHog и объединяет текстовые ответы пользователей в повторяющиеся темы. CX Codex +1 319установок signals-scout-feature-flags Скилл signals-scout-feature-flags для Claude Code сопоставляет конфигурацию фичефлагов PostHog с потоком вызовов $feature_flag_called. Находит призрачные флаги, обрывы вызовов и технический долг в кодовой базе. CX Codex +1 318установок signals-scout-anomaly-detection Скилл signals-scout-anomaly-detection для Claude Code находит аномалии в сохранённых инсайтах PostHog: резкие всплески, падения и сломы трендов. Отслеживает ключевые дашборды с учётом сезонной базовой линии. CX Codex +1 318установок signals-scout-web-analytics Скилл signals-scout-web-analytics для Claude Code выявляет в PostHog расхождения в каналах трафика, сбои атрибуции и деградацию посадочных страниц, сравнивая сегменты с их историей. CX Codex +1 317установок signals-scout-ai-observability Скилл signals-scout-ai-observability отслеживает аномалии в PostHog AI observability: всплески расходов, рост задержек, ошибки и сбои в трейсах LLM. CX Codex +1 317установок

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

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