이 가이드는 2025년 3월 13일에 릴리스된 새로운 AWS Wickr 관리 콘솔을 문서화합니다. AWS Wickr 관리 콘솔의 클래식 버전에 대한 설명서는 [Classic 관리 안내서](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 지표와 Amazon Simple Notification Service(SNS) 이벤트입니다.

**Topics**
+ [Wickr 네트워크에 대한 CloudWatch 지표](cloudwatch-metrics.md)
+ [Wickr 네트워크에 대한 Amazon SNS 이벤트](sns-events.md)

# Wickr 네트워크에 대한 CloudWatch 지표
<a name="cloudwatch-metrics"></a>

지표는 봇이 1분 간격으로 생성되어 데이터 보존 봇 도커 이미지가 실행되는 계정과 연결된 CloudWatch 서비스에 전송됩니다.

다음은 데이터 보존 봇이 지원하는 기존 지표입니다.


| 지표 | 설명 | 
| --- | --- | 
|  Messages\$1Rx  |  메시지 수신됨  | 
|  메시지\$1Rx\$1실패함  |  수신된 메시지를 처리하지 못했습니다.  | 
|  메시지\$1저장됨  |  받은 메시지 파일에 메시지가 저장되었습니다.  | 
|  메시지\$1저장\$1실패  |  받은 메시지 파일에 메시지를 저장하지 못했습니다.  | 
|  파일\$1저장됨  |  파일을 받았습니다.  | 
|  파일\$1저장\$1바이트  |  받은 파일의 바이트 수  | 
|  파일\$1저장\$1실패  |  파일 저장 실패.  | 
|  로그인  |  로그인(일반적으로 각 간격마다 1회입니다).  | 
|  로그인\$1실패  |  로그인 실패(일반적으로 각 간격마다 1회씩 발생)  | 
|  S3\$1Post\$1Errors  |  Amazon S3 버킷에 메시지 파일 및 파일을 게시하는 중 오류가 발생했습니다.  | 
|  Watchdog\$1실패  |  Watchdog 장애  | 
|  Watchdog\$1경고  |  Watchdog 경고  | 

지표는 CloudWatch에서 사용할 수 있도록 생성됩니다. 봇에 사용되는 네임스페이스는 `WickrIO`입니다. 각 지표에는 차원 배열이 있습니다. 다음은 위 지표와 함께 게시된 측정기준 목록입니다.


| 측정 기준 | 값 | 
| --- | --- | 
|  Id  |  봇의 사용자 이름입니다.  | 
|  장치  |  특정 봇 기기 또는 인스턴스에 대한 설명. 여러 봇 기기 또는 인스턴스를 실행하는 경우 유용합니다.  | 
|  제품  |  봇을 위한 제품입니다. `WickrPro_` 또는 `WickrEnterprise_`에 `Alpha`, `Beta`, 또는 `Production`가 붙을 수 있습니다.  | 
|  BotType  |  봇 유형. 규정 준수스 봇의 경우 **규정 준수**로 분류됩니다.  | 
|  Network  |  연결된 네트워크의 ID.  | 

# Wickr 네트워크에 대한 Amazon SNS 이벤트
<a name="sns-events"></a>

다음 이벤트는 `WICKRIO_SNS_TOPIC_ARN`환경 변수 또는 Secrets Manager `sns_topic_arn` 비밀 값을 사용하여 식별된 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  |  봇과 관련된 도커 이미지.  | 
|  dockerTag  |  도커 이미지의 태그 또는 버전입니다.  | 
|  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"
}
```

## 중요 이벤트
<a name="sns-critical-events"></a>

이러한 이벤트로 인해 봇이 중지되거나 다시 시작됩니다. 다른 문제가 발생하지 않도록 재시작 횟수를 제한합니다.

**로그인 실패**

봇이 로그인하지 못할 때 생성될 수 있는 이벤트는 다음과 같습니다. 각 메시지에는 로그인 실패 이유가 표시됩니다.


| 이벤트 유형 | 이벤트 메시지 | 
| --- | --- | 
|  failedlogin  |  보안 인증이 잘못되었습니다. 비밀번호를 확인합니다.  | 
|  failedlogin  |  사용자를 찾을 수 없습니다.  | 
|  failedlogin  |  계정 또는 기기가 일시 중지되었습니다.  | 
|  provisioning  |  사용자가 명령을 종료합니다.  | 
|  provisioning  |  `config.wickr`파일의 비밀번호가 잘못되었습니다.  | 
|  provisioning  |  `config.wickr`파일을 읽을 수 없습니다.  | 
|  failedlogin  |  로그인이 모두 실패했습니다.  | 
|  failedlogin  |  새 사용자이지만 데이터베이스가 이미 있습니다.  | 

**더 중요한 이벤트**


| 이벤트 유형 | 이벤트 메시지 | 
| --- | --- | 
|  일시 중지된 계정  |  WickrIOClientMain::slotAdminUserSuspend: code(%1): reason: %2“  | 
|  BotDevice Suspended  |  기기가 일시 중지되었습니다\$1  | 
|  WatchDog  |  SwitchBoard 시스템이 <*N*> 분 이상 다운되었습니다.  | 
|  S3 실패  |  S3 버킷에 파일 <*file-name*≫을 넣지 못했습니다. *오류: <AWS-error*>  | 
|  Fallback Key  |  서버에서 제출한 폴백 키: 인식된 클라이언트 활성 폴백 키가 아닙니다. 데스크탑 엔지니어링에 로그를 제출하십시오.  | 

## 일반 이벤트
<a name="sns-normal-events"></a>

다음은 정상 작동 발생에 대해 경고하는 이벤트입니다. 특정 기간 내에 이러한 유형의 이벤트가 너무 많이 발생하는 것은 우려의 원인이 될 수 있습니다.

**계정에 추가된 기기**

이 이벤트는 새 기기가 데이터 보존 봇 계정에 추가될 때 생성됩니다. 경우에 따라 이는 누군가가 데이터 보존 봇의 인스턴스를 생성했다는 중요한 표시일 수 있습니다. 다음은 이 이벤트의 메시지입니다.

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

**봇이 로그인**

이 이벤트는 봇이 성공적으로 로그인했을 때 생성됩니다. 다음은 이 이벤트의 메시지입니다.

```
Logged in
```

**시스템 종료**

이 이벤트는 봇이 종료될 때 생성됩니다. 사용자가 이를 명시적으로 시작하지 않았다면 문제가 있다는 신호일 수 있습니다. 다음은 이 이벤트의 메시지입니다.

```
Shutting down
```

**업데이트 사용 가능**

이 이벤트는 데이터 보존 봇이 시작될 때 생성되며 관련 도커 이미지의 최신 버전을 사용할 수 있음을 식별합니다. 이 이벤트는 봇이 시작될 때 매일 생성됩니다. 이 이벤트에는 사용 가능한 새 버전을 식별하는 `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"
  ]
}
```