14.3.11　storeusage（レンジおよびキャッシュの使用状況の確認）

(1)　機能

格納されているkeyの数，およびメモリ使用量をレンジ単位で表示します。また，レンジ単位，キャッシュ単位に設定されている，データ総量監視の上限値を表示します。

ページの先頭へ

(2)　規則

• このサブコマンドは，クラスタが次の状態のときに実行できます。

  • クラスタ稼働中（AVAILABLE）

  • クラスタ一部稼働中（PARTIALLY_AVAILABLE）

• このサブコマンドは，クラスタへの参加状況がonlineのEADSサーバを処理対象とします。ただし，クラスタへの参加状況がstandbyのEADSサーバがクラスタ内にある場合は実行できません。クラスタへの参加状況については，eztool statusコマンドで確認できます。

• このサブコマンドは，処理対象のEADSサーバが次の状態のときに実行できます。

  • 初期化中（initializing）

  • 初期化状態（initialized）

  • 稼働状態（running）

  • 閉塞中（closing）

  • 閉塞状態（closed）

ページの先頭へ

(3)　形式

eztool storeusage ［--replica|--cache ＜キャッシュ名＞］
                  ［--format ＜フォーマット名＞］
                  ［--columns ＜列名＞［,＜列名＞］…］
                  ［--filter ＜フィルタの条件＞］
                  ［--match ＜一致条件＞］

ページの先頭へ

(4)　オプションおよび引数

ページの先頭へ

(5)　出力例

eztool storeusageコマンドの実行結果の出力例を次に示します。

表示の構成要素については，「14.4.1　表示内容の構成要素」を参照してください。

■--replicaオプションおよび--cacheオプションを指定しない場合

■--replicaオプションを指定する場合

■--cacheオプションを指定する場合

メインの表示内容を次の表に示します。

表14‒28　eztool storeusageコマンドのメインの表示内容

項番	列名	説明	表示の有無
			--replicaオプションまたは--cacheオプションの指定
			どちらも指定なし	--replicaオプション指定あり	---cacheオプション指定あり
1	RangeID	レンジID	○	○	○
2	StartPosition	各レンジの開始位置（ハッシュ値）※1 位置（ハッシュ値）は降順で表示されます。	○	○	○
3	EndPosition	各レンジの終了位置（ハッシュ値）※1	○	○	○
4	Server	各レンジのデータの格納先EADSサーバのIPアドレス，およびEADSクライアントとの通信に使用するEADSサーバのポート番号※2 次の形式で表示されます。 IPアドレス:ポート番号	○	○	○
5	StoredExternalHeapSize	メモリキャッシュおよび2Wayキャッシュのメモリ使用量の合計※3 （単位：メガバイト） 小数点以下の値は切り捨てて表示されます。 ディスクキャッシュのメモリ使用量は0として扱われます。	○	○	○
6	ExternalHeapSizeLimit	メモリ使用量の上限値※3※4 （単位：メガバイト） ディスクキャッシュの場合，0が表示されます。	○	×	×
7	StoredDiskSize	ディスクキャッシュまたは2Wayキャッシュのディスク使用量※3※5 （単位：メガバイト） 小数点以下の値は切り捨てて表示されます。	×	×	○
8	DiskSizeLimit	ディスクキャッシュまたは2Wayキャッシュのディスク使用量の上限値※3※4※5 （単位：メガバイト）	×	×	○
9	RangeKeyCount	各レンジのkeyの総数※3 多重化によってコピーされたkeyの数は含みません。	○	×	○
10	KeyCountLimit	各レンジのkeyの総数の上限値※3※4 多重化によってコピーされるkeyの数は含みません。	○	×	×
11	KeyCount(ServerID:x Position:y)※6	EADSサーバごとの各レンジのkeyの総数※3 多重化によってコピーされたkeyの数も含みます。 縮退状態（isolated），または起動していないEADSサーバのkeyの数は含みません。 データを多重化している場合，EADSサーバの位置（ハッシュ値）の降順に表示されます。 コマンド実行時点での値を取得するため，データの格納先EADSサーバとコピー先EADSサーバで値が異なる場合があります。 データの格納先でもコピー先でもないEADSサーバの場合，何も表示されません。	×	○	×

（凡例）

○：表示されます。

×：表示されません。

注※1

各レンジの範囲を次に示します。

• StartPositionの値がEndPositionの値よりも小さい場合

  StartPositionの値からEndPositionの値までの範囲

• StartPositionの値がEndPositionの値よりも大きい場合

  次に示す範囲を合わせた範囲となります。

  ・StartPositionの値から2,147,483,647までの範囲

  ・-2,147,483,648からEndPositionの値までの範囲

注※2

該当するレンジのデータの格納先EADSサーバ，およびデータのコピー先EADSサーバが，すべて縮退状態（isolated）またはプロセスダウンしている場合，ハイフン（-）が表示されます。

注※3

該当するレンジの情報が取得できない場合，ハイフン（-）が表示されます。

注※4

データ総量監視機能が無効になっている場合，ハイフン（-）が表示されます。

注※5

メモリキャッシュの場合，ハイフン（-）が表示されます。

注※6

xには，EADSサーバのサーバIDが表示されます。yには，EADSサーバの位置（ハッシュ値）が表示されます。

ページの先頭へ

(6)　リターンコード

次の表に示すリターンコードが返却されます。

表14‒29　eztool storeusageコマンドのリターンコード

項番	リターンコード		リターンコードの説明
	コマンド定義のeads.command.compatパラメタを指定していない場合	コマンド定義のeads.command.compatパラメタに0300を指定した場合
1	0	0	コマンドの実行に成功しました。
2	101	101	コマンドの初期化に失敗しました。
3	110		接続に失敗しました。
4	111		通信タイムアウトで失敗しました。
5	120		構文不正で失敗しました。
6	130		コマンドを実行できない状態のため失敗しました。
7	150		コマンド実行中に失敗しました。
8	200		コマンドタイムアウトで失敗しました。

--matchオプションを指定した場合

条件に一致した場合は0，一致しなかった場合は1を，リターンコードとして返します。ただし，コマンドの実行に失敗したときは，--matchオプションを指定しなかった場合と同じになります。

ページの先頭へ

(7)　注意事項

• 出力処理中にコマンドがタイムアウトした場合，出力結果が欠落することがあります。また，出力処理が完了していても，コマンドがタイムアウトになることがあります。このような場合には，コマンドのタイムアウト時間を大きくしてから再実行してください。

• スケールアウト処理の実行中，またはリバランス処理の実行中は，クラスタの構成が変更されることが原因で，このサブコマンドの実行に失敗することがあります。

• リバランス処理の実行中にこのサブコマンドを実行すると，一時的に次の値が少なく表示されることがあります。

  • StoredExternalHeapSize

  • RangeKeyCount

  • KeyCount(ServerID:x Position:y)

• リバランス処理の実行中にこのサブコマンドを実行すると，一時的に次の値が小さくなることがあります。

  • ExternalHeapSizeLimit

  • KeyCountLimit

ページの先頭へ