tencent cloud

Tencent Cloud Distributed Cache (Redis OSS-Compatible)

ドキュメントTencent Cloud Distributed Cache (Redis OSS-Compatible)Operation GuideOperation Overview

Operation Overview

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-09-14 16:07:57
AI翻訳・品質チェック済み
Distributed Cache (Redis-compatible) provides comprehensive Ops capabilities, including instance management, connection access, monitoring and alarms, network security, backup and restoration, data migration, and diagnostics and optimization. This document summarizes all guides by feature module for on-demand search.

I. Quick Start by Usage Stage

From creating an instance to officially connecting it to your business, you typically go through the following five stages. The required operations for each stage are as follows:
Phase
Target
Required Actions
1. Selection and Purchase
Determine the engine, architecture, specifications, and billing mode.
2. Creating an Instance.
Create an instance and complete the initialization.
3. Network Connection.
Ensure that clients can access the instance.
4. Service Integration.
Establish a connection in the business code.
5. Ops Assurance.
Establish observability and data protection capabilities.

II. Feature Module Index

The operation guide contains 20 feature modules. The following table describes the problems that each module solves. You can click a module name to navigate to the corresponding detail table in this document.
No.
Feature Module
Problem Solved
1
Viewing instance information, changing specifications, clearing, returning, terminating, and other lifecycle operations
2
Connection methods for various clients and development languages
3
Engine major and minor version upgrades, standard architecture upgrade to cluster architecture, and proxy upgrade
4
Viewing node information, replica promotion to primary, read-only replica, and failure simulation
5
Multi-AZ deployment configuration, AZ change, and nearby access
6
Viewing monitoring metrics, full-link monitoring, and alarm and event rule configuration
7
Network change, bandwidth adjustment, security group, SSL encryption, and public network access
8
Account creation and authorization, password reset, and password complexity policy
9
Instance parameter and parameter template management, and usage instructions for key parameters
10
Backup rule configuration, backup encryption, backup file download, and instance clone
11
Slow query logs, error log viewing, and log delivery
12
Viewing pending Ops events and adjusting execution plans
13
Accessing instances through the Sentinel protocol
14
CAM-based sub-account permission management and policy configuration
15
Migrating self-built or third-party databases to the cloud, and cross-instance data migration
16
Exception diagnosis, performance trends, and big Key and hot Key analysis
17
Enabling, querying, and delivering full SQL audit logs
18
Viewing and tracking asynchronous operation tasks of instances
19
Cross-region data synchronization and region-level disaster recovery

III. Managing Instances

An instance is the smallest service unit of Distributed Cache, and each instance represents an independent cache service. The following operations cover the complete instance lifecycle from viewing and modifying to reclamation.

3.1 Viewing and Information Maintenance

Operation
Description
Documentation
Viewing Redis Edition and Valkey Edition Instances
View instance list, specifications, network, status, and other information
Viewing Memcached Edition Instances
How to View Information About Memcached Edition Instances
Reassigning Project for Instance
Classify instances by project to facilitate permission delegation and cost allocation.
Editing Instance Tags
Group instances by tag for filtering and cost allocation.
Setting Maintenance Time Window
Specify the execution time window for Ops operations to avoid peak business hours.

3.2 Specification and Capacity Changes

Operation
Description
Documentation
Changing Instance Specification
Adjust memory capacity, replica quantity, or number of shards
Adjust the Quantity of Connections
Add connection quota above the default specification value
Purchase with Same Configuration
Quickly create an instance using the configuration of an existing instance as a template.

3.3 Data Cleanup and Instance Reclamation

Operation
Description
Documentation
Clearing Instance Data
Clear all data in the instance at once while retaining the instance itself.
Eliminate/Restore Instances
Temporarily stop the instance from providing external services, and restore it when needed.
Returning/Terminating an Instance
Return the instance, and permanently terminate it after the recycle bin isolation period ends.
Setting Instance Termination Protection
After it is enabled, a second confirmation is required before termination to prevent accidental operations.
Note:
Returned instances are first moved to the recycle bin for isolation. They can be restored during the isolation period, but data cannot be recovered after the isolation period ends. Confirm that data backup is completed before proceeding.

