翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ラベル付けジョブのステータスのモニタリング
ラベル付けジョブのステータスをモニタリングするには、ラベル付けジョブのステータスが `Completed`、`Failed`、または `Stopped` に変更されたとき、またはワーカーがタスクを受諾、拒否、送信、または返したときに、Amazon SageMaker Ground Truth (Ground Truth) がイベントを CloudWatch Events に送信するための [Amazon CloudWatch Events](https://docs.aws.amazon.com/sagemaker/latest/dg/monitoring-cloudwatch.html#cloudwatch-metrics-ground-truth) (CloudWatch Events) ルールを設定できます。
ルールを作成したら、それに*ターゲット*を追加できます。CloudWatch Events は、このターゲットを使用して別の AWS サービスを呼び出し、イベントを処理します。例えば、Amazon Simple Notification Service (Amazon SNS) トピックを使用してターゲットを作成し、ラベル付けジョブの状態が変化したときに通知メ－ルを送ることができます。
**前提条件**:
CloudWatch Events ルールを作成するには、events.amazonaws.com 信頼ポリシーがアタッチされた AWS Identity and Access Management (IAM) ロールが必要です。以下は、イベント.amazonaws.com 信頼ポリシーの例です。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": [
"events.amazonaws.com"
]
},
"Action": "sts:AssumeRole"
}
]
}
```
------
**Topics**
+ [CloudWatch Events にイベントを送信する](#sms-cloud-watch-event-rule-setup)
+ [イベントを処理するターゲットを設定する](#sms-cloud-watch-events-labelingjob-notifications)
+ [ラベル付けジョブの有効期限](#sms-labeling-job-expiration)
+ [タスクを拒否する](#sms-decline-tasks)
## CloudWatch Events にイベントを送信する
Ground Truth ラベル付けジョブのステータス更新または*イベント*を取得するように CloudWatch Events ルールを設定するには、 AWS Command Line Interface (AWS CLI) [https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html](https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html) コマンドを使用します。ルールに送信されるイベントは、ステータスの変更によってフィルタリングできます。例えば、ラベル付けジョブのステータスが `Completed` に変わった場合にのみ通知するルールを作成できます。`put-rule` コマンドを使用する場合は、ラベル付けジョブのステータスを受け取るために以下を指定します。
+ `\"source\":[\"aws.sagemaker\"]`
+ `\"detail-type\":[\"SageMaker Ground Truth Labeling Job State Change\"]`
すべてのステータスの変更をモニタリングする CloudWatch Events ルールを設定するには、次のコマンドを使用してプレースホルダテキストを置き換えます。例えば、`"GTLabelingJobStateChanges"` を一意の CloudWatch Events ルール名に置き換え、*`"arn:aws:iam::111122223333:role/MyRoleForThisRule"`* は events.amazonaws.com 信頼ポリシーがアタッチされた IAM ロールの Amazon リソース番号 (ARN) に置き換えます。
```
aws events put-rule --name "GTLabelingJobStateChanges"
--event-pattern "{\"source\":[\"aws.sagemaker\"],\"detail-type\":[\"SageMaker Ground Truth Labeling Job State Change\"]}"
--role-arn "arn:aws:iam::111122223333:role/MyRoleForThisRule"
--region "region"
```
ジョブのステータスでフィルタリングするには、`\"detail\":{\"LabelingJobStatus\":[\"Status\"]}}"` 構文を使用します。`Status` の有効値は、`Completed`、`Failed`、および `Stopped` です。
次の例では、us-west-2 (Oregon) のラベル付けジョブが `Completed` に変更されたときに通知する CloudWatch Events ルールを作成します。
```
aws events put-rule --name "LabelingJobCompleted"
--event-pattern "{\"source\":[\"aws.sagemaker\"],\"detail-type\":[\"SageMaker Ground Truth Labeling Job State Change\"], \"detail\":{\"LabelingJobStatus\":[\"Completed\"]}}"
--role-arn "arn:aws:iam::111122223333:role/MyRoleForThisRule"
--region us-west-2
```
次の例では、us-east-1 (Virginia) のラベル付けジョブが `Completed` または `Failed` に変更されたときに通知する CloudWatch Events ルールを作成します。
```
aws events put-rule --name "LabelingJobCompletedOrFailed"
--event-pattern "{\"source\":[\"aws.sagemaker\"],\"detail-type\":[\"SageMaker Ground Truth Labeling Job State Change\"], \"detail\":{\"LabelingJobStatus\":[\"Completed\", \"Failed\"]}}"
--role-arn "arn:aws:iam::111122223333:role/MyRoleForThisRule"
--region us-east-1
```
`put-rule` リクエストの詳細については、*Amazon CloudWatch Events ユーザーガイド*の「[CloudWatch Events のイベントパターン](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)」を参照してください。
## イベントを処理するターゲットを設定する
ルールを作成すると、次のようなイベントが CloudWatch Events に送信されます。この例では、ラベル付けジョブのステータス `test-labeling-job` が `Completed` に変更されました。
```
{
"version": "0",
"id": "111e1111-11d1-111f-b111-1111b11dcb11",
"detail-type": "SageMaker Ground Truth Labeling Job State Change",
"source": "aws.sagemaker",
"account": "111122223333",
"time": "2018-10-06T12:26:13Z",
"region": "us-east-1",
"resources": [
"arn:aws:sagemaker:us-east-1:111122223333:labeling-job/test-labeling-job"
],
"detail": {
"LabelingJobStatus": "Completed"
}
}
```
イベントを処理するには、ターゲットを設定する必要があります。例えば、ラベル付けジョブのステータス変更時にメールを受信する場合は、*Amazon CloudWatch ユーザーガイド*の「[Amazon SNS 通知の設定](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html)」に記載されている手順を使って Amazon SNS トピックを設定し、メールでそれをサブスクライブします。トピックを作成したら、このトピックを使用してターゲットを作成できます。
**CloudWatch Events ルールにターゲットを追加するには**
1. CloudWatch コンソール [https://console.aws.amazon.com/cloudwatch/home](https://console.aws.amazon.com/cloudwatch/home) を開きます。
1. ナビゲーションペインで **[ルール]** を選択します。
1. ターゲットを追加するルールを選択します。
1. **[アクション]** を選択し、**[編集]** を選択します。
1. **ターゲット** で、**ターゲットの追加** を選択し、ラベル付けジョブのステータス変更イベントが検出されたときに実行する AWS サービスを選択します。
1. ターゲットを設定します。手順については、[そのサービスのAWS ドキュメント](https://docs.aws.amazon.com/index.html)のターゲット設定に関するトピックを参照してください。
1. [**詳細の設定**] を選択します。
1. **[名前]** に名前を入力し、必要に応じて [**説明**] にルールの目的の詳細を入力します。
1. **[State]** (状態) のチェックボックスをオンにして、ルールが **[Enabled]** (有効) として表示されることを確認します。
1. [**ルールの更新**] を選択します。
## ラベル付けジョブの有効期限
ラベルリングジョブが 30 日経過しても完了しない場合は、有効期限が切れます。ラベルリングジョブの有効期限が切れた場合、ジョブを連鎖して、ラベル付けされていないデータのみワーカーに送信する新しいラベルリングジョブを作成できます。詳細についてと、および連鎖を使用してラベル付けジョブを作成する方法については、「[ラベリングジョブの連鎖](sms-reusing-data.md)」を参照してください。
## タスクを拒否する
ワーカーはタスクを拒否できます。
ワーカーは、指示が明確でない場合、入力データが正しく表示されない場合、またはタスクで他の問題が発生した場合、タスクを拒否します。データセットオブジェクトあたりのワーカー数 ([https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_HumanTaskConfig.html#sagemaker-Type-HumanTaskConfig-NumberOfHumanWorkersPerDataObject](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_HumanTaskConfig.html#sagemaker-Type-HumanTaskConfig-NumberOfHumanWorkersPerDataObject)) がタスクを拒否すると、データオブジェクトは期限切れとしてマークされ、追加のワーカーに送信されません。