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
<a name="track-screen-recording-status"></a>

Dengan Amazon EventBridge, Anda dapat melihat status [rekaman layar agen](agent-screen-recording.md) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)
+ Dapatkan peringatan waktu nyata di dasbor [Amazon Quick](https://aws.amazon.com/quicksight/)
+ Membuat laporan gabungan di luar Amazon Connect
+ Hubungkan solusi pipeline data khusus Anda lainnya dengan Amazon EventBridge

**Topics**
+ [Format payload EventBridge acara Amazon](#eventbridge-payload-formats)
+ [Buat aturan untuk mencocokkan EventBridge acara Amazon](#create-eventbridge-rule)
+ [Konfigurasikan target EventBridge aturan Amazon yang dibuat](#configure-eventbridge-target)

## Format payload EventBridge acara Amazon
<a name="eventbridge-payload-formats"></a>

### Acara dengan status perekaman layar - DIMULAI
<a name="event-initiated"></a>

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
<a name="event-completed"></a>

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
<a name="event-published"></a>

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
<a name="event-failed"></a>

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
<a name="create-eventbridge-rule"></a>

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
<a name="create-rule-console"></a>

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

#### Gunakan bus acara default
<a name="use-default-event-bus"></a>

![Halaman Buat aturan yang menampilkan pilihan bus acara default.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/screen-recording-eventbridge-event-rule.png)


#### Gunakan pola acara template
<a name="use-template-event-pattern"></a>

Pilih pola acara yang ditentukan dari daftar dropdown.

![Dropdown sumber acara yang menunjukkan aws.connect dipilih.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/screen-recording-eventbridge-event-source.png)


![Pola acara yang menampilkan Status Perekaman Layar Berubah dipilih.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/screen-recording-eventbridge-event-pattern.png)


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
<a name="create-rule-cdk"></a>

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
<a name="configure-eventbridge-target"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) *di Panduan EventBridge Pengguna Amazon*.

### Grup CloudWatch log Amazon sebagai target contoh
<a name="cloudwatch-log-group-target"></a>

Contoh berikut menggunakan [grup CloudWatch log Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) sebagai target.

![Konfigurasi Target yang menampilkan grup CloudWatch log dipilih.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/screen-recording-eventbridge-target-cwl.png)


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
<a name="cloudwatch-log-insights-queries"></a>

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 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 kontak paling gagal**

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