Suivi des erreurs PostHog pour Python

Cette skill vous aide à ajouter le suivi des erreurs PostHog à vos applications Python.

Fichiers de référence

• references/python.md - Installation du suivi des erreurs Python - docs
• references/fingerprints.md - Empreintes digitales - docs
• references/alerts.md - Envoyer des alertes de suivi des erreurs - docs
• references/monitoring.md - Surveiller et rechercher les problèmes - docs
• references/assigning-issues.md - Assigner des problèmes aux coéquipiers - docs
• references/upload-source-maps.md - Télécharger les source maps - docs

Consultez la documentation pour les détails de l'API et les modèles spécifiques aux frameworks.

Principes clés

• Variables d'environnement : Utilisez toujours les variables d'environnement pour les clés PostHog et les URLs d'hôte. Ne les codez jamais en dur.
• Changements minimaux : Ajoutez le suivi des erreurs aux côtés de la gestion des erreurs existante. Ne remplacez ou ne restructurez pas le code de gestion des erreurs existant.
• Autocapture d'abord : Activez l'autocapture d'exceptions dans l'initialisation du SDK avant d'ajouter des captures manuelles.
• Source maps : Téléchargez les source maps pour que les stack traces se résolvent en code source original, non en bundles minifiés.
• Capture manuelle aux limites : Utilisez captureException() aux limites d'erreur et dans les blocs catch pour les erreurs qui ne se propagent pas au gestionnaire global.

Directives de framework

• Souvenez-vous que le code source est disponible dans le répertoire venv/site-packages
• posthog est le nom du package du SDK Python
• Installez les dépendances avec pip install posthog ou pip install -r requirements.txt et n'utilisez PAS de spécificateurs de version sans guillemets comme >= directement dans les commandes shell
• Dans les CLIs et scripts : DEVEZ appeler posthog.shutdown() avant la sortie ou tous les événements sont perdus
• Utilisez toujours le constructeur de classe Posthog() (API basée sur les instances) au lieu de la configuration module-level posthog.api_key
• Incluez toujours enable_exception_autocapture=True dans le constructeur Posthog() pour suivre automatiquement les exceptions
• N'ENVOYEZ JAMAIS d'informations personnelles dans les propriétés d'événement capture() — pas d'emails, noms complets, numéros de téléphone, adresses physiques, adresses IP ou contenu généré par l'utilisateur
• Les informations personnelles appartiennent aux propriétés de personne identify(), PAS aux propriétés d'événement capture(). Les propriétés d'événement sûres sont les métadonnées comme message_length, form_type, drapeaux booléens.
• Enregistrez posthog_client.shutdown avec atexit.register() pour garantir que tous les événements sont vidés à la sortie
• Le SDK Python n'a PAS de méthode identify() — utilisez posthog_client.set(distinct_id=user_id, properties={...}) pour définir les propriétés de personne, ou utilisez identify_context(user_id) dans un contexte