本指南记录了 2025 年 3 月 13 日发布的全新 AWS Wickr 管理控制台。有关经典版 AWS Wickr 管理控制台的文档，请参阅[经典管理指南](https://docs.aws.amazon.com/wickr/latest/adminguide-classic/what-is-wickr.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Wickr 网络的数据保留指标和事件
以下是 AWS Wickr 数据保留机器人的 5.116 版本目前支持的亚马逊 CloudWatch (CloudWatch) 指标和亚马逊简单通知服务 (Amazon SNS) Simple Notification Service 事件。
**Topics**
+ [CloudWatch 你的 Wickr 网络的指标](cloudwatch-metrics.md)
+ [为你的 Wickr 网络举办的亚马逊 SNS 活动](sns-events.md)
# CloudWatch 你的 Wickr 网络的指标
指标由机器人每隔 1 分钟生成一次，并传输到与运行数据保留机器人 Docker 镜像的账户关联的 CloudWatch 服务。
以下是数据留存机器人支持的现有指标。
| 指标 | 说明 |
| --- | --- |
| Messages\$1Rx | 消息收到 |
| Messages\$1Rx\$1Failed | 处理收到的消息失败。 |
| Messages\$1Saved | 消息保存到收到的消息文件中。 |
| Messages\$1Saved\$1Failed | 将消息保存到收到的消息文件中失败。 |
| Files\$1Saved | 文件已收到。 |
| Files\$1Saved\$1Bytes | 已接收文件的字节数。 |
| Files\$1Saved\$1Failed | 无法保存文件。 |
| 登录名 | 登录（通常每个间隔为 1 次）。 |
| Login\$1Failures | 登录失败（通常每个间隔为 1 次）。 |
| S3\$1Post\$1Errors | 将消息文件和文件发布到 Amazon S3 存储桶时出错。 |
| Watchdog\$1Failures | 看门狗故障。 |
| Watchdog\$1Warnings | 看门狗警告。 |
生成指标供其使用 CloudWatch。用于机器人的命名空间是 `WickrIO`。每个指标都有一个维度阵列。以下是与上述指标一起发布的维度的列表。
| 维度 | 值 |
| --- | --- |
| Id | 机器人的用户名。 |
| 设备 | 特定机器人设备或实例的描述。在运行多个机器人设备或实例时有用。 |
| 产品 | 机器人的产品。可以是附加了 `Alpha`、`Beta` 或 `Production` 的 `WickrPro_` 或 `WickrEnterprise_`。 |
| BotType | 机器人类型。合规机器人被标记为**合规**。 |
| Network | 关联网络的 ID。 |
# 为你的 Wickr 网络举办的亚马逊 SNS 活动
以下事件发布到由使用 `WICKRIO_SNS_TOPIC_ARN` 环境变量或 `sns_topic_arn` Secrets Manager 密钥值识别的 Amazon 资源名称（ARN）值定义的 Amazon SNS 主题。有关更多信息，请参阅[在 AWS Wickr 中配置数据保留机器人的环境变量](data-retention-bot-env-variables.md)和[AWS Wickr 的 Secrets Manager 值](data-retention-aws-secret-values.md)。
数据留存机器人生成的事件以 JSON 字符串的形式发送。从 5.116 版的数据留存机器人起，这些事件中包含以下值。
| Name | 值 |
| --- | --- |
| complianceBot | 数据留存机器人的用户名。 |
| dataTime | 事件发生时的日期和时间。 |
| 设备 | 对特定机器人设备或实例的描述。在运行多个机器人实例时很有用。 |
| 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": "wickr/bot-compliance-cloud",
"dockerTag": "5.116.13.01",
"message": "Logged in",
"notificationType": "Bot Event",
"severity": "normal"
}
```
## 关键事件
这些事件将导致机器人停止或重启。重启次数受到限制，以免导致其他问题。
**登录失败**
以下是机器人登录失败时可能生成的事件。每条消息都会指出登录失败的原因。
| 事件类型 | 事件消息 |
| --- | --- |
| failedlogin | 凭证不正确。检查密码。 |
| failedlogin | 未找到用户。 |
| failedlogin | 账户或设备已被暂停。 |
| 预置 | 用户退出命令。 |
| 预置 | `config.wickr` 文件的密码不正确。 |
| 预置 | 无法读取 `config.wickr` 文件。 |
| failedlogin | 登录全部失败。 |
| failedlogin | 新用户但数据库已存在。 |
**更多关键事件**
| 事件类型 | 事件消息 |
| --- | --- |
| 账户暂停 | Wickr IOClient Main:: slotAdminUser 暂停:代码 (%1): 原因:%2” |
| BotDevice 已暂停 | 设备已暂停！ |
| WatchDog | SwitchBoard 系统停机时间超过 < *N* > 分钟 |
| S3 失败 | 无法将文件 < *file-name* ≫ 放在 S3 存储桶上。错误：< *AWS-error* > |
| 回退键 | 服务器提交的回退键：不是已识别客户端活跃回退键。请向桌面工程部门提交日志。 |
## 正常事件
以下是警告您发生正常操作的事件。在特定时间段内出现过多此类事件可能是担忧的原因。
**设备已添加到账户**
此事件在向数据留存机器人账户添加新设备时生成。在某些情况下，这可能是一个重要迹象，表明有人已创建数据留存机器人实例。以下是此事件的消息。
```
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": "wickr/bot-compliance-cloud",
"dockerTag": "5.116.13.01",
"message": "There are updates available",
"notificationType": "Bot Event",
"severity": "normal",
"versions": [
"5.116.10.01"
]
}
```