IV. Connecting to Database Instances

4.1 Connection Methods

Operation
Description
Documentation
Preparing for Connection
Network, Account, Password, and Client Conditions to Verify Before Connection
Connecting to Instances
Connect to an instance through DMC, redis-cli, or other methods.
Connecting in Sentinel Mode
Discover master nodes on the client side through the Sentinel protocol.

4.2 Client Connection Examples

Development Language
Documentation
Java
Python
Go
Node.js
PHP
C
.Net

V. Upgrading Version and Architecture

Operation
Description
Documentation
Upgrading the Instance Version
Upgrade the engine major or minor version to obtain new features and bug fixes.
Upgrading Instance Architecture
Upgrade the standard architecture to the cluster architecture to break through the capacity and performance limits of a single shard.
Proxy Upgrade
Upgrade the Proxy version independently, decoupled from the engine version.
Note:
An upgrade involves node switchover. We recommend that you perform the upgrade within the maintenance window and confirm that clients support reconnection. For version differences, see Major Version Feature List and Version Lifecycle Plan.

VI. Managing Nodes (Redis/Valkey Edition)

Operation
Description
Documentation
Viewing Node Information
View the primary/secondary node distribution, AZ, and running status of each shard.
Promotion of replica nodes to primary nodes
Manually promote the specified replica node to master node.
Read-Only Replicas
Enable read/write separation to route read requests to replica nodes.
Switching Proxy Nodes
Manually switch Proxy nodes for troubleshooting and verification.
Fault Simulation
Proactively inject faults to verify the disaster recovery and reconnection capabilities of the service.
Note:
After read-only replicas are enabled, data on replica nodes is slightly delayed compared to the master node. Read requests that require strong consistency should be routed to the master node. For details, see Read/Write Separation.

VII. Managing AZs

Operation
Description
Documentation
Configure multiple AZs.
Distribute instance nodes across multiple AZs to achieve data center-level disaster recovery.
Change AZ.
Adjust the AZ where the instance resides, or change from a single AZ to multiple AZs.
Access multi-AZ instances.
Client access and nearby access configuration in multi-AZ scenarios
Note:
To enable clients to preferentially access nodes in the same AZ and reduce cross-AZ latency, configure local access through the read-local-node-only parameter. For architectural details, see Multi-AZ Deployment.

VIII. Monitoring and Alarms

8.1 Viewing Monitoring Data

Operation
Description
Documentation
Monitoring Overview
Capabilities, collection granularity, and data retention policies of the monitoring system
Monitoring metrics
Descriptions, units, and value explanations of all monitoring metrics
Viewing Monitoring Data.
View monitoring curves by instance, node, and Proxy dimension in the console.
Monitoring Instances (Memcached Edition)
How to View Monitoring Data of Memcached Edition Instances
Multi-instance comparative monitoring
Overlay and compare the same metric across multiple instances to quickly locate abnormal instances.

8.2 Full-Link Monitoring

End-to-end monitoring displays the latency of clients, proxies, and data nodes in a correlated manner, helping you identify whether latency originates from the network, the Proxy layer, or the engine.
Operation
Description
Documentation
Solution Overview
Architecture, capability boundaries, and prerequisites of end-to-end monitoring
Enable Full-Link Feature.
Enable full-link monitoring in the console.
Client Configurations
Client-side event tracking and reporting configuration
Visualization Display
View link topology and segment latency.

8.3 Alarms and Events

Operation
Description
Documentation
Configure Alarm.
Set thresholds, alarm channels, and recipients for key metrics.
Create Event Rule.
Configure notification rules for events such as node switchover and memory overlimit.

IX. Network and Security

9.1 Network Configuration

Operation
Description
Documentation
Network change.
Change the VPC and subnet of the instance.
Adjusting Bandwidth
Purchase additional bandwidth beyond the standard bandwidth to handle traffic peaks.
Enabling Public Network Access.
Assign a public network access address to the instance.
Enabling Public Network Services Through CLB.
Provide external access through CLB.
Iptable Forwarding
Enable cross-network access through CVM forwarding.

