1. RESTfulサービス管理者ガイド
  2. モニタリング・コマンド

6 モニタリング・コマンド

モニタリング・コマンドは、Oracle Key Vaultの構成、ヘルスおよびデプロイメント・モードを確認するために使用できます。

6.1 okv cluster info getコマンド

okv cluster info getコマンドでは、クラスタまたはクラスタ・ノードに関する静的な情報を取得します。

okv cluster info getは、次の情報を取得します。

  • クラスタ名
  • クラスタのバージョン
  • 「Maximum Disable Node Duration」の設定
  • クラスタ・サブグループのリスト
  • クラスタ・ノードの情報(構成モード、ステータス、サブグループ、バージョン情報など)。

必要な権限

システム管理者ロール

構文

okv cluster info get --node node_name

JSON入力ファイル・テンプレート

{
  "service" : {
    "category" : "cluster",
    "resource" : "info",
    "action" : "get",
    "options" : {
      "node" : "#VALUE"
    }
  }
}

パラメータ

パラメータ/テンプレート・パラメータ 必須かどうか 説明

--node / node

オプション

現在のクラスタ内のノードの名前。この設定を省略すると、クラスタ全体の情報が取得されます。

JSONの例

  1. okv cluster info getコマンド用にJSON入力を生成します。 
    okv cluster info get --generate-json-input

    次のような入力が生成されます。 

    {
  "service" : {
    "category" : "cluster",
    "resource" : "info",
    "action" : "get",
    "options" : {
      "node" : "#VALUE"
    }
  }
}
  2. 生成された入力をファイル(たとえば、get-cluster-info.json)に保存します。

    調べようとしている情報の種類によって、次のいずれかを実行します。

    • 特定のノードのクラスタ情報の取得: node値を指定するようにファイルを編集します。次に例を示します。 
      {
  "service" : {
    "category" : "cluster",
    "resource" : "info",
    "action" : "get",
    "options" : {
      "node" : "node_1"
    }
  }
}
    • クラスタ内のすべてのノードのクラスタ情報の取得: ノード・エントリを削除するようにファイルを編集します。
      {
  "service" : {
    "category" : "cluster",
    "resource" : "info",
    "action" : "get"
  }
}
  3. 生成されたJSONファイルを使用して、okv cluster info getコマンドを実行します。 
    okv cluster info get --from-json get-cluster-info.json

    ステップ2のファイルの処理方法に応じて、次のような出力が表示されます。

    • 特定のノードのクラスタ情報の取得:
      {
  "result" : "Success",
  "values" : [ {
    "nodeName" : "node_1",
    "nodeID" : "1",
    "ipAddress" : "10.1.0.40",
    "mode" : "Read-Write",
    "status" : "ACTIVE",
    "readWritePeer" : "node_2",
    "clusterSubgroup" : "sub_1",
    "joinDate" : "2021-01-06 00:43:55.036908 UTC",
    "version" : "21.1.0.0.0"
  } ]
}
    • クラスタ内のすべてのノードのクラスタ情報の取得:
      {
  "result" : "Success",
  "values" : [ {
    "clusterName" : "name_1",
    "clusterVersion" : "21.1.0.0.0",
    "maximumDisableNodeDuration" : "24 hrs",
    "clusterSubgroups" : "sub_1, sub_2",
    "nodes" : [ {
      "node_1" : {
        "nodeID" : "1",
        "ipAddress" : "10.1.0.40",
        "mode" : "Read-Write",
        "status" : "ACTIVE",
        "readWritePeer" : "node_2",
        "clusterSubgroup" : "sub_1",
        "joinDate" : "2021-01-06 00:43:55.036908 UTC",
        "version" : "21.1.0.0.0"
      }
    }, {
      "node_2" : {
        "nodeID" : "2",
        "ipAddress" : "10.1.0.39",
        "mode" : "Read-Write",
        "status" : "ACTIVE",
        "readWritePeer" : "node_1",
        "clusterSubgroup" : "sub_2",
        "joinDate" : "2021-01-06 00:49:57.677501 UTC",
        "version" : "21.1.0.0.0"
      }
    } ]
  } ]
}

親トピック: モニタリング・コマンド

6.2 okv primary-standby info getコマンド

okv primary-standby info getコマンドでは、Oracle Key Vaultプライマリ/スタンバイ構成に関する静的な情報を表示します。

