기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Valkey 및 Redis OSS 서버리스 캐시에 대한 지표 및 이벤트
<a name="serverless-metrics-events-redis"></a>

ElastiCache는 서버리스 캐시로 작업할 때 모니터링할 수 있는 다양한 지표와 이벤트를 제공합니다. 여기에는 Amazon EventBridge를 통해 수집할 수 있는 CloudWatch 지표, 명령 수준 지표 및 이벤트 로그가 포함됩니다.

**Topics**
+ [서버리스 캐시 지표](#serverless-metrics)
+ [서버리스 캐시 이벤트](#serverless-events)

## 서버리스 캐시 지표
<a name="serverless-metrics"></a>

`AWS/ElastiCache` 네임스페이스에는 Valkey 또는 Redis OSS 서버리스 캐시에 대한 다음의 CloudWatch 지표가 포함되어 있습니다.

*Valkey 또는 Redis OSS의 지표 코드*


| 지표 | 설명 | 단위 | 
| --- | --- | --- | 
| BytesUsedForCache | 캐시에 저장된 데이터에서 사용되는 총 바이트 수 | 바이트 | 
| ElastiCacheProcessingUnits | 캐시에서 실행된 요청이 사용한 총 ElastiCacheProcessingUnits(ECPU) 수 | 개수 | 
| SuccessfulReadRequestLatency | 성공적인 읽기 요청의 지연 시간 | 마이크로초 | 
| SuccessfulWriteRequestLatency | 성공적인 쓰기 요청의 지연 시간 | 마이크로초 | 
| TotalCmdsCount | 캐시에서 실행된 모든 명령의 총 개수 | 개수 | 
| CacheHitRate | 캐시의 일치율 이는 `cache_hits` 및 `cache_misses` 통계를 사용하여 다음과 같은 방식으로 계산됩니다. `cache_hits /(cache_hits + cache_misses)`  | % | 
| CacheHits | 캐시의 성공한 읽기 전용 키 조회수 | 개수 | 
| CacheMisses | 캐시에서 실패한 읽기 전용 키 조회 수입니다. | 개수 | 
| CurrConnections | 캐시에 대한 클라이언트 연결 수 | 개수 | 
| ThrottledCmds | 워크로드가 ElastiCache가 규모를 조정할 수 있는 속도보다 빠르게 확장되어 ElastiCache에서 병목 현상이 발생한 요청 수 | 개수 | 
| NewConnections | 이 기간에 서버에서 허용된 총 연결 수입니다. | 개수 | 
| CurrItems | 캐시 항목 수입니다. | 개수 | 
| CurrVolatileItems | TTL 포함 캐시의 항목 수 | 개수 | 
| NetworkBytesIn | 캐시로 전송된 총 바이트 수 | 바이트 | 
| NetworkBytesOut | 캐시에서 나간 총 바이트 수 | 바이트 | 
| Evictions | 캐시에서 제거된 키 수 | 개수 | 
| IamAuthenticationExpirations | 만료된 IAM 인증 Valkey 또는 Redis OSS 연결의 총 수입니다. [IAM을 통한 인증](auth-iam.md)에 대한 자세한 내용은 사용 설명서를 참조하세요. | 개수 | 
| IamAuthenticationThrottling | 제한된 IAM 인증 Valkey 또는 Redis OSS AUTH 또는 HELLO 요청의 총 수입니다. [IAM을 통한 인증](auth-iam.md)에 대한 자세한 내용은 사용 설명서를 참조하세요. | 개수 | 
| KeyAuthorizationFailures | 사용자가 액세스 권한이 없는 키에 액세스한 실패한 시도의 총 수입니다. 무단 액세스 시도를 감지하려면 이에 대한 경보를 설정하는 것이 좋습니다. | 개수 | 
| AuthenticationFailures | AUTH 명령을 사용하여 Valkey 또는 Redis OSS에 인증한 실패한 시도의 총 수입니다. 무단 액세스 시도를 감지하려면 이에 대한 경보를 설정하는 것이 좋습니다. | 개수 | 
| CommandAuthorizationFailures | 사용자가 호출 권한이 없는 명령을 실행한 실패한 시도의 총 수입니다. 무단 액세스 시도를 감지하려면 이에 대한 경보를 설정하는 것이 좋습니다. | 개수 | 

**명령 수준 지표**

또한 ElastiCache는 다음과 같은 명령 수준 지표를 내보냅니다. ElastiCache는 각 명령 유형에서 총 명령 수와 해당 명령 유형에서 사용한 ECPU 수를 내보냅니다.


| 지표 | 설명 | 단위 | 
| --- | --- | --- | 
| EvalBasedCmds | 캐시가 수신한 get 명령 수 | 개수 | 
| EvalBasedCmdsECPUs | eval 기반 명령에서 사용하는 ECPU | 개수 | 
| GeoSpatialBasedCmds | 지리 기반 명령의 총 명령 수입니다. 이 지표는 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. 모든 지리 유형의 명령(예: geoadd, geodist, geohash, geopos, georadius, georadiusbymember)을 합산하여 도출됩니다. | 개수 | 
| GeoSpatialBasedCmdsECPUs | geospatial 기반 명령에서 사용하는 ECPU | 개수 | 
| GetTypeCmds | 읽기 전용 유형 명령의 총 수 이 지표는 모든 읽기 전용 유형 명령(예: get, hget, scard, lrange 등)을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| GetTypeCmdsECPUs | 읽기 명령에서 사용되는 ECPU | 개수 | 
| HashBasedCmds | 해시 기반 명령의 총 수입니다. 이 지표는 1개 이상의 해시(예: hget, hkeys, hvals, hdel 등)를 기반으로 실행되는 모든 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| HashBasedCmdsECPUs | hash 기반 명령에서 사용하는 ECPU | 개수 | 
| HyperLogLogBasedCmds | HyperLogLog 기반 명령의 총 수입니다. 이 지표는 모든 pf 유형 명령(예: pfadd, pfcount, pfmerge 등)을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| HyperLogLogBasedCmdsECPUs | HyperLogLog 기반 명령에서 사용하는 ECPU | 개수 | 
| JsonBasedCmds | 읽기 및 쓰기 명령을 포함한 총 JSON 명령 수입니다. 이 지표는 JSON 키를 기반으로 실행되는 모든 JSON 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| JsonBasedCmdsECPUs | 읽기 및 쓰기 명령을 포함한 모든 JSON 명령에서 사용되는 ECPU | 개수 | 
| JsonBasedGetCmds | JSON 읽기 전용 명령의 총 수입니다. 이 지표는 JSON 키를 기반으로 실행되는 모든 JSON 읽기 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| JsonBasedGetCmdsECPUs | JSON 읽기 전용 명령에서 사용하는 ECPU | 개수 | 
| JsonBasedSetCmds | JSON 쓰기 명령의 총 수입니다. 이 지표는 JSON 키를 기반으로 실행되는 모든 JSON 쓰기 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| JsonBasedSetCmdsECPUs | JSON 쓰기 명령에서 사용하는 ECPU | 개수 | 
| KeyBasedCmds | 키 기반 명령 총 수입니다. 이 수는 여러 데이터 구조(예: del, expire, rename 등)에서 1개 이상의 키에 따라 실행되는 모든 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| KeyBasedCmdsECPUs | key 기반 명령에서 사용하는 ECPU | 개수 | 
| ListBasedCmds | 목록 기반 명령 총 수입니다. 이 지표는 1개 이상의 목록(예: lindex, lrange, lpush, ltrim 등)을 기반으로 실행되는 모든 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 파생됩니다. | 개수 | 
| ListBasedCmdsECPUs | 목록 기반 명령에서 사용하는 ECPU | 개수 | 
| NonKeyTypeCmds | 키 기반이 아닌 명령의 총 수입니다. 이 지표는 키를 기반으로 하지 않고 실행되는 모든 명령(예: acl, dbsize, info)을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 파생됩니다. | 개수 | 
| NonKeyTypeCmdsECPUs | 키 기반이 아닌 명령에서 사용하는 ECPU | 개수 | 
| PubSubBasedCmds | pub/sub 기능의 명령 총 수입니다. 이는 pub/sub 기능에 사용되는 모든 명령(예: psubscribe, publish, pubsub, punsubscribe, ssubscribe, sunsubscribe, spublish, subscribe, unsubscribe)을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| PubSubBasedCmdsECPUs | pub/sub 기반 명령에서 사용하는 ECPU | 개수 | 
| SetBasedCmds | 집합 기반 명령 총 수입니다. 이 지표는 1개 이상의 집합(예: scard, sdiff, sadd, sunion 등)을 기반으로 실행되는 모든 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| SetBasedCmdsECPUs | 설정 기반 명령에서 사용하는 ECPU | 개수 | 
| SetTypeCmds | 쓰기 유형의 총 명령 수입니다. 이 수는 데이터(예: set, hset, sadd, lpop 등)에서 작동하는 모든 변형 유형의 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 도출됩니다. | 개수 | 
| SetTypeCmdsECPUs | 쓰기 명령에서 사용하는 ECPU | 개수 | 
| SortedSetBasedCmds | 정렬된 집합 기반 명령 총 수입니다. 이 지표는 1개 이상의 정렬된 집합(예: zcount, zrange, zrank, zadd 등)을 기반으로 실행되는 모든 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 파생됩니다. | 개수 | 
| SortedSetBasedCmdsECPUs | 정렬 기반 명령에서 사용하는 ECPU | 개수 | 
| StringBasedCmds | 문자열 기반 명령 총 수입니다. 이 지표는 1개 이상의 문자열(예: strlen, setex, setrange 등)을 기반으로 실행되는 모든 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 파생됩니다. | 개수 | 
| StringBasedCmdsECPUs | 문자열 기반 명령에서 사용하는 ECPU | 개수 | 
| StreamBasedCmds | 총 스트림 기반 명령 수입니다. 이 지표는 1개 이상의 스트림 데이터 형식(예: xrange, xlen, xadd, xdel 등)을 기반으로 실행되는 모든 명령을 합산하여 Valkey 또는 Redis OSS commandstats 통계에서 파생됩니다. | 개수 | 
| StreamBasedCmdsECPUs | 스트림 기반 명령에서 사용하는 ECPU | 개수 | 

## 서버리스 캐시 이벤트
<a name="serverless-events"></a>



ElastiCache는 서버리스 캐시와 관련된 이벤트를 로그합니다. 여기에는 이벤트 날짜 및 시간, 이벤트의 원본 이름 및 원본 유형, 이벤트 설명 등의 정보가 포함됩니다. ElastiCache 콘솔, AWS CLI describe-events 명령 또는 ElastiCache API 작업을 사용하여 로그에서 이벤트를 쉽게 검색할 수 있습니다`DescribeEvents`.

Amazon EventBridge를 사용하여 ElastiCache 이벤트를 모니터링하고, 수집하고, 변환하고, 조치를 취하도록 선택할 수 있습니다. Amazon EventBridge [시작하기 안내서](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)에서 자세히 알아보세요.

**ElastiCache 이벤트 보기(콘솔)**

ElastiCache 콘솔을 사용하여 이벤트를 보려면 다음과 같이 하세요.

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) ElastiCache 콘솔을 엽니다.

1. 사용 가능한 모든 이벤트의 목록을 보려면 탐색 창에서 **이벤트**를 선택합니다.

1. *이벤트* 화면에서 목록의 각 행은 하나의 이벤트를 나타내며, 이벤트 소스, 이벤트 유형, 이벤트의 GMT 시간 및 이벤트 설명이 표시됩니다. [**Filter**]를 사용하여 이벤트 목록에서 모든 이벤트를 볼지 특정 유형의 이벤트만 볼지를 지정할 수 있습니다.

**ElastiCache 이벤트 보기(AWS CLI)**

를 사용하여 ElastiCache 이벤트 목록을 생성하려면 명령 describe-events를 AWS CLI사용합니다. 선택적 파라미터를 사용하여 나열된 이벤트의 유형, 나열된 이벤트의 기간, 나열할 이벤트의 최대 수 등을 제어할 수 있습니다.

다음 코드는 최대 40개의 서버리스 캐시 이벤트를 나열합니다.

```
aws elasticache describe-events --source-type serverless-cache --max-items 40
```

다음 코드는 지난 24시간(1,440분) 동안 발생한 서버리스 캐시의 모든 이벤트를 나열합니다.

```
aws elasticache describe-events --source-type serverless-cache --duration 1440
```

**서버리스 이벤트**

이 섹션에서는 서버리스 캐시에서 수신할 수 있는 다양한 유형의 이벤트를 설명합니다.

**서버리스 캐시 생성 이벤트**


| Detail-Type | 설명 | 단위 | 소스 | 메시지 | 
| --- | --- | --- | --- | --- | 
| 캐시 생성됨 | 캐시 ARN | 생성 | serverless-cache | <cache-name> 캐시가 생성되어 바로 사용할 수 있습니다. | 
| 캐시 생성됨 | 캐시 ARN<br />스냅샷 경과 시간 | 생성 | serverless-cache | <cache-name> 캐시가 생성되고 스냅샷에서 데이터가 복원되었습니다. 캐시를 사용할 준비가 되었습니다. | 
| 캐시 생성 실패 | 캐시 ARN | 실패 | serverless-cache | <cache-name> 캐시 생성에 실패했습니다. 사용 가능한 IP 주소가 부족하여 VPC 엔드포인트를 생성할 수 없습니다. | 
| 캐시 생성 실패 | 캐시 ARN | 실패 | serverless-cache | <cache-name> 캐시 생성에 실패했습니다. 요청에 잘못된 서브넷이 제공되었습니다. | 
| 캐시 생성 실패 | 캐시 ARN | 실패 | serverless-cache | <cache-name> 캐시 생성에 실패했습니다. VPC 엔드포인트 생성을 위한 할당량 한도에 도달했습니다. | 
| 캐시 생성 실패 | 캐시 ARN | 실패 | serverless-cache | <cache-name> 캐시 생성에 실패했습니다. VPC 엔드포인트를 생성할 수 있는 권한이 없습니다. | 
| 캐시 생성 실패 | 캐시 ARN | 실패 | serverless-cache | <cache-name> 캐시 생성에 실패했습니다. <user-group-name> 사용자 그룹에 호환되지 않는 Valkey 또는 Redis OSS 버전을 사용하는 사용자가 있습니다. | 
| 캐시 생성 실패 | 캐시 ARN<br />캐시 스냅샷 ARN | 실패 | serverless-cache | <cache-name> 캐시 생성에 실패했습니다. 제공된 <user-group-name> 사용자 그룹이 존재하지 않습니다. | 
| 캐시 생성 실패 | 캐시 ARN | 실패 | serverless-cache | <cache-name> 캐시 생성에 실패했습니다. <reason>으로 인해 스냅샷에서 데이터를 복원하지 못했습니다.<br />실패 이유:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/AmazonElastiCache/latest/dg/serverless-metrics-events-redis.html) | 

