本頁說明各種問題、相關錯誤訊息,以及解決問題的疑難排解步驟。
連線問題
如果 Memorystore for Redis 執行個體發生連線問題,請查看本節中的問題,確認是否為其中一項問題所致。
如果本節中的問題與您的問題不符,請透過 Telnet 連線至其中一個 Redis 節點,並執行一些 Redis 指令,看看執行個體是否回應。
如果節點沒有回應,請查看是否有任何網路問題導致節點的網路連線遭到封鎖。如果上述方法都無法解決問題,請與 Cloud Customer Care 聯絡。
您在不同的虛擬私有雲網路中佈建資源。
如要從 Google Cloud 資源 (例如 Compute Engine VM) 連線至 Memorystore for Redis 執行個體,您必須在與執行個體相同的授權虛擬私有雲網路上佈建資源。
如果嘗試從不同區域或虛擬私有雲網路中的資源,透過 Telnet 連線至執行個體,會出現下列錯誤訊息:
telnet: Unable to connect to remote host: Connection timed out
刪除虛擬私有雲網路對等互連。
建立 Memorystore for Redis 執行個體時,您會在虛擬私有雲網路和內部 Google 虛擬私有雲網路之間建立虛擬私有雲對接。
網路對等互連的格式如下:
redis-peer-############
如果刪除這個網路對等互連,嘗試透過 Telnet 連線至執行個體時,會出現下列錯誤訊息:
telnet: Unable to connect to remote host: Connection timed out
如要重新建立已刪除的網路對等互連,請建立其他執行個體。接著,刪除這個執行個體。原始執行個體現在已具備所需的網路對接。
建立防火牆規則,封鎖執行個體的 IP 位址。
如果您建立的輸出防火牆規則會封鎖 Memorystore for Redis 執行個體的通訊埠 (6379) 或 IP 位址,可能會發生連線問題。請勿建立會封鎖執行個體 IP 位址範圍的網路防火牆規則。
有連線未回應
強烈建議您設定用戶端應用程式,偵測 Memorystore for Redis 連線是否無回應。偵測到無回應的連線時,用戶端必須重設連線。如要建構彈性應用程式,建議您採用下列用戶端設定:
- 設定 TCP 保持運作參數:設定
TCP keepalive time、TCP keepalive interval和TCP keepalive probes參數,讓用戶端主動偵測並捨棄無回應的連線,即使連線處於閒置狀態也一樣。舉例來說,如果將TCP keepalive time參數設為 30 秒、TCP keepalive interval設為 10 秒,並將TCP keepalive probes設為 3,用戶端就會在一分鐘內重設無回應的閒置連線。 - 設定 TCP 使用者逾時:在用戶端設定這項逾時,重設有未完成要求且停止回應的連線。舉例來說,如果將逾時時間設為 15 秒,用戶端會在 15 秒後重設有未完成要求且沒有回應的連線。
Memorystore for Redis 拒絕新的連線嘗試
啟用傳輸中資料加密功能後,每個 Memorystore for Redis 容量級別都會強制執行連線數量上限。如果執行個體達到這個上限,Memorystore for Redis 就會拒絕新的連線嘗試。
如要解決這個問題,請按照下列其中一種做法進行:
- 將執行個體擴充至支援所需連線數量的容量級別
- 建立並重複使用長時間執行的連線,減少連線總數
您可以使用 redis.googleapis.com/clients/connected 指標監控有效連線數量。如果 Memorystore for Redis 拒絕新的連線嘗試,但連線數量低於上限,請檢查用戶端記錄 (例如 stunnel 記錄) 是否有錯誤。
Memorystore for Redis 捨棄現有連線
如果執行個體執行 Redis 6.x 以下版本,且已啟用傳輸中加密功能,Memorystore for Redis 會每 180 天輪替一次伺服器端憑證。這項輪替作業可能會導致執行個體中斷連線幾秒鐘。
如要解決這個問題,請設定用戶端應用程式,讓其使用指數輪詢重試連線,自動重新連線。如果將執行個體升級至 Redis 7.0 以上版本,Memorystore for Redis 就不會在輪替憑證時中斷連線。
CPU 使用率問題
本節說明 Memorystore for Redis 執行個體可能遇到的 CPU 使用率問題。
執行個體延遲時間過長或沒有回應。
如果 Memorystore for Redis 執行個體延遲時間過長或沒有回應,可能是因為使用了下列需要大量資源的 Redis 指令:
這些指令可能會對執行個體造成沉重的 CPU 壓力。建議您不要在正式環境中執行 KEYS 指令。請改用 SCAN,因為這個指令使用的資源比 KEYS 少。
使用 LRANGE 查詢全部或大部分鍵空間,可能會耗用大量 CPU 資源。如要解決這個問題,建議您減少在單一作業中查詢的金鑰組金鑰數量。
搭配 EVAL 使用複雜的 Lua 指令碼,也可能導致 CPU 使用率偏高。建議您使用較不複雜的 Lua 指令碼。
HGETALL 和 ZRANGE 可能會傳回大量金鑰,對伺服器效能造成負面影響。建議您執行 HSCAN 指令,而非 HGETALL。此外,在使用 ZRANGE 之前,建議您限制查詢範圍的大小。
執行需要大量資源的指令前,請先檢查指令查詢的資料結構大小,確保不會造成延遲。
如果執行個體延遲時間過長或沒有回應,請執行下列操作:
- 查看用戶端記錄,確認是否有任何指令占用大量資源。如果是,請記下日期和時間。
- 使用 Cloud Monitoring 查看
redis.googleapis.com/stats/cpu_utilization指標。查看 CPU 使用率偏高的時段,是否與執行資源密集指令的時段重疊。
執行個體的輸出緩衝區空間不足。
如果 Memorystore for Redis 執行個體的輸出緩衝區空間用盡,請按照下列步驟操作:
- 為
maxmemory-gb參數設定較小的值。 - 使用
allkeys-lrumaxmemory政策。
當執行個體的記憶體已滿,且有新的寫入作業時,Memorystore for Redis 會根據執行個體的 maxmemory 政策,剔除金鑰來騰出空間給寫入作業。allkeys-lru 政策會從整個金鑰集中,剔除最近最少使用 (LRU) 的金鑰。
建議您監控執行個體的 maxmemory 和已用記憶體。這有助於瞭解執行個體是否達到佈建的執行個體容量。此外,降低 maxmemory-gb 參數的值,可為負載提供更多空間。
執行個體缺少外部指標
如果執行個體的 CPU 使用率偏高,或執行個體的資源耗盡 (例如連線過多),執行個體可能會發生異常行為,且外部指標可能會遺失。
找出執行個體延遲的來源
如要判斷延遲時間是否源自執行個體、用戶端應用程式或網路環境,請使用 redis-cli 工具執行連續延遲時間測試。
如要找出執行個體延遲的來源,請按照下列步驟操作:
連線至與執行個體位於相同區域和虛擬私有雲網路的 Compute Engine VM。
如果尚未安裝,請在 VM 上安裝
redis-cli工具。如果是 Debian 或 Ubuntu VM,請執行下列指令:
sudo apt-get install redis-tools如果是 RHEL 或 CentOS 虛擬機器,請執行下列指令:
sudo yum install redis
如要測量執行個體的延遲時間 (以毫秒為單位),請執行下列指令:
redis-cli --latency -h IP_ADDRESS -p PORT
如果執行個體已啟用 Redis AUTH 或傳輸中資料加密功能,請務必附加必要的驗證 (
-a) 或 TLS (--tls) 旗標。請依指示取代下列項目:
- IP_ADDRESS:執行個體的 IP 位址。
- PORT:為執行個體保留的通訊埠編號。這個通訊埠編號通常是 6379。
讓指令執行幾分鐘。這項工具會持續對伺服器執行連線偵測 (ping),並計算最低、最高和平均延遲時間值。
如要停止指令並查看結果,請按下
Ctrl+C。
如果指令輸出的平均延遲時間持續偏低 (通常為 1 毫秒以下),表示執行個體運作正常且回應速度很快。
如果指令顯示的延遲時間持續偏低,但用戶端應用程式仍有延遲,則可能是下列問題導致延遲:
- 網路:如果流量在用戶端和執行個體之間跨不同區域或可用區轉送,可能會導致嚴重的網路延遲。
- 用戶端:用戶端的 CPU 或記憶體使用率過高、連線集區耗盡,或應用程式邏輯瓶頸,都可能增加用戶端體驗的總封包往返時間。
網路問題
本節說明執行個體可能遇到的網路問題。
分配的 IP 範圍已用盡,或有衝突的路由。
在 Memorystore for Redis 專用的 IP 位址範圍內建立資源時,可能會用盡所有 IP 位址。或者,可能有路徑與您嘗試建立的 Memorystore for Redis 執行個體 IP 位址衝突。
這些問題會導致系統顯示下列錯誤訊息:
The IP ranges for the connection do not have enough available IPs. Allocate a
new range or expand existing range and try again.
如要解決這個問題,請分配額外的 IP 位址,或移除路由衝突差異。詳情請參閱「IP 位址範圍耗盡」。
您尚未為網路建立私人服務存取連線。
如果 Memorystore for Redis 執行個體使用私人服務存取連線模式,但您的網路沒有私人服務存取連線,則可能會收到下列錯誤訊息:
Google private service access is not enabled. Enable private service access and
try again
如要解決這個問題,請建立私人服務存取連線。
刪除私人服務存取連線的網路對接。
建立私人服務存取權連線時,Memorystore for Redis 會建立名為 servicenetworking-googleapis-com 的網路對接連線。這項連線會顯示在專案的「VPC network peering」(虛擬私有雲網路對等互連) 頁面中。
如果刪除網路對等互連,現有執行個體會顯示下列錯誤訊息:
telnet: Unable to connect to remote host: Connection timed out
此外,如果您刪除網路對等互連並建立執行個體,系統會顯示下列錯誤訊息:
Private services access is not configured correctly. For steps on how to
verify the connection, check the documentation.
如要解決這個問題,請執行下列指令,在您的網路和私人服務存取網路之間建立私人服務存取連線:
gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com --ranges=RESERVED_RANGE_NAME --network=VPC_NETWORK --project=PROJECT_ID
您使用的參數相互衝突。
如果同時使用 --reserved-ip-range 參數和 --connect-mode=private-service-access 參數,系統會顯示下列錯誤訊息:
Reserved IP range is not supported for --connect-mode private services access
您無法同時使用這兩個參數,因為 Memorystore for Redis 不支援私人服務存取連線模式的 --reserved-ip-range 參數。
如要解決這個問題,請按照下列其中一種做法進行:
- 請將
--reserved-ip-range參數與--connect-mode=direct-peering參數搭配使用。 - 請勿使用
--reserved-ip-range參數。
超過專案的子網路配額。
您在Google Cloud 專案中可建立的子網路數量有限。如果超出這項配額,就會收到下列其中一則錯誤訊息:
Internal network quota exceeded. Please request higher limit here: https://forms.gle/ZfVduUGq2iSYcYGm8
或
Unable to create instance. Network quota limit has been reached. Please request higher limit here: https://forms.gle/ZfVduUGq2iSYcYGm8
如要解決這個問題,請填寫錯誤訊息中顯示的表單,或與 Cloud Customer Care 聯絡。
您未將服務專案附加至主專案。
如果您使用 Shared VPC,但未將服務專案附加至主專案,則會收到下列錯誤訊息:
Invalid network name <network-name>. Project <project-name> referenced is not the host project for <service-project-name>.
如要解決這個問題,請將服務專案附加至主專案。
您在服務專案中建立執行個體,並指定直接對接連線模式和 Shared VPC 網路。
如果您在服務專案中建立 Memorystore for Redis 執行個體,並從主專案為執行個體指定 Shared VPC 網路,則無法使用直接對接連線模式。
連線模式預設為直接對接。如果您在建立執行個體時嘗試使用這個連線模式,並選擇主專案中的共用虛擬私有雲網路做為 --network 參數的值,就會收到下列錯誤訊息:
Authorized_network must exist in the same project as redis instance
如要解決這個問題,請按照下列其中一種做法進行:
- 建立執行個體時,請使用私人服務存取連線模式
(--connect-mode=private-service-access)。 - 選擇與執行個體位於相同專案的授權虛擬私有雲網路。
您為 Compute Engine 使用的 IP 位址範圍,Memorystore for Redis 無法存取。
您無法從 IP 位址在 172.17.0.0/16 範圍內的 Compute Engine VM 存取 Memorystore for Redis 執行個體。這個範圍已預留給內部元件。
如要解決這個問題,請從 IP 位址在不同範圍內的 Compute Engine VM 存取執行個體。
從其他 Google Cloud 資源連線至執行個體時發生問題
本節說明其他資源嘗試連線至 Memorystore for Redis 執行個體時,執行個體可能遇到的問題。
您無法從需要無伺服器 VPC 存取連接器的無伺服器環境連線至執行個體
如果您無法使用需要無伺服器 VPC 存取連接器的無伺服器環境連線至 Memorystore for Redis 執行個體,請確認是否已為環境設定這個連接器。詳情請參閱「無伺服器 VPC 存取連接器需求」。
無法從 Google Kubernetes Engine (GKE) 叢集連線至執行個體
如要從 GKE 叢集連線至 Memorystore for Redis 執行個體,您必須在叢集上啟用虛擬私有雲原生/IP 別名。
建立叢集時,最容易啟用虛擬私有雲原生/IP 別名。在進階選項部分,選取「VPC Native」(虛擬私有雲原生)。詳情請參閱「建立 VPC 原生叢集」。
Identity and Access Management (IAM) 問題
本節說明 Memorystore for Redis 執行個體可能遇到的 IAM 問題。
您想還原服務帳戶已刪除的政策繫結
Memorystore for Redis 會使用下列服務帳戶管理執行個體:
service-PROJECT_NUMBER@service-networking.service-PROJECT_NUMBER@cloud-redis.
如果刪除這些服務帳戶的政策繫結,就無法建立執行個體。
如果嘗試使用 Google Cloud CLI 建立 Memorystore for Redis 執行個體,可能會收到下列錯誤訊息:
(gcloud.redis.instances.create) FAILED_PRECONDITION: A required IAM policy might be missing. Please run this command:"gcloud projects add-iam-policy-binding YOUR_PROJECT_ID --member='serviceAccount:service-YOUR_PROJECT_NUMBER@cloud-redis.' --role='roles/redis.serviceAgent'" and try again.
如要重新建立 service-networking 服務帳戶的政策繫結,請執行下列指令。將 VARIABLES 替換為適當的值。
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:service-PROJECT_NUMBER@service-networking.' --role='roles/servicenetworking.serviceAgent'
如要重新建立 cloud-redis 服務帳戶的政策繫結,請執行下列指令。將 VARIABLES 替換為適當的值。
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:service-PROJECT_NUMBER@cloud-redis.' --role='roles/redis.serviceAgent'
作業逾時問題
下列問題會導致 Redis 執行個體沒有回應,以及/或執行個體/節點作業逾時。
網路失聯問題
有時,由於 Google Cloud 伺服器發生網路失聯錯誤, Google Cloud 資源無法在區域內跨可用區通訊。這可能會導致執行個體中斷連線,進而發生逾時錯誤。
Google Cloud 解決執行個體佈建區域或可用區的網路失聯錯誤後,連線能力應會恢復正常。
發生這個問題時,您可能會看到類似以下的連線錯誤訊息:
telnet: Unable to connect to remote host: Connection timed out
如果無法找出逾時錯誤的原因,請與 Google Cloud 支援團隊聯絡。
服務專案和主專案不在同一個 VPC Service Controls 範圍內
如果您使用共用虛擬私有雲和 VPC Service Controls 範圍,且 Redis 執行個體建立作業逾時,這可能表示服務專案和主機專案不在同一個服務範圍內。服務專案和主專案必須位於相同 perimeter,Redis 執行個體才能透過 Shared VPC 網路與連線用戶端通訊。
如要確認是否遇到這個問題,請查看 Redis 執行個體的稽核記錄,確認是否有下列錯誤:
violationReason: "NETWORK_NOT_IN_SAME_SERVICE_PERIMETER"
如要解決這個問題,請將主機網路和服務網路放在同一個 service perimeter。
排解匯入和匯出問題
本節概述使用 Memorystore for Redis 匯入和匯出功能時,可能遇到的常見問題。
Google Cloud 控制台中的匯入和匯出按鈕已停用
問題:登入控制台的使用者沒有匯入和/或匯出 RDB 檔案所需的 redis.instances.import 和/或 redis.instances.export 權限。
解決方案:將權限授予使用者,然後重新整理執行個體詳細資料頁面。
匯入作業已完成,但資料未還原
如果匯入作業完成,但資料未還原,請先查看 Google Cloud 控制台或指令列是否有錯誤訊息,並解決錯誤訊息所述的問題。
如果匯入程序失敗,系統會使用空白 RDB 檔案復原執行個體。您可以再次匯入相同的 RDB 檔案,或使用其他 RDB 檔案,嘗試還原資料。
RDB 檔案過大,因此無法匯入
如果收到「Import RDB file gs://bucket/object.rdb size exceeds max memory 10GB」(匯入 RDB 檔案 gs://bucket/object.rdb 的大小超過記憶體上限 10 GB) 錯誤訊息,請擴充執行個體並重新匯入。您也可以嘗試將較小的 RDB 檔案匯入執行個體。
排解 Google Cloud CLI 問題
如果遇到 gcloud CLI 指令無法使用,或指令行為與說明文件不符的問題,請嘗試更新 gcloud CLI:
gcloud components update
停止 Redis 執行個體所有進行中的指令和連線
Memorystore for Redis 是 Google 代管的產品,因此您的 Redis 執行個體會封鎖部分指令,以提供安全可靠的環境。其中一個受限制指令是 CLIENT,包括用於停止指令的 CLIENT KILL。
如果 Redis 指令耗用大量 CPU/RAM,並影響正式環境,您必須重新啟動執行個體 (適用於基本級設定),或容錯移轉至副本 (適用於標準級設定)。這項重新啟動/容錯移轉作業會停止 Redis 伺服器上執行的所有指令,並終止所有進行中的連線。
以下指令可用於重新啟動或容錯移轉各項 Memorystore for Redis 設定。
停止標準級 Memorystore for Redis 執行個體中的指令
gcloud redis instances failover INSTANCE_NAME --data-protection-mode=limited-data-loss
停止基本級 Memorystore for Redis 執行個體中的指令
如要重新啟動 Memorystore for Redis 執行個體,唯一的方法是變更設定,例如擴充執行個體。以下是可用來重新啟動執行個體的指令範例。
gcloud redis instances update INSTANCE_NAME --region REGION_ID --size NUMBER_GB
將執行個體調整為其他大小後,您可以執行其他縮放作業,將執行個體恢復為原始大小。
網域限制相關的組織政策問題
目前已知 iam.allowedPolicyMemberDomains 組織政策與使用 PROJECT_NUMBER-compute@ 服務帳戶格式的 Memorystore for Redis 執行個體搭配時,會發生錯誤。
視執行個體的建立時間而定,Memorystore for Redis 會使用兩種服務帳戶格式之一。如要找出執行個體的服務帳戶格式,請參閱「Memorystore for Redis 服務帳戶格式」。
發生這個問題時,您可能會看到下列錯誤訊息:One or
more users named in the policy do not belong to a permitted customer.
視貴組織的政策和是否能重新建立執行個體而定,您可以透過下列任一選項解決這項錯誤:
重新建立執行個體:舊版執行個體使用
PROJECT_NUMBER-compute@服務帳戶格式,這類格式通常會遭到網域限制共用政策封鎖。新建立的執行個體會使用新版服務帳戶格式,與大多數組織政策相容。如果組織政策封鎖所有外部網域,這個選項就不會生效。如要略過政策,請務必使用第二個選項。
強制帳戶存取權:如果無法重新建立執行個體來取得新的服務帳戶格式,或貴組織的政策封鎖了新的服務帳戶網域,則必須強制專案存取帳戶,藉此略過政策。詳情請參閱「強制帳戶存取權」。