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

encore-go-logging — скилл для Claude Code: логи Encore.go

Скилл encore-go-logging для Claude Code помогает добавлять и разбирать структурированные логи в сервисах Encore.go. Включается при работе с уровнями логирования, полями событий и объёмом логов.

Apache-2.0 136 установок ★ 30 обновлён 2026-10-23

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

Что делает encore-go-logging

Скилл помогает добавлять и проверять логи через encore.dev/rlog: выбирать место и уровень записи, задавать стабильные сообщения и поля, передавать ошибки и общий контекст. Он также разбирает, какие события уже видны в трассировках Encore и не требуют дублирующих логов.

Для ошибок скилл предлагает записывать исходное значение error и логировать сбой на уровне, где принимают решение о повторе или восстановлении. Он проверяет чувствительные данные и лишний объём: Encore не маскирует поля, переданные в rlog, даже если для запросов включена аннотация sensitive. Перед добавлением частых вызовов Debug нужно настроить log_level в encore.app.

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

  • выбрать уровень для ошибки, предупреждения или бизнес-события
  • добавить стабильные поля к структурированному логу
  • убрать повторные записи событий, уже видимых в трассировках
  • сократить объём логов в циклах и обработчиках Pub/Sub
  • не допустить попадания секретов в поля rlog

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

  • Добавь структурированные логи для перехода заказа в новое состояние.
  • Проверь уровни и поля логов в обработчике оплаты.
  • Сократи шум в логах подписчика Pub/Sub и проверь чувствительные данные.

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

1Через Skills CLI (Vercel)

npx skills add encoredev/skills --skill encore-go-logging -a claude-code

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

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

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

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

Вопросы об encore-go-logging

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

Выполни npx skills add encoredev/skills --skill encore-go-logging -a claude-code. Файл скилла находится по пути ~/.claude/skills/go-logging/SKILL.md.

Что делает encore-go-logging?

Скилл помогает добавлять и проверять структурированные логи Encore.go через encore.dev/rlog: выбирать уровни, поля, места записи и общий контекст.

Маскирует ли Encore чувствительные поля, переданные в rlog?

Нет. Аннотация sensitive и тег encore:"sensitive" маскируют тела запросов и ответов в трассировках, но не значения, переданные в rlog.

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

SKILL.md · Apache-2.0
---
name: encore-go-logging
description: Add or improve structured logging in Encore.go using `encore.dev/rlog`. Covers log placement, levels, stable messages and fields, errors, logging contexts, sensitive data, and log volume.
when_to_use: >-
  User is adding, changing, or reviewing application logs in an Encore.go service. Mentions structured logging, `encore.dev/rlog`, `rlog.Info`, `rlog.Error`, log fields, log levels, noisy or duplicate logs, production debugging, or what to log. Trigger phrases: "add Go logging", "improve these logs", "which log level", "structured log fields", "reduce log volume", "log this error".
---

# Encore.go structured logging

Use `encore.dev/rlog` for application events that need structured fields or trace integration. Preserve an application's established field names and event conventions when they are consistent with this guidance.

## Decide what to record

Add logs for information Encore cannot infer from infrastructure operations:

- Business state transitions
- Decisions and the inputs that determined them
- Retries, fallbacks, and degraded operation
- Failures at the boundary that decides whether to retry, recover, or abort
- External-system interactions that require domain context
- Security-relevant or administrative actions

Encore already traces API requests, database queries, service calls, cache operations, and Pub/Sub activity. Do not narrate that execution with logs such as `request started`, `querying database`, or `request completed`.

Use metrics for aggregate counts and levels. Use traces for call flow and timing. Use logs for the context needed to investigate an individual event.

## Emit structured logs

Keep the message stable and pass alternating string keys and values after it:

```go
import "encore.dev/rlog"

rlog.Info("order rejected",
	"event", "order.rejected",
	"order_id", orderID,
	"product_id", productID,
	"reason", "insufficient_inventory",
	"requested_quantity", requestedQuantity,
	"available_quantity", availableQuantity,
)
```

Avoid interpolating identifiers into the message. Stable messages can be grouped, while fields remain searchable.

For events used by dashboards, alerts, or automation, include a stable `event` field. Prefer `<domain>.<past-tense-event>`, such as `payment.authorized` or `subscription.cancelled`. Diagnostic logs do not require an event name.

Keep each field name and type consistent across events. Prefer numeric values with explicit units and enum-like values over formatted prose:

```go
rlog.Info("payment authorized",
	"event", "payment.authorized",
	"amount_minor_units", 14900,
	"currency", "SEK",
)
```

Encore's runtime fields use snake_case. Field names beginning with `encore_` are reserved; `rlog` rewrites them with an `x_` prefix.

## Choose a level

Encore.go provides `Error`, `Warn`, `Info`, and `Debug`. It does not expose a `Trace` function through `rlog`.

- `Error`: an unexpected failure prevented an operation from completing
- `Warn`: the application recovered or continued in a degraded state
- `Info`: a meaningful, relatively low-volume business event
- `Debug`: diagnostic detail not required for normal operation

Expected outcomes such as validation failures, missing resources, rejected logins, or declined payments are not `Error` events. Use their business meaning to choose a level.

The default minimum level is `trace`, so all four `rlog` levels are emitted. Configure `log_level` in `encore.app` before adding `Debug` calls to frequently executed code.

## Record errors once

