Résolution des problèmes

Questions fréquemment posées

Est-ce que Relay protège-t-il contre les attaques DDoS?

Le domaine Relay est un enregistrement DNS supplémentaire sous uipath.com, servi par Cloudflare. La protection DDoS est gérée par Cloudflare, conformément à la façon dont cloud.uipath.com est protégé.

Tous les clients de relais doivent-ils être déployés dans la même région?

Non. Les clients de relais se connectent à l'API de relais via la couche de routage standard, quel que soit l'endroit où ils sont physiquement déployés. Cependant, pour de meilleures performances, en particulier pour les scénarios de charge utile importante tels que BYO LLM, déployez le client de relais dans la même région géographique que votre locataire Test Cloud. Les tunnels inter-régions ajoutent une latence égale au temps d'aller-retour entre les régions.

Quelles sont les attentes en matière de latence?

La latence et le débit dépendent de la taille de la charge utile, de la distance géographique entre le nœud Relay et le serveur Relay, ainsi que de la capacité du nœud Relay. Les déploiements dans la même région ajoutent des frais généraux minimaux. Les tunnels inter-régions ajoutent une latence égale au temps d'aller-retour du réseau entre les régions.

Que se passe-t-il si le client de relais perd la connectivité?

Le client de relais se reconnecte automatiquement via un retrait exponentiel, avec des intervalles de 20 secondes. Le service d'arrière-plan redémarre automatiquement en cas de plantage et au redémarrage du système. Aucune intervention manuelle n’est requise pour les problèmes de réseau temporaires. Pour les déconnexions persistantes causées par des délais d'expiration de connexion inactive sur les appareils réseau, activez la reconnexion proactive. Voir Déploiement du client de relais.

A-t-on besoin de différents nœuds de Relay pour différents locataires?

Non. Le même nœud de relais peut exécuter simultanément le processus du client de relais pour plusieurs locataires.

Quand faut-il créer plusieurs groupes de Relay?

Plusieurs groupes de Relay sont recommandés uniquement pour la ségrégation du réseau. Par exemple, si vous avez Jira sur le réseau 1 et SAP sur le réseau 2, vous pouvez créer deux groupes de relais avec Jira dans l'un et un point de terminaison SAP dans l'autre. Vous pouvez exécuter les processus du client de relais pour ces groupes dans deux machines virtuelles ayant accès aux réseaux respectifs.

Le nombre de points de terminaison locaux par groupe de Relay est-il limité?

Il n'y a pas de limites strictes. Avec un trafic modéré (1 à 10 requêtes par seconde par point de terminaison), nous recommandons jusqu’à 50 points de terminaison par groupe. Avec un trafic plus faible, jusqu’à 100 points de terminaison par groupe sont pris en charge.

Puis-je exécuter plusieurs clients de relais sur la même machine?

Oui. Chaque groupe de Relay dispose de son propre service d’arrière-plan, de son propre répertoire de données et de son propre répertoire de journaux. Utilisez relay list pour voir tous les clients de relais installés et leur statut.

Puis-je déplacer un client de relais vers une autre machine?

Non. Les informations d'identification sont chiffrées avec des clés spécifiques à la machine — AES-256-GCM sous Linux, DPAPI sous Windows. Pour déplacer, supprimez le client de relais sur l'ancienne machine et réenregistrez-le sur la nouvelle machine avec une nouvelle configuration à partir de l'administration UiPath.

Que se passe-t-il si je clone une machine virtuelle sur laquelle un client de relais est installé?

Le déchiffrement des informations d’identification échoue sur le clonage, car l’identité de la machine diffère. Exécutez relay delete <id> --force sur le clone et réenregistrez-le avec une nouvelle configuration.

Comment mettre à jour le fichier binaire du client de relais?

Téléchargez le nouveau binaire et exécutez relay restart <id>. La commande de redémarrage détecte le fichier binaire mis à jour et applique la modification sans nécessiter de réinstallation complète.

Quelles données le client de relais stocke-t-il sur le disque?

Configuration client chiffrée, configuration du proxy extraite du cloud et fichiers journaux. Aucune donnée d'application n'est écrite sur le disque - le client de relais diffuse le trafic en mémoire.

Puis-je modifier la configuration du proxy une fois le client de relais installé?

Oui. Mettez à jour la variable d’environnement du proxy et exécutez relay restart <id> pour appliquer la modification.

Pourquoi mon proxy nécessite-t-il des informations d’identification, mais le client de relais se connecte sans ces informations?

La variable d'environnement n'est probablement pas transmise au service d'arrière-plan. Sur Linux: réexécutez avec sudo -E ou exécutez relay restart <id> Sur Windows: définissez le proxy au niveau du système plutôt que dans l'environnement utilisateur.

J’ai ajouté un nouveau point de terminaison dans l’administration UiPath — dois-je redémarrer le client de relais?

Non. Les modifications de configuration sont automatiquement transmises à un client de relais en cours d'exécution sans interruption des connexions en vol. Si le point de terminaison nouvellement ajouté renvoie 404, la transmission n'a pas encore été appliquée, exécutez relay reload <id> comme solution de secours.

Problèmes couramment rencontrés

Si le problème ci-dessous ne résout pas votre problème, collectez un package d'assistance et contactez le support UiPath.

