Kubernetes Engine (OKE)メトリック
Kubernetes Engine (OKE)によって生成されるメトリックを確認します。
メトリック、アラームおよび通知を使用して、Kubernetesエンジンが管理するKubernetesクラスタのヘルス、容量およびパフォーマンスをモニターできます。
このトピックでは、oci_okeメトリック・ネームスペースでKubernetesエンジンによって生成されるメトリックについて説明します。
リソース: クラスタ、ワーカー・ノード
Kubernetesエンジン(OKE)サービス・メトリックの概要
Kubernetesエンジン・メトリックは、ノード・プールおよび個々のワーカー・ノードとともにKubernetesクラスタをモニターするのに役立ちます。メトリック・データを使用して、クラスタおよびノード・プールの問題を診断およびトラブルシューティングできます。
頻度はメトリックによって異なりますが、デフォルトのサービス・メトリックの頻度は通常60秒です(1分当たりに少なくとも1つのデータ・ポイントがポストされます)。
コンソールでメトリック・チャートのデフォルト・セットを表示するには、関心のあるクラスタに移動し、「メトリック」をクリックします。モニタリング・サービスを使用して、カスタム問合せを作成することもできます。メトリック問合せの作成を参照してください。
前提条件
IAMポリシー: リソースをモニターするには、管理者が作成するポリシーで、コンソールを使用しているか、SDK、CLIまたはその他のツールでREST APIを使用しているかにかかわらず、必要なアクセスのタイプを付与されている必要があります。ポリシーでは、モニタリング・サービスとモニターされているリソースの両方にアクセスできる必要があります。アクションを実行しようとして、権限がない、または認可されていないというメッセージが表示された場合は、管理者に連絡して、付与されたアクセスのタイプと作業する必要があるコンパートメントを確認してください。モニタリングのユーザー認可の詳細は、「IAMポリシー」を参照してください。
たとえば、Kubernetesクラスタ内のノードの状態を監視するには、次のようなポリシー・ステートメントを使用してアクセス権が付与されている必要があります:
Allow group <group-name> to read metrics in <location>使用可能なメトリック: oci_oke
次の表に示すメトリックは、作成するKubernetesクラスタで自動的に使用可能になります。これらのメトリックを取得するためにリソースのモニタリングを有効にする必要はありません。
Kubernetesエンジン・メトリックには、次のディメンションが含まれます:
- RESOURCEID
- メトリックが適用されるリソースのOCID 。
- RESOURCEDISPLAYNAME
- メトリックが適用されるリソースの名前。
- RESPONSECODE
- Kubernetes API Serverから送信されるレスポンス・コード。
- RESPONSEGROUP
- レスポンス・コード・グループ。レスポンス・コードの最初の数字(たとえば、2xx、3xx、4xx、5xx)に基づいています。
- CLUSTERID
- メトリックが適用されるクラスタのOCID。
- NODEPOOLID
- メトリックが適用されるノード・プールのOCID。
- NODESTATE
- ワーカー・ノードをホストするコンピュート・インスタンスの状態。たとえば、ACTIVE、CREATING、DELETING、DELETED、FAILED、UPDATING、INACTIVEです。
- NODECONDITION
- Kubernetes API Serverによって示されたワーカー・ノードの条件。たとえば、Ready、MemoryPressure、PIDPressure、DiskPressure、NetworkUnavailableです。
- AVAILABILITYDOMAIN
- コンピュート・インスタンスが存在する可用性ドメイン。
- FAULTDOMAIN
- コンピュート・インスタンスが存在するフォルト・ドメイン。
| メトリック | メトリック表示名 | 単位 | 説明 | ディメンション |
|---|---|---|---|---|
APIServerRequestCount
|
APIサーバー・リクエスト | 件数 | Kubernetes API Serverが受信したリクエスト数。 |
|
APIServerResponseCount
|
APIサーバー・レスポンス数 | 件数 | Kubernetes API Serverから送信される200以外の様々なレスポンス(エラー・レスポンス)の数。 | resourceId
|
UnschedulablePods
|
スケジュールできないポッド数 | 件数 | Kubernetesスケジューラがスケジュールできないポッド数。バージョン1.15.xより前のKubernetesのバージョンを実行しているクラスタでは使用できません。 | resourceId
|
NodeState
|
ノードの状態 | 件数 | 様々な状態のコンピュート・ノードの数。 | resourceId
|
KubernetesNodeCondition
|
Kubernetesのノード条件 | 件数 |
Kubernetes API Serverで示される様々な条件のワーカー・ノードの数。 |
resourceId
|
コンソールの使用
- ナビゲーション・メニューを開き、「開発者サービス」を選択します。「コンテナおよびアーティファクト」で、「Kubernetesクラスタ(OKE)」を選択します。
- Kubernetes Engineで使用するリージョンを選択します。
-
メトリックを表示するクラスタを含むコンパートメントを選択してください。
「クラスタ」ページには、選択したコンパートメント内のすべてのクラスタが表示されます。
- メトリックを表示するクラスタの名前をクリックします。
-
「リソース」で「メトリック」をクリックします。
「メトリック」タブには、Kubernetesエンジン・メトリック・ネームスペースによって生成されるクラスタの各メトリックのチャートが表示されます。クラスタ内のノード・プールのメトリックを表示するには、「ノード・プール」タブを表示し、ノード・プールの名前をクリックし、「メトリック」タブを表示します。ノード・プール内のワーカー・ノードのメトリックを表示するには、「ノード」タブを表示し、ワーカー・ノードの名前の横にある「メトリックの表示」リンクをクリックします。生成されるメトリックの詳細は、使用可能なメトリック: oci_okeを参照してください。
予想されるクラスタのメトリック・データが表示されない場合は、次の原因および解決方法を参照してください。
| 問題 | 考えられる原因 | 確認方法 | 解決策 |
|---|---|---|---|
|
Kubernetes API Serverからエラー・レスポンスが返されましたが、APIサーバー・レスポンス数チャートにそれが表示されません。 |
レスポンスは、APIサーバー・レスポンス数チャートでカバーされる期間外に返された可能性があります。 | 応答が返された期間の開始時間と終了時間を確認します。 | 必要に応じて、開始時間と終了時間を調整します。 |
| Kubernetes API Serverからエラー・レスポンスが返されたことがわかっていますが、開始時間と終了時間の間にレスポンスが返されたとしても、APIサーバー・レスポンス数チャートにはそれが表示されません。 | 開始時間と終了時間の間にレスポンスが返されましたが、X軸(データ表示のウィンドウ)によってレスポンスが除外されることがあります。 | レスポンスが返された期間がx軸(データ表示のウィンドウ)に含まれていることを確認します。 | 必要に応じて、x軸(データ表示のウィンドウ)を調整します。 |
| チャート内のデータを連続した線として経時的に表示したいのですが、線にギャップがあります。 | これは予期された動作です。選択した間隔で表示するメトリック・データがない場合、データ行は不連続になります。 | 間隔を増やします(たとえば、1分から5分、1分から1時間)。 | 必要に応じて間隔を調整します。 |
APIの使用
APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。