9.2 Access Security

Operation
Description
Documentation
Configure Security Group.
Control the source IP addresses and ports for accessing the instance through a virtual firewall.
SSL Encryption
Enable transport link encryption to prevent data from being stolen during transmission.
Configure Disabled Commands.
Block high-risk commands such as FLUSHALL and KEYS.
Note:
A security group is a stateful virtual firewall that controls network access to one or more instances and serves as an important network isolation mechanism. We recommend that you follow the principle of least privilege and allow access only to the source IPs and ports required by your business.

X. Account Management

Operation
Description
Documentation
Manage an account.
Create a sub-account and assign read/write or read-only permissions.
Reset Password.
Modify the access password of the instance.
Set Password Complexity.
Configure password length and character combination rules to enhance password strength.
Password-Free Access
Connect to an instance without a password within a trusted VPC.
Note:
Password-free access lowers the access barrier and is recommended only in test environments with sufficient network isolation. In production environments, enable password authentication and use security groups to restrict access sources.

XI. Parameter Configuration

11.1 Parameter and Template Management

Operation
Description
Documentation
Managing Instance Parameters.
View and modify the running parameters of a single instance.
Managing Parameter Templates.
Convert parameter sets into templates and apply them to multiple instances in batches.
Configurable Parameter List
Value ranges, default values, and effective methods of all modifiable parameters

11.2 Instructions for Key Parameters

Some parameters directly affect access behavior and disaster recovery policies. We recommend that you read the corresponding descriptions before using them.
Parameter
Function
Documentation
local-client-list
Obtain client information of the connected instance to troubleshoot connection sources.
disable-command-list
Disable high-risk commands to reduce data risks caused by misoperations.
read-local-node-only
Prioritize access to nodes in the same AZ to reduce cross-AZ latency.
auto-failback
Automatically switch back after master node restoration to maintain the original node distribution across AZs.

XII. Backup and Recovery

Operation
Description
Documentation
Backup and Restoration Overview
Overview of backup types, retention periods, and restoration capabilities
Configure backup rules.
Set the execution time and retention period for automatic backups.
Enable backup encryption.
Encrypt backup files at rest to meet compliance requirements.
Configure backup file download method.
Restrict download sources and network types for backup files.
Backup file download.
Download backup files to a local or specified environment.
Clone instance (Redis/Valkey edition)
Create a new data-consistent instance from a backup set.
Clone an instance (Memcached Edition).
Cloning method for Memcached edition instances

XIII. Log Center

Operation
Description
Documentation
SLow log (Redis/ValKey Edfition)
View commands whose execution time exceeds the threshold to identify performance bottlenecks.
Slow query (Memcached edition)
How to View Slow Queries of Memcached Edition Instances
Error logs
View error logs generated during instance running.
Log shipping
Deliver logs to CLS for long-term retention and search.

XIV. Event Management (Redis/Valkey Edition)

Operation
Description
Documentation
View Pending Events.
View pending Ops events such as version upgrades and hardware maintenance.
Modify Event Execution Plan.
Adjust the execution time of the event to control the impact during off-peak hours.

XV. Sentinel Mode

Operation
Description
Documentation
Sentinel Mode
Obtain the master node address through the Sentinel protocol and adapt to the existing Sentinel client architecture.

XVI. CAM

Operation
Description
Documentation
CAM Overview
Implement sub-account permission isolation based on CAM.
Authorization Policy Syntax
Policy structure, elements, and writing rules
Authorizable Resource Type
APIs that support resource-level authorization and resource description methods

XVII. Data Migration

17.1 Solution Selection

Operation
Description
Documentation
Migration Solution Overview
Compare applicable sources, downtime, and limitations of each migration solution.

17.2 Migration with DTS