okv primary-standby infoでは次の情報を取得します。

  • プライマリ/スタンバイのステータス
  • プライマリ・サーバーのIPアドレス
  • スタンバイ・サーバーのIPアドレス
  • ファスト・スタート・フェイルオーバーのしきい値

必要な権限

システム管理者ロール

構文

okv primary-standby info get

JSON入力ファイル・テンプレート

{
 "service" : {
 "category" : "primary-standby",
 "resource" : "info",
 "action" : "get"
 }
}

パラメータ

なし

JSONの例

  1. okv primary-standby info getコマンド用にJSON入力を生成します。 
    okv primary-standby info get --generate-json-input

    次のような入力が生成されます。 

    {
 "service" : {
 "category" : "primary-standby",
 "resource" : "info",
 "action" : "get"
 }
}
  2. 出力をファイル(たとえば、primary-standby-info.json)に保存します。
  3. 生成されたJSONファイルを使用して、okv primary-standby info getコマンドを実行します。 
    okv primary-standby info get --from-json primary-standby-info.json

    出力は、次のようになります。 

    {
  "result" : "Success",
  "values" : [ {
    "clusterServiceStatus" : "Up",
    "alertsCount" : "2",
    "unresolvedConflicts" : {
      "endpointNameConflicts" : "0",
      "endpointGroupNameConflicts" : "0",
      "userNameConflicts" : "0",
      "userGroupNameConflicts" : "0",
      "walletNameConflicts" : "0",
      "kmipObjectNameConflicts" : "0"
    }
  } ]
}

親トピック: モニタリング・コマンド

6.3 okv cluster status getコマンド

okv cluster status getコマンドでは、クラスタまたは指定したクラスタ・ノードに関する動的な情報を取得します。

okv cluster status getでは、次の情報を取得します。

  • 読取り/書込みペアのノード
  • 読取り専用ペアのノード
  • 未解決の名前の競合の数とタイプ
  • クラスタに関連するアラート

必要な権限

システム管理者ロール

構文

okv cluster status get --node node_name

JSON入力ファイル・テンプレート

{
  "service" : {
    "category" : "cluster",
    "resource" : "status",
    "action" : "get",
    "options" : {
      "node" : "#VALUE"
    }
  }
}

パラメータ

パラメータ/テンプレート・パラメータ 必須かどうか 説明

--node / node

オプション

現在のクラスタ内のノードの名前。この設定を省略すると、クラスタ全体の情報が取得されます。

JSONの例

  1. okv cluster status getコマンド用にJSON入力を生成します。 
    okv cluster status get --generate-json-input

    次のような入力が生成されます。 

    {
  "service" : {
    "category" : "cluster",
    "resource" : "status",
    "action" : "get",
    "options" : {
      "node" : "#VALUE"
    }
  }
}
  2. 生成された入力をファイル(たとえば、get-cluster-status.json)に保存します。

    調べようとしている情報の種類によって、次のいずれかを実行します。

    • 特定のノードのクラスタ・ステータスの取得: node値を指定するようにファイルを編集します。次に例を示します。 
      {
  "service" : {
    "category" : "cluster",
    "resource" : "status",
    "action" : "get",
    "options" : {
      "node" : "node_1"
    }
  }
}
    • クラスタ内のすべてのノードのクラスタ情報の取得: ノード・エントリを削除するようにファイルを編集します。
      {
  "service" : {
    "category" : "cluster",
    "resource" : "status",
    "action" : "get"
  }
}
  3. 生成されたJSONファイルを使用して、okv cluster status getコマンドを実行します。 
    okv cluster status get --from-json get-cluster-status.json

    ステップ2のファイルの処理方法に応じて、次のような出力が表示されます。

    • 特定のノードのクラスタ・ステータスの取得:
      {
  "result" : "Success",
  "values" : [ {
    "nodeStatus" : "Read-Write",
    "state" : "ACTIVE",
    "nameResolutionTime" : "Could not determine"
  } ]
}
    • クラスタ内のすべてのノードのクラスタ情報の取得:
      {
  "result" : "Success",
  "values" : [ {
    "clusterServiceStatus" : "Up",
    "alertsCount" : "2",
    "unresolvedConflicts" : {
      "endpointNameConflicts" : "0",
      "endpointGroupNameConflicts" : "0",
      "userNameConflicts" : "0",
      "userGroupNameConflicts" : "0",
      "walletNameConflicts" : "0",
      "kmipObjectNameConflicts" : "0"
    }
  } ]
}

親トピック: モニタリング・コマンド

