Métriques Amazon SWF pour CloudWatch

Amazon SWF fournit désormais des métriques CloudWatch que vous pouvez utiliser pour suivre vos flux de travail et vos activités et définir des alarmes sur les valeurs de seuil que vous choisissez. Vous pouvez consulter les statistiques à l'aide du AWS Management Console. Pour plus d’informations, consultez Affichage des métriques Amazon SWF pour CloudWatch viaAWS Management Console.

Unités de reporting pour les métriques Amazon SWF

Métriques qui indiquent un intervalle de temps

Certaines mesures Amazon SWF concernent les intervalles de temps, toujours mesurés en millisecondes. CloudWatch L' CloudWatch unité est signalée commeTime. Ces métriques correspondent généralement aux étapes d'exécution de flux de travail pour lesquelles vous pouvez définir des délais d'activité et de flux de travail, et utiliser des noms similaires.

Par exemple, la métrique DecisionTaskStartToCloseTime mesure le temps nécessaire pour que la tâche de décision soit menée à bien après le début de l'exécution, ce qui correspond à la période pour laquelle vous pouvez définir une valeur DecisionTaskStartToCloseTimeout.

Pour afficher le schéma de chacune de ces étapes et pour découvrir quand elles ont lieu dans le cycle de vie des flux de travail et des activités, consultez la section Types Amazon SWF Timeout .

Métriques qui indiquent un nombre

Certaines mesures Amazon SWF relatives aux résultats des CloudWatch rapports sont dénombrées. Par exemple, WorkflowsCanceled enregistre le résultat sous la forme du numéro un ou zéro pour indiquer si le flux de travail a été annulé ou non. Une valeur de zéro n'indique pas que cette métrique n'a pas été fournie, mais que la condition décrite par la métrique ne s'est pas produite.

Certaines des mesures Amazon SWF associées à CloudWatch ce rapport CloudWatch sont exprimées Count en nombre par seconde. Par exempleProvisionedRefillRate, ce qui est indiqué sous forme CloudWatch d'Countentrée représente le taux Count de demandes par seconde.

Pour les métriques chiffrées, le minimum et le maximum seront toujours zéro ou un, avec une valeur allant de zéro à un comme moyenne.

Métriques des événements d'API et de décision

Vous pouvez surveiller à la fois les événements liés à l'API et CloudWatch aux décisions pour obtenir un aperçu de votre utilisation et de vos capacités. Consultez les décideurs dans la Fonctionnement d'Amazon SWF section et la rubrique Décision dans le manuel Amazon Simple Workflow Service API Reference.

Vous pouvez également surveiller ces limites pour déclencher une alarme lorsque vous approchez de vos limites de régulation Amazon SWF. Consultez Limitation des quotas Amazon SWF pour obtenir une description de ces limites, ainsi que leurs paramètres par défaut. Ces limites sont conçues pour empêcher que des flux de travail incorrects utilisent des ressources système excessives. Pour demander une augmentation de vos limites, consultez Demande d'augmentation de quota.

Il est recommandé de configurer les CloudWatch alarmes à environ 60 % de la capacité de votre API ou de vos événements décisionnels. Cela vous permettra soit d'ajuster votre flux de travail, soit de demander une augmentation de la limite de service, avant d'activer la régulation Amazon SWF. En fonction des variations de vos appels, vous pouvez configurer différentes alarmes afin d'être averti lorsque vous approchez les limites du service :

• Si votre trafic présente des pics importants, définissez une alarme à 60 % de vos limites ProvisionedBucketSize.

• Si vos appels sont relativement réguliers, définissez une alarme à 60 % de votre limite ProvisionedRefillRate pour les événements d'API et de décision associés.

Métriques Amazon SWF

Les mesures suivantes sont disponibles pour Amazon SWF :