Symptôme	Origine	Résolution
cloud portal unreachable	Port de blocage du pare-feu 443	Autoriser HTTPS sortant à cloud.uipath.com:443
authentication failed	Informations d’identification non valides ou expirées	Régénérez la configuration du client à partir du groupe de relais dans l'administration UiPath
relay server unreachable	Le pare-feu bloque le TCP sortant vers le serveur de relais; la vérification de connectivité en amont ne peut pas terminer l'établissement de la liaison TCP	Autoriser le TCP sortant vers <region>-relay.uipath.com:443 à partir du nœud Relay
Erreurs d'établissement de liaison TLS, réinitialisation de la connexion ou unexpected EOF récurrent après la réussite de la connexion TCP	Le proxy d’inspection TLS, le DLP ou l’appareil IDS intercepte la session vers le serveur de relais (le passage TLS est requis)	Configurez votre proxy ou votre pare-feu pour contourner l’inspection TLS pour <region>-relay.uipath.com:443. La vérification en amont réussit, car le protocole TCP est accessible — l'arrêt n'apparaît qu'une fois que le relais tente d'établir la liaison TLS
provisioning timed out after 60s	Latence du réseau ou délai du proxy	Vérifiez la connectivité et les paramètres proxy; Réessayer
maximum number of allowed agents	Le groupe a atteint sa limite de clients de relais	Supprimez les clients de relais inutilisés du groupe ou créez un nouveau groupe de relais
config input is empty	Valeur --config vide ou fichier de configuration vide	Vérifiez que la chaîne ou le fichier de configuration n’est pas vide
relay is already running	relay start en double pour un groupe dont le service est déjà actif	Exécutez relay stop <id>, puis relay restart <id>
relay for group "<id>" is already installed as a system service	Un client de relais pour ce groupe est déjà installé sur la machine	Exécuter relay delete <id>, puis réinstaller
ID mismatch au redémarrage	Le fichier de configuration appartient à un autre groupe	Vérifiez que vous utilisez le bon fichier de configuration pour l’ID de relais
credentials: decryption failed	Fichier de clé AES manquant ou corrompu (Linux), ou modification de l’identité DPAPI	Linux: si le fichier de clé a été supprimé, enregistrez à nouveau le Relay. Windows: courant après le clonage ou la réimage de la MV — réenregistrer le Relay. Le réenregistrement indique relay delete <id> suivi de relay start avec la nouvelle configuration
La désinscription échoue lors de la suppression	Informations d’identification perdues ou objets côté cloud déjà supprimés	Utiliser relay delete <id> --force pour ignorer la désinscription du cloud
host unreachable via proxy	Le proxy ne peut pas atteindre la cible	Vérifiez que l’URL du proxy est correcte; vérifier les journaux du proxy; confirmer que le proxy autorise Connecter au port 443
cannot reach proxy	L’adresse du proxy est inaccessible	Vérifiez que l’hôte et le port du proxy sont corrects et accessibles depuis le nœud Relay
proxy CONNECT rejected (407)	Le proxy nécessite l’authentification	Ajoutez des informations d’identification à l’URL du proxy: http://user:password@proxy:port
Variable d’environnement proxy définie, mais le relais se connecte directement	Variable d'environnement non transmise au service	Linux: réexécutez avec sudo -E ou exécutez relay restart <id>. Windows: définir le proxy au niveau du système
Le relais se reconnecte à plusieurs reprises	Délai d’expiration du réseau ou de la connexion inactive silencieuse	Vérifiez la connectivité; envisager d'activer la reconnexion proactive
Le client de relais ne peut pas atteindre le point de terminaison local	La machine du client de relais n’a pas d’accès réseau à la cible	Confirmer que le nœud Relay dispose d’un accès réseau direct au point de terminaison local
Erreur TLS lors de la connexion au point de terminaison local	Certificat CA non approuvé par le magasin d'approbation du système d'exploitation du nœud de relais	Ajouter le certificat CA émetteur au magasin approuvé du système d’exploitation du nœud Relay

Collecter un package d'assistance

Si aucun des problèmes ou solutions décrits sur cette page ne s'applique à votre scénario, signalez le problème à l'assistance UiPath en collectant un package d'assistance — une archive compressée contenant la configuration, les journaux et les détails système nécessaires au diagnostic. Les informations d’identification et les clés de chiffrement ne sont jamais incluses.

# Collect for all relay clients on this machine
relay support-bundle

# Collect for a specific relay client
relay support-bundle <id>

# Write to a specific directory
relay support-bundle --output-dir /path/to/dir

L'archive est écrite dans le répertoire actuel par défaut (.tar.gz sous Linux, .zip sous Windows). Partagez l'archive et son hachage SHA-256 avec l'assistance UiPath.

Exemple de sortie :

Collecting support bundle...
  [1/2] Relay metadata and configuration... (2 groups)
  [2/2] Relay logs...

✓ Support bundle created: support-bundle-relay01-20260413-150405.tar.gz (3.1 MiB)
  SHA256: a1b2c3d4e5f6789abcdef0123456789abcdef0123456789abcdef0123456789

Éléments inclus

Fichier	Contenus
bundle-info.json	Métadonnées du bundle: version du relais, nom d'hôte, système d'exploitation, architecture, heure de la collection
relay-version.txt	Version du relais, date de création et validation de git
relay-list.json	Tous les groupes de Relay sur cette machine avec ce statut
groups/<id>/data/	Métadonnées par groupe (metadata.json)
groups/<id>/logs/	Fichiers journaux de relais par groupe
errors.log	Avertissements de collection non fatals (affichés uniquement si des avertissements se sont produits)

Ce qui est exclu

Exclu	Raison
client_config	Contient les informations d’identification client chiffrées
*.key Files	Clés de chiffrement AES (Linux uniquement)
Liens systémiques	Empêche la navigation du chemin en dehors du bundle

Remarque :

Linux: les groupes installés en tant que services système nécessitent sudo relay support-bundle. Les groupes en mode utilisateur ne le sont pas. Si la commande ignore un groupe avec un avertissement d'autorisation, réexécutez-le avec sudo.