Payload-Formate für EventBridge Amazon-Ereignisse Erstellen Sie eine Regel, die EventBridge Amazon-Ereignissen entspricht Konfigurieren Sie das Ziel der erstellten Amazon-Regel EventBridge

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 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, 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
In einem Amazon 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

Inhalt

Payload-Formate für EventBridge Amazon-Ereignisse
Erstellen Sie eine Regel, die EventBridge Amazon-Ereignissen entspricht
Konfigurieren Sie das Ziel der erstellten Amazon-Regel EventBridge

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

Die Seite „Regel erstellen“ mit der Auswahl des Standard-Event-Busses.

Verwenden Sie eine Vorlage für ein Event-Muster

Wählen Sie das definierte Ereignismuster aus den Dropdownlisten aus.

Das Drop-down-Menü „Eventquelle“ zeigt, dass aws.connect ausgewählt ist.

Das Event-Muster, in dem der Status der Bildschirmaufzeichnung geändert angezeigt wird, ist ausgewählt.

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 im EventBridge Amazon-Benutzerhandbuch.

CloudWatch Amazon-Protokollgruppe als Beispielziel

Das folgende Beispiel verwendet eine CloudWatch Amazon-Loggruppe als Ziel.

Die Zielkonfiguration zeigt die ausgewählte CloudWatch Protokollgruppe an.

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

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Herunterladen von Protokolldateien für die App zur Bildschirmaufzeichnung

Häufig gestellte Fragen zu Bildschirmaufzeichnungsfunktionen