How to run the mock snmp device

The SNMP mock

The snmp mock is an UDP server mocking a device using SNMP with an mock MIB file (./dev/TNO-PDU-MIB.txt) and providing the following metrics tnoPduEnergyValue and tnoPduPowerValue. This file details how to set up the mock device, and how to subsequently run a demo with it including both the PhysicalMeasurement and MeasurementDevice custom resources.

requirements

Ensure you have followed the instructions in How to set up the local development environment to set up a local development environment. After this:

  • The development cluster is running.
  • The controller is running (locally via make run or in-cluster).
  • Port-forwarding is active (./dev/port-forward.sh).

Build and load the snmp-mock image into the kind environment

export CI_REGISTRY="ci.tno.nl/ipcei-cis-misd-sustainable-datacenters/wp2/energy-domain-controller/chantico"
export SNMP_MOCK_TAG="${SNMP_MOCK_TAG:-latest}"
export SNMP_MOCK_IMAGE="$CI_REGISTRY/chantico-snmp-mock:$SNMP_MOCK_TAG"
docker pull "$SNMP_MOCK_IMAGE"
docker tag "$SNMP_MOCK_IMAGE" chantico-snmp-mock:latest
kind load docker-image chantico-snmp-mock:latest --name kind

Apply the mock to Kubernetes

kubectl apply -f dev/k8s/snmp-mock-deployment.yaml
kubectl apply -f dev/k8s/snmp-mock-service.yaml
kubectl apply -f config/samples/chantico_v1alpha1_physicalmeasurement_mock.yaml

Querying the chantico-snmp-mock running in the development setup

If the development kind cluster is running the chantico-snmp-mock service, there is a Node Port that is visible on port 31161.

It can be queried as follow:

snmpget -v2c -c public -M +./dev -m +TNO-PDU-MIB localhost:31161 tnoPduEnergyValue

Chantico workflow with the snmp-mock as snmp device (full demo)

For an overview of the workflow that is run in the background in this demo please see the below image.

This section demonstrates a full flow: MIB upload → MeasurementDevice → PhysicalMeasurement → Prometheus targets.

  1. Login in the web UI of chantico-filebrowser, localhost:18888 and Upload ./dev/TNO-PDU-MIB.txt to ./snmp/mibs/TNO-PDU-MIB.txt

  2. Create a MeasurementDevice for the mock MIB:

kubectl apply -f ./config/samples/chantico_v1alpha1_measurementdevice_mock.yaml
  1. Wait for the SNMP generator job:
kubectl get jobs -n chantico | grep update-snmp
  1. Create a PhysicalMeasurement pointing at the mock target:
kubectl apply -f ./config/samples/chantico_v1alpha1_physicalmeasurement_mock.yaml
  1. Port-forward Prometheus and verify targets:
kubectl port-forward -n chantico deployment/chantico-prometheus 9090:9090

Open http://localhost:9090/targets and verify the target is UP.

Adding another mock snmp device

The same mock SNMP image can be deployed multiple times to simulate additional devices. Each additional device needs its own Deployment, Service, MeasurementDevice, and PhysicalMeasurement. Example manifests for a second mock device are provided in the repository.

  1. Deploy the second mock SNMP agent:
kubectl apply -f dev/k8s/snmp-mock-2-deployment.yaml
kubectl apply -f dev/k8s/snmp-mock-2-service.yaml
  1. Create a second MeasurementDevice (can reuse the same MIB/walks, or use different ones):
kubectl apply -f ./config/samples/chantico_v1alpha1_measurementdevice_mock2.yaml
  1. Wait for the SNMP generator job for the new device:
kubectl get jobs -n chantico | grep update-snmp
  1. Create a second PhysicalMeasurement pointing at the new mock target:
kubectl apply -f ./config/samples/chantico_v1alpha1_physicalmeasurement_mock2.yaml
  1. Verify both targets appear in Prometheus:
kubectl port-forward -n chantico deployment/chantico-prometheus 9090:9090

Open http://localhost:9090/targets — both the original and the new target should show as UP.

The second mock is exposed on NodePort 31162, so you can also query it directly:

snmpget -v2c -c public -M +./dev -m +TNO-PDU-MIB localhost:31162 tnoPduEnergyValue

Tip: To add more devices beyond the second, copy the mock-2 manifests, update the names (e.g. chantico-snmp-mock-3), pick a free NodePort, and create corresponding MeasurementDevice / PhysicalMeasurement resources. Prometheus will automatically pick up new targets via file_sd_configs — no restart required.