Pass the original `error` as a field value:

```go
if err := chargeCustomer(ctx, customerID, amount); err != nil {
	rlog.Error("payment authorization failed",
		"err", err,
		"customer_id", customerID,
		"amount_minor_units", amount,
		"currency", currency,
	)
	return err
}
```

Passing the `error` value lets `rlog` apply its error serialization. Calling `err.Error()` first passes a plain string.

Log a returned failure at the layer that owns the recovery decision and has the domain context to describe its impact. A lower layer should log only when it handles or suppresses the error, retries, detects an invariant violation, or holds context that the returned error will not contain.

## Add shared context

Use `rlog.With` when several events from one domain operation share fields:

```go
logger := rlog.With("import_id", importID, "tenant_id", tenantID)

logger.Info("user import completed", "succeeded_count", succeededCount, "failed_count", failedCount)
logger.Warn("user import row rejected", "row_number", rowNumber, "reason", "invalid_email")
```

Encore already attaches the service, endpoint, trace ID, and authenticated user ID to request logs. Do not add duplicate copies.

## Protect sensitive data

Encore does not redact log fields. Never log credentials, tokens, session identifiers, cookies, authorization headers, secret configuration, payment details, or complete request and response values.

Prefer internal identifiers over personal data. Use a stable non-reversible fingerprint when correlation requires a value that should not be stored.

The `sensitive` API annotation and `encore:"sensitive"` struct tag redact request and response payloads from traces; they do not redact values passed to `rlog`.

## Control volume

Summarize batches and long-running operations with outcomes, counts, and durations. Avoid one log per item unless each failure requires investigation.

Log selected metadata from large values rather than complete provider responses, records, configuration values, slices, or document bodies. Bound previews and review them for sensitive data before logging.

When reviewing an existing application, check loops, Pub/Sub subscribers, middleware, and frequently called helpers first. A small number of these call sites often produces most of the log volume.

See the [Encore.go logging guide](https://encore.dev/docs/go/observability/logging) and [`rlog` package reference](https://pkg.go.dev/encore.dev/rlog).

© encoredev · Apache-2.0 · encoredev/skills

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

Все скиллы по теме «Бэкенд и API» →
go-logging cxuu Скилл go-logging для Claude Code: правила логирования в Go — уровни, структурные поля, контекст запроса. Наводит порядок в логах растущего Go-проекта. CX Codex +1 1 100установок logging-best-practices Mindrally Скилл logging-best-practices для Claude Code задаёт правила логирования: структурный JSON, уровни, общие поля и работа с контекстом запроса. Унифицирует логи в проекте — все пишут по одним правилам. CX Codex +1 842установок better-logging biw Скилл better-logging для Claude Code помогает проектировать структурированные события для HTTP, IPC, tRPC, фоновых задач и очередей. Помогает искать сбои и задержки по разрозненным логам. CX Codex +1 497установок golang-samber-oops samber Скилл golang-samber-oops добавляет в Claude Code, Cursor и другие IDE знание о samber/oops — библиотеке для структурированной обработки ошибок в Go с контекстом, стек-трейсами, кодами ошибок и сообщениями для пользователя. CX Codex +1 40 300установок serilog codewithmukesh Скилл помогает настроить структурированное логирование Serilog в приложении .NET 10: уровни, приёмники, свойства событий и журналы HTTP-запросов. CX Codex +1 4 000установок 181-java-observability-logging Juan Antonio Breña Moral Скилл 181-java-observability-logging для Claude Code помогает внедрять и улучшать логирование Java. Он включается по запросам настроить, пересмотреть или добавить поддержку логов. CX Codex +1 325установок

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

Весь набор →
encore-go-secret Скилл encore-go-secret для Claude Code подключает секреты Encore Go через поля package-level структуры secrets. Срабатывает для API-ключей и других приватных учётных данных. CX Codex +1 362установок encore-go-pubsub Скилл encore-go-pubsub для Claude Code описывает асинхронный обмен сообщениями в Encore Go через topics и subscriptions. Помогает публиковать события и обрабатывать их в фоне. CX Codex +1 360установок encore-go-bucket Скилл encore-go-bucket для Claude Code и Codex: работа с объектным хранилищем Encore Go через objects.NewBucket. Загружает, скачивает, удаляет файлы и генерирует подписанные URL для прямого доступа клиентов. CX Codex +1 359установок encore-go-webhook Скилл encore-go-webhook помогает принимать webhook-события в Encore Go через raw HTTP, проверять подписи и передавать обработку в Pub/Sub. CX Codex +1 358установок encore-go-cron Скилл encore-go-cron для Claude Code учит агента объявлять периодические задачи в Encore Go через cron.NewJob. Задаёт расписание вместо обработки входящего запроса. CX Codex +1 357установок encore-go-cache Скилл encore-go-cache учит агента писать кэш в Redis из Go-сервисов на Encore: типизированные keyspaces, TTL, атомарные счётчики. CX Codex +1 355установок encore-logging Скилл encore-logging учит агента расставлять структурные логи в Encore.ts через encore.dev/log: что писать, с каким уровнем и какими полями. CX Codex +1 168установок encore-architecture Скилл encore-architecture помогает спроектировать или разделить сервисы в приложениях на Encore.go и Encore.ts. Подходит для выбора границ сервисов, моделей данных и Pub/Sub. CX Codex +1 167установок

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

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