Kubernetes Telemetry
Provision an Istio Telemetry resource -- the mesh primitive that controls how
observability signals are generated for selected workloads: trace sampling and custom
span tags, metric dimensions and toggles, and access-log providers and filters.
What Gets Created
- A namespaced
telemetry.istio.io/v1Telemetrycustom resource. - Optional
selectorortarget_refs, plus any oftracing,metrics, andaccess_logging.
Prerequisites
- Istio CRDs installed on the cluster (
KubernetesIstioBaseCrds). - A running Istio control plane, istiod (
KubernetesIstio), to apply the configuration. - The target namespace (
KubernetesNamespace).
Quick Start
apiVersion: kubernetes.openmcf.org/v1
kind: KubernetesTelemetry
metadata:
name: mesh-default
spec:
namespace:
value: istio-system
tracing:
- random_sampling_percentage: 10
openmcf apply -f telemetry.yaml
Configuration Reference
Required Fields
| Field | Type | Description |
|---|---|---|
namespace | reference | Namespace the Telemetry resource is created in. |
Optional Fields
| Field | Type | Description |
|---|---|---|
selector.match_labels | map | Pods/VMs the config applies to; matched by istiod, not a foreign key. Mutually exclusive with target_refs. |
target_refs | list | Attach to Gateway/Service/ServiceEntry instead of a selector (max 16). |
tracing | list | Sampling, providers, custom span tags, span-reporting toggles. |
metrics | list | Providers, per-metric overrides (enable/disable + tag dimensions), reporting interval. |
access_logging | list | Providers, enable/disable, CEL filter. |
Stack Outputs
| Output | Description |
|---|---|
telemetry_name | Name of the created Telemetry resource (equals metadata.name). |
namespace | Namespace the Telemetry resource was created in. |
Related Components
Next article
Kubernetes Temporal
Kubernetes Temporal Deploys a Temporal server cluster on Kubernetes using the official Temporal Helm chart, with support for Cassandra, PostgreSQL, or MySQL database backends (embedded or external), optional Temporal Web UI, Elasticsearch-based advanced visibility, Prometheus and Grafana monitoring, and external access through gRPC LoadBalancer services and Istio Gateway API ingress with automatic TLS via cert-manager. What Gets Created When you deploy a KubernetesTemporal resource, OpenMCF...