**서버리스 캐시 업데이트 이벤트(Valkey 또는 Redis OSS)**


| Detail-Type | 리소스 목록 | 카테고리 | 소스 | 메시지 | 
| --- | --- | --- | --- | --- | 
| 캐시 업데이트 | 캐시 ARN | 구성 변경 | serverless-cache | <cache-name> 캐시에 대한 SecurityGroups가 업데이트되었습니다. | 
| 캐시 업데이트 | 캐시 ARN | 구성 변경 | serverless-cache | <cache-name> 캐시에 대한 태그가 업데이트되었습니다. | 
| 캐시 업데이트 실패 | 캐시 ARN | 구성 변경 | serverless-cache | <cache-name> 캐시를 업데이트하지 못했습니다. <user-group-name> 사용자 그룹에 호환되지 않는 Valkey 또는 Redis OSS 버전을 사용하는 사용자가 있습니다. | 
| 캐시 업데이트 실패 | 캐시 ARN | 구성 변경 | serverless-cache | <cache-name> 캐시를 업데이트하지 못했습니다. SecurityGroups를 업데이트하지 못했습니다. | 
| 캐시 업데이트 실패 | 캐시 ARN | 구성 변경 | serverless-cache | <cache-name> 캐시를 업데이트하지 못했습니다. 권한이 충분하지 않아 SecurityGroups를 업데이트하지 못했습니다. | 
| 캐시 업데이트 실패 | 캐시 ARN | 구성 변경 | serverless-cache | <cache-name> 캐시를 업데이트하지 못했습니다. SecurityGroups가 잘못되어 SecurityGroups를 업데이트하지 못했습니다. | 

**서버리스 캐시 삭제 이벤트(Valkey 또는 Redis OSS)**


| Detail-Type | 리소스 목록 | 카테고리 | 소스 | 메시지 | 
| --- | --- | --- | --- | --- | 
| 캐시 삭제 | 캐시 ARN | 삭제 | serverless-cache | <cache-name> 캐시가 삭제되었습니다. | 

**서버리스 캐시 사용 제한 이벤트(Valkey 또는 Redis OSS)**


| Detail-Type | 설명 | 단위 | 소스 | 메시지 | 
| --- | --- | --- | --- | --- | 
| 캐시 업데이트 | 캐시 ARN | 구성 변경 | serverless-cache | <cache-name> 캐시에 대한 한도가 업데이트되었습니다. | 
| 캐시 한도 근접 | 캐시 ARN | 알림 | serverless-cache | 슬롯 <X>가 슬롯당 제한인 32GB의 <Y>%를 초과하여 사용하고 있습니다. 슬롯 10이 슬롯당 제한인 32GB의 90%를 초과하여 사용하고 있습니다. | 
| 캐시 업데이트 실패 | 캐시 ARN | 실패 | serverless-cache | 캐시가 삭제되어 <cache-name> 캐시에 대한 제한이 업데이트되지 못했습니다. | 
| 캐시 업데이트 실패 | 캐시 ARN | 실패 | serverless-cache | 구성이 유효하지 않아 <cache-name> 캐시에 대한 한도가 업데이트되지 못했습니다. | 
| 캐시 업데이트 실패 | 캐시 ARN | 실패 | serverless-cache | 현재 캐시된 데이터가 새 한도를 초과하여 <cache-name> 캐시 한도가 업데이트되지 못했습니다. 제한을 적용하기 전에 일부 데이터를 삭제합니다. | 

**서버리스 캐시 스냅샷 이벤트(Valkey 또는 Redis OSS)**


| Detail-Type | Resources-list | 카테고리 | 소스 | 메시지 | 
| --- | --- | --- | --- | --- | 
| 스냅샷 생성됨 | 캐시 ARN<br />스냅샷 경과 시간 | 생성 | serverless-cache-snapshot | <cache-name> 캐시용으로 생성된 <snapshot-name> 스냅샷입니다. | 
| 스냅샷 생성 실패 | 캐시 ARN<br />스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 생성에 실패했습니다. 고객 관리형 키 <key-id> <reason>으로 인해 <snapshot-name> 스냅샷 생성이 실패했습니다.<br />실패 이유 메시지:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/AmazonElastiCache/latest/dg/serverless-metrics-events-redis.html) | 
| 스냅샷 생성 실패 | 캐시 ARN<br />스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 생성에 실패했습니다. <reason>으로 인해 <snapshot-name> 스냅샷 생성이 실패했습니다.<br />기본 이유:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/AmazonElastiCache/latest/dg/serverless-metrics-events-redis.html) | 
| 스냅샷 내보내기 작업 실패 | 스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 내보내기에 실패했습니다. ElastiCache에 버킷에 대한 권한이 없으므로 스냅샷을 %의 버킷으로 내보낼 수 없습니다. | 
| 스냅샷 내보내기 작업 실패 | 스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 내보내기에 실패했습니다. 버킷에 이미 동일한 이름의 객체가 있으므로 '%'의 버킷으로 스냅샷을 내보낼 수 없습니다. | 
| 스냅샷 내보내기 작업 실패 | 스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 내보내기에 실패했습니다. 버킷 소유자 계정 ID가 변경되었으므로 '%'의 버킷으로 스냅샷을 내보낼 수 없습니다. | 
| 스냅샷 내보내기 작업 실패 | 스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 내보내기에 실패했습니다. S3 버킷에 액세스할 수 없으므로 '%'의 버킷으로 스냅샷을 내보낼 수 없습니다. | 
| 스냅샷 내보내기 작업 실패 | 스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 내보내기에 실패했습니다. 버킷에 액세스할 수 없으므로 '%'의 버킷으로 스냅샷을 내보낼 수 없습니다. | 
| 스냅샷 내보내기 작업 실패 | 스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 내보내기에 실패했습니다. 버킷이 존재하지 않으므로 '%'의 버킷으로 스냅샷을 내보낼 수 없습니다. | 
| 스냅샷 내보내기 작업 실패 | 스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 내보내기에 실패했습니다. 소스 스냅샷 고객 관리형 키 % <reason>과 함께 '%'의 버킷으로 내보낼 수 없습니다. | 
| 스냅샷 내보내기 작업 실패 | 스냅샷 ARN | 실패 | serverless-cache-snapshot | <cache-name> 캐시용 스냅샷 내보내기에 실패했습니다. 스냅샷을 '%'의 버킷으로 내보낼 수 없습니다. | 
| 스냅샷 복사 실패 | 스냅샷 ARN-1<br />스냅샷 ARN-2 | 실패 | serverless-cache-snapshot | <snapshot-name> 스냅샷을 복사하지 못했습니다. 스냅샷 '%'를 소스 스냅샷 고객 관리형 키 <key-id> <reason-name>와 함께 '%'의 스냅샷에 복사할 수 없습니다. | 
| 스냅샷 복사 실패 | 스냅샷 ARN-1<br />스냅샷 ARN-2 | 실패 | serverless-cache-snapshot | <snapshot-name> 스냅샷을 복사하지 못했습니다. 스냅샷 '%'를 타겟 스냅샷 고객 관리형 키 '%' '%'와 함께 스냅샷 '%'에 복사할 수 없습니다. |