Gérer les agents de transfert sur site

Ce document explique comment administrer les agents du service de transfert des données sur site sur vos serveurs. Tous les agents sont assignés à un pool d'agents.

Installer et exécuter un agent sur site

Pour installer et exécuter un agent sur site, procédez comme suit :

Console

  1. Dans Cloud Console, accédez à la page Service de transfert des données sur site.

    Accéder au service de transfert des données sur site

  2. Cliquez sur Paramètres de connexion.

  3. Sélectionnez le pool d'agents auquel ajouter le nouvel agent.

  4. Cliquez sur Installer l'agent.

  5. Suivez les instructions pour installer et exécuter l'agent.

    Pour en savoir plus sur les options de ligne de commande de l'agent, consultez la section Options de ligne de commande de l'agent.

gcloud

Pour installer un ou plusieurs agents à l'aide de l'outil gcloud, procédez comme suit :

  1. Suivez les instructions pour configurer l'outil gcloud.

  2. Exécutez gcloud alpha transfer agents install :

    gcloud alpha transfer agents install --pool=POOL_NAME --count=1
    

    L'outil vous guide tout au long du processus d'installation des agents. Cette commande installe un agent sur votre ordinateur, mappé sur le nom de pool spécifié en tant que POOL_NAME, et authentifie l'agent à l'aide de vos identifiants gcloud. Si le nom du pool existe, une erreur est renvoyée.

Pour exécuter des agents à l'aide d'une clé de compte de service, utilisez l'option --creds-file :

gcloud alpha transfer agents install --pool=my-agent-pool --count=3 \
 --creds-file=/relative/path/to/service-account-key.json

Pour obtenir la liste complète des options facultatives, exécutez gcloud alpha transfer agents install --help.

Nous vous recommandons d'installer plusieurs agents par machine. Pour savoir comment déterminer le nombre d'agents à exécuter, consultez la section Optimiser les performances de l'agent de transfert.

Confirmer les connexions des agents

Après avoir installé vos agents sur site, vous pouvez vérifier qu'ils sont connectés au pool d'agents du service de transfert des données sur site.

Pour vérifier que vos agents sont bien connectés, procédez comme suit :

  1. Dans Cloud Console, accédez à la page Service de transfert des données sur site.

    Accéder au service de transfert des données sur site

  2. Cliquez sur Paramètres de connexion. Vos pools d'agents s'affichent, avec le nombre d'agents connectés.

  3. Sélectionnez un pool d'agents pour afficher les détails des agents connectés.

Si un nouvel agent n'apparaît pas sur la page du pool d'agents dans les dix minutes suivant sa création, consultez la section Les agents ne sont pas connectés.

Surveiller l'activité des agents

Vous pouvez surveiller l'activité des agents à l'aide des alertes Cloud Monitoring.

Pour ce faire, créez une alerte sur l'une des métriques Google Cloud suivantes :

Nom de la métrique Description Suggestions d'utilisation
storagetransfer.googleapis.com/agent/transferred_bytes_count Mesure la vitesse à laquelle un agent spécifique déplace des données (parmi toutes les tâches qu'il traite) à un instant donné. Alerte en cas de baisses de performances
storagetransfer.googleapis.com/agent/connected Valeur booléenne correspondant à True si un agent a récemment envoyé un message de pulsation à Google.
  • Alerte en cas d'agents défaillants
  • Chute du nombre d'agents sous un seuil que vous jugez nécessaire pour obtenir des performances raisonnables
  • Signalement d'un problème avec les machines agents

Arrêter un agent

Pour arrêter un agent, exécutez docker stop sur son ID de conteneur Docker. Pour trouver cet ID, procédez comme suit :

  1. Dans Cloud Console, accédez à la page Service de transfert des données sur site.

    Accéder au service de transfert des données sur site

  2. Cliquez sur Paramètres de connexion.

  3. Sélectionnez le pool d'agents contenant l'agent à arrêter.

  4. Sélectionnez un agent dans la liste. Utilisez le champ Filtre pour rechercher suivant un préfixe, l'état de l'agent, l'âge de l'agent, etc.

  5. Cliquez sur Arrêter l'agent. La commande docker stop s'affiche avec l'ID de conteneur spécifique.

  6. Exécutez la commande sur la machine sur laquelles s'exécute l'agent. Si la commande docker stop réussit, l'ID du conteneur est renvoyé.

Une fois arrêté, l'agent apparaît dans la liste des agents du pool comme étant déconnecté.