Mise en file d'attente de priorité d'ingestion de livraison dynamique

Cette rubrique explique comment utiliser le paramètre de priorité pour optimiser le temps d'ingestion des vidéos hautement prioritaires.

Introduction

Dynamic Delivery Ingest dispose désormais d'une fonctionnalité appelée File d'attente prioritaire qui permettent aux éditeurs de nous soumettre des travaux d'ingestion avec un paramètre de priorité souhaité pour influencer l'ordre et la rapidité de traitement du travail.

Fonctionnement de la file d'attente d'ingestion Dynamic Delivery

Avec la mise en file d'attente prioritaire normale, l'ingestion de livraison dynamique a une limite de 100 tâches actives par compte. Lorsque cette limite est dépassée, le système d'ingestion met en file d'attente des demandes supplémentaires pour un traitement ultérieur. La taille de la file d'attente a une limite distincte, et lorsque celle-ci est atteinte, elle rejette la demande d'ingestion au client (avec un code d'erreur 429). Lorsque les travaux sont terminés, la capacité est libérée et les travaux en file d'attente sont récupérés et traités un par un, dans l'ordre où ils ont été reçus.

L'état de la vidéo dans le CMS API ne reflète pas que la tâche a été mise en file d'attente - l'état sera de pending savoir si la tâche est traitée ou mise en file d'attente.

Comment la file d'attente prioritaire affecte l'ingestion

La file d'attente prioritaire permet à l'utilisateur d'ajouter un priority indicateur à une demande d'ingestion. Les valeurs admissibles pour priority sommes low et normal . Toute autre valeur entraînera le rejet de la demande avec un code d'erreur 422. Lorsque l'utilisateur ne spécifie aucune priorité, la valeur par défaut de normal est utilisé. Voici une brève description de la façon dont Priority Queuing modifie la façon dont les travaux sont traités à partir de la file d'attente :

  1. S'il n'y a pas de travaux en file d'attente et qu'il existe une capacité pour exécuter un travail, le travail est exécuté immédiatement. Cela s'applique à la fois aux tâches de priorité faible et normale.
  2. S'il n'y a pas de capacité pour l'exécution d'un autre travail, le travail est mis en file d'attente.
  3. S'il y a des tâches dans la file d'attente, toutes les nouvelles tâches sont également mises en file d'attente. Cela signifie qu'un nouveau travail ne peut pas démarrer avant les travaux en file d'attente.
  4. Lorsqu'il est possible d'exécuter une autre tâche et qu'il y a des tâches en file d'attente, une tâche est extraite de la file d'attente :
    • S'il y a TOUT travail prioritaire normal dans la file d'attente, le travail prioritaire normal le plus ancien sera sélectionné.
    • S'il n'y a AUCUNE tâche à priorité normale dans la file d'attente, la tâche à faible priorité la plus ancienne sera sélectionnée.
  5. Les travaux de priorité normale et faible sont traités comme même pour combien de tâches en cours il peut y avoir. Le nombre total de travaux traités, quelle que soit leur priorité, est limité à 100 par compte.
  6. Il y a séparé quotas pour le nombre de tâches normales et de faible priorité pouvant être mises en file d'attente.
  7. Chaque compte est limité à 1000 travaux en attente dans la file d'attente de faible priorité à un moment donné.
  8. Chaque compte est limité à 1000 travaux en attente dans la file d'attente prioritaire normale à un moment donné.

À quoi faire attention

Les détails du rendu ont été modifiés après la soumission d'un travail

Lorsque vous créez une tâche d'ingestion dynamique, le profil d'ingestion spécifié est copié par le système d'ingestion dynamique, et ce profil copie sera utilisé pour le traitement même si le profil a été modifié depuis que le travail a été soumis.

Pour les tâches à faible priorité, dont le traitement peut être retardé pendant un certain temps dans certains cas, les rendus spécifiés dans ce profil pourraient être modifiés avant que le travail ne soit réellement traité. Si cela se produit, les rendus utilisés pour traiter la vidéo seront les NOUVEAU définition de ces restitutions ; pas la définition des rendus au moment où le travail a été soumis.

Si vous souhaitez garantie vous obtenez les rendus tels qu'ils ont été spécifiés lors de la soumission du travail , vous devez faire des copies des rendus et créer un nouveau profil qui référence ces rendus copiés, puis démarrer le processus d'intégration. (Vous pouvez retranscoder la vidéo avec le profil mis à jour si la vidéo a déjà été placée dans Video Cloud. N'oubliez pas que vous ne pouvez pas retranscoder la vidéo tant que le traitement de la tâche d'origine n'est pas terminé.)

Téléchargement du fichier source

Le téléchargement du fichier source supprimera les fichiers de ce compartiment S3 après 24 heures. Étant donné que les tâches de faible priorité peuvent ne pas être traitées pendant plus de 24 heures dans certains cas, le ou les fichiers peuvent avoir déjà été supprimés et le traitement échouera dans ce cas. Nous ne recommandons pas l'ingestion de faible priorité pour l'importation de fichiers sources.

Exemples de demandes

Vous trouverez ci-dessous un exemple de corps de requête d'ingestion de faible priorité :

    {
    "master": {
    "url": "https://host/master.mp4"
    },
    "profile": "multi-platform-extended-static",
    "priority": "low",
    "callbacks": [
    "https://mydomain.com/di-callbacks.php"
    ]
    }

Et voici un exemple de tâche prioritaire normale :

    {
    "master": {
    "url": "https://host/master.mp4"
    },
    "profile": "multi-platform-extended-static",
    "priority": "normal",
    "callbacks": [
    "https://mydomain.com/di-callbacks.php"
    ]
    }

A noter que depuis normal est la valeur par défaut, la requête précédente serait traitée exactement de la même manière que la suivante :

    {
    "master": {
    "url": "https://host/master.mp4"
    },
    "profile": "multi-platform-extended-static",
    "callbacks": [
    "https://mydomain.com/di-callbacks.php"
    ]
    }

Utilisation de la file d'attente prioritaire

D'après le dernier exemple de la section précédente, il devrait être clair que si vous ne pas Utilisez le priority dans vos tâches d'ingestion, elles continueront à être traitées exactement comme elles l'ont été.

L'ajout du priority domaine vous profitera principalement si :

  1. Vous ingérez un assez grand nombre de vidéos
  2. Il est essentiel de mettre certaines de vos vidéos en ligne dès que possible, alors qu'il n'y a pas d'urgence de publier d'autres vidéos (parce que le contenu est moins important, ou vous n'avez pas l'intention de publier les vidéos immédiatement de toute façon)
  3. Vous avez des vidéos que vous souhaitez retranscoder, mais vous ne voulez pas que cela ralentisse l'ingestion de nouveau contenu

Fonctionnement de la file d'attente à faible priorité

Cette section explique le fonctionnement de la file d'attente à faible priorité.

Il n'y a aucune garantie quand les tâches normales ou de faible priorité seront démarrées. Cependant, les travaux à priorité normale seront toujours lancés avant les travaux à faible priorité.

Si votre taux de soumission de travaux à priorité normale est stable et rapide, le démarrage des travaux à faible priorité peut prendre un temps considérable.

Les tâches à faible priorité peuvent prendre plus de temps à démarrer et à traiter que la priorité normale pour la même vidéo.