Memorystore for Valkey インスタンスに関する概要情報を表示することは、インスタンスの状態、構成、接続性の包括的なスナップショットを取得するために不可欠です。
Memorystore for Valkey インスタンスの概要情報を表示するユースケースの例を次に示します。
- 接続エンドポイントを取得する: クラスタモードが有効なインスタンスの場合、IP アドレスとポート番号で構成される検出エンドポイントを取得できます。クラスタモードが無効なインスタンスの場合、クライアント アプリケーションをインスタンスに接続するように構成するために必要なプライマリ エンドポイントとリーダー エンドポイントを取得できます。
- カスタム構成を確認する: ユーザーがインスタンスに適用する構成パラメータを表示します。たとえば、ユーザーが
maxmemory-policyパラメータに設定した値を取得できます。 - ノードとシャードに関する情報を確認する: インスタンスに関連付けられているノードとシャードに関する情報を取得します。これには、シャード数、ノードタイプ、各シャードのレプリカ数が含まれます。
- データ復元力の設定を確認する: Redis データベース(RDB)スナップショットと追記専用ファイル(AOF)ログファイルのアクティブな永続性モードと、インスタンスが誤って削除されないように保護されているかどうかを確認します。
インスタンスの概要情報を表示する
インスタンスの概要情報を確認するには、Google Cloud コンソールまたは gcloud CLI を使用します。
コンソール
Google Cloud コンソールで、[Memorystore for Valkey] ページに移動します。
概要情報を表示するインスタンスの ID をクリックします。
gcloud
インスタンスの概要情報を表示するには、gcloud memorystore instances describe コマンドを使用します。
gcloud memorystore instances describe INSTANCE_ID \ --location=REGION_ID
次のように置き換えます。
- INSTANCE_ID: 概要情報を表示するインスタンスの ID
- REGION_ID: インスタンスが配置されているリージョン
次に例を示します。
gcloud memorystore instances describe my-instance \ --location=us-central1
インスタンスのゾーンを表示する
インスタンスが使用するゾーンは、 Google Cloud コンソールまたは gcloud CLI を使用して確認できます。
コンソール
Google Cloud コンソールに、インスタンスが使用するゾーンを一覧表示するツールチップが表示されます。インスタンスが 2 ゾーン デプロイで実行されている場合、ツールチップにこのデプロイタイプが表示されます。詳細については、高可用性と復元性を実現する 2 ゾーン デプロイをご覧ください。
インスタンスが使用するゾーンを確認する手順は次のとおりです。
Google Cloud コンソールで、[Memorystore for Valkey] ページに移動します。
インスタンスのゾーン数にマウスポインタを合わせます。
gcloud
インスタンスが使用するゾーンを表示するには、--format="yaml(zoneDistributionConfig)" フラグを指定して gcloud memorystore instances describe コマンドを使用します。
gcloud memorystore instances describe INSTANCE_ID \ --location=REGION_ID \ --format="yaml(zoneDistributionConfig)"
次のように置き換えます。
- INSTANCE_ID: インスタンスの ID
- REGION_ID: インスタンスが配置されているリージョン
REST
インスタンスが使用するゾーンを表示するには、次の REST コマンドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: インスタンスが含まれているプロジェクトの ID
- REGION_ID: インスタンスが配置されているリージョン
- INSTANCE_ID: インスタンスの ID
HTTP メソッドと URL:
GET https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instancesINSTANCE_ID
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{
"name": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
"state": "ACTIVE",
"shardCount": SHARD_COUNT,
"zoneDistributionConfig": {
"mode": "MULTI_ZONE",
"zones": [
"ZONE_1",
"ZONE_2",
"ZONE_3"
],
"activeZones": [
"ZONE_1",
"ZONE_2"
]
}
}