🔍 Dépannage

Ce guide couvre les problèmes courants que vous pouvez rencontrer en travaillant avec ShredStream.com et comment les résoudre.

Vous utilisez notre SDK ? Le SDK gère le parsing et la validation des paquets automatiquement. Les problèmes réseau ci-dessous (pare-feu, IP, buffers) s'appliquent dans tous les cas.


❌ Aucune donnée reçue

Si votre écouteur UDP est en cours d'exécution mais qu'aucun shred n'arrive :

  1. Vérifiez votre pare-feu -- Assurez-vous que votre pare-feu autorise le trafic UDP entrant sur le port que vous avez configuré. Sous Linux :
    bash
    sudo ufw allow <port>/udp
  2. Vérifiez que le stream est actif -- Ouvrez votre Tableau de bord et confirmez que le statut du stream affiche Actif. Les streams expirés ou en pause n'envoient pas de données. Si le stream affiche Provisionnement ou Error, patientez un instant et rafraîchissez. Si le statut ne change pas, contactez le support sur Discord.
  3. Confirmez que votre IP correspond -- L'IP de destination de votre stream doit correspondre exactement à l'IP publique de votre serveur. Vous pouvez vérifier votre IP publique avec :
    bash
    curl -4 ifconfig.me
  4. Liez à 0.0.0.0 -- Assurez-vous que votre socket UDP se lie à 0.0.0.0, et non à 127.0.0.1 ou à l'IP d'une interface spécifique. Se lier à localhost rejettera silencieusement tout le trafic externe.

📉 Perte élevée de paquets

Les shreds arrivent via UDP, qui ne retransmet pas les paquets perdus. Minimiser les pertes est essentiel.

  1. Augmentez votre tampon de réception UDP à au moins 25 Mo :

    bash
    # Check current value
    sysctl net.core.rmem_max
    # Set to 25 MB
    sudo sysctl -w net.core.rmem_max=26214400
    sudo sysctl -w net.core.rmem_default=26214400

    Remarque : Linux double la valeur que vous définissez via setsockopt(). Si vous demandez 25 Mo, le noyau alloue 50 Mo. La valeur sysctl est la limite supérieure avant le doublement.

  2. Choisissez une région plus proche -- La latence et la perte de paquets augmentent avec la distance. Sélectionnez la région la plus proche de votre serveur dans les paramètres du stream.

  3. Évitez les E/S bloquantes dans votre boucle de réception -- Tout délai de traitement dans le thread qui appelle recvfrom() provoque le remplissage du tampon du noyau et la perte de paquets. Déléguez l'analyse et la logique à un thread séparé.

  4. Surveillez les pertes au niveau du noyau :

    bash
    # Per-socket drops (Linux)
    ss -u -a -n
    # System-wide UDP stats
    netstat -su

    Recherchez le compteur RcvbufErrors ou packet receive errors. Si ce nombre augmente, votre tampon est trop petit ou votre application ne lit pas assez vite.


💳 Paiement non confirmé

Les paiements sont traités sur la blockchain Solana. Si votre paiement semble bloqué :

  1. Attendez 30 à 60 secondes -- Les transactions Solana sont généralement confirmées en quelques secondes, mais la congestion du réseau peut causer des délais.
  2. Assurez-vous d'avoir envoyé suffisamment de SOL -- Le montant envoyé doit correspondre au montant affiché dans la fenêtre de paiement. Si vous payez depuis un exchange, tenez compte des frais de retrait pour que le montant complet arrive à l'adresse de paiement.

Si la transaction a échoué on-chain, vous pouvez retenter le paiement depuis votre tableau de bord.


⚠️ Stream arrêté de manière inattendue

Si un stream qui fonctionnait précédemment a cessé de livrer des shreds :

  1. Vérifiez la date d'expiration -- Ouvrez la page de détail du stream sur votre tableau de bord. Si le stream a expiré, renouvelez-le pour reprendre la livraison.
  2. Vérifiez le statut de la région -- Occasionnellement, une région peut faire l'objet d'une maintenance. Consultez le tableau de bord pour toute notification de statut de région.
  3. Contactez le support -- Si le stream affiche comme actif et que la région est opérationnelle, ouvrez un ticket sur Discord dans le canal #ticket pour obtenir de l'aide.

🌍 Échec du changement de région

Lorsqu'un changement de région échoue, ShredStream.com revient automatiquement à votre région d'origine afin que votre stream ne soit pas interrompu.

  1. Vérifiez la capacité de la région cible -- La région que vous avez sélectionnée peut être temporairement à pleine capacité. Réessayez dans quelques minutes.
  2. Vérifiez que le stream est actif -- Les changements de région ne peuvent être effectués que sur des streams actifs. Les streams expirés ou en erreur doivent d'abord être renouvelés.
  3. Essayez une autre région -- Si la région cible est constamment indisponible, sélectionnez une région alternative géographiquement proche.

Après un changement échoué, votre stream continue de fonctionner dans sa région d'origine sans perte de données.


🔌 Problèmes de connexion

Si vous ne parvenez pas à configurer un stream ou si vous voyez des erreurs de connectivité :

  1. Utilisez une adresse IPv4 publique -- ShredStream.com livre les données uniquement vers des IP publiques. Les plages privées ne fonctionneront pas :
    • 10.0.0.0/8
    • 172.16.0.0/12
    • 192.168.0.0/16
  2. Utilisez un port entre 1024 et 65535 -- Les ports inférieurs à 1024 sont réservés et peuvent nécessiter des privilèges root ou être bloqués par les fournisseurs d'hébergement.
  3. Assurez-vous qu'aucun NAT ne bloque le trafic UDP entrant -- Si votre serveur se trouve derrière une passerelle NAT (courant chez les fournisseurs cloud), assurez-vous que le NAT ou le groupe de sécurité redirige le trafic UDP sur le port choisi vers votre instance.

💬 Besoin d'aide supplémentaire ?

Si aucune des solutions ci-dessus ne résout votre problème, contactez notre équipe de support :

  • Discord (le plus rapide) : Ouvrez un ticket dans le canal #ticket
  • Telegram : @shredstream

Incluez votre identifiant de stream, la région du serveur et une description du problème afin que nous puissions vous aider rapidement.

Dépannage — Documentations | ShredStream.com