第7章 Event [events.k8s.io/v1]
- 説明
- イベントは、クラスター内のどこかにあるイベントのレポートです。これは通常、システムの状態変化を示します。イベントの保持時間は限られており、トリガーとメッセージは時間とともに進化する可能性があります。イベントの利用者は、一貫した根本的なトリガーを反映する特定の理由を持つイベントのタイミング、またはその理由を持つイベントの継続的な存在に依存するべきではありません。イベントは、有益で、最善を尽くした、補足的なデータとして扱う必要があります。
- タイプ
-
object
- 必須
-
eventTime
-
7.1. 仕様
プロパティー | タイプ | 説明 |
---|---|---|
|
| アクションは、関連するオブジェクトに関して実行された/失敗したアクションです。機械可読です。このフィールドは、新しいイベントでは空にすることはできず、最大 128 文字にすることができます。 |
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| deprecatedCount は、core.v1 イベントタイプとの下位互換性を保証する非推奨のフィールドです。 |
| deprecatedFirstTimestamp は、core.v1 イベントタイプとの下位互換性を保証する非推奨のフィールドです。 | |
| deprecatedLastTimestamp は、core.v1 イベントタイプとの下位互換性を保証する非推奨のフィールドです。 | |
| deprecatedSource は、core.v1 イベントタイプとの下位互換性を保証する非推奨のフィールドです。 | |
| eventTime は、このイベントが最初に観察された時刻です。必須です。 | |
|
| 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 を参照してください。 | |
|
| 注は、この操作のステータスを人間が読める形式で説明したものです。ノートの最大長は 1kB ですが、ライブラリーは 64kB までの値を処理できるように準備する必要があります。 |
|
| 理由は、行動がとられた理由です。人間が読める形式です。このフィールドは、新しいイベントでは空にすることはできず、最大 128 文字にすることができます。 |
| このイベントに関するオブジェクトが含まれています。ほとんどの場合、これはオブジェクトレポートコントローラーが実装します。たとえば、ReplicaSetController は ReplicaSets を実装し、このイベントは、ReplicaSet オブジェクトの一部の変更に作用するために発行されます。 | |
| 関連するのは、より複雑なアクションのためのオプションのセカンダリーオブジェクトです。たとえば、オブジェクトに関しては、関連するオブジェクトの作成または削除がトリガーされます。 | |
|
|
reportingController は、このイベントを発行したコントローラーの名前です (例: |
|
|
reportingInstance は、コントローラーインスタンスの ID です (例: |
|
| EventSeries には、一連のイベントに関する情報が含まれています。つまり、しばらくの間継続的に発生していた/発生しているものです。EventSeries を更新する頻度は、イベントレポーター次第です。"k8s.io/client-go/tools/events/event_broadcaster.go" のデフォルトのイベントレポーターは、この構造体がハートビートでどのように更新されるかを示し、カスタマイズされたレポーターの実装をガイドできます。 |
|
| type は、このイベントのタイプ (Normal、Warning) であり、将来、新しいタイプが追加される可能性があります。機械可読です。新しいイベントの場合、このフィールドを空にすることはできません。 |
7.1.1. .series
- 説明
- EventSeries には、一連のイベントに関する情報が含まれています。つまり、しばらくの間継続的に発生していた/発生しているものです。EventSeries を更新する頻度は、イベントレポーター次第です。"k8s.io/client-go/tools/events/event_broadcaster.go" のデフォルトのイベントレポーターは、この構造体がハートビートでどのように更新されるかを示し、カスタマイズされたレポーターの実装をガイドできます。
- タイプ
-
object
- 必須
-
count
-
lastObservedTime
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| count は、最後のハートビート時間までのこのシリーズの発生数です。 |
| lastObservedTime は、シリーズの最後のイベントが最後のハートビートの前に見られた時刻です。 |