本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 在 Amazon Chime SDK 中記錄和監控 監控是維護 Amazon Chime 開發套件和其他 AWS 解決方案可靠性、可用性和效能的重要部分。 AWS 提供下列工具來監控 Amazon Chime 開發套件、報告問題，並適時採取自動動作： + *Amazon CloudWatch* 會即時監控您的 AWS 資源和執行的應用程式 AWS。您可以收集和追蹤指標、建立自訂儀板表，以及設定警示，在特定指標達到您指定的閾值時通知您或採取動作。例如，您可以讓 CloudWatch 追蹤 CPU 使用量或其他 Amazon EC2 執行個體指標，並在需要時自動啟動新的執行個體。如需詳細資訊，請參閱 [Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。 + *Amazon EventBridge* 提供近乎即時的系統事件串流，描述 AWS 資源的變更。EventBridge 支援自動化事件驅動型運算。這可讓您撰寫監看特定事件的規則，並在發生這些事件時觸發 AWS 其他服務中的自動動作。如需詳細資訊，請參閱[「Amazon EventBridge 使用者指南」](https://docs.aws.amazon.com/eventbridge/latest/userguide/)。 + *Amazon CloudWatch Logs* 可讓您監控、存放和存取來自 Amazon EC2 執行個體、CloudTrail 及其他來源的日誌檔案。CloudWatch Logs 可監控日誌檔案中的資訊，並在達到特定閾值時通知您。您也可以將日誌資料存檔在高耐用性的儲存空間。如需詳細資訊，請參閱 [Amazon CloudWatch Logs 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/)。 + *AWS CloudTrail* 會擷取由您的帳戶發出或代表 AWS 您的帳戶發出的 API 呼叫和相關事件。其接著會將日誌檔案交付到您指定的 Amazon S3 儲存貯體。您可以識別呼叫的使用者和帳戶 AWS、進行呼叫的來源 IP 地址，以及呼叫的時間。如需詳細資訊，請參閱[「AWS CloudTrail 使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。 **Topics** + [使用 Amazon CloudWatch 監控 Amazon Chime SDK](monitoring-cloudwatch.md) + [使用 EventBridge 自動化 Amazon Chime 開發套件](automating-chime-with-cloudwatch-events.md) + [使用 AWS CloudTrail 記錄 API 呼叫](cloudtrail.md) # 使用 Amazon CloudWatch 監控 Amazon Chime SDK 您可以使用 CloudWatch 來監控 Amazon Chime SDK。CloudWatch 可收集原始資料，將這些資料轉換為可讀取且幾近即時的指標。這些統計資料會保留 15 個月，讓您可以存取歷史資訊，並更清楚 Web 應用程式或服務的效能。您也可以設定留意特定閾值的警示，當滿足這些閾值時傳送通知或採取動作。如需詳細資訊，請參閱 [Amazon CloudWatch 使用者指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)。 ## Amazon Chime SDK 的 CloudWatch 指標 Amazon Chime SDK 會將下列指標傳送至 CloudWatch。Amazon Chime SDK 會在通話期間每分鐘傳送指標一次，並傳送此處列出的所有指標。 `AWS/ChimeVoiceConnector` 命名空間包含下列指派給您 AWS 帳戶和 Amazon Chime SDK Voice Connectors 的電話號碼指標。 **注意** 軟體開發套件會在呼叫期間每分鐘傳送封包遺失值一次。損失值會在呼叫期間累積。例如，如果封包在 11：01 發生遺失，該遺失值會轉送至通話的剩餘分鐘數。在通話結束時，您會收到單一封包遺失指標。 | 指標 | Description | | --- | --- | | `SmaActiveCallCount` | 作用中並行 Sip Media Application 呼叫的數量。 單位：Count | | `VoiceConnectorActiveCallCount` | 作用中並行語音連接器呼叫的數量。 單位：Count | | `InboundCallAttempts` | 嘗試的傳入呼叫次數。 單位：Count | | `InboundCallFailures` | 傳入呼叫的失敗次數。 單位：Count | | `InboundCallsAnswered` | 接聽的傳入呼叫數。 單位：Count | | `InboundCallsActive` | 目前作用中的傳入呼叫數。 單位：Count | | `OutboundCallAttempts` | 嘗試的傳出呼叫數。 單位：Count | | `OutboundCallFailures` | 傳出呼叫的失敗次數。 單位：Count | | `OutboundCallsAnswered` | 接聽的傳出呼叫數。 單位：Count | | `OutboundCallsActive` | 目前作用中的傳出呼叫數。 單位：Count | | `Throttles` | 嘗試進行呼叫時，您帳戶受到節流的次數。 單位：Count | | `Sip1xxCodes` | 狀態代碼為 1xx 層級的 SIP 訊息數。 單位：Count | | `Sip2xxCodes` | 狀態代碼為 2xx 層級的 SIP 訊息數。 單位：Count | | `Sip3xxCodes` | 狀態代碼為 3xx 層級的 SIP 訊息數。 單位：Count | | `Sip4xxCodes` | 狀態代碼為 4xx 層級的 SIP 訊息數。 單位：Count | | `Sip5xxCodes` | 狀態代碼為 5xx 層級的 SIP 訊息數。 單位：Count | | `Sip6xxCodes` | 狀態代碼為 6xx 層級的 SIP 訊息數。 單位：Count | | `CustomerToVcRtpPackets` | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施的 RTP 封包數量。 單位：Count | | `CustomerToVcRtpBytes` | 從客戶傳送至 RTP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。 單位：Count | | `CustomerToVcRtcpPackets` | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施的 RTCP 封包數量。 單位：Count | | `CustomerToVcRtcpBytes` | RTCP 封包中從客戶傳送至 Amazon Chime SDK Voice Connector 基礎設施的位元組數。 單位：Count | | `CustomerToVcPacketsLost` | 從客戶到 Amazon Chime SDK Voice Connector 基礎設施的傳輸中遺失封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 單位：Count | | `CustomerToVcJitter` | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施之封包的平均抖動。 單位：微秒 | | `VcToCustomerRtpPackets` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTP 封包數量。 單位：Count | | `VcToCustomerRtpBytes` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的位元組數，以 RTP 封包顯示。 單位：Count | | `VcToCustomerRtcpPackets` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTCP 封包數量。 單位：Count | | `VcToCustomerRtcpBytes` | RTCP 封包中從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的位元組數。 單位：Count | | `VcToCustomerPacketsLost` | 從 Amazon Chime SDK Voice Connector 基礎設施傳輸到客戶的封包遺失數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 單位：Count | | `VcToCustomerJitter` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶之封包的平均抖動。 單位：微秒 | | `RTTBetweenVcAndCustomer` | 客戶與 Amazon Chime SDK Voice Connector 基礎設施之間的平均往返時間。 單位：微秒 | | `MOSBetweenVcAndCustomer` | 與客戶與 Amazon Chime SDK Voice Connector 基礎設施之間的語音串流相關聯的預估平均意見分數 (MOS)。 單位：介於 1.0-4.4 之間的分數。分數越高，表示感知的音訊品質越好。 | | `RemoteToVcRtpPackets` | 從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施的 RTP 封包數量。 單位：Count | | `RemoteToVcRtpBytes` | 從遠端傳送至 RTP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。 單位：Count | | `RemoteToVcRtcpPackets` | 從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施的 RTCP 封包數量。 單位：Count | | `RemoteToVcRtcpBytes` | 從遠端傳送至 RTCP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。 單位：Count | | `RemoteToVcPacketsLost` | 從遠端傳輸到 Amazon Chime SDK Voice Connector 基礎設施時遺失的封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 單位：Count | | `RemoteToVcJitter` | 從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施之封包的平均抖動。 單位：微秒 | | `VcToRemoteRtpPackets` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的 RTP 封包數量。 單位：Count | | `VcToRemoteRtpBytes` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的位元組數，以 RTP 封包顯示。 單位：Count | | `VcToRemoteRtcpPackets` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的 RTCP 封包數量。 單位：Count | | `VcToRemoteRtcpBytes` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的位元組數，以 RTCP 封包顯示。 單位：Count | | `VcToRemotePacketsLost` | 從 Amazon Chime SDK Voice Connector 基礎設施到遠端傳輸中遺失的封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 單位：Count | | `VcToRemoteJitter` | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端之封包的平均抖動。 單位：微秒 | | `RTTBetweenVcAndRemote` | 遠端與 Amazon Chime SDK Voice Connector 基礎設施之間的平均往返時間。 單位：微秒 | | `MOSBetweenVcAndRemote` | 遠端與 Amazon Chime SDK Voice Connector 基礎設施之間與語音串流相關聯的預估平均意見分數 (MOS)。 單位：單位：介於 1.0-4.4 之間的分數。分數越高，表示感知的音訊品質越好。 | ## Amazon Chime SDK 的 CloudWatch 維度 您可以與 Amazon Chime SDK 搭配使用的 CloudWatch 維度如下所示。 | 維度 | Description | | --- | --- | | `VoiceConnectorId` | 要顯示指標的 Amazon Chime SDK Voice Connector 識別符。 | | `Region` | 與事件相關聯的 AWS 區域。 | ## Amazon Chime SDK 的 CloudWatch 日誌 您可以設定 Amazon Chime SDK Voice Connectors 將指標傳送至 CloudWatch Logs。當您這麼做時，您也可以接收這些語音連接器的媒體品質指標日誌。 Amazon Chime SDK 每分鐘傳送一次詳細指標。Amazon Chime SDK 會針對使用設定的語音連接器進行的所有呼叫傳送它們，並將它們傳送至我們為您建立的 CloudWatch Logs 日誌群組。 日誌群組名稱使用此格式：`/aws/ChimeVoiceConnectorLogs/${VoiceConnectorID}`。 如需設定語音連接器以傳送指標的詳細資訊，請參閱 [編輯 Amazon Chime SDK Voice Connector 設定](edit-voicecon.md)。 **注意** 封包遺失指標會在呼叫期間累積。例如，如果封包在 11：01 發生遺失，該遺失值會轉送至通話的剩餘分鐘數。在通話結束時，您會收到單一封包遺失指標。 Amazon Chime SDK 在日誌中包含 JSON 格式的下列欄位。 | 欄位 | Description | | --- | --- | | voice\$1connector\$1id | 攜帶呼叫的 Amazon Chime SDK Voice Connector ID。 | | event\$1timestamp | 發出指標的時間，單位為自 UNIX Epoch (1970 年 1 月 1 日午夜) 以來的毫秒數 (UTC)。 | | call\$1id | 對應至交易 ID。 | | from\$1sip\$1user | 呼叫的起始使用者。 | | from\$1country | 呼叫的起始國家/地區。 | | to\$1sip\$1user | 呼叫的接收使用者。 | | to\$1country | 呼叫的接收國家/地區。 | | endpoint\$1id | 指示呼叫的其他端點的不透明識別符。搭配 CloudWatch Logs Insights 使用。如需詳細資訊，請參閱《Amazon CloudWatch Logs 使用者指南》**中的[使用 CloudWatch Logs Insights 分析日誌資料](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)。 | | aws\$1region | 呼叫 AWS 的區域。 | | cust2vc\$1rtp\$1packets | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施的 RTP 封包數量。 | | cust2vc\$1rtp\$1bytes | 從客戶傳送至 RTP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。 | | cust2vc\$1rtcp\$1packets | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施的 RTCP 封包數量。 | | cust2vc\$1rtcp\$1bytes | RTCP 封包中從客戶傳送至 Amazon Chime SDK Voice Connector 基礎設施的位元組數。 | | cust2vc\$1packets\$1lost | 從客戶到 Amazon Chime SDK Voice Connector 基礎設施的傳輸中遺失封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 | | cust2vc\$1jitter | 從客戶傳送到 Amazon Chime SDK Voice Connector 基礎設施之封包的平均抖動。 | | vc2cust\$1rtp\$1packets | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTP 封包數量。 | | vc2cust\$1rtp\$1bytes | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的位元組數，以 RTP 封包顯示。 | | vc2cust\$1rtcp\$1packets | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的 RTCP 封包數量。 | | vc2cust\$1rtcp\$1bytes | RTCP 封包中從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶的位元組數。 | | vc2cust\$1packets\$1lost | 從 Amazon Chime SDK Voice Connector 基礎設施傳輸到客戶的封包遺失數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 | | vc2cust\$1jitter | 從 Amazon Chime SDK Voice Connector 基礎設施傳送給客戶之封包的平均抖動。 | | rtt\$1btwn\$1vc\$1and\$1cust | 客戶與 Amazon Chime SDK Voice Connector 基礎設施之間的平均往返時間。 | | mos\$1btwn\$1vc\$1and\$1cust | 與客戶與 Amazon Chime SDK Voice Connector 基礎設施之間的語音串流相關聯的預估平均意見分數 (MOS)。 | | rem2vc\$1rtp\$1packets | 從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施的 RTP 封包數量。 | | rem2vc\$1rtp\$1bytes | 從遠端傳送至 RTP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。 | | rem2vc\$1rtcp\$1packets | 從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施的 RTCP 封包數量。 | | rem2vc\$1rtcp\$1bytes | 從遠端傳送至 RTCP 封包中 Amazon Chime SDK Voice Connector 基礎設施的位元組數。 | | rem2vc\$1packets\$1lost | 從遠端傳輸到 Amazon Chime SDK Voice Connector 基礎設施時遺失的封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 | | rem2vc\$1jitter | 從遠端傳送至 Amazon Chime SDK Voice Connector 基礎設施之封包的平均抖動。 | | vc2rem\$1rtp\$1packets | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的 RTP 封包數目。 | | vc2rem\$1rtp\$1bytes | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的位元組數，以 RTP 封包顯示。 | | vc2rem\$1rtcp\$1packets | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的 RTCP 封包數量。 | | vc2rem\$1rtcp\$1bytes | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端的位元組數，以 RTCP 封包顯示。 | | vc2rem\$1packets\$1lost | 從 Amazon Chime SDK Voice Connector 基礎設施到遠端傳輸中遺失的封包數量。值會每分鐘傳送一次，直到呼叫結束為止。值計數是累積的。 | | vc2rem\$1jitter | 從 Amazon Chime SDK Voice Connector 基礎設施傳送至遠端之封包的平均抖動。 | | rtt\$1btwn\$1vc\$1and\$1rem | 遠端與 Amazon Chime SDK Voice Connector 基礎設施之間的平均往返時間。 | | mos\$1btwn\$1vc\$1and\$1rem | 遠端與 Amazon Chime SDK Voice Connector 基礎設施之間與語音串流相關聯的預估平均意見分數 (MOS)。 | **SIP 訊息日誌** 您可以選擇接收 Amazon Chime SDK Voice Connector 的 SIP 訊息日誌。當您執行此操作時，Amazon Chime SDK 會擷取傳入和傳出 SIP 訊息，並將其傳送至為您建立的 CloudWatch Logs 日誌群組。日誌群組的名稱為 `/aws/ChimeVoiceConnectorSipMessages/${VoiceConnectorID}`。日誌中會包含以下欄位，其格式為 JSON。 | 欄位 | Description | | --- | --- | | voice\$1connector\$1id | Amazon Chime SDK Voice Connector ID。 | | aws\$1region | 與事件相關聯的 AWS 區域。 | | event\$1timestamp | 擷取訊息的時間，單位為自 UNIX Epoch (1970 年 1 月 1 日午夜) 以來的毫秒數 (UTC)。 | | call\$1id | Amazon Chime SDK Voice Connector 呼叫 ID。 | | sip\$1message | 擷取的完整 SIP 訊息。 | # 使用 EventBridge 自動化 Amazon Chime 開發套件 Amazon EventBridge 可讓您自動化 AWS 服務，並自動回應系統事件，例如應用程式可用性問題或資源變更。如需會議事件的詳細資訊，請參閱《*Amazon Chime SDK 開發人員指南*》中的[會議事件](https://docs.aws.amazon.com/chime/latest/dg/using-events.html)。 當 Amazon Chime SDK 產生事件時，會將其傳送至 EventBridge 以*盡力交付*，這表示 Amazon Chime SDK 會嘗試將所有事件傳送至 EventBridge，但在極少數情況下可能不會交付事件。如需詳細資訊，請參閱《*Amazon EventBridge 使用者指南*》中的[來自 AWS 服務的事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)。 **注意** 如果您需要加密資料，您必須使用 Amazon S3-Managed金鑰。我們不支援使用存放在 AWS Key Management Service 中的客戶主金鑰進行伺服器端加密。 ## 使用 EventBridge 自動化 Amazon Chime SDK 語音連接器 Amazon Chime SDK Voice Connectors 可自動觸發的動作包括下列項目： + 叫用 AWS Lambda 函數 + 啟動 Amazon Elastic Container Service 任務 + 將事件轉送至 Amazon Kinesis Video Streams + 啟用 AWS Step Functions 狀態機器 + 通知 Amazon SNS 主題或 Amazon SQS 佇列 搭配 Amazon Chime SDK Voice Connectors 使用 EventBridge 的一些範例包括： + 啟用 Lambda 函數以在通話結束後下載通話的音訊。 + 啟動 Amazon ECS 任務，以在呼叫啟動後啟用即時轉錄。 如需詳細資訊，請參閱[「Amazon EventBridge 使用者指南」](https://docs.aws.amazon.com/eventbridge/latest/userguide/)。 ## Amazon Chime SDK Voice Connector 串流事件 當本節討論的事件發生時，Amazon Chime SDK Voice Connectors 支援將事件傳送至 EventBridge。 ### Amazon Chime SDK Voice Connector 串流開始 當媒體串流至 Kinesis Video Streams 開始時，Amazon Chime SDK Voice Connectors 會傳送此事件。 **Example 事件資料** 以下是此事件的範例資料。 ``` { "version": "0", "id": "12345678-1234-1234-1234-111122223333", "detail-type": "Chime VoiceConnector Streaming Status", "source": "aws.chime", "account": "111122223333", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": [], "detail": { "callId": "1112-2222-4333", "direction": "Outbound", "fromNumber": "+12065550100", "inviteHeaders": { "from": "\"John\" ;tag=abcdefg", "to": "", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": ";", "content-type": "application/sdp", "content-length": "246" }, "isCaller": false, "mediaType": "audio/L16", "sdp": { "mediaIndex": 0, "mediaLabel": "1" }, "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>;\r\n", "startFragmentNumber": "1234567899444", "startTime": "yyyy-mm-ddThh:mm:ssZ", "streamArn": "arn:aws:kinesisvideo:us-east-1:123456M:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333", "toNumber": "+13605550199", "transactionId": "12345678-1234-1234", "voiceConnectorId": "abcdef1ghij2klmno3pqr4", "streamingStatus": "STARTED", "version": "0" } } ``` ### Amazon Chime SDK Voice Connector 串流結束 當媒體串流至 Kinesis Video Streams 結束時，Amazon Chime SDK Voice Connectors 會傳送此事件。 **Example 事件資料** 以下是此事件的範例資料。 ``` { "version": "0", "id": "12345678-1234-1234-1234-111122223333", "detail-type": "Chime VoiceConnector Streaming Status", "source": "aws.chime", "account": "111122223333", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": [], "detail": { "streamingStatus": "ENDED", "voiceConnectorId": "abcdef1ghij2klmno3pqr4", "transactionId": "12345678-1234-1234", "callId": "1112-2222-4333", "direction": "Inbound", "fromNumber": "+12065550100", "inviteHeaders": { "from": "\"John\" ;tag=abcdefg", "to": "", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": "", "content-type": "application/sdp", "content-length": "246" }, "isCaller": false, "mediaType": "audio/L16", "sdp": { "mediaIndex": 0, "mediaLabel": "1" }, "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n", "startFragmentNumber": "1234567899444", "startTime": "yyyy-mm-ddThh:mm:ssZ", "endTime": "yyyy-mm-ddThh:mm:ssZ", "streamArn": "arn:aws:kinesisvideo:us-east-1:123456:stream/ChimeVoiceConnector-abcdef1ghij2klmno3pqr4-111aaa-22bb-33cc-44dd-111222/111122223333", "toNumber": "+13605550199", "version": "0" } } ``` ### Amazon Chime SDK Voice Connector 串流更新 更新媒體串流至 Kinesis Video Streams 時，Amazon Chime SDK Voice Connectors 會傳送此事件。 **Example 事件資料** 以下是此事件的範例資料。 ``` { "version": "0", "id": "12345678-1234-1234-1234-111122223333", "detail-type": "Chime VoiceConnector Streaming Status", "source": "aws.chime", "account": "111122223333", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": [], "detail": { "callId": "1112-2222-4333", "updateHeaders": { "from": "\"John\" ;;tag=abcdefg", "to": "", "call-id": "1112-2222-4333", "cseq": "101 INVITE", "contact": "", "content-type": "application/sdp", "content-length": "246" }, "siprecMetadata": "<&xml version=\"1.0\" encoding=\"UTF-8\"&>\r\n", "streamingStatus": "UPDATED", "transactionId": "12345678-1234-1234", "version": "0", "voiceConnectorId": "abcdef1ghij2klmno3pqr4" } } ``` ### Amazon Chime SDK Voice Connector 串流失敗 當媒體串流至 Kinesis Video Streams 失敗時，Amazon Chime SDK Voice Connectors 會傳送此事件。 **Example 事件資料** 以下是此事件的範例資料。 ``` { "version": "0", "id": "12345678-1234-1234-1234-111122223333", "detail-type": "Chime VoiceConnector Streaming Status", "source": "aws.chime", "account": "111122223333", "time": "yyyy-mm-ddThh:mm:ssZ", "region": "us-east-1", "resources": [], "detail": { "streamingStatus":"FAILED", "voiceConnectorId":"abcdefghi", "transactionId":"12345678-1234-1234", "callId":"1112-2222-4333", "direction":"Inbound", "failTime":"yyyy-mm-ddThh:mm:ssZ", "failureReason": "Internal failure", "version":"0" } } ``` # 使用 AWS CloudTrail 記錄 API 呼叫 Amazon Chime SDK 已與 整合 AWS CloudTrail，此服務提供使用者、角色 AWS 或服務在 Amazon Chime SDK 中所採取動作的記錄。CloudTrail 會將 Amazon Chime SDK 的所有 API 呼叫擷取為事件，包括來自 Amazon Chime SDK 主控台的呼叫，以及對 Amazon Chime SDK APIs程式碼呼叫。 如果您建立線索，則可以將 CloudTrail 事件持續交付至 Amazon S3 儲存貯體，包括 Amazon Chime SDK 的事件。如果您未設定追蹤，您仍然可以在 CloudTrail 主控台的事件**歷史記錄頁面上檢視最新的事件**。該資訊包括每個請求、提出請求的 IP 地址，以及提出請求的人員。 當您建立 AWS 帳戶時，會在您的帳戶上啟用 CloudTrail。當 Amazon Chime 管理主控台進行 API 呼叫時，CloudTrail 會在事件中記錄該活動。若要查看事件，請啟動 CloudTrail 主控台並前往**事件歷史記錄** 。您可以在 AWS 帳戶中檢視、搜尋和下載最近的事件。如需詳細資訊，請參閱[使用 CloudTrail 事件歷史記錄檢視事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。 若要進一步了解 CloudTrail，請參閱[「AWS CloudTrail 使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。 ## 建立追蹤 下列主題說明如何使用 CloudTrail 主控台建立追蹤。根據預設，當您在主控台中建立線索時，線索會記錄 AWS 分割區中所有區域的事件，並將日誌檔案傳送到您指定的 Amazon S3 儲存貯體。 依照列出的順序遵循這些主題。 1. [建立追蹤的概觀](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) 1. [CloudTrail 支援的服務和整合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) 1. [設定 CloudTrail 的 Amazon SNS 通知](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) 1. [接收多個區域的 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)及[接收多個帳戶的 CloudTrail 日誌檔案](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) ## 追蹤擷取的資料 CloudTrail 會記錄所有 Amazon Chime SDK 動作。如需動作的相關資訊，請參閱 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/Welcome.html)。例如，對 的呼叫[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meetings-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meetings-chime_CreateAttendee.html)，動作會在 CloudTrail 日誌檔案中產生項目。每個事件都包含產生請求者的相關資訊。身分資訊可協助您判斷下列事項： + 該請求是否使用根或 IAM 使用者憑證提出。 + 提出該請求時，是否使用了特定角色或聯合身分使用者的暫時安全憑證。 + 請求是否由其他 AWS 服務提出。 如需詳細資訊，請參閱 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。 ## 了解 Amazon Chime SDK 日誌檔案項目 追蹤是一種組態，能讓事件以日誌檔案的形式交付到您指定的 Amazon S3 儲存貯體。CloudTrail 日誌檔案包含一或多個日誌專案。一個事件為任何來源提出的單一請求，並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔案並非依公有 API 呼叫追蹤記錄的堆疊排序，因此不會以任何特定順序出現。 Amazon Chime SDK 的項目由 **chime.amazonaws.com** 事件來源識別。 如果您已為 Amazon Chime SDK 帳戶設定 Active Directory，請參閱[使用 CloudTrail 記錄 AWS Directory Service API 呼叫](https://docs.aws.amazon.com/directoryservice/latest/devguide/cloudtrail_logging.html)。這說明如何監控可能影響 Amazon Chime SDK 使用者登入能力的問題。 下列範例顯示 Amazon Chime SDK 的 CloudTrail 日誌項目： ``` {"eventVersion":"1.05", "userIdentity":{ "type":"IAMUser", "principalId":"AAAAAABBBBBBBBEXAMPLE", "arn":"arn:aws:iam::123456789012:user/Alice", "accountId":"0123456789012", "accessKeyId":"AAAAAABBBBBBBBEXAMPLE", "sessionContext":{ "attributes":{ "mfaAuthenticated":"false", "creationDate":"2017-07-24T17:57:43Z" }, "sessionIssuer":{ "type":"Role", "principalId":"AAAAAABBBBBBBBEXAMPLE", "arn":"arn:aws:iam::123456789012:role/Joe", "accountId":"123456789012", "userName":"Joe" } } } , "eventTime":"2017-07-24T17:58:21Z", "eventSource":"chime.amazonaws.com", "eventName":"AddDomain", "awsRegion":"us-east-1", "sourceIPAddress":"72.21.198.64", "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36", "errorCode":"ConflictException", "errorMessage":"Request could not be completed due to a conflict", "requestParameters":{ "domainName":"example.com", "accountId":"11aaaaaa1-1a11-1111-1a11-aaadd0a0aa00" }, "responseElements":null, "requestID":"be1bee1d-1111-11e1-1eD1-0dc1111f1ac1", "eventID":"00fbeee1-123e-111e-93e3-11111bfbfcc1", "eventType":"AwsApiCall", "recipientAccountId":"123456789012" } ```