Menggunakan EventBridge acara Amazon untuk melacak status perekaman layar - Amazon Connect
Format payload EventBridge acara AmazonBuat aturan untuk mencocokkan EventBridge acara AmazonKonfigurasikan target EventBridge aturan Amazon yang dibuat

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan EventBridge acara Amazon untuk melacak status perekaman layar

Dengan Amazon EventBridge, Anda dapat melihat status rekaman layar agen dalam waktu dekat. Acara untuk setiap perekaman layar agen mencakup success/failure status, kode kegagalan dengan deskripsi, lokasi perekaman, ukuran perekaman, versi klien yang diinstal, dan waktu mulai dan berakhir perekaman layar.

Anda dapat berintegrasi dengan AWS layanan lain untuk mendapatkan wawasan analitis atau pemantauan rekaman layar agen:

  • Kueri dengan Amazon CloudWatch Log Insights

  • Dapatkan peringatan waktu nyata di dasbor Amazon Quick

  • Membuat laporan gabungan di luar Amazon Connect

  • Hubungkan solusi pipeline data khusus Anda lainnya dengan Amazon EventBridge

Format payload EventBridge acara Amazon

Acara dengan status perekaman layar - DIMULAI

Acara ini dipancarkan ketika kontak diterima oleh agen, yang mungkin sebelum perekaman dimulai, untuk setiap kontak dengan perekaman layar agen diaktifkan.

{  
  "version": "0",  
  "id": "the_event_id_from_eventbridge",  
  "detail-type": "Screen Recording Status Changed",  
  "source": "aws.connect",  
  "account": "your_aws_account_id",  
  "time": "2026-01-01T00:00:00Z",  
  "region": "us-west-2",  
  "resources": [  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"  
  ],  
  "detail": {  
    "version": "1.0",  
    "recordingStatus": "INITIATED",  
    "eventDeduplicationId": "unique_uuid",  
    "instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",  
    "contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",  
    "clientInfo": {  
      "appVersion": "2.0.3.0",  
    }  
  }  
}

Acara dengan status perekaman layar - SELESAI

Acara ini dipancarkan saat perekaman layar berakhir di desktop agen. Ini tidak berarti perekaman layar telah berhasil diunggah ke bucket Amazon S3 Anda.

{  
  "version": "0",  
  "id": "the_event_id_from_eventbridge",  
  "detail-type": "Screen Recording Status Changed",  
  "source": "aws.connect",  
  "account": "your_aws_account_id",  
  "time": "2026-01-01T00:00:00Z",  
  "region": "us-west-2",  
  "resources": [  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"  
  ],  
  "detail": {  
    "version": "1.0",  
    "recordingStatus": "COMPLETED",  
    "eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",  
    "instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",  
    "contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",  
    "clientInfo": {  
      "appVersion": "2.0.3.0",  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z",  
      "endTime": "2026-01-01T00:00:00.000Z",  
    }  
  }  
}

Acara dengan status perekaman layar - DITERBITKAN

Acara ini dipancarkan saat perekaman layar berhasil diunggah ke bucket Amazon S3 Anda. Detailnya mencakup lokasi bucket Amazon S3, ukuran perekaman, dan durasi perekaman.

{  
  "version": "0",  
  "id": "the_event_id_from_eventbridge",  
  "detail-type": "Screen Recording Status Changed",  
  "source": "aws.connect",  
  "account": "your_aws_account_id",  
  "time": "2026-01-01T00:00:00Z",  
  "region": "us-west-2",  
  "resources": [  
    "contactArn",  
    "instanceArn"  
  ],  
  "detail": {  
    "version": "1.0",  
    "recordingStatus": "PUBLISHED",  
    "eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",  
    "instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",  
    "contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/your_contact_id",  
    "agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",  
    "clientInfo": {  
      "appVersion": "2.0.3.0",  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z",  
      "endTime": "2026-01-01T00:00:00.000Z",  
      "publishTime": "2026-01-01T00:00:00.000Z",  
      "location": "s3://your-bucket-name/object-prefix/object-key",  
      "durationInMillis": 100000,  
      "sizeInBytes": 1000000  
    }  
  }  
}

Acara dengan status perekaman layar - GAGAL

Acara ini dipancarkan jika perekaman layar gagal. Rincian informasi kegagalan disediakan sebagai estimasi upaya terbaik dari kemungkinan alasan kegagalan yang dapat kami deteksi.

