第16章 InsightsOperator [operator.openshift.io/v1]
- 説明
- InsightsOperator は、Insights Operator に関するクラスター全体の情報を保持します。互換性レベル 1: メジャーリリース内で最低 12 カ月または 3 つのマイナーリリース (どちらか長い方) の間 Stable です。
- タイプ
-
object
- 必須
-
spec
-
16.1. 仕様
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| spec は、Insights の望ましい動作の仕様です。 |
|
| ステータスは、Insights Operator の最新のステータスです。 |
16.1.1. .spec
- 説明
- spec は、Insights の望ましい動作の仕様です。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| logLevel は、コンポーネント全体のインテントベースのログです。きめ細かい制御はできませんが、Operator がオペランドに対して解釈する必要のある粗いロギングの選択を管理する簡単な方法です。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal". |
|
| managementState は、Operator がコンポーネントを管理する必要があるかどうか、およびその方法を示します |
| `` | observedConfig は、コントローラーがクラスター状態から監視したスパース設定を保持します。Operator のレベルへの入力であるため、仕様に存在します |
|
| operatorLogLevel は、Operator 自体のインテントベースのログです。きめ細かい制御はできませんが、Operator が自分で解釈しなければならない粗いロギングの選択を管理する簡単な方法です。有効な値は、"Normal"、"Debug"、"Trace"、"TraceAll" です。Defaults to "Normal". |
| `` | unsupportedConfigOverrides は、以前に設定されたオプションをオーバーライドするスパース設定を保持します。オーバーライドするフィールドである必要があるだけで、次の順序でオーバーレイされます。1.ハードコードされたデフォルト 2.observedConfig 3. unsupportedConfigOverrides |
16.1.2. .status
- 説明
- ステータスは、Insights Operator の最新のステータスです。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| conditions は、状態とそのステータスのリストです。 |
|
| OperatorCondition は、標準の状態フィールドです。 |
|
| gatherStatus は、最後の Insights データ収集に関する基本情報を提供します。省略された場合、データ収集はまだ行われていません。 |
|
| generations は、項目を調整する必要があるタイミングや、対応が必要な変更が項目に対して行われたタイミングを判断するために使用します。 |
|
| GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。 |
|
| insightsReport は、一般的な Insights の分析結果を提供します。省略された場合、データ収集はまだ行われていません。 |
|
| observedGeneration はあなたが扱った最後の世代の変更です |
|
| readyReplicas は、準備ができて目的の状態にあるレプリカの数を示します |
|
| バージョンは、この可用性が適用されるレベルです |
16.1.3. .status.conditions
- 説明
- conditions は、状態とそのステータスのリストです。
- 型
-
array
16.1.4. .status.conditions[]
- 説明
- OperatorCondition は、標準の状態フィールドです。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| |
|
| |
|
| |
|
| |
|
|
16.1.5. .status.gatherStatus
- 説明
- gatherStatus は、最後の Insights データ収集に関する基本情報を提供します。省略された場合、データ収集はまだ行われていません。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| gatherers は、最後の収集のアクティブなギャザラー (およびそのステータス) のリストです。 |
|
| gathererStatus は、特定のデータギャザラーに関する情報を表します。 |
|
| lastGatherDuration は、最後の収集イベント中にすべての収集を処理するのにかかった合計時間です。 |
|
| lastGatherTime は、Insights のデータ収集が最後に終了した時刻です。空の値は、データがまだ収集されていないことを意味します。 |
16.1.6. .status.gatherStatus.gatherers
- 説明
- gatherers は、最後の収集のアクティブなギャザラー (およびそのステータス) のリストです。
- 型
-
array
16.1.7. .status.gatherStatus.gatherers[]
- 説明
- gathererStatus は、特定のデータギャザラーに関する情報を表します。
- 型
-
object
- 必須
-
conditions
-
lastGatherDuration
-
name
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| conditions は、各ギャザラーのステータスの詳細を示します。 |
|
|
条件には、この API リソースの現在の状態の 1 つの側面の詳細が含まれています。--- この構造体は、フィールドパスの .status.conditions で配列として直接使用することを目的としています。たとえば、次のように入力します。FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition |
|
| lastGatherDuration は、収集に費やされた時間を表します。 |
|
| name は、ギャザラーの名前です。 |
16.1.8. .status.gatherStatus.gatherers[].conditions
- 説明
- conditions は、各ギャザラーのステータスの詳細を示します。
- 型
-
array
16.1.9. .status.gatherStatus.gatherers[].conditions[]
- 説明
-
条件には、この API リソースの現在の状態の 1 つの側面の詳細が含まれています。--- この構造体は、フィールドパスの .status.conditions で配列として直接使用することを目的としています。たとえば、次のように入力します。FooStatus struct{ // Represents the observations of a foo’s current state. // Known .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchMergeKey=type // +patchStrategy=merge // +listType=map // +listMapKey=type Conditions []metav1.Condition
json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions"
// other fields } - 型
-
object
- 必須
-
lastTransitionTime
-
message
-
reason
-
status
-
type
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| lastTransitionTime は、ある状態から別の状態に最後に遷移した時間です。これは、基本的な条件が変更された時点となります。不明な場合には、API フィールドが変更された時点を使用することも可能です。 |
|
| message は、遷移の詳細を示す人が判読できるメッセージです。空の文字列の場合もあります。 |
|
| observedGeneration は、それをベースに条件が設定された .metadata.generation を表します。たとえば、.metadata.generation が現在 12 で、.status.conditions[x].observedGeneration が 9 の場合、インスタンスの現在の状態に対して条件が古くなっています。 |
|
| reason には、条件の最後の遷移の理由を示すプログラムによる識別子が含まれます。特定の条件タイプのプロデューサーは、このフィールドの期待値と意味、および値が保証された API と見なされるかどうかを定義できます。値は CamelCase 文字列である必要があります。このフィールドには空白を指定できません。 |
|
| 条件のステータス、True、False、Unknown のいずれか。 |
|
| CamelCase または foo.example.com/CamelCase の条件のタイプ。--- 多くの.condition.type 値は、Available などのリソース全体で一貫していますが、任意の条件が役立つ可能性があるため (.node.status.conditions を参照)、競合を解消する機能が重要です。一致する正規表現は (dns1123SubdomainFmt/)?(qualifiedNameFmt) です。 |
16.1.10. .status.generations
- 説明
- generations は、項目を調整する必要があるタイミングや、対応が必要な変更が項目に対して行われたタイミングを判断するために使用します。
- 型
-
array
16.1.11. .status.generations[]
- 説明
- GenerationStatus は、特定のリソースの生成を追跡するため、強制更新に関する決定を行うことができます。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| グループはあなたが追跡しているもののグループです |
|
| ハッシュは、シークレットや設定マップのようにコンテンツに依存する、生成されないリソース用に設定されたオプションのフィールドです。 |
|
| lastGeneration は、関連するワークロードコントローラーの最後の世代です。 |
|
| name は、追跡しているものの名前です |
|
| 名前空間は、追跡しているものがどこにあるかです |
|
| リソースは、追跡しているもののリソースタイプです |
16.1.12. .status.insightsReport
- 説明
- insightsReport は、一般的な Insights の分析結果を提供します。省略された場合、データ収集はまだ行われていません。
- 型
-
object
プロパティー | タイプ | 説明 |
---|---|---|
|
| downloadedAt は、最後の Insights レポートがダウンロードされた時刻です。空の値は、Insights レポートがまだダウンロードされていないことを意味し、通常は非接続のクラスター (または Insights のデータ収集が無効なクラスター) で見られます。 |
|
| healthChecks は、クラスター内のアクティブな Insights ヘルスチェックに関する基本情報を提供します。 |
|
| healthCheck は、Insights ヘルスチェックの属性を表します。 |
16.1.13. .status.insightsReport.healthChecks
- 説明
- healthChecks は、クラスター内のアクティブな Insights ヘルスチェックに関する基本情報を提供します。
- 型
-
array
16.1.14. .status.insightsReport.healthChecks[]
- 説明
- healthCheck は、Insights ヘルスチェックの属性を表します。
- 型
-
object
- 必須
-
advisorURI
-
description
-
state
-
totalRisk
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| advisorURI は、Insights Advisor への URL リンクを提供します。 |
|
| description は、ヘルスチェックの基本的な説明を提供します。 |
|
| state は、ヘルスチェックの現在の状態を示します。ヘルスチェックはデフォルトで有効になっていますが、ユーザーは Insights アドバイザーユーザーインターフェイスで無効にすることができます。 |
|
| ヘルスチェックの totalRisk。検出された問題によってもたらされる総リスクを示します。影響と確率を組み合わせたものです。値は 1 から 4 までで、数値が大きいほど問題の重要度が高くなります。 |