Amazon EventBridge 와 함께 사용 Amazon Transcribe

를 사용하면 다른 작업에서 이벤트를 시작하여 Amazon Transcribe 작업의 상태 변화에 대응할 수 있습니다. Amazon EventBridge AWS 서비스트랜스크립션 작업의 상태가 변경되면 EventBridge 자동으로 이벤트를 이벤트 스트림으로 보냅니다. 이벤트 스트림에서 모니터링하고자 하는 이벤트를 정의하고, 이벤트 발생 시 EventBridge 에서 취해야 할 조치를 정의하는 규칙을 생성합니다. 조치를 취할 수 있는 또 다른 서비스(또는 대상)로 이벤트를 라우팅하는 경우를 예로 들 수 있습니다. 예를 들어, 트랜스크립션 작업이 성공적으로 완료되었을 때 이벤트를 AWS Lambda 함수로 라우팅하도록 규칙을 구성할 수 있습니다. EventBridge 규칙을 정의하려면 다음 섹션을 참조하세요.

이메일, AWS Chatbot 채팅 알림 또는 AWS Console Mobile Application 푸시 알림을 비롯한 여러 채널을 통해 이벤트에 대한 알림을 받을 수 있습니다. 콘솔 알림 센터에서도 알림을 볼 수 있습니다. 알림을 설정하려는 경우 사용할 AWS 사용자 알림수 있습니다. AWS 사용자 알림 집계를 지원하므로 특정 이벤트 중에 받는 알림 수를 줄일 수 있습니다.

규칙 정의 EventBridge

EventBridge 규칙을 정의하려면 를 사용하십시오 AWS Management Console. 규칙을 정의할 때 Amazon Transcribe 를 서비스 이름으로 사용하세요. 규칙을 만드는 방법에 대한 예는 Amazon EventBridge 규칙을 참조하십시오. EventBridge

사용하기 EventBridge전에 다음 정의를 참고하십시오.

이벤트–이벤트는 트랜스크립션 작업 중 하나의 상태 변화를 나타냅니다. 작업의 TranscriptionJobStatus가 IN_PROGRESS에서 COMPLETED로 변경되는 경우를 예로 들 수 있습니다.
대상–대상은 이벤트를 처리하는 또 다른 AWS 서비스 입니다. 예: AWS Lambda 또는 Amazon Simple Notification Service (Amazon SNS). 대상은 JSON 형식으로 이벤트를 수신합니다.
규칙 - 규칙은 EventBridge 감시하려는 수신 이벤트를 매칭하고 처리 대상으로 라우팅합니다. 규칙이 하나의 이벤트를 여러 대상으로 라우팅하는 경우, 모든 대상은 이벤트를 병렬 방식으로 처리합니다. 규칙은 대상으로 전송된 JSON을 사용자 지정할 수 있습니다.

Amazon EventBridge 이벤트는 최선의 노력을 기울여 발생합니다. 에서 EventBridge이벤트를 만들고 관리하는 방법에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의Amazon EventBridge 이벤트를 참조하십시오.

다음은 트랜스크립션 작업의 상태가 또는 로 COMPLETED 변경될 때 시작되는 EventBridge 규칙의 예입니다. Amazon Transcribe FAILED


{
    "source": [
        "aws.transcribe"
    ],
    "detail-type": [
        "Transcribe Job State Change"
    ],
    "detail": {
        "TranscriptionJobStatus": [
            "COMPLETED",
            "FAILED"
        ]
    }
}

규칙에는 다음 필드가 포함됩니다.

source–이벤트의 원본. 왜냐하면 이는 Amazon Transcribe항상 그렇기 때문입니다. aws.transcribe
detail-type–이벤트 세부 정보에 대한 식별자. Amazon Transcribe의 경우 항상 Transcribe Job State Change입니다.
detail–트랜스크립션 작업의 새 상태. 이 예시에서 규칙은 작업 상태가 COMPLETED 또는 FAILED로 변경될 때 이벤트를 시작합니다.

Amazon Transcribe 이벤트

Amazon EventBridge 여러 Amazon Transcribe 이벤트를 기록합니다.

트랜스크립션 작업 이벤트
언어 식별 이벤트
Call Analytics 이벤트
Call Analytics 통화 후 이벤트
어휘 이벤트

이러한 이벤트는 모두 다음과 같은 공유 필드를 포함합니다.

