Integrations
Kubernetes
Connect Castrel to Kubernetes for cluster resource queries, Pod status monitoring, and event retrieval.
Overview
- Connector name:
kubernetes - Supported API version: Kubernetes API v1
- Official docs: Kubernetes API Reference
Configuration
To use Kubernetes tools, create a Connector with the following fields:
| Field | Required | Description |
|---|---|---|
base_url | Yes | Kubernetes API Server address (e.g., https://10.104.0.219:6443) |
auth_type | Yes | Authentication type: bearer (ServiceAccount Token) or basic |
bearer_token | No | ServiceAccount Bearer Token (required when auth_type=bearer) |
timeout | No | Request timeout in seconds (default: 30) |
verify_ssl | No | Verify SSL certificates (clusters typically use self-signed certs, default: false) |
It is recommended to use a ServiceAccount Token with read-only permissions, granting the
viewClusterRole via RBAC.
Available Tools
This connector provides a comprehensive set of tools for Kubernetes cluster status monitoring and resource queries.
- Pod queries: List Pod status, resource usage, and logs
- Deployment management: Query Deployment and ReplicaSet status and history
- Node information: Retrieve node status, resource capacity, and health
- Event queries: Retrieve cluster event (Warning/Normal) lists
- Services & Ingress: Query network resource configurations and status
- ConfigMap / Secret: View configuration resources (Secret values are masked)