DTS supports data migration without service downtime and is the recommended solution for migrating self-built instances to the cloud.
Operation
Description
Documentation
Supported Capability
Supported Source Types, Versions, and Architecture Combinations
Usage Instructions
Preparation Items and Precautions Before Migration
Migration Instructions
Complete Steps for Creating and Executing a Migration Task
Checking Standard Architecture to Cluster Architecture Migration
Compatibility Check Items Before Cross-Architecture Migration
Creating a Data Consistency Check Task.
Verify data consistency between the source and target after migration.
Key Prefix Filtering
Filter the migration scope by Key prefix to migrate partial data.
Pre-Migration Check Items: The following checks are performed before a migration task starts. If any check fails, the task will fail.
Check Item
Documentation
Whether the Source Instance Is a Replica Node
Whether the Target Instance Status Is Normal
Whether the Target Instance Capacity Meets Requirements
Source Instance Parameter Check
Network Reachability
Compatibility Between Source and Target Instance Versions
Common Errors and Their Solutions

17.3 Other Migration Solutions

Operation
Description
Documentation
Migrating with redis-port
Import and export data through tools, suitable for offline migration scenarios.
Data Migration Solution from PIKA to Redis
Migrate from PIKA to a distributed cache database
Data Migration Solution from SSDB to Redis
Migrate from SSDB to a distributed cache database

XVIII. Diagnosis and Optimization (DBbrain)

DBbrain provides automated performance diagnostics and optimization suggestions, turning anomaly identification from manual investigation into system alerts.
Operation
Description
Documentation
Overview
Scope and Prerequisites of Diagnosis and Optimization
Enable Automatic Capacity Expansion (Autonomy Task).
Automatically expand capacity when it approaches the upper limit to prevent service damage caused by full memory.
Exception Diagnosis
View instance health scores and root cause analysis of abnormal events.
Performance Trend
Observe changes in core performance metrics by time dimension.
Real-Time Session
View current connections and commands being executed.
Slow Log Analysis
Aggregate slow logs and identify high-frequency slow commands.
Memory Analysis (Big Key Analysis)
Locate keys that occupy excessive memory.
Latency Analysis
Analyze the overall distribution of request latency.
Latency Analysis (Command Word Analysis)
Break down latency by command dimension.
Latency Analysis (Hot Key Analysis)
Locate keys with abnormally concentrated access frequency.

XIX. Database Audit

Operation
Description
Documentation
Audit Overview
Recording scope, storage, and billing description of audit capabilities
Enabling Database Audit.
Enable auditing for an instance and set a log retention policy.
Viewing Audit Instances.
View instances with auditing enabled and their configurations.
Managing Audit Logs.
Search, filter, and download audit logs.
Configuring Log Shipping.
Deliver audit logs to an external system for retention.
Modifying Audit Configurations.
Adjust audit rules and log retention period.
Disabling Database Audit.
Stop auditing and process existing logs.

XX. Task Management

Operation
Description
Documentation
Task Management
View the execution progress and results of asynchronous tasks such as specification changes, migrations, and upgrades.

XXI. Global Replication (Redis Edition)

Global replication establishes data synchronization relationships across multiple regions, enabling local reads and region-level disaster recovery.
Operation
Description
Documentation
Global Replication Overview
Architecture principles and applicable scenarios of replication groups
Use Limits
Supported Region, Version, and Architecture Limitations
Creating a Global Replication Group.
Create a replication group and add member instances.
Managing a Global Replication Group.
Adjust member roles, switch the master instance, and remove members.
Monitoring metrics
Global replication-specific monitoring metrics such as replication latency

XXII. Related Documentation

In addition to the operation guide, the following sections can help you with selection, development, and troubleshooting.
Column
Application scenarios
Entries
Getting Started
When using the product for the first time, you need a complete getting-started path.
Product Introduction
Learn about engine, architecture, specifications, and region support.
Purchase Guide
Confirm billing mode, configuration change billing, and renewal and refund rules.
API documentation
Achieve automated Ops through APIs.
Command Reference
Query command support status and version differences
Development Guidelines
Standardize Key design, command usage, and client implementation.
Use Cases
Refer to complete implementation plans for typical scenarios.
FAQs
Troubleshoot connection, performance, and migration issues.
Glossary
Query term definitions.
前の記事へ: Connecting to an Instance (Redis/Valkey Edition)次の記事へ: Connection Preparation

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック

キーワードで検索
    Enter keywords to search documentation