version: 이벤트 데이터의 버전. 이 값은 항상 0입니다.
id: 이벤트에 EventBridge 대해 생성한 고유 식별자입니다.
detail-type: 이벤트 세부 정보에 대한 식별자. 예를 들어 Transcribe Job State Change입니다.
source: 이벤트의 원본. Amazon Transcribe 왜냐하면 항상 그렇기 aws.transcribe 때문입니다.
account: API 호출을 생성한 계정의 AWS 계정 ID.
time: 이벤트가 전달된 날짜 및 시간.
region: 요청이 이루어진 위치. AWS 리전
resources: API 호출에서 사용한 리소스. 왜냐하면 Amazon Transcribe이 필드는 항상 비어 있기 때문입니다.
detail: 이벤트에 대한 추가 세부 정보.
- FailureReason: 이 필드는 상태 또는 상태가 FAILED로 변경될 경우 표시되며 FAILED 상태의 이유를 설명합니다.
- 각 이벤트 유형에는 detail 아래에 표시되는 고유한 추가 필드가 있습니다. 이러한 고유 필드는 각 이벤트 예시 후 다음 섹션에서 정의합니다.

트랜스크립션 작업 이벤트

작업 상태가 에서 COMPLETED 또는 IN_PROGRESS FAILED 로 변경되면 이벤트가 Amazon Transcribe 생성됩니다. 상태가 바뀐 작업을 식별하고 대상에서 이벤트를 시작하려면 이벤트의 TranscriptionJobName 필드를 사용합니다. Amazon Transcribe 이벤트에는 다음 정보가 포함됩니다. 트랜스크립션 작업 상태가 detail인 경우 FailureReason 필드가 FAILED 아래에 추가됩니다.

단, 이 이벤트는 StartTranscriptionJob API 작업에만 적용됩니다.


{
    "version": "0",
    "id": "event ID",
    "detail-type":"Transcribe Job State Change",
    "source": "aws.transcribe",
    "account": "111122223333",
    "time": "timestamp",
    "region": "us-west-2",
    "resources": [],
    "detail": {
          "TranscriptionJobName": "my-first-transcription-job",
          "TranscriptionJobStatus": "COMPLETED" (or "FAILED")
    }   
}

TranscriptionJobName: 트랜스크립션 작업에 대해 선택한 고유한 이름.
TranscriptionJobStatus : 트랜스크립션 작업의 새 상태. 이는 COMPLETED 또는 FAILED일 수 있습니다.

언어 식별 이벤트

자동 언어 식별을 활성화하면 언어 식별 상태가 COMPLETED 또는 FAILED일 때 Amazon Transcribe 에서 이벤트를 생성합니다. 상태가 바뀐 작업을 식별하고 대상에서 이벤트를 시작하려면 이벤트의 JobName 필드를 사용합니다. Amazon Transcribe 이벤트에는 다음 정보가 포함됩니다. 언어 식별 상태가 FAILED인 경우 FailureReason 필드가 detail 아래에 추가됩니다.

단, 이 이벤트는 LanguageIdSettings 파라미터가 포함된 경우 StartTranscriptionJob API 작업에만 적용됩니다.


{
    "version": "0",
    "id": "event ID",
    "detail-type": "Language Identification State Change",
    "source": "aws.transcribe",
    "account": "111122223333",
    "time": "timestamp",
    "region": "us-west-2",
    "resources": [],
    "detail": {
        "JobType": "TranscriptionJob",
        "JobName": "my-first-lang-id-job",
        "LanguageIdentificationStatus": "COMPLETED" (or "FAILED")
    }
}

JobType: 트랜스크립션 작업에서 이 값은 TranscriptionJob이어야 합니다.
JobName: 트랜스크립션 작업의 고유 이름.
LanguageIdentificationStatus: 트랜스크립션 작업의 언어 식별 상태. 이는 COMPLETED 또는 FAILED일 수 있습니다.

Call Analytics 이벤트

Call Analytics 작업의 상태가 IN_PROGRESS에서 COMPLETED 또는 FAILED로 바뀌면 Amazon Transcribe 에서 이벤트를 생성합니다. 상태가 바뀐 Call Analytics 작업을 식별하고 대상에서 이벤트를 시작하려면 이벤트의 JobName 필드를 사용합니다. Amazon Transcribe 이벤트에는 다음 정보가 포함됩니다. Call Analytics 작업의 상태가 FAILED인 경우 FailureReason 필드가 detail 아래에 추가됩니다.

단, 이 이벤트는 StartCallAnalyticsJob API 작업에만 적용됩니다.


