Reference on ZAPP

gRPC pipeline component

Mon, 01 Jan 0001 00:00:00 +0000

Use grpcServer when a listener should expose telemetry directly to consumers. The component is terminal: it accepts pipeline input and serves the ZAPP gRPC service, but it does not produce downstream pipeline targets.

components:
 grpc:
 type: grpcServer
 address: :9998

Important fields:

type must be grpcServer
address is the TCP listen address for the gRPC server

Accepted input types:

*timeseries.Model
[]*zapp.Payload

Use grpcServer for direct listener-to-consumer deployments. Use the ZAPP Aggregator consumer API when you need one endpoint that combines telemetry from multiple listeners.

Redfish listener pipeline

Mon, 01 Jan 0001 00:00:00 +0000

A Redfish listener pipeline uses envPlugins.sensorPipeline to discover sensor metadata and a pipeline component to emit telemetry. The direct collector pattern uses redfishCollector to poll each configured baseboard management controller (BMC) and send time-series models to downstream targets.

envPlugins:
 sensorPipeline:
 maxRedfishConnections: 1
 redfishDevices:
 - endpoint: ${secrets.redfish_endpoint}
 username: ${secrets.redfish_username}
 password: ${secrets.redfish_password}
 tls:
 insecureSkipVerify: true
 manifest:
 path: /data/redfish-sensor-manifest.yaml
 forceReload: false

components:
 redfish:
 type: redfishCollector
 timeout: 30s
 samplePeriod: 5s
 targets:
 - target: aggregator
 cap: 1000
 leaky: true

Security note

Do not use tls.insecureSkipVerify: true in production. This setting disables certificate verification for Redfish connections. Use it only for local testing or lab environments with self-signed certificates. For production deployments, configure a trusted certificate authority for the BMC endpoints and leave tls.insecureSkipVerify unset or set it to false.

UDP listener and writer

Mon, 01 Jan 0001 00:00:00 +0000

Use udpListener to receive ZAPP UDP payload containers. Use udpWriter to forward payload batches to another UDP endpoint.

UDP listener

udpListener is a source component. It listens on a local UDP address, decodes ZAPP packets into payload batches, and sends those batches to configured targets.

components:
 listener:
 type: udpListener
 network: udp
 address: :9091
 allowedSources:
 - 10.0.0.0/24
 targets:
 - target: payloadProcessor
 cap: 1000
 leaky: true

Important fields:

Troubleshoot the Redfish listener

Mon, 01 Jan 0001 00:00:00 +0000

Start with Kubernetes readiness, then check listener configuration, ZAPP Aggregator connectivity, Redfish access, and telemetry validation.

Use Kubernetes checks, HTTP monitoring endpoints, and zest to isolate Redfish listener deployment problems.

Check pods and releases

helm list --namespace <namespace>
kubectl get pods --namespace <namespace>
kubectl get statefulsets --namespace <namespace>

If a pod is not ready, describe it and inspect recent events: