AWS AmazonElastiCache documentation change
Summary
Expanded documentation for self-designed cluster metrics and events, including detailed event descriptions, viewing methods via console/CLI, and 20+ specific event types with explanations
Security assessment
While the changes document security-related events like 'CacheClusterSecurityGroupModified' and 'CertificateRenewalComplete', these are standard operational events rather than addressing specific vulnerabilities. The documentation adds information about security features like certificate management and security group modifications, but no evidence of patching vulnerabilities.
Diff
diff --git a/AmazonElastiCache/latest/dg/self-designed-metrics-events.valkey-and-redis.md b/AmazonElastiCache/latest/dg/self-designed-metrics-events.valkey-and-redis.md index 0e8ad6837..c215aa3e3 100644 --- a//AmazonElastiCache/latest/dg/self-designed-metrics-events.valkey-and-redis.md +++ b//AmazonElastiCache/latest/dg/self-designed-metrics-events.valkey-and-redis.md @@ -4,0 +5,2 @@ +Self-designed cluster metricsSelf-designed cluster events (Valkey and Redis OSS) + @@ -11 +13,73 @@ ElastiCache offers a wide variety of metrics and events for monitoring self-desi - * [Metrics for self-designed clusters](./self-designed-metrics.redis.html) + * Metrics for self-designed clusters + + * Events for self-designed clusters (Valkey and Redis OSS) + + + + +## Metrics for self-designed clusters + +When you self-design clusters, ElastiCache emits metrics at each node level, including both host-level metrics and cache metrics. + +For more information on host-level metrics, see [Host-Level Metrics](./CacheMetrics.HostLevel.html). + +For more information on node-level metrics, see [Metrics for Valkey and Redis OSS](./CacheMetrics.Redis.html). + +## Events for self-designed clusters (Valkey and Redis OSS) + +ElastiCache logs events that relate to your self-designed caches. When working with self-designed clusters, you can view your cluster events in the ElastiCache console, using the AWS CLI, or using Amazon Simple Notification Service (SNS). Self-designed cluster events are not published to Amazon EventBridge. + +Self-designed cluster event information includes the date and time of the event, the source name and source type of the event, and a description of the event. You can easily retrieve events from the log using the ElastiCache console, the AWS CLI describe-events command, or the ElastiCache API action DescribeEvents. + +Viewing ElastiCache events (Console) + +The following procedure displays events using the ElastiCache console. + +To view events using the ElastiCache console + + 1. Sign in to the AWS Management Console and open the ElastiCache console at [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) + + 2. To see a list of all available events, in the navigation pane, choose Events. + + 3. On the Events screen each row of the list represents one event and displays the event source, the event type, the GMT time of the event, and a description of the event. Using the Filter you can specify whether you want to see all events, or just events of a specific type in the event list. + + + + +Viewing ElastiCache events (AWS CLI) + +To generate a list of ElastiCache events using the AWS CLI, use the command describe-events. You can use optional parameters to control the type of events listed, the time frame of the events listed, the maximum number of events to list, and more. + +The following code lists up to 40 self-designed cluster events. + + + aws elasticache describe-events --source-type cache-cluster --max-items 40 + +The following code lists all events for self-designed caches for the past 24 hours (1440 minutes). + + + aws elasticache describe-events --source-type cache-cluster --duration 1440 + +Self-designed cluster events + +This section contains the list of events you can expect to receive for your self-designed clusters. + +The following ElastiCache events trigger Amazon SNS notifications. For information on event details, see [Viewing ElastiCache events](./ECEvents.Viewing.html). + +Event Name | Message | Description +---|---|--- +ElastiCache:AddCacheNodeComplete | `ElastiCache:AddCacheNodeComplete : `cache-cluster`` | A cache node has been added to the cache cluster and is ready for use. +ElastiCache:AddCacheNodeFailed due to insufficient free IP addresses | `ElastiCache:AddCacheNodeFailed : `cluster-name`` | A cache node could not be added because there are not enough available IP addresses. +ElastiCache:CacheClusterParametersChanged | `ElastiCache:CacheClusterParametersChanged : `cluster-name`` | One or more cache cluster parameters have been changed. +ElastiCache:CacheClusterProvisioningComplete | `ElastiCache:CacheClusterProvisioningComplete `cluster-name-0001-005`` | The provisioning of a cache cluster is completed, and the cache nodes in the cache cluster are ready to use. +ElastiCache:CacheClusterProvisioningFailed due to incompatible network state | `ElastiCache:CacheClusterProvisioningFailed : `cluster-name`` | An attempt was made to launch a new cache cluster into a nonexistent virtual private cloud (VPC). +ElastiCache:CacheClusterScalingComplete | `CacheClusterScalingComplete : `cluster-name`` | Scaling for cache-cluster completed successfully. +ElastiCache:CacheClusterScalingFailed | ElastiCache:CacheClusterScalingFailed : `cluster-name` | Scale-up operation on cache-cluster failed. +ElastiCache:CacheClusterSecurityGroupModified | `ElastiCache:CacheClusterSecurityGroupModified : `cluster-name`` | One of the following events has occurred: + + * The list of cache security groups authorized for the cache cluster has been modified. + * One or more new EC2 security groups have been authorized on any of the cache security groups associated with the cache cluster. + * One or more EC2 security groups have been revoked from any of the cache security groups associated with the cache cluster. + + +ElastiCache:CacheNodeReplaceStarted | `ElastiCache:CacheNodeReplaceStarted : `cluster-name`` | ElastiCache has detected that the host running a cache node is degraded or unreachable and has started replacing the cache node. @@ -13 +87 @@ ElastiCache offers a wide variety of metrics and events for monitoring self-desi - * [Events for self-designed clusters (Valkey and Redis OSS)](./self-designed-events-redis.html) +###### Note @@ -14,0 +89,2 @@ ElastiCache offers a wide variety of metrics and events for monitoring self-desi +The DNS entry for the replaced cache node is not changed. In most instances, you do not need to refresh the server-list for your clients when this event occurs. However, some cache client libraries may stop using the cache node even after ElastiCache has replaced the cache node; in this case, the application should refresh the server-list when this event occurs. +ElastiCache:CacheNodeReplaceComplete | `ElastiCache:CacheNodeReplaceComplete : `cluster-name`` | ElastiCache has detected that the host running a cache node is degraded or unreachable and has completed replacing the cache node. @@ -15,0 +92 @@ ElastiCache offers a wide variety of metrics and events for monitoring self-desi +###### Note @@ -16,0 +94,17 @@ ElastiCache offers a wide variety of metrics and events for monitoring self-desi +The DNS entry for the replaced cache node is not changed. In most instances, you do not need to refresh the server-list for your clients when this event occurs. However, some cache client libraries may stop using the cache node even after ElastiCache has replaced the cache node; in this case, the application should refresh the server-list when this event occurs. +ElastiCache:CacheNodesRebooted | `ElastiCache:CacheNodesRebooted : `cluster-name`` | One or more cache nodes has been rebooted. Message (Memcached): `"Cache node %s shutdown"` Then a second message: `"Cache node %s restarted"` +ElastiCache:CertificateRenewalComplete (Valkey or Redis OSS only) | `ElastiCache:CertificateRenewalComplete` | The Amazon CA certificate was successfully renewed. +ElastiCache:CreateReplicationGroupComplete | `ElastiCache:CreateReplicationGroupComplete : `cluster-name`` | The replication group was successfully created. +ElastiCache:DeleteCacheClusterComplete | `ElastiCache:DeleteCacheClusterComplete : `cluster-name`` | The deletion of a cache cluster and all associated cache nodes has completed. +ElastiCache:FailoverComplete (Valkey or Redis OSS only) | `ElastiCache:FailoverComplete : `mycluster`` | Failover over to a replica node was successful. +ElastiCache:ReplicationGroupIncreaseReplicaCountFinished | `ElastiCache:ReplicationGroupIncreaseReplicaCountFinished : `cluster-name-0001-005`` | The number of replicas in the cluster has been increased. +ElastiCache:ReplicationGroupIncreaseReplicaCountStarted | `ElastiCache:ReplicationGroupIncreaseReplicaCountStarted : `cluster-name-0003-004`` | The process of adding replicas to your cluster has begun. +ElastiCache:NodeReplacementCanceled | `ElastiCache:NodeReplacementCanceled : `cluster-name`` | A node in your cluster that was scheduled for replacement is no longer scheduled for replacement. +ElastiCache:NodeReplacementRescheduled | `ElastiCache:NodeReplacementRescheduled : `cluster-name`` | A node in your cluster previously scheduled for replacement has been rescheduled for replacement during the new window described in the notification. For information on what actions you can take, see [Replacing nodes (Valkey and Redis OSS)](./CacheNodes.NodeReplacement.html). +ElastiCache:NodeReplacementScheduled | `ElastiCache:NodeReplacementScheduled : `cluster-name`` | A node in your cluster is scheduled for replacement during the window described in the notification. For information on what actions you can take, see [Replacing nodes (Valkey and Redis OSS)](./CacheNodes.NodeReplacement.html). +ElastiCache:RemoveCacheNodeComplete | `ElastiCache:RemoveCacheNodeComplete : `cluster-name`` | A cache node has been removed from the cache cluster. +ElastiCache:ReplicationGroupScalingComplete | `ElastiCache:ReplicationGroupScalingComplete : `cluster-name`` | Scale-up operation on replication group completed successfully. +ElastiCache:ReplicationGroupScalingFailed | `"Failed applying modification to cache node type to %s."` | Scale-up operation on replication group failed. +ElastiCache:ServiceUpdateAvailableForNode | `"Service update is available for cache node %s."` | A self-service update is available for the node. +ElastiCache:SnapshotComplete (Valkey or Redis OSS only) | `ElastiCache:SnapshotComplete : `cluster-name`` | A cache snapshot has completed successfully. +ElastiCache:SnapshotFailed (Valkey or Redis OSS only) | `SnapshotFailed : `cluster-name`` | A cache snapshot has failed. See the cluster’s cache events for more a detailed cause. If you describe the snapshot, see [`DescribeSnapshots`](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeSnapshots.html), the status will be `failed`. @@ -26 +120 @@ Serverless metrics and events for Valkey and Redis OSS -Self-designed cluster metrics +Metrics and events for Memcached