Résoudre les problèmes courants

Consultez les sections suivantes pour obtenir de l'aide en cas de problème.

État perdu dans Fleet Engine

Lorsque vous travaillez avec Fleet Engine, concevez votre implémentation de manière à anticiper les défaillances. Par exemple, si vous envoyez une requête à Fleet Engine pour mettre à jour un véhicule, il peut renvoyer une erreur indiquant que le véhicule n'existe pas. Votre implémentation doit ensuite recréer le véhicule dans le nouvel état.

Dans le cas extrêmement improbable d'une défaillance catastrophique de Fleet Engine, vous devrez peut-être recréer la plupart ou la totalité des véhicules et des tâches. Si le taux de création devient trop élevé, certaines requêtes peuvent à nouveau échouer en raison de problèmes de quota, car des vérifications de quota sont en place pour éviter les attaques par déni de service (DoS). Dans ce cas, ralentissez le taux de recréation en utilisant une stratégie d'intervalle entre les tentatives.

Tentatives

Assurez-vous que votre système implémente des nouvelles tentatives pour les requêtes envoyées à Fleet Engine, car elles peuvent échouer occasionnellement. Les bibliothèques clientes Fleet Engine effectuent des nouvelles tentatives par défaut.

État perdu dans l'application du conducteur

Si l'application du conducteur plante, elle doit recréer l'état actuel dans le SDK Driver. L'application doit tenter de recréer les tâches pour s'assurer qu'elles existent et pour restaurer leur état actuel. L'application doit également recréer et définir explicitement la liste des arrêts pour le SDK Driver.

Remarque : Ces restaurations doivent être effectuées de manière autonome, sans s'appuyer sur les informations de Fleet Engine, à l'exception des erreurs indiquant si une entité existe déjà dans la base de données et à quel moment. Si une entité existe déjà, cette erreur peut être absorbée et l'entité peut être mise à jour à l'aide de son ID.

Erreurs de dépassement de délai

Si vous obtenez une erreur DEADLINE_EXCEEDED lors de l'appel de Fleet Engine, cela signifie que la requête a pris plus de temps que le délai avant expiration configuré. Les bibliothèques clientes Fleet Engine ont des délais avant expiration par défaut, mais vous devrez peut-être les ajuster.

Pour obtenir des informations générales sur les délais gRPC, consultez gRPC et délais.

Pour configurer le délai avant expiration lorsque vous utilisez la bibliothèque cliente Java Fleet Engine, vous pouvez ajuster les paramètres de nouvelle tentative RPC. L'exemple suivant montre comment configurer un délai avant expiration personnalisé lors de la configuration de VehicleService :

VehicleServiceSettings.Builder settingsBuilder = VehicleServiceSettings.newBuilder();

// Set the timeout to 10 seconds.
settingsBuilder
    .getVehicleSettings()
    .setRetrySettings(
        settingsBuilder.getVehicleSettings().getRetrySettings().toBuilder()
            .setTotalTimeout(java.time.Duration.ofSeconds(10))
            .build());

VehicleServiceClient client = VehicleServiceClient.create(settingsBuilder.build());

Erreurs d'API courantes

Cette section liste les erreurs d'API courantes que vous pouvez rencontrer, leurs causes et comment les résoudre.

NOT_FOUND (HTTP 404)

L'entité demandée (par exemple, un véhicule, un trajet ou une tâche) est introuvable.

  • Cause : généralement causée par une tentative d'obtention, de mise à jour ou de suppression d'une entité à l'aide d'un ID qui n'existe pas dans la base de données.
  • Correction : vérifiez que l'ID d'entité est correct et que l'entité a bien été créée avant d'essayer d'y accéder.

ALREADY_EXISTS (HTTP 409)

L'entité que vous essayez de créer existe déjà.

  • Cause : ce problème est dû à l'appel d'une méthode de création (comme CreateVehicle ou CreateTrip) avec un ID déjà utilisé.
  • Correction : mettez à jour l'entité existante ou utilisez un nouvel identifiant unique pour la requête de création.

PERMISSION_DENIED (HTTP 403)

Vous ne disposez pas des autorisations nécessaires pour effectuer la demande.

  • Cause : cela se produit généralement si votre jeton Web JSON (JWT) ne contient pas les revendications appropriées ou si le compte de service signant le jeton JWT ne dispose pas des rôles IAM requis. Par exemple, "Le jeton JWT ne contient pas de champ d'application correspondant au trajet demandé".
  • Correction : vérifiez les autorisations de votre compte de service et assurez-vous que vos revendications JWT incluent les champs d'application appropriés pour l'entité à laquelle vous essayez d'accéder.

INVALID_ARGUMENT (HTTP 400)

Un ou plusieurs des arguments transmis dans la requête ne sont pas valides.

  • Cause : cela peut se produire pour diverses raisons, par exemple si vous fournissez une valeur hors plage (par exemple, la capacité maximale), si un champ obligatoire est manquant (par exemple, un VehicleType) ou si vous fournissez des coordonnées non valides pour un point de retrait.
  • Correction : examinez le message d'erreur pour identifier le champ non valide et assurez-vous que votre requête est conforme à la spécification de l'API.

FAILED_PRECONDITION (HTTP 400)

L'opération a été rejetée, car le système n'est pas dans un état requis pour exécuter l'opération.

  • Cause : les causes courantes incluent la tentative de modification d'un trajet COMPLETE ou CANCELED vers un autre état, ou la tentative d'attribution d'une tâche CLOSED à un véhicule.
  • Correction : assurez-vous que l'état actuel de l'entité autorise l'opération que vous tentez d'effectuer. Consultez le message d'erreur pour connaître les violations d'état spécifiques.

UNAVAILABLE (HTTP 503)

Le service est indisponible.

  • Cause : cela indique un problème temporaire avec le service Fleet Engine.
  • Correction : la requête peut être relancée en toute sécurité avec un intervalle exponentiel entre les tentatives.