6.4 okv primary-standby status getコマンド

okv primary-standby status getコマンドでは、Oracle Key Vaultプライマリ/スタンバイ構成に関する動的な情報を取得します。

okv primary-standby status getでは、次の情報を取得します。

  • スイッチオーバーのステータス
  • フェイルオーバーのステータス
  • プライマリが読取り専用制限モードかどうか

必要な権限

システム管理者ロール

構文

okv primary-standby status get

JSON入力ファイル・テンプレート

{
 "service" : {
 "category" : "primary-standby",
 "resource" : "status",
 "action" : "get"
 }
}

パラメータ

なし

JSONの例

  1. okv primary-standby status getコマンド用にJSON入力を生成します。 
    okv primary-standby status get --generate-json-input

    次のような入力が生成されます。 

    {
 "service" : {
 "category" : "primary-standby",
 "resource" : "status",
 "action" : "get"
 }
}
  2. 生成された入力をファイル(たとえば、primary-standby-status.json)に保存します。
  3. 生成されたJSONファイルを使用して、okv primary-standby status getコマンドを実行します。 
    okv primary-standby status get --from-json primary-standby-status.json

    出力は、次のようになります。 

    {
  "object" : [ {
    "switchoverStatus" : "TO STANDBY",
    "failoverStatus" : "SYNCHRONIZED",
    "rormMode" : "No"
  } ]
}

親トピック: モニタリング・コマンド

6.5 okv server status getコマンド

okv server status getコマンドでは、Oracle Key Vaultサーバーに関するステータス情報を取得します。

okv server status getでは、次の項目を表示します。

  • Oracle Key Vaultが実行している時間(稼働時間)
  • Oracle Key Vaultサーバーに残っている現在の空き領域
  • Oracle Key Vaultに対して開始されたバックアップ・ジョブのステータス
  • Oracle Key Vaultシステムに関して発生したアラートの数

必要な権限

システム管理者ロール

構文

okv server status get

JSON入力ファイル・テンプレート

{
 "service" : {
 "category" : "server",
 "resource" : "status",
 "action" : "get"
 }
}

パラメータ

なし

JSONの例

  1. okv server status getコマンド用にJSON入力を生成します。 
    okv server status get --generate-json-input

    次のような入力が生成されます。 

    {
 "service" : {
 "category" : "server",
 "resource" : "status",
 "action" : "get"
 }
}
  2. 生成された入力をファイル(たとえば、server-status.json)に保存します。
  3. 生成されたJSONファイルを使用して、okv server status getコマンドを実行します。 
    okv server status get --from-json server-status.json

    出力は、次のようになります。 

    {
  "result" : "Success",
  "values" : [ {
    "uptime" : " 1 day, 7:50 HH:MM",
    "freeSpace" : "90%",
    "backupStatus" : "Successful backup done today",
    "alertsRaised" : "1"
  } ]
}

親トピック: モニタリング・コマンド

6.6 okv server info getコマンド

okv server info getコマンドでは、Oracle Key Vaultサーバーに関する静的な情報を取得します。

必要な権限

システム管理者ロール

okv server info getでは、次の項目を表示します。

  • Oracle Key Vaultサーバーの現在のバージョン
  • Oracle Key Vaultサーバー証明書の有効期限
  • Oracle Key Vaultサーバーのデプロイメント・タイプ(スタンドアロン、クラスタ、プライマリ・スタンバイなど)

構文

okv server info get

JSON入力ファイル・テンプレート

{
 "service" : {
 "category" : "server",
 "resource" : "info",
 "action" : "get"
 }
}

パラメータ

なし

JSONの例

  1. okv server info getコマンド用にJSON入力を生成します。 
    okv server info get --generate-json-input

    次のような入力が生成されます。 

    {
 "service" : {
 "category" : "server",
 "resource" : "info",
 "action" : "get"
 }
}
  2. 生成された入力をファイル(たとえば、server_info_get.json)に保存します。変更するパラメータがないため、ファイルの編集は不要です。
  3. 生成されたJSONファイルを使用して、okv server info getコマンドを実行します。 
    okv server info get --from-json server_info_get.json

    出力は、次のようになります。 

    {
  "result" : "Success",
  "values" : [ {
    "version" : "21.1.0.0.0",
    "deploymentType" : "Standalone",
    "serverCertificateExpirationDate" : "Dec 17 21:49:12 2022 GMT"
  } ]
}

親トピック: モニタリング・コマンド