Format EventBridge muatan acara Amazon Buat aturan untuk mencocokkan EventBridge acara Amazon Konfigurasikan target EventBridge aturan Amazon yang dibuat

Gunakan EventBridge acara Amazon untuk melacak status perekaman layar

Dengan Amazon EventBridge, Anda dapat melihat status rekaman layar agen hampir secara real-time. Acara untuk setiap perekaman layar agen mencakup success/failure status, kode kegagalan dengan deskripsi, lokasi perekaman, ukuran rekaman, versi klien yang diinstal, dan waktu mulai dan akhir perekaman layar.

catatan

Pelacakan status perekaman layar dengan Amazon EventBridge tersedia di setiap Wil AWS ayah yang mendukung perekaman layar agen Connect Customer, kecuali AWS GovCloud (US-West).

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

Kueri dengan Amazon CloudWatch Log Insights
Dapatkan peringatan hampir real-time di dasbor Amazon Quick
Membuat laporan agregat di luar Connect Customer
Hubungkan solusi pipeline data khusus lainnya dengan Amazon EventBridge

Daftar Isi

Format EventBridge muatan acara Amazon
Buat aturan untuk mencocokkan EventBridge acara Amazon
Konfigurasikan target EventBridge aturan Amazon yang dibuat

Format EventBridge muatan acara Amazon

Acara dengan status perekaman layar - DIMULAI

Peristiwa 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": "3.0.2.0",  
    }  
  }  
}

Acara dengan status perekaman layar - SELESAI

Peristiwa ini dipancarkan saat perekaman layar berakhir di desktop agen. Ini tidak berarti rekaman 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": "3.0.2.0",  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z",  
      "endTime": "2026-01-01T00:00:00.000Z",  
    }  
  }  
}

Acara dengan status perekaman layar - DITERBITKAN

Peristiwa ini dipancarkan saat perekaman layar berhasil diunggah ke bucket Amazon S3 Anda. Rinciannya termasuk 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": "3.0.2.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/connect/your-instance-alias/object-prefix/object-key",  
      "durationInMillis": 100000,  
      "sizeInBytes": 1000000  
    }  
  }  
}

Acara dengan status perekaman layar - GAGAL

Peristiwa ini dipancarkan jika perekaman layar gagal. Informasi kegagalan mencakup 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": "3.0.2.0",  
    },  
    "failureInfo": {  
      "code": "UNKNOWN",  
      "message": "Unknown failure",  
      "source": "UNKNOWN"  
    },  
    "recordingInfo": {  
      "startTime": "2026-01-01T00:00:00.000Z"  
    }  
  }  
}

Tabel berikut mencantumkan nilai yang mungkin dalam failureInfo objek.

code	pesan	sumber
`CLIENT_LOCAL_NETWORK_ACCESS_BLOCKED`	Kebijakan akses jaringan lokal browser memblokir koneksi ke Aplikasi Klien Amazon Connect	`CLIENT`
`CLIENT_APP_NOT_RUNNING`	Aplikasi Klien Amazon Connect tidak berjalan di desktop agen	`CLIENT`
`CLIENT_UNSUPPORTED_OS`	Sistem operasi agen tidak didukung untuk perekaman layar	`CLIENT`
`CLIENT_AUTH_ERROR`	Aplikasi Klien Amazon Connect gagal diautentikasi	`CLIENT`
`CLIENT_CONNECTION_ERROR`	Aplikasi Klien Amazon Connect tidak terhubung	`CLIENT`
`MULTIPLE_CCP_INTERACTION`	Terdeteksi beberapa interaksi browser dengan CCP	`CLIENT`
`USER_ERROR`	Permintaan mengalami kesalahan konfigurasi pengguna	`CLIENT`
`SERVICE_ISSUE`	Permintaan menemukan pengecualian layanan	`SERVICE`
`UNKNOWN`	Kegagalan yang tidak diketahui	`UNKNOWN`

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 dan tipe detail acara yang ditentukan. Ini dapat dicapai melalui Kon AWS sol atau AWS CDK pustaka.

Buat aturan menggunakan AWS Konsol

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

Gunakan bus acara default

Halaman Buat aturan yang menampilkan pemilihan bus acara default.

Gunakan pola acara template

Pilih pola acara yang ditentukan dari daftar dropdown.

Dropdown sumber acara yang menampilkan aws.connect dipilih.

Pola Acara yang menunjukkan Status Perekaman Layar Diubah dipilih.

Jika jenis acara tidak muncul di daftar dropdown, Anda dapat membuat pola yang sama menggunakan pola khusus (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 cuplikan TypeScript kode contoh untuk membuat EventBridge aturan Amazon:


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. Tergantung pada kebutuhan Anda, fleksibel untuk membangun jalur 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 contoh target

Contoh berikut menggunakan grup CloudWatch log Amazon sebagai target.

Konfigurasi Target menunjukkan 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 jumlah setiap status rekaman


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 gagal


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

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Unduh file log untuk aplikasi perekaman layar

FAQ untuk kemampuan perekaman layar