このガイドでは、2025 年 3 月 13 日にリリースされた新しい AWS Wickr 管理コンソールについて説明します。AWS Wickr 管理コンソールのクラシックバージョンに関するドキュメントについては、[「 Classic Administration Guide](https://docs.aws.amazon.com/wickr/latest/adminguide-classic/what-is-wickr.html)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Wickr ネットワークのデータ保持メトリクスとイベント
<a name="metrics-events"></a>

以下は、AWS Wickr データ保持ボットの 5.116 バージョンで現在サポートされている Amazon CloudWatch (CloudWatch) メトリックスと Amazon Simple Notification Service (Amazon SNS) イベントです。

**Topics**
+ [Wickr ネットワークの CloudWatch メトリクス](cloudwatch-metrics.md)
+ [Wickr ネットワークの Amazon SNS イベント](sns-events.md)

# Wickr ネットワークの CloudWatch メトリクス
<a name="cloudwatch-metrics"></a>

メトリクスは 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 ネットワークの Amazon SNS イベント
<a name="sns-events"></a>

以下のイベントは、`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 バージョンでは、以下の値がイベントに含まれています。


| 名前 | 値 | 
| --- | --- | 
|  complianceBot  |  データ保持ボットのユーザー名。  | 
|  dataTime  |  イベントが発生したときの日時  | 
|  デバイス  |  特定のボットデバイスまたはインスタンスの説明。複数のボットインスタンスを実行している場合に便利です。  | 
|  dockerImage  |  ボットに関連付けられている Docker イメージ。  | 
|  dockerTag  |  Docker イメージのタグまたはバージョン。  | 
|  メッセージ  |  イベントメッセージ。詳細については、「[重要なイベント](#sns-critical-events)」および「[通常のイベント](#sns-normal-events)」を参照してください。  | 
|  notificationType  |  この値は `Bot Event` になります。  | 
|  severity  |  イベントの重要度。`normal` または `critical` のいずれかを設定できます。  | 

イベントを受信するには、Amazon SNS トピックにサブスクライブする必要があります。E メールアドレスを使用してサブスクライブすると、次の例のような情報を含む E メールが送信されます。

```
{
"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"
}
```

## 重要なイベント
<a name="sns-critical-events"></a>

これらのイベントにより、ボットは停止または再起動します。他の問題を引き起こさないように、再起動の回数は制限されています。

**ログイン失敗**

ボットがログインに失敗した場合に発生する可能性のあるイベントは次のとおりです。各メッセージには、ログインに失敗した理由が示されます。


| イベントタイプ | イベントメッセージ | 
| --- | --- | 
|  failedlogin  |  不正な認証情報。パスワードを確認してください。  | 
|  failedlogin  |  ユーザーが見つかりません。  | 
|  failedlogin  |  アカウントまたはデバイスが停止されています。  | 
|  プロビジョニング  |  ユーザーはコマンドを終了した。  | 
|  プロビジョニング  |  `config.wickr` ファイルのパスワードが不正です。  | 
|  プロビジョニング  |  `config.wickr` ファイルを読み込めません。  | 
|  failedlogin  |  ログインがすべて失敗しました。  | 
|  failedlogin  |  新しいユーザーですが、データベースはすでに存在しています。  | 

**より重大なイベント**


| イベントタイプ | イベントメッセージ | 
| --- | --- | 
|  停止中のアカウント  |  WickrIOClientMain::slotAdminUserSuspend: code(%1): reason: %2“  | 
|  BotDevice Suspended  |  デバイスが停止されました。  | 
|  ウォッチドッグ  |  スイッチボードシステムが <*N*> 分以上停止しています  | 
|  S3 障害  |  ファイル <*file-name*≫ を S3 バケットに配置できませんでした。エラー: <*AWS-error*>  | 
|  フォールバックキー  |  SERVER SUBMIITED FALLBACK KEY: クライアント側で認識されているアクティブなフォールバックキーではありません。デスクトップエンジニアリングにログを送信してください。  | 

## 通常のイベント
<a name="sns-normal-events"></a>

通常の運用状況について警告するイベントは次のとおりです。特定の期間内にこの種のイベントが多発すると、懸念の原因となることがあります。

**デバイスがアカウントに追加されました**

このイベントは、データ保持ボットアカウントに新しいデバイスが追加されたときに生成されます。状況によっては、これは誰かがデータ保持ボットのインスタンスを作成したことを示す重要な指標となることがあります。以下は、このイベントのメッセージです。

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

**Bot がログインしました**

このイベントは、ボットが正常にログインしたときに生成されます。以下は、このイベントのメッセージです。

```
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"
  ]
}
```