Merge pull request #47451 from Ritikaa96/audit-annotation-etcd-decode-latency

Register some audit annotations

Author: k8s-ci-robot

content/en/docs/reference/labels-annotations-taints/audit-annotations.md

@@ -31,7 +31,7 @@ request used a deprecated API version.
 
 Example: `k8s.io/removed-release: "1.22"`
 
-Value **must** be in the format "<major>.<minor>". It is set to target the removal release
+Value **must** be in the format "\<MAJOR>\.\<MINOR>\". It is set to target the removal release
 on requests made to deprecated API versions with a target removal release.
 
 ## pod-security.kubernetes.io/exempt
@@ -72,6 +72,30 @@ violated from the PodSecurity enforcement.
 See [Pod Security Standards](/docs/concepts/security/pod-security-standards/)
 for more information.
 
+## apiserver.latency.k8s.io/etcd
+
+Example: `apiserver.latency.k8s.io/etcd: "4.730661757s"`
+
+This annotation indiactes the measure of latency incurred inside the storage layer,
+it accounts for the time it takes to send data to the etcd and get the complete response back.
+
+The value of this audit annotation does not include the time incurred in admission, or validation.
+
+## apiserver.latency.k8s.io/decode-response-object
+
+Example: `apiserver.latency.k8s.io/decode-response-object: "450.6649ns"`
+
+This annotation records the time taken to decode the response received from the storage layer (etcd)
+
+## apiserver.latency.k8s.io/apf-queue-wait
+
+Example: `apiserver.latency.k8s.io/apf-queue-wait: "100ns"`
+
+This annotation records the time that a request spent queued due to API server priorities.
+
+See [API Priority and Fairness](/docs/concepts/cluster-administration/flow-control/) (APF)
+for more information about this mechanism.
+
 ## authorization.k8s.io/decision
 
 Example: `authorization.k8s.io/decision: "forbid"`