{
    "version": "0",
    "id": "event ID",
    "detail-type": "Call Analytics Job State Change",
    "source": "aws.transcribe",
    "account": "111122223333",
    "time": "timestamp",
    "region": "us-west-2",
    "resources": [],
    "detail": {
        "JobName": "my-first-analytics-job",
        "JobStatus": "COMPLETED" (or "FAILED"),
        "AnalyticsJobDetails": { // only when you enable optional features such as Generative Call Summarization
            "Skipped": []
        }
    }
}

JobName: Call Analytics 트랜스크립션 작업의 고유한 이름.
JobStatus: Call Analytics 트랜스크립션 작업의 상태. 이는 COMPLETED 또는 FAILED일 수 있습니다.
AnalyticsJobDetails: 건너뛰는 분석 기능에 대한 정보를 포함한 통화 분석 기록 작업의 세부 정보.

Call Analytics 통화 후 이벤트

통화 후 분석 트랜스크립션의 상태가 IN_PROGRESS에서 COMPLETED 또는 FAILED로 바뀌면 Amazon Transcribe 에서 이벤트를 생성합니다. 상태가 바뀐 Call Analytics 통화 후 작업을 식별하고 대상에서 이벤트를 시작하려면 이벤트의 StreamingSessionId 필드를 사용합니다.

단, 이 이벤트는 PostCallAnalyticsSettings 파라미터가 포함된 경우 StartCallAnalyticsStreamTranscription API 작업에만 적용됩니다.

COMPLETED 이벤트에는 다음 정보가 포함됩니다.


{
    "version": "0",
    "id": "event ID",
    "detail-type": "Call Analytics Post Call Job State Change",
    "source": "aws.transcribe",
    "account": "111122223333",
    "time": "timestamp",
    "region": "us-west-2",
    "resources": [],
    "detail": {
        "StreamingSessionId": "session-id",
        "PostCallStatus": "COMPLETED",
        "Transcript": {
            "RedactedTranscriptFileUri": "s3://DOC-EXAMPLE-BUCKET/my-output-files/my-redacted-file.JSON",
            "TranscriptFileUri": "s3://DOC-EXAMPLE-BUCKET/my-output-files/my-file.JSON"
        },
        "Media": {
            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-output-files/my-redacted-file.WAV",
            "RedactedMediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-output-files/my-redacted-file.WAV"
        }
    }
}

FAILED 이벤트에는 다음 정보가 포함됩니다.


{
    "version": "0",
    "id": "event ID",
    "detail-type": "Call Analytics Post Call Job State Change",
    "source": "aws.transcribe",
    "account": "111122223333",
    "time": "timestamp",
    "region": "us-west-2",
    "resources": [],
    "detail": {
        "StreamingSessionId": "session-id",
        "PostCallStatus": "FAILED"
    }
}

StreamingSessionId: 실시간 Call Analytics 트랜스크립션 요청에 할당된 식별 번호.
PostCallStatus: 통화 후 Call Analytics 트랜스크립션의 상태. 이는 COMPLETED 또는 FAILED일 수 있습니다.
Transcript: 수정된 트랜스크립트과 수정되지 않은 트랜스크립트의 URI.
Media: 수정된 오디오 파일과 수정되지 않은 오디오 파일의 URI.

어휘 이벤트

사용자 지정 어휘의 상태가 에서 READY 또는 PENDING 로 변경되면 FAILED 이벤트가 Amazon Transcribe 생성됩니다. 상태가 바뀐 사용자 지정 어휘를 식별하고 대상에서 이벤트를 시작하려면 이벤트의 VocabularyName 필드를 사용합니다. Amazon Transcribe 이벤트에는 다음 정보가 포함됩니다. 사용자 지정 어휘 상태가 FAILED인 경우 FailureReason 필드가 detail 아래에 추가됩니다.

단, 이 이벤트는 CreateVocabulary API 작업에만 적용됩니다.


{
    "version": "0",
    "id": "event ID",
    "detail-type": "Vocabulary State Change",
    "source": "aws.transcribe",
    "account": "111122223333",
    "time": "timestamp",
    "region": "us-west-2",
    "resources": [],
    "detail": {
        "VocabularyName": "unique-vocabulary-name",
        "VocabularyState": "READY" (or "FAILED")
    }
}

VocabularyName: 사용자 지정 어휘의 고유한 이름.
VocabularyState: 사용자 지정 어휘의 처리 상태. 이는 READY 또는 FAILED일 수 있습니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Amazon Transcribe 를 통한 모니터링 CloudTrail

규정 준수 확인