Audit logs in Google Distributed Cloud (GDC) air-gapped record create, read, update, and
delete (CRUD) activity across your Kubernetes clusters. This document lists
the tracked operations, payload fields, and an example entry for
`NodePoolClaim`, `AddressPoolClaim`, `SubnetClaim`, `CIDRClaim`, and `NodePool`
custom resources.

## CRUD operations

CRUD operations include:

- `NodePoolClaim` data
- `AddressPoolClaim` data
- `SubnetClaim` data
- `CIDRClaim` data
- Cluster data
- `NodePool` data
- MKS Cluster data

The following table contains an example for `NodePoolClaim` data (CRUD
operations):

| Fields in the log entry that contain audit information |||
| Audit metadata | Audit field name | Value |
|---|---|---|
| **User or service identity** | `user` | User performing the action: `user.username: system:serviceaccount:kube-system:anthos-cluster-operator-1.13.2` *Full object snippet:* ```json "user":{ "username": "system:serviceaccount:kube-system:anthos-cluster-operator-1.13.2", "uid": "4ebfd4f7-f371-4c40-9f88-ea0709a7039e", "groups": [ "system:serviceaccounts", "system:serviceaccounts:kube-system", "system:authenticated" ], "extra": { "authentication.kubernetes.io/pod-name": [ "anthos-cluster-operator-1.13.2-bc6b7467d-22z88" ], "authentication.kubernetes.io/pod-uid": [ "004e1b37-6d4d-4959-b77d-0e69dce5ef4a" ] } } ``` |
| **Target** *(KRM object being acted upon)* | `objectRef` / `requestURI` | Specific object reference: ```json "objectRef": { "resource": "nodepoolclaims", "namespace": "org-1", "name": "admin-control-plane-node-pool", "apiGroup": "baremetal.cluster.gke.io", "apiVersion": "v1", "subresource": "status" } ``` Request URI: `/apis/baremetal.cluster.gke.io/v1/namespaces/org-1/nodepoolclaims/admin-control-plane-node-pool/status` |
| **Action** *(The CRUD operation performed)* | `verb` | Operation performed: `update` *(Other possible values: get, create, apply, patch, delete, list, watch)* |
| **Event timestamp** | `requestReceivedTimestamp` | `2022-11-23T23:19:42.690064Z` |
| **Source of action** | `_gdch_cluster`, `sourceIPs` | Cluster: `root-admin` Source IP address: `["10.253.128.74"]` |
| **Outcome** | `responseStatus`, `stage` | Stage: `ResponseComplete` Response Status: ```json "responseStatus": { "metadata": {}, "code": 200 } ``` *(Code `200` indicates success)* |
| **Other useful fields** | `auditID`, `annotations`, *Search Filter* | Audit ID: `0539ea3a-b858-4a43-b516-812fc7e80dbd` Annotations include authorization details. *Search Filter:* `` {service_name="apiserver"} |= `"resource":"nodepoolclaims"` `` |

**Example log**

    {
      "responseStatus": {
        "metadata": {},
        "code": 200
      },
      "_gdch_cluster": "root-admin",
      "sourceIPs": [
        "10.253.128.74"
      ],
      "annotations": {
        "authorization.k8s.io/reason": "RBAC: allowed by ClusterRoleBinding \"operator-rolebinding-1.13.2\" of ClusterRole \"anthos-baremetal-operator-1.13.2\" to ServiceAccount \"anthos-cluster-operator-1.13.2/kube-system\"",
        "authorization.k8s.io/decision": "allow"
      },
      "requestReceivedTimestamp": "2022-11-23T23:19:42.690064Z",
      "stageTimestamp": "2022-11-23T23:19:42.695372Z",
      "_gdch_fluentbit_pod": "anthos-audit-logs-forwarder-4hlmv",
      "apiVersion": "audit.k8s.io/v1",
      "level": "Metadata",
      "user": {
        "extra": {
          "authentication.kubernetes.io/pod-name": [
            "anthos-cluster-operator-1.13.2-bc6b7467d-22z88"
          ],
          "authentication.kubernetes.io/pod-uid": [
            "004e1b37-6d4d-4959-b77d-0e69dce5ef4a"
          ]
        },
        "groups": [
          "system:serviceaccounts",
          "system:serviceaccounts:kube-system",
          "system:authenticated"
        ],
        "username": "system:serviceaccount:kube-system:anthos-cluster-operator-1.13.2",
        "uid": "4ebfd4f7-f371-4c40-9f88-ea0709a7039e"
      },
      "stage": "ResponseComplete",
      "requestURI": "/apis/baremetal.cluster.gke.io/v1/namespaces/org-1/nodepoolclaims/admin-control-plane-node-pool/status",
      "kind": "Event",
      "objectRef": {
        "resource": "nodepoolclaims",
        "namespace": "org-1",
        "subresource": "status",
        "name": "admin-control-plane-node-pool",
        "apiVersion": "v1",
        "apiGroup": "baremetal.cluster.gke.io",
        "resourceVersion": "878163",
        "uid": "b2e1bec0-0f7c-4a57-869b-3fcb969ba7e2"
      },
      "verb": "update",
      "userAgent": "operator/v0.0.0 (linux/amd64) kubernetes/$Format",
      "auditID": "0539ea3a-b858-4a43-b516-812fc7e80dbd",
      "_gdch_service_name": "apiserver"
    }