ModifyClusterFullThreshold

ModifyClusterFullThresholdメソッドを使用すると、ストレージ クラスタの容量が一定の利用率に近づいた場合にイベントを生成するレベルを変更できます。このしきい値設定を使用すると、警告が表示されるまでの間使用できるブロック ストレージの許容量を指定することができます。

たとえば、「Error」レベルのブロック ストレージ利用率まで残り3%でアラートを表示するには、stage3BlockThresholdPercentパラメータに「3」と入力します。このレベルに到達すると、クラスタ管理コンソールのイベント ログにアラートが送信されます。

パラメータ

このメソッドの入力パラメータは次のとおりです。

注: 少なくとも 1 つのパラメータを選択する必要があります。
名前 説明 タイプ デフォルト値 必須
maxMetadataOverProvisionFactor 使用可能な容量に対して、メタデータ スペースをプロビジョニングできる回数。たとえば、100TiB分のボリュームを格納するのに十分なメタデータ スペースがある場合、この数値を「5」に設定すると、500TiB分のボリュームを作成できます。 整数 5 無効
stage2AwareThreshold クラスタ内で容量が残っているノードの数。この値を超えると、容量の通知がトリガーされます。 整数 なし 無効
stage3BlockThresholdPercent ブロック ストレージ利用率が「Error」しきい値まであと何パーセントになった時点でクラスタの「Warning」アラートをトリガーするか。 整数 なし 無効
stage3MetadataThresholdPercent メタデータストレージ使用率がエラーしきい値を下回ったために、システムがクラスタ警告アラートをトリガーします。 整数 なし 無効

戻り値

このメソッドの戻り値は次のとおりです。

名前 説明 タイプ
blockFullness クラスタの現在のブロック フル レベル。
  • stage1Happy:アラートまたはエラー状態はありません。Web UIのHealthy状態に相当します。
  • stage2Aware:アラートまたはエラー状態はありません。Web UIのHealthy状態に相当します。
  • stage3Low:2つのノードで時間をおいて障害が発生した場合、冗長データ保護は提供されません。Web UIのWarning状態に相当します。このレベルはWeb UIで設定できます(デフォルトでは、このアラートはError状態の3%下の容量でトリガーされます)。
  • stage4Critical:1つのノードで障害が発生した場合、冗長データ保護は提供されません。新しいボリュームやクローンを作成できません。Element UIのError状態に相当します。
  • stage5CompletelyConsumed:すべての容量が消費されています。クラスタは読み取り専用になります。iSCSI接続は維持されますが、すべての書き込みが中断されます。Element UIのCritical状態に相当します。
文字列
fullness 「blockFullness」と「metadataFullness」のうち、より容量が不足している方の値が反映されます。 文字列
maxMetadataOverProvisionFactor 使用可能な容量に対して、メタデータ スペースをプロビジョニングできる回数。たとえば、100TiB分のボリュームを格納するのに十分なメタデータ スペースがある場合、この数値を「5」に設定すると、500TiB分のボリュームを作成できます。 整数
metadataFullness クラスタの現在のメタデータフル レベル。
  • stage1Happy:アラートまたはエラー状態はありません。Web UIのHealthy状態に相当します。
  • stage2Aware:アラートまたはエラー状態はありません。Web UIのHealthy状態に相当します。
  • stage3Low:2つのノードで時間をおいて障害が発生した場合、冗長データ保護は提供されません。Web UIのWarning状態に相当します。このレベルはWeb UIで設定できます(デフォルトでは、このアラートはError状態の3%下の容量でトリガーされます)。
  • stage4Critical:1つのノードで障害が発生した場合、冗長データ保護は提供されません。新しいボリュームやクローンを作成できません。Element UIのError状態に相当します。
  • stage5CompletelyConsumed:すべての容量が消費されています。クラスタは読み取り専用になります。iSCSI接続は維持されますが、すべての書き込みが中断されます。Element UIのCritical状態に相当します。
文字列
sliceReserveUsedThresholdPct エラー状態。予約されたスライス使用率が、返されたsliceReserveUsedThresholdPctの値よりも大きい場合、システム アラートがトリガーされます。 整数
stage2AwareThreshold 認識状態。「ステージ2」のクラスタのしきい値レベルに設定された値。 整数
stage2BlockThresholdBytes ステージ 2 のフルネス状態が存在するクラスタで使用されているバイト数。 整数
ステージ 2 の MetadataThresholdBytes ステージ 2 のフルネス状態が存在するクラスタで使用されているメタデータバイト数。  
stage3BlockThresholdBytes ステージ 3 のフルネス状態が存在するクラスタで使用されているストレージバイト数。 整数
stage3BlockThresholdPercent ステージ 3 に設定されたパーセント値。この比率に達すると、アラート ログに警告が記録されます。 整数
stage3LowThreshold エラー状態。クラスタの容量低下が原因でシステム アラートが作成されるしきい値。 整数
ステージ 3 の MetadataThresholdBytes ステージ 3 のフルネス状態が存在するクラスタで使用されるメタデータバイト数。  
stage4BlockThresholdBytes ステージ 4 のフルネス状態が存在するクラスタで使用されているストレージバイト数。 整数
stage4CriticalThreshold エラー状態。クラスタの容量の深刻な低下を警告するためにシステム アラートが作成されるしきい値。 整数
ステージ 4 の MetadataThresholdBytes ステージ 4 のフルネス状態が存在するクラスタで使用されるメタデータバイト数。  
stage5BlockThresholdBytes ステージ 5 のフルネス状態が存在するクラスタで使用されるストレージバイト数。 整数
ステージ 5 の MetadataThresholdBytes ステージ 5 のフルネス状態が存在するクラスタで使用されるメタデータバイト数。  
sumTotalClusterBytes クラスタの物理容量(バイト)。 整数
sumTotalMetadataClusterBytes メタデータの格納に使用できるスペースの合計。 整数
sumUsedClusterBytes クラスタで使用されているストレージバイト数。 整数
sumUsedMetadataClusterBytes メタデータを格納するためにボリュームドライブで使用されるスペースの量。 整数

要求例

このメソッドの要求例を次に示します。

{
   "method" : "ModifyClusterFullThreshold", 
   "params" : { 
              "stage3BlockThresholdPercent" : 3
              },
   "id" : 1
}

応答例

このメソッドの応答例を次に示します。

{
  "id": 1,
  "result": {
    "blockFullness": "stage1Happy",
    "fullness": "stage3Low",
    "maxMetadataOverProvisionFactor": 5,
    "metadataFullness": "stage3Low",
    "sliceReserveUsedThresholdPct": 5,
    "stage2AwareThreshold": 3,
    "stage2BlockThresholdBytes": 2640607661261,
    "stage3BlockThresholdBytes": 8281905846682,
    "stage3BlockThresholdPercent": 3,
    "stage3LowThreshold": 2,
    "stage4BlockThresholdBytes": 8641988709581,
    "stage4CriticalThreshold": 1,
    "stage5BlockThresholdBytes": 12002762096640,
    "sumTotalClusterBytes": 12002762096640,
    "sumTotalMetadataClusterBytes": 404849531289,
    "sumUsedClusterBytes": 45553617581,
    "sumUsedMetadataClusterBytes": 31703113728
  }
}

新規導入バージョン

9.6