Surveillance de la file d'attente des tâches Apex
La page de configuration des tâches Apex présente des informations sur les tâches Apex, notamment le pourcentage d'utilisation de code Apex asynchrone et le nombre d'opérations Apex utilisées dans la limite de 24 heures de l'organisation. Surveillez le statut des tâches Apex afin d’anticiper les problèmes potentiels de limite avant qu'ils ne surviennent.
Éditions requises
| Disponible avec : Salesforce Classic (pas disponible dans toutes les organisations) et Lightning Experience |
| Disponible avec : Enterprise Edition, Performance Edition, Unlimited Edition, Developer Edition et Database.com Edition |
La file d'attente des tâches Apex répertorie toutes les tâches Apex qui ont été soumises pour exécution au cours des sept derniers jours. Si vous souhaitez afficher les tâches Apex datant de plus de sept jours, utilisez la page Toutes les tâches planifiées pour les tâches planifiées ou accédez-y par programmation via AsyncApexJob. Les tâches dont l'exécution est terminée sont répertoriées ainsi que celles qui ne sont pas terminées, notamment :
- Les méthodes Apex avec l'annotation
futurequi n'ont pas encore été exécutées. Ces tâches sont répertoriées dans la colonne Type de tâche et n'ont pas de valeurs dans les colonnes Nombre total de lots ou Lots traités. - Les classes Apex implémentant l'interface
Queueablequi n'ont pas encore été exécutées. Ces tâches sont répertoriées dans la colonne Type de tâche et n'ont pas de valeurs dans les colonnes Nombre total de lots ou Lots traités. - Tâches Apex planifiées dont l'exécution n'est pas encore terminée.
- Ces tâches sont répertoriées en tant qu'Apex planifiées dans la colonne Type de tâche, elles n'ont pas de valeurs dans les colonnes Nombre total de lots ou Lots traités, et ont toujours un statut En file d'attente.
- Les tâches planifiées ne peuvent pas être abandonnées depuis cette page. Utilisez la page Toutes les tâches planifiées pour les gérer ou les supprimer.
- Même si une tâche planifiée s'affiche à la fois dans les pages Tâches Apex et Toutes les tâches planifiées, elle est prise en compte une seule fois dans la limite en exécutions de code Apex asynchrone.
- Tâches en lots Apex de nouveau calcul de partage dont l'exécution n'est pas encore terminée. De telles tâches sont répertoriées comme Nouveau calcul de partage dans la colonne Type de tâche. Les enregistrements de tâche de nouveau calcul de partage sont automatiquement divisés en lots. La colonne Nombre total de lots indique le nombre total de lots pour cette tâche. La colonne Lots traités indique le nombre de lots ayant déjà été traités.
- Tâches Apex par lot dont l'exécution n'est pas encore terminée. De telles tâches sont répertoriées comme Apex par lot dans la colonne Type de tâche. Les enregistrements d'une tâche Apex par lot sont automatiquement divisés en lots. La colonne Nombre total de lots indique le nombre total de lots pour cette tâche. La colonne Lots traités indique le nombre de lots ayant déjà été traités.
Ce tableau répertorie toutes les valeurs de statut de tâche possibles. La colonne Statut indique le statut de la tâche. Valeurs possibles :
| Statut | Description |
|---|---|
| En file d'attente | La tâche est en attente d'exécution. |
| Préparation | La méthode start de la tâche a été invoquée. Ce statut peut durer quelques minutes, selon la taille du lot d'enregistrements. |
| Traitement en cours | La tâche est en cours de traitement. |
| Interrompue | La tâche a été interrompue par un utilisateur. |
| Terminée | La tâche a été exécutée avec ou sans échec. |
| Échouée | La tâche a rencontré une défaillance système. |
Les tâches Apex par lot peuvent également présenter le statut Holding lorsqu'elles sont retenues dans la file Flex Apex. Reportez-vous à Surveillance de la file d'attente Flex Apex.
Si une ou plusieurs erreurs se produisent au cours d'un traitement par lot, la colonne Détails de l'état fournit une courte description de la première erreur. Une description plus détaillée de cette erreur, et de toutes les erreurs ultérieures, est envoyée par e-mail à l'utilisateur qui a modifié la classe par lot.
Dans la page Tâches Apex, le numéro de la colonne Nombre total de lots peut être incorrect lors du traitement d'une tâche par lot importante. Pour afficher toutes les classes Apex par lot, cliquez sur le lien en haut de la page pour accéder à la page des tâches par lot. Cliquez sur Plus d'informations sur une classe par lot particulière pour afficher les tâches parentes de la classe par lot, y compris les informations suivantes :
- Statut
- Dates de soumission et de réalisation
- Délai écoulé pour chaque lot
- Nombre de lots traités
- Nombre de lots échoués
Pour afficher une liste d'éléments filtrée, sélectionnez une liste prédéfinie dans la liste déroulante Vue ou cliquez sur Créer une vue pour définir vos propres vues personnalisées. Les vues filtrées sont particulièrement utiles pour afficher uniquement les méthodes future.
Une seule méthode start d'une tâche Apex par lot peut être exécutée à la fois dans une organisation. Les tâches par lot qui n'ont pas encore commencé restent dans la file d'attente jusqu'à leur démarrage. Cette limite n'entraîne aucun échec de tâches par lot, et les méthodes execute des tâches Apex par lot continuent de s'exécuter en parallèle si plusieurs tâches simultanées sont en cours.
Pour n'importe quel type de tâche Apex, vous pouvez cliquez sur Interrompre la tâche dans la colonne Action pour arrêter la totalité du processus de cette tâche.
Toutes les tâches du lot dont l'exécution est terminée sont supprimées de la liste de la file d'attente sept jours après la date de fin de l'exécution.
Pour plus d'informations sur Apex, consultez Lightning Platform Apex Code Developer's Guide.
