Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden Sie EventBridge Amazon-Ereignisse, um den Status der Bildschirmaufnahme zu verfolgen
Mit Amazon EventBridge können Sie den Status der Bildschirmaufzeichnungen von [ Agenten nahezu ](agent-screen-recording.md) in Echtzeit einsehen. Das Ereignis für jede Bildschirmaufzeichnung eines Agenten umfasst success/failure den Status, Fehlercodes mit Beschreibungen, den Ort der Aufzeichnung, die Größe der Aufzeichnung, die installierte Client-Version sowie die Start- und Endzeiten der Bildschirmaufzeichnung.
**Anmerkung**
Die Statusverfolgung der Bildschirmaufzeichnung mit Amazon EventBridge ist in allen AWS Regionen verfügbar, in denen die Bildschirmaufzeichnung durch den Agenten von [ Connect Customer unterstützt wird](agent-screen-recording.md), mit Ausnahme von AWS GovCloud (US-West).
Sie können eine Integration mit anderen AWS Diensten vornehmen, um analytische oder überwachende Einblicke in die Bildschirmaufzeichnungen von Agenten zu erhalten:
+ Fragen Sie mit [ Amazon CloudWatch Log Insights ab ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)
+ In einem [ Amazon ](https://aws.amazon.com/quicksight/) Quick-Dashboard erhalten Sie Benachrichtigungen nahezu in Echtzeit
+ Erstellen Sie aggregierte Berichte außerhalb von Connect Customer
+ Verbinden Sie Ihre anderen maßgeschneiderten Datenpipeline-Lösungen mit Amazon EventBridge
**Topics**
+ [Payload-Formate für EventBridge Amazon-Ereignisse](#eventbridge-payload-formats)
+ [Erstellen Sie eine Regel, die EventBridge Amazon-Ereignissen entspricht](#create-eventbridge-rule)
+ [Konfigurieren Sie das Ziel der erstellten Amazon-Regel EventBridge](#configure-eventbridge-target)
## Payload-Formate für EventBridge Amazon-Ereignisse
### Ereignis mit dem Status der Bildschirmaufzeichnung — INITIIERT
Dieses Ereignis wird für jeden Kontakt ausgelöst, bei dem die Agentenbildschirmaufzeichnung aktiviert ist, wenn ein Kontakt vom Agenten akzeptiert wird (möglicherweise vor Beginn der Aufzeichnung).
```
{
"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",
}
}
}
```
### Ereignis mit dem Status der Bildschirmaufzeichnung — ABGESCHLOSSEN
Dieses Ereignis wird ausgelöst, wenn die Bildschirmaufnahme auf dem Agenten-Desktop endet. Das bedeutet nicht, dass die Bildschirmaufnahme erfolgreich in Ihren Amazon S3-Bucket hochgeladen wurde.
```
{
"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",
}
}
}
```
### Ereignis mit dem Status der Bildschirmaufzeichnung — VERÖFFENTLICHT
Dieses Ereignis wird ausgelöst, wenn die Bildschirmaufnahme erfolgreich in Ihren Amazon S3-Bucket hochgeladen wurde. Zu den Details gehören der Standort des Amazon S3-Buckets, die Größe der Aufzeichnung und die Dauer der Aufzeichnung.
```
{
"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
}
}
}
```
### Ereignis mit dem Status der Bildschirmaufzeichnung — FEHLGESCHLAGEN
Dieses Ereignis wird ausgelöst, wenn die Bildschirmaufnahme fehlschlägt. Die Fehlerinformationen beinhalten eine Schätzung der möglichen Fehlerursache, die wir nach besten Kräften erkennen können.
```
{
"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"
}
}
}
```
In der folgenden Tabelle sind die möglichen Werte im `failureInfo` Objekt aufgeführt.
| Code | Nachricht | Quelle |
| --- | --- | --- |
| CLIENT\_LOCAL\_NETWORK\_ACCESS\_BLOCKED | Die lokale Netzwerkzugriffsrichtlinie des Browsers blockierte die Verbindung zur Amazon Connect-Client-Anwendung | CLIENT |
| CLIENT\_APP\_NOT\_RUNNING | Die Amazon Connect-Client-Anwendung läuft nicht auf dem Desktop des Agenten | CLIENT |
| CLIENT\_UNSUPPORTED\_OS | Das Betriebssystem des Agenten wird für die Bildschirmaufnahme nicht unterstützt | CLIENT |
| CLIENT\_AUTH\_ERROR | Die Amazon Connect-Client-Anwendung konnte nicht authentifiziert werden | CLIENT |
| CLIENT\_CONNECTION\_ERROR | Die Amazon Connect-Client-Anwendung ist nicht verbunden | CLIENT |
| MULTIPLE\_CCP\_INTERACTION | Es wurden mehrere Browserinteraktionen mit CCP erkannt | CLIENT |
| USER\_ERROR | Bei der Anfrage ist ein Fehler bei der Benutzerkonfiguration aufgetreten | CLIENT |
| SERVICE\_ISSUE | Bei der Anfrage ist eine Serviceausnahme aufgetreten | SERVICE |
| UNKNOWN | Unbekannter Fehler | UNKNOWN |
## Erstellen Sie eine Regel, die EventBridge Amazon-Ereignissen entspricht
Um EventBridge Amazon-Ereignisse für den Status der Bildschirmaufzeichnung zu abonnieren, müssen Sie eine EventBridge Amazon-Regel erstellen, die der definierten Eventquelle und dem Event-Detailtyp entspricht. Dies kann entweder über die AWS Konsole oder AWS CDK über Bibliotheken erreicht werden.
### Erstellen Sie eine Regel mit dem AWS Konsole
Erstellen Sie in der AWS Konsole eine neue Regel in Amazon EventBridge → Busse → Regeln.
#### Verwenden Sie den Standard-Event-Bus
#### Verwenden Sie eine Vorlage für ein Event-Muster
Wählen Sie das definierte Ereignismuster aus den Dropdownlisten aus.
Wenn der Ereignistyp nicht in der Dropdownliste angezeigt wird, können Sie dasselbe Muster auch mithilfe des ** benutzerdefinierten Musters (JSON-Editor) ** erstellen. Verwenden Sie dazu:
```
{
"source": [ "aws.connect" ],
"detailType": [ "Screen Recording Status Changed" ]
}
```
### Erstellen Sie eine Regel mit AWS CDK
Wenn Sie AWS Ressourcen mit verwalten AWS CDK, finden Sie hier alternativ einen TypeScript Beispielcodeausschnitt zum Erstellen einer EventBridge Amazon-Regel:
```
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" ]
}
});
```
## Konfigurieren Sie das Ziel der erstellten Amazon-Regel EventBridge
Amazon EventBridge unterstützt eine Reihe von AWS Diensten als Ziele. Je nach Ihren Bedürfnissen ist es flexibel, Ihre eigene Event-Processing-Pipeline mit anderen AWS Diensten aufzubauen. Sie können für jede Regel bis zu fünf Ziele definieren. Weitere Informationen finden Sie unter [ EventBridge Amazon-Ziele ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) im * EventBridge Amazon-Benutzerhandbuch*.
### CloudWatch Amazon-Protokollgruppe als Beispielziel
Das folgende Beispiel verwendet eine [ CloudWatch Amazon-Loggruppe ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) als Ziel.
Erstellen Sie die Ressource im AWS CDK Code und fügen Sie sie der EventBridge Amazon-Regel hinzu:
```
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)));
```
#### Beispiele für Amazon CloudWatch Log Insights-Abfragen
Unter Verwendung der Amazon CloudWatch Insights-Abfragesprache finden Sie hier einige Beispielabfragen:
+ **Beispielabfrage zur Erfolgsquote **
```
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
```
+ **Beispielabfrage, um die Anzahl der einzelnen Aufzeichnungsstatus zu ermitteln **
```
fields @timestamp, @message, detail
| stats count(*) as Count group by detail.recordingStatus as recordingStatus
```
+ **Beispielabfrage zu fehlgeschlagenen Kontakten mit den häufigsten Fehlercodes **
```
fields @timestamp, @message, detail
| filter detail.recordingStatus = "FAILED"
| stats count(*) as Count group by detail.failureInfo.code as FailureCode
| sort by Count desc
```
+ **Beispielabfrage zu Agenten mit den meisten fehlgeschlagenen Kontakten **
```
fields @timestamp, @message, detail
| filter detail.recordingStatus = "FAILED"
| stats count(*) as Count group by detail.agentArn as AgentArn
| sort by Count desc
```