{  
  "version": "0",  
  "id": "the_event_id_from_eventbridge",  
  "detail-type": "Screen Recording Status Changed",  
  "source": "aws.connect",  
  "account": "your_aws_account_id",  
  "time": "2026-01-01T00:00:00Z",  
  "region": "us-west-2",  
  "resources": [  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/cccccccc-cccc-cccc-cccc-ccccccccccccc",  
    "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id"  
  ],  
  "detail": {  
    "version": "1.0",  
    "recordingStatus": "FAILED",  
    "eventDeduplicationId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeee",  
    "instanceArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id",  
    "contactArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/contact/cccccccc-cccc-cccc-cccc-ccccccccccccc",  
    "agentArn": "arn:aws:connect:us-west-2:your_aws_account_id:instance/your_instance_id/agent/your_agent_id",  
    "clientInfo": {  
      "appVersion": "2.0.3.0",  
    },  
    "failureInfo": {  
      "code": "UNKNOWN",  
      "message": "UNKNOWN",  
      "source": "Unknown failure"  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z"  
    }  
  }  
}

Buat aturan untuk mencocokkan EventBridge acara Amazon

Untuk berlangganan EventBridge acara Amazon untuk status perekaman layar, Anda perlu membuat EventBridge aturan Amazon yang cocok dengan sumber peristiwa yang ditentukan dan jenis detail acara. Ini dapat dicapai melalui AWS Konsol atau AWS CDK pustaka.

Buat aturan menggunakan AWS Konsol

Di AWS konsol, buat aturan baru di Amazon EventBridge → Bus → Aturan.

Gunakan bus acara default

Halaman Buat aturan yang menampilkan pilihan bus acara default.

Gunakan pola acara template

Pilih pola acara yang ditentukan dari daftar dropdown.

Dropdown sumber acara yang menunjukkan aws.connect dipilih.
Pola acara yang menampilkan Status Perekaman Layar Berubah dipilih.

Jika jenis acara tidak muncul di daftar dropdown, Anda dapat membuat pola yang sama menggunakan pola Kustom (editor JSON) dengan:

{  
  "source": [ "aws.connect" ],  
  "detailType": [ "Screen Recording Status Changed" ]  
}

Buat aturan menggunakan AWS CDK

Atau, jika Anda mengelola AWS sumber daya dengan AWS CDK, berikut adalah contoh cuplikan TypeScript kode untuk membuat aturan Amazon: EventBridge 

import { Rule } from 'aws-cdk-lib/aws-events';  
  
const eventBridgeRule = new Rule(this, 'YourEventBridgeRuleLogicalName', {  
    ruleName: 'your-event-bridge-rule-name',  
    description: 'your rule description',  
    eventPattern: {  
        source: [ "aws.connect" ],  
        detailType: [ "Screen Recording Status Changed" ]  
    }  
});

Konfigurasikan target EventBridge aturan Amazon yang dibuat

Amazon EventBridge mendukung sejumlah AWS layanan sebagai target. Bergantung pada kebutuhan Anda, fleksibel untuk membangun pipeline pemrosesan acara Anda sendiri dengan AWS layanan lain. Anda dapat menentukan hingga lima target untuk setiap aturan. Untuk informasi selengkapnya, lihat EventBridge Target Amazon di Panduan EventBridge Pengguna Amazon.

Grup CloudWatch log Amazon sebagai target contoh

Contoh berikut menggunakan grup CloudWatch log Amazon sebagai target.

Konfigurasi Target yang menampilkan grup CloudWatch log dipilih.

Dalam AWS CDK kode, buat sumber daya dan tambahkan ke EventBridge aturan Amazon:

import { LogGroup, RetentionDays } from "aws-cdk-lib/aws-logs";  
import { CloudWatchLogGroup } from 'aws-cdk-lib/aws-events-targets';  
   
const logGroup = new LogGroup(this, 'YourLogGroupLogicalName', {  
    logGroupName: '"/aws/events/your-log-group-name',  
    retention: RetentionDays.ONE_YEAR  
});  
  
eventBridgeRule.addTarget(new CloudWatchLogGroup((logGroup)));

Contoh kueri Amazon CloudWatch Log Insights

Menggunakan bahasa kueri Amazon CloudWatch Insights, berikut adalah beberapa contoh kueri:

  • Contoh kueri tentang rasio keberhasilan

    fields @timestamp, @message, detail  
| stats sum(detail.recordingStatus= "PUBLISHED") as Count_Success,   
  sum(detail.recordingStatus= "INITIATED") as Count_Total,   
  Count_Success / Count_Total as Success_Ratio

  • Contoh kueri untuk mendapatkan hitungan dari setiap status perekaman

    fields @timestamp, @message, detail  
| stats count(*) as Count group by detail.recordingStatus as recordingStatus

  • Contoh kueri pada kontak yang gagal dengan kode kegagalan yang paling umum

    fields @timestamp, @message, detail  
| filter detail.recordingStatus = "FAILED"   
| stats count(*) as Count group by detail.failureInfo.code as FailureCode  
| sort by Count desc

  • Contoh kueri pada agen dengan sebagian besar kontak yang gagal

    fields @timestamp, @message, detail  
| filter detail.recordingStatus = "FAILED"   
| stats count(*) as Count group by detail.agentArn as AgentArn  
| sort by Count desc