本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 Amazon Chime SDK 會議的記錄和監控
<a name="ts-log-monitor"></a>

記錄可協助您收集伺服器端會議事件和用戶端瀏覽器主控台日誌等資訊。

Amazon Chime SDK 提供伺服器端會議事件，您可以傳送到 Amazon EventBridge 和 Amazon CloudWatch Events 日誌。您可以建立 CloudWatch 指標和洞見，並在儀表板中使用這些指標和洞見進行監控。[Amazon Chime SDK 事件的伺服器端記錄和監控](https://aws.amazon.com/blogs/business-productivity/server-side-logging-and-monitoring-of-amazon-chime-sdk-events/)部落格文章說明如何啟用 CloudWatch 指標、洞見和儀表板。

Amazon Chime SDK 為音訊和視訊品質、網路頻寬和連線問題提供用戶端事件。[使用 Amazon Chime SDK 會議事件進行監控和故障](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/)診斷部落格文章說明如何針對聯結失敗、音訊品質問題，以及麥克風和攝影機設定失敗啟用 CloudWatch 指標、洞見和儀表板。如需會議事件的其他資訊，請參閱 Github 上的[會議事件](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/06_Meeting_Events.md)。



## 對指標進行故障診斷的選項
<a name="ts-cloudwatch-options"></a>

您可以使用下列選項來收集故障診斷事件。
+ 在每個事件中傳送指標 
+ 每 N 秒批次事件 
+ 在會議結束時傳送指標 
+ 瀏覽器主控台日誌的日誌記錄層級

## 建議的指標
<a name="ts-cloudwatch-metrics"></a>

您至少應該收集並記錄下列指標。
+ SDK 平台和版本
+ 瀏覽器和版本
+ 作業系統
+ 邏輯核心
+ 會議已開始
+ 會議已結束
+ 出席者已加入
+ 剩餘出席者
+ 已捨棄的出席者

此外，根據您面臨的問題，以下指標可以提供有關連線能力、頻寬和品質問題的資訊。您可以記錄這些指標的每次出現，或只計算它們。計數可以提供基礎問題的摘要檢視：
+ connectionDidSuggestStopVideo
+ connectionDidBecomeGood
+ connectionDidBecomePoor
+ 出席者加入時間 > t 秒
+ MeetingStartFailed
+ MeetingFailed

## 啟用用戶端記錄
<a name="client-side-logging"></a>

您可以透過傳遞`LogLevel.INFO`至 `ConsoleLogger` 物件來啟用 `INFO`層級瀏覽器日誌。

```
const logger = new ConsoleLogger('MyLogger', LogLevel.INFO);const meetingSession = new DefaultMeetingSession(configuration,logger,deviceController); 
```

您也可以使用適用於 JavaScript 的 Amazon Chime 開發套件中的 `POSTLogger`元件來擷取後端的瀏覽器日誌，例如 Amazon CloudWatch Logs。 `POSTLogger`會`HTTP POST`請求將瀏覽器日誌上傳至 [POSTLogger 建構函數](https://aws.github.io/amazon-chime-sdk-js/classes/postlogger.html)中的指定 URL。例如，[GitHub 上的 Amazon Chime SDK 無伺服器示範](https://github.com/aws/amazon-chime-sdk-js/blob/main/demos/browser/app/meetingV2/meetingV2.ts#L1773)會使用 `POSTLogger`將瀏覽器日誌傳送至 Amazon CloudWatch Logs 以供日後調查。

## 啟用伺服器端記錄
<a name="server-side-logging"></a>

適用於 JavaScript 的 Amazon Chime 開發套件也會呼叫具有關鍵會議事件的`eventDidReceive`觀察者方法，例如 `MeetingStartFailed`和 `MeetingFailed`。會議事件通常包含失敗的特定原因。例如，假設大量客戶遇到故障。您的 Web 應用程式可以收集這些會議事件，然後與我們共用這些事件，以疑難排解根本原因。如需會議事件的詳細資訊，請參閱 [ GitHub 上的會議事件指南](https://aws.github.io/amazon-chime-sdk-js/modules/meetingevents.html)，以及[使用 Amazon Chime SDK 會議事件進行監控和故障診斷](https://aws.amazon.com/blogs/business-productivity/monitoring-and-troubleshooting-with-amazon-chime-sdk-meeting-events/)部落格文章。