本指南記載於 2025 年 3 月 13 日發行的新 AWS Wickr 管理主控台。如需 AWS Wickr 管理主控台傳統版本的文件，請參閱[傳統管理指南](https://docs.aws.amazon.com/wickr/latest/adminguide-classic/what-is-wickr.html)。

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

# Wickr 網路的 Amazon SNS 事件
<a name="sns-events"></a>

下列事件會發佈至由使用環境`WICKRIO_SNS_TOPIC_ARN`變數或 `sns_topic_arn` Secrets Manager 秘密值識別的 Amazon Resource Name (ARN) 值定義的 Amazon SNS 主題。如需詳細資訊，請參閱[在 AWS Wickr 中設定資料保留機器人的環境變數](data-retention-bot-env-variables.md)及[AWS Wickr 的 Secrets Manager 值](data-retention-aws-secret-values.md)。

資料保留機器人產生的事件會以 JSON 字串傳送。下列值包含在資料保留機器人 5.116 版的事件中。


| 名稱 | 值 | 
| --- | --- | 
| complianceBot | 資料保留機器人的使用者名稱。 | 
| dataTime | 事件發生的日期和時間。 | 
| device | 特定機器人裝置或執行個體的描述。如果您執行多個機器人執行個體，則很有用。 | 
| dockerImage | 與機器人相關聯的 Docker 映像。 | 
| dockerTag | Docker 映像的標籤或版本。 | 
| message | 事件訊息。如需更多資訊，請參閱[關鍵事件](#sns-critical-events)及[正常事件](#sns-normal-events)。 | 
| notificationType | 此值將為 `Bot Event`。 | 
| severity | 事件的嚴重性。可以是 `normal` 或 `critical`。 | 

您必須訂閱 Amazon SNS 主題，才能接收事件。如果您使用電子郵件地址訂閱，系統會傳送電子郵件給您，其中包含類似下列範例的資訊。

```
{
"complianceBot": "compliance_1234567890_bot",
 "dateTime": "2022-10-12T13:05:39",
 "device": "Desktop 1234567890ab",
 "dockerImage": "public.ecr.aws/x3s2s6k3/wickrio/bot-compliance-cloud",
 "dockerTag": "5.116.13.01",
 "message": "Logged in",
 "notificationType": "Bot Event",
 "severity": "normal"
}
```

## 關鍵事件
<a name="sns-critical-events"></a>

這些事件會導致機器人停止或重新啟動。重新啟動次數會受到限制，以避免造成其他問題。

**登入失敗**

以下是機器人無法登入時可能產生的事件。每個訊息都會指出登入失敗的原因。


| 事件類型 | 事件訊息 | 
| --- | --- | 
| 失敗登入 | 登入資料錯誤。檢查密碼。 | 
| 失敗登入 | 找不到使用者。 | 
| 失敗登入 | 帳戶或裝置已暫停。 | 
| 佈建中 | 使用者已結束 命令。 | 
| 佈建中 | `config.wickr` 檔案的密碼不正確。 | 
| 佈建中 | 無法讀取`config.wickr`檔案。 | 
| 失敗登入 | 登入所有失敗。 | 
| 失敗登入 | 新使用者但資料庫已存在。 | 

**更關鍵的事件**


| 事件類型 | 事件訊息 | 
| --- | --- | 
| 已暫停的帳戶 | WickrIOClientMain：：slotAdminUserSuspend：code(%1)： reason： %2“ | 
| BotDevice 已暫停 | 裝置已暫停！ | 
| WatchDog | SwitchBoard 系統已關閉超過 <{{N}}> 分鐘 | 
| S3 失敗 | 無法在 S3 儲存貯體上放置檔案 <{{file-name}}≫。錯誤：<{{AWS-error}}> | 
| 備用金鑰 | SERVER SUBMIITED FALLBACK KEY：不是已辨識的用戶端作用中備用金鑰。請將日誌提交至桌面工程。 | 

## 正常事件
<a name="sns-normal-events"></a>

以下是警告您正常操作發生的事件。在特定期間內發生過多這些類型的事件可能會導致疑慮。

**裝置已新增至帳戶**

當新裝置新增至資料保留機器人帳戶時，就會產生此事件。在某些情況下，這可能是某人已建立資料保留機器人執行個體的重要跡象。以下是此事件的訊息。

```
A device has been added to this account!
```

**已登入的機器人**

此事件會在機器人成功登入時產生。以下是此事件的訊息。

```
Logged in
```

**關閉**

此事件會在機器人關閉時產生。如果使用者未明確啟動，可能表示發生問題。以下是此事件的訊息。

```
Shutting down
```

**可用的更新**

此事件會在資料保留機器人啟動時產生，並識別有較新版本的相關聯 Docker 映像可用。此事件會在機器人啟動時產生，並且每天產生。此事件包含陣列`versions`欄位，可識別可用的新版本。以下是此事件的範例。

```
{
  "complianceBot": "compliance_1234567890_bot",
  "dateTime": "2022-10-12T13:05:55",
  "device": "Desktop 1234567890ab",
  "dockerImage": "public.ecr.aws/x3s2s6k3/wickrio/bot-compliance-cloud",
  "dockerTag": "5.116.13.01",
  "message": "There are updates available",
  "notificationType": "Bot Event",
  "severity": "normal",
  "versions": [
    "5.116.10.01"
  ]
}
```