Skip to main content
Monitoring & Collection/Logging
GETLoggingSince 1.0SynchronousAuth Required

GetK8sComponentLogs

Retrieve recent logs from a specific Kubernetes control-plane component

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Query Parameters

Request Inputs

Path Parameters

  • componentStringRequired

    Kubernetes control-plane component name to retrieve logs from

Query Parameters

  • tailInteger

    Number of most recent log lines to return Number of most recent log lines to return

    Example: 0

Responses

200 OK

On success, this API returns the following response structure.

  • itemsList

    Collection of result items

    Example: (nested array)

    • auditIdString

      Unique identifier of this audit log entry

      Example: audit-abc-001

    • levelString

      Audit log level as defined by the Kubernetes audit policy

      Example: RequestResponse

    • timestampString

      Timestamp for this resource

      Example: 2026-01-15T08:00:00Z

    • userObject

      The user value

      • usernameString

        Kubernetes username from the audit log record

        Example: system:admin

      • groupsList

        Groups for this resource

        Example: item1,item2

    • sourceIpsList

      Source ips

      Example: item1,item2

    • verbString

      HTTP verb of the API request (get, create, delete, patch, etc.)

      Example: delete

    • resourceString

      Kubernetes resource type that was operated on

      Example: pods

    • namespaceString

      Kubernetes namespace in which the resource resides

      Example: production

    • nameString

      Name of the specific resource instance operated on

      Example: payment-pod-001

    • responseCodeInteger

      HTTP response code returned by the API server

      Example: 200

    • userAgentString

      User-Agent header value from the API request

      Example: kubectl/v1.28.0

    • sensitiveBoolean

      Whether this audit entry is flagged as a sensitive or high-risk operation

      Example: true

    • componentString

      Control-plane component that produced this audit entry

      Example: kube-apiserver

    • idString

      Secondary identifier for this audit log entry

      Example: entry-0001

Endpoint

GET/api/v1/logging/k8s-control-plane/{component}/logs

/api/v1/logging/k8s-control-plane/{component}/logs

Operation ID

GetK8sComponentLogs

Permalink

Request Example

curl -X GET '{host}/api/v1/logging/k8s-control-plane/{component}/logs' -H 'Authorization: Bearer {token}'

Response Example

200
{
  "items": [
    {}
  ]
}

Change History

This API has no change history records yet.

View all change history