スキル structured-logging
📋

structured-logging

安全 🌐 ネットワークアクセス📁 ファイルシステムへのアクセス⚙️ 外部コマンド🔑 環境変数

Strukturiertes JSON-Logging implementieren

こちらからも入手できます: Chemiseblanc

Traditionelle Console-Logs sind schwer durchsuchbar und zu parsen. Diese Skill stellt Muster und Codebeispiele für die Implementierung von JSON-strukturiertem Logging bereit, das leistungsfähiges Filtern, Aggregation und Observability über Ihre Dienste hinweg ermöglicht.

対応: Claude Codex Code(CC)
📊 69 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「structured-logging」を使用しています。 Set up structured logging for my Node.js API

期待される結果:

  • Create logger.ts with Pino configured for JSON output
  • Add environment-based log level (info for production, debug for development)
  • Include base fields: service name, environment, requestId
  • Use pino-pretty transport for development readability
  • Configure redact option for sensitive fields

「structured-logging」を使用しています。 How do I trace a user request through multiple services?

期待される結果:

  • Generate unique requestId at API entry point using crypto.randomUUID()
  • Propagate requestId via AsyncLocalStorage across all async operations
  • Include requestId in every log entry for correlation
  • Set x-request-id header for upstream service communication

セキュリティ監査

安全
v5 • 1/17/2026

This is a documentation-only skill containing logging best practices and code examples. All code is illustrative, demonstrating legitimate patterns like Pino/Winston configuration, AsyncLocalStorage context propagation, and sensitive data redaction. No executable code, no network calls, no credential access patterns. The static scanner flagged generic patterns in documentation examples that are false positives.

2
スキャンされたファイル
632
解析された行数
4
検出結果
5
総監査数
監査者: claude 監査履歴を表示 →

品質スコア

38
アーキテクチャ
100
保守性
85
コンテンツ
20
コミュニティ
100
セキュリティ
91
仕様準拠

作れるもの

Produktions-Logging-Setup

Strukturiertes Logging für Produktionsdienste mit Pino oder Winston für besseres Debugging und Observability konfigurieren.

Log-Aggregations-Pipeline

Log-Shipping zu ELK Stack oder Datadog mit proper Trace-Kontext-Propagation einrichten.

API-Request-Tracking

Request-ID-Middleware und kontextbewusstes Logging implementieren, um Requests über Microservices zu verfolgen.

これらのプロンプトを試す

Grundlegendes Logger-Setup
Pino Logger mit umgebungsbasiertem Log-Level, Service-Name und Development-Pretty-Print-Modus einrichten.
Kontext-Propagation
AsyncLocalStorage-Kontext erstellen, um requestId und userId über alle asynchronen Operationen zu propagieren.
Sensible Daten-Redaktion
Pino-Redaktionsoption konfigurieren, um Passwörter, Tokens, API-Schlüssel und Kreditkartennummern zu maskieren.
Log-Aggregation
Winston-Transport erstellen, der JSON-Logs an Elasticsearch für den ELK Stack sendet.

ベストプラクティス

  • Verwenden Sie immer ISO 8601-Zeitstempel für konsistentes Log-Parsing über Systeme hinweg
  • Nehmen Sie requestId in alle Logs auf, um verteiltes Tracing über Dienste hinweg zu ermöglichen
  • Loggen Sie niemals sensible Daten wie Passwörter, Tokens oder Kreditkartennummern

回避

  • Unstrukturierte Strings mit String-Interpolation statt JSON-Objekten loggen
  • Sensible Zugangsdaten oder persönliche Daten in die Log-Ausgabe einschließen
  • Übermäßiges Debug-Logging in Produktion, das Performance-Probleme und Log-Bloat verursacht

よくある質問

Welche Logging-Bibliothek sollte ich wählen?
Pino wird für neue Projekte aufgrund seines minimalen Overheads und seiner hervorragenden Performance empfohlen.
Welches Log-Level sollte ich in Produktion verwenden?
Verwenden Sie info-Level in Produktion, um Rauschen zu reduzieren. Aktivieren Sie debug oder trace nur bei der Fehlersuche.
Wie füge ich Kontext zu allen Log-Einträgen hinzu?
Verwenden Sie AsyncLocalStorage, um requestId und userId zu speichern. Erstellen Sie einen Wrapper-Logger, der den Kontext einschließt.
Sind meine sensiblen Daten in Logs sicher?
Konfigurieren Sie Redaktion für sensible Felder mit der Pino-Redaktionsoption oder benutzerdefinierter Sanitisierung.
Warum erscheinen meine Logs nicht im ELK?
Stellen Sie JSON-Format-Ausgabe sicher, verifizieren Sie, dass Filebeat Ihr Format parsen kann, prüfen Sie die Elasticsearch-Konnektivität.
Wie unterscheidet sich dies von console.log?
Strukturiertes Logging bietet durchsuchbare JSON-Ausgabe im Gegensatz zu console.log. Ermöglicht Aggregation und Alerting.

開発者の詳細

ファイル構成

📄 SKILL.md