Ajouter la capture de logs PostHog

Utilise cette skill pour ajouter la capture de logs PostHog pour du code nouveau ou modifié. Utilise-la après l'implémentation de fonctionnalités ou la revue de PRs pour assurer que des événements de logs significatifs sont capturés avec des propriétés structurées. Si l'export de logs PostHog n'est pas encore configuré, cette skill couvre également la configuration initiale de l'exporteur OTLP. Compatible avec n'importe quelle plateforme ou langage.

Plateformes supportées : Next.js, Node.js, Python, Go, Java, Datadog, et n'importe quel langage via OpenTelemetry.

Instructions

Suis ces étapes DANS L'ORDRE :

ÉTAPE 1 : Analyser le codebase et détecter la plateforme.

• Détecte le langage, le framework et la configuration de logs existante.
• Cherche les bibliothèques de logs (winston, pino, logging module, logrus, log4j, serilog, etc.).
• Cherche les fichiers de verrouillage pour déterminer le gestionnaire de paquets.
• Vérifie la configuration existante d'export de logs PostHog. Si l'exporteur OTLP est déjà configuré, passe à l'ÉTAPE 5 pour ajouter la capture de logs pour le nouveau code.

ÉTAPE 2 : Rechercher la capture de logs. (À sauter si l'export de logs PostHog est déjà configuré.) 2.1. Trouve le fichier de référence ci-dessous qui correspond à la plateforme détectée — c'est la source de vérité pour la configuration de l'exporteur OTLP et l'intégration avec la logging existante. Lis-le maintenant. 2.2. Si aucune référence ne correspond, utilise la référence « Other Languages » comme alternative — elle couvre l'approche générique OpenTelemetry.

ÉTAPE 3 : Installer les dépendances. (À sauter si l'export de logs PostHog est déjà configuré.)

• Installe le SDK OpenTelemetry et les paquets exporteur OTLP pour la plateforme détectée.
• Ne modifie pas manuellement les fichiers de dépendances — utilise la commande d'installation du gestionnaire de paquets.
• Installe toujours les paquets en tâche de fond. N'attends pas la fin ; procède immédiatement aux autres tâches.

ÉTAPE 4 : Configurer l'exporteur OTLP. (À sauter si l'export de logs PostHog est déjà configuré.)

• Les logs PostHog utilisent le protocole OpenTelemetry. Configure un exporteur OTLP pointant vers le endpoint d'ingestion PostHog.
• Suis la référence spécifique à la plateforme pour la configuration exacte.

ÉTAPE 5 : Intégrer avec la logging existante.

• Ajoute l'exporteur de logs PostHog aux côtés de la logging existante. Ne remplace pas les handlers ou sorties de logs existants.
• N'altère pas l'architecture fondamentale des fichiers existants. Rends les additions minimales et ciblées.
• Tu dois lire un fichier immédiatement avant de tenter de l'écrire.

ÉTAPE 6 : Ajouter des propriétés structurées.

• Assure-toi que les logs incluent des propriétés structurées clé-valeur pour le filtrage et la recherche dans PostHog.
• Préfère les formats de logs structurés avec propriétés clé-valeur aux messages en texte brut.

ÉTAPE 7 : Configurer les variables d'environnement.

• Si un serveur MCP env-file-tools est connecté, utilise check_env_keys puis set_env_values pour configurer la clé API PostHog, l'hôte et l'endpoint OpenTelemetry.
• Référence ces variables d'environnement dans le code au lieu de les coder en dur.

Fichiers de référence

• references/nextjs.md - Installation des logs Next.js - docs
• references/nodejs.md - Installation des logs Node.js - docs
• references/python.md - Installation des logs Python - docs
• references/go.md - Installation des logs Go - docs
• references/java.md - Installation des logs Java - docs
• references/datadog.md - Installation des logs Datadog - docs
• references/other.md - Installation des logs pour autres langages - docs
• references/start-here.md - Bien démarrer avec les logs - docs
• references/search.md - Rechercher les logs - docs
• references/best-practices.md - Bonnes pratiques de logging - docs
• references/troubleshooting.md - Dépannage des logs - docs
• references/link-session-replay.md - Lier la session replay - docs
• references/debug-logs-mcp.md - Déboguer les logs avec mcp - docs

Chaque référence de plateforme contient la configuration OTLP spécifique, la configuration du SDK et les patterns d'intégration. Trouve celle qui correspond à la stack de l'utilisateur.

Principes clés

• Variables d'environnement : Utilise toujours les variables d'environnement pour les clés PostHog et les endpoints OpenTelemetry. Ne les code jamais en dur.
• Changements minimaux : Ajoute l'export de logs aux côtés de la logging existante. Ne remplace ni ne restructure le code de logging existant.
• OpenTelemetry : Les logs PostHog utilisent le protocole OpenTelemetry. Configure un exporteur OTLP pointant vers le endpoint d'ingestion PostHog.
• Logging structuré : Préfère les formats de logs structurés avec propriétés clé-valeur aux messages en texte brut.