Métrique	Description
DecisionTaskScheduleToStartTime	Intervalle de temps, en millisecondes, entre le moment où la tâche de décision a été planifiée et le moment où elle a été traitée par un employé et démarrée. CloudWatch Unités : Time Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Average, Minimum, Maximum
DecisionTaskStartToCloseTime	Intervalle de temps, en millisecondes, entre le moment où la tâche de décision a été démarrée et le moment où elle a été clôturée. CloudWatch Unités : Time Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Average, Minimum, Maximum
DecisionTasksCompleted	Nombre de tâches de décision qui ont été effectuées. CloudWatch Unités : Count Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Sum
PendingTasks	Nombre de tâches en attente dans un intervalle de 1 minute pour une liste des tâches spécifique. CloudWatch Unités : Count Dimensions : Domain, TaskListName Statistiques valides : Sum
StartedDecisionTasksTimedOutOnClose	Nombre de tâches de décision qui ont été démarrées mais ayant expiré à la clôture. CloudWatch Unités : Count Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Sum
WorkflowStartToCloseTime	Durée, en millisecondes, entre le moment où le flux de travail a démarré et le moment où il a été clôturé. CloudWatch Unités : Time Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Average, Minimum, Maximum
WorkflowsCanceled	Nombre de flux de travail ayant été annulés. CloudWatch Unités : Count Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Sum
WorkflowsCompleted	Nombre de flux de travail terminés. CloudWatch Unités : Count Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Sum
WorkflowsContinuedAsNew	Nombre de flux de travail toujours considérés comme nouveaux. CloudWatch Unités : Count Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Sum
WorkflowsFailed	Nombre de flux de travail ayant échoué. CloudWatch Unités : Count Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Sum
WorkflowsTerminated	Nombre de flux de travail ayant été achevés. CloudWatch Unités : Count Dimensions : Cause, Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Sum
WorkflowsTimedOut	Nombre de flux de travail ayant expiré, pour une raison quelconque. CloudWatch Unités : Count Dimensions : Domain, WorkflowTypeName, WorkflowTypeVersion Statistiques valides : Sum
ActivityTaskScheduleToCloseTime	Intervalle de temps, en millisecondes, entre le moment où l'activité a été planifiée et le moment où elle est clôturée. CloudWatch Unités : Time Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Average, Minimum, Maximum
ActivityTaskScheduleToStartTime	Intervalle de temps, en millisecondes, entre le moment où la tâche d'activité a été planifiée et le moment où elle a été démarrée. CloudWatch Unités : Time Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Average, Minimum, Maximum
ActivityTaskStartToCloseTime	Intervalle de temps, en millisecondes, entre le moment où la tâche d'activité a été démarrée et le moment où elle a été clôturée. CloudWatch Unités : Time Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Average, Minimum, Maximum
ActivityTasksCanceled	Nombre de tâches d'activité ayant été annulées. CloudWatch Unités : Count Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Sum
ActivityTasksCompleted	Nombre de tâches d'activité ayant été effectuées. CloudWatch Unités : Count Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Sum
ActivityTasksFailed	Nombre de tâches d'activité ayant échoué. CloudWatch Unités : Count Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Sum
ScheduledActivityTasksTimedOutOnClose	Nombre de tâches d'activité qui ont été planifiées mais ayant expiré lors de la clôture. CloudWatch Unités : Count Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Sum
ScheduledActivityTasksTimedOutOnStart	Nombre de tâches d'activité qui ont été planifiées mais ayant expiré lors du démarrage. CloudWatch Unités : Count Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Sum
StartedActivityTasksTimedOutOnClose	Nombre de tâches d'activité qui ont été démarrées mais ayant expiré lors de la clôture. CloudWatch Unités : Count Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Sum
StartedActivityTasksTimedOutOnHeartbeat	Nombre de tâches d'activité qui ont été démarrées mais ayant expiré en raison d'un délai d'attente des pulsations. CloudWatch Unités : Count Dimensions : Domain, ActivityTypeName, ActivityTypeVersion Statistiques valides : Sum
ThrottledEvents	Nombre de demandes ayant été limitées. CloudWatch Unités : Count Dimensions : APIName, DecisionName, ThrottlingScope Statistiques valides : Sum
ProvisionedBucketSize	Nombre de demandes disponibles par seconde. Dimensions : APIName, DecisionName Statistiques valides : Minimum
ConsumedCapacity	Nombre de demandes par seconde. CloudWatch Unités : Count Dimensions : APIName, DecisionName Statistiques valides : Sum
ConsumedLimit	Le montant de la limite générale qui a été consommé. Dimensions : GeneralLimitType
ProvisionedRefillRate	Nombre de demandes par seconde autorisées dans le compartiment. Dimensions : APIName, DecisionName Statistiques valides : Minimum
ProvisionedLimit	Le montant de la limite générale allouée au compte. Dimensions : GeneralLimitType

Dimension	Description
Domain	Filtre les données vers le domaine Amazon SWF dans lequel le flux de travail ou l'activité s'exécute.
ActivityTypeName	Filtre les données sur le nom du type d'activité.
ActivityTypeVersion	Filtre les données sur la version du type d'activité.
WorkflowTypeName	Filtre les données sur le nom du type de flux de travail pour l'exécution de ce flux de travail.
WorkflowTypeVersion	Filtre les données sur la version du type de flux de travail pour l'exécution de ce flux de travail.
APIName	Filtre les données sur une API correspondant au nom d'API spécifié.
DecisionName	Filtre les données sur le nom de décision spécifié.
TaskListName	Filtre les données sur le nom Liste des tâches spécifié.
TaskListClassification	Filtre les données en fonction de la classification de la liste des tâches. La valeur est « D » pour les listes de tâches décisionnelles et « A » pour les listes de tâches d'activité.
ThrottlingScope	Filtre les données selon l'étendue de régulation spécifiée. La valeur est « Compte » en cas de dépassement du quota au niveau du compte, ou « Workflow » en cas de dépassement du quota au niveau du flux de travail.

Noms et dimensions des ressources non ASCII Amazon SWF CloudWatch

Amazon SWF autorise les caractères non ASCII dans les noms de ressources tels que et. TaskList DomainName Toutefois, les valeurs dimensionnelles des CloudWatch métriques ne peuvent contenir que des caractères ASCII imprimables. Pour garantir qu'Amazon SWF utilise des valeurs de dimension compatibles avec les CloudWatch exigences, les noms de ressources Amazon SWF qui ne répondent pas à ces exigences sont convertis et une somme de contrôle sera ajoutée comme suit :

• Tout caractère non ASCII est remplacé par. ?

• La chaîne d'entrée ou la chaîne convertie sera, si nécessaire, tronquée. Cela garantit que lorsque la somme de contrôle est ajoutée, la nouvelle longueur de chaîne ne dépassera pas le CloudWatch maximum.

• Étant donné que tous les caractères non ASCII sont convertis en caractères?, certaines valeurs de dimension CloudWatch métrique qui étaient différentes avant la conversion peuvent sembler identiques après la conversion. Pour aider à les différencier, un trait de soulignement (_) suivi des 16 premiers caractères de la somme de contrôle SHA256 du nom de ressource d'origine est ajouté au nom de la ressource.

Exemples de conversion :

• test àppleserait converti en test ?pple_82cc5b8e3a771d12

• àòàserait converti en???_2fec5edbb2c05c22.

• Les TaskList noms àpplé et les deux âpplè seraient convertis en?ppl?, et seraient identiques. L'ajout de la somme de contrôle renvoie des valeurs distinctes, et?ppl?_f39a36df9d85a69d. ?ppl?_da3efb4f11dd0f7f

Astuce

Vous pouvez générer votre propre somme de contrôle SHA256. Par exemple, pour utiliser l'outil de ligne de shasum commande :

echo -n "<the original resource name>" | shasum -a 256 | cut -c1-16