Previous

Next

Exercise - Deploy an Azure function to IoT Edge

Completed

Filter the telemetry sent by the device.

Recall that you want to minimize the amount of data sent from each store. To reduce the amount of telemetry sent to your Azure IoT Central application, you want to filter the data on the IoT Edge device.

Here, you use Azure Functions running on the IoT Edge device to implement a filter. The filter ensures that the device only sends telemetry when the ambient temperature is above 21°C.

Note

This exercise is optional. If you want to complete this exercise, you'll need to create an Azure subscription before you begin. If you don't have an Azure account or you don't want to create one at this time, you can read through the instructions so you understand the information that's being presented.

Configure a container registry

Your IoT Edge device must download and install the custom Azure Functions module that implements the filter. IoT Edge modules are packaged as Docker-compatible images that you can store in a container repository. You use the Azure Container Registry (ACR) to store your new module and to build the container from a source project.

Run the following commands to add a container registry to your resource group in Azure:

REGISTRY_NAME="edgecentral$RANDOM"
az acr create -n $REGISTRY_NAME -g <rgn>[sandbox resource group name]</rgn> --sku Standard --admin-enabled true
az acr credential show -n $REGISTRY_NAME
echo "Your registry name is: $REGISTRY_NAME"

Make a note of the registry name and password values for use later in this unit.

Create an Azure Functions project

You're using C# to implement the function. Run the following commands to install the project template and then generate a skeleton project:

dotnet new -i Microsoft.Azure.IoT.Edge.Function
dotnet new aziotedgefunction -n FilterFunction -r $REGISTRY_NAME.azurecr.io/filterfunction
cd FilterFunction
ls

Run the following command to replace the existing FilterFunction.cs with an implementation that filters the machine temperature telemetry:

curl -O https://raw.githubusercontent.com/Azure-Samples/iot-central-docs-samples/main/iotedge/FilterFunction.cs

Now build the image and upload it to your container registry. Expect this command to take a couple of minutes to run:

az acr build --registry $REGISTRY_NAME --image filterfunction:v1 -f Dockerfile.amd64 .

You can list the images in your registry with the following command:

az acr repository list --name $REGISTRY_NAME

Update the deployment manifest

To use the new filter module on your IoT Edge device, update the deployment manifest with the new version.

Download the new deployment manifest and interface definition to your local machine by right-clicking on the following links and choosing Save as:

• EnvironmentalSensorManifestFilter-1-4.json
• TelemetryInterfaceFilter.json

Open the EnvironmentalSensorManifestFilter-1-4.json in a text editor and update it to use the filter module from your container registry:

1. Replace the three instances of <YOUR CONTAINER REGISTRY NAME> with the name of your container registry. The name looks like edgecentral27912.
2. Replace <YOUR CONTAINER REGISTRY PASSWORD> with the password you made a note of previously in this unit.
3. Save the changes.

This version of the deployment manifest:

• Adds the module with the Azure function you created:

  "filterfunction": {
    "version": "1.0",
    "type": "docker",
    "status": "running",
    "restartPolicy": "always",
    "settings": {
      "image": "<YOUR CONTAINER REGISTRY NAME>.azurecr.io/filterfunction:v1",
      "createOptions": ""
    }
  

• Routes the output from the SimulatedTemperatureSensor module to the filterfunction module before sending the filtered telemetry to your Azure IoT Central application:

  "routes": {
      "FilterFunctionToIoTCentral": "FROM /messages/modules/filterfunction/outputs/* INTO $upstream",
      "sensorToFilterFunction": "FROM /messages/modules/SimulatedTemperatureSensor/outputs/temperatureOutput INTO BrokeredEndpoint(\"/modules/filterfunction/inputs/input1\")"
    },
  

To upload the new deployment manifest:

1. In your Azure IoT Central application, go to Edge manifests and select the Environmental Sensor manifest.

2. On the Customize page, upload the new EnvironmentalSensorManifestFilter-1-4.json file. Select Next.

3. The Review and finish page shows the new filterfunction module. Select Save.

4. Go to the Environmental Sensor Edge Device - store-001 device from the Devices page and select Modules.

5. Near the top of the page, select Manage manifest > Assign edge manifest. Select the Environmental Sensor manifest, then select Assign manifest.

The list of modules now includes the running filterfunction module:

Update the device template to use the new module

The IoT Edge device is now sending the telemetry through the filterfunction interface instead of the Telemetry interface. Therefore, you need to update the device template and views.

1. On the Device templates page, select Environmental Sensor Edge Device.

2. Select Modules, and then select Import modules from manifest.

   

3. In the Import modules dialog, select Environmental Sensor, and then select Import.

The new module now sends the telemetry to Azure IoT Central. Next, add an interface to the new filter module that specifies the telemetry and updates the chart.

1. Select Module FilterFunction, then + Add inherited interface. You might need to select the ellipses (...) to see this option.
2. Choose the Import interface tile. Select the TelemetryInterfaceFilter.json file you downloaded previously.

You can remove the original Telemetry interface because the SimulatedTemperatureModule no longer sends telemetry directly to Azure IoT Central. The output from this module is routed to the FilterFunction module by the IoT Edge runtime.

1. Select the Telemetry interface in the SimulatedTemperatureSensor module.
2. Select Delete and then confirm the operation.

Modify the View IoT Edge device telemetry view to display the telemetry sent by the FilterFunction module.

1. In the device template, select the View IoT Edge device telemetry view, and then select the Edit option on the chart tile.
2. Add the ambient/temperature, humidity, machine/temperature, and pressure telemetry values.
3. Select Update and then Save.
4. Select Publish to publish the new version of the device template.

Check your work

To view the filtered telemetry from your IoT Edge device:

1. On the Devices page, select the store-001 device.

2. Select the View IoT Edge device telemetry view.

   You can see the filtered telemetry on the chart. There are no values shown with an average ambient temperature of less than 21.0 degrees.

   

If the device appears to stop sending telemetry, it's likely because the SimulatedTemperatureSensor module stops after sending 500 messages. If you restart the virtual machine, the count resets and you see telemetry start to flow again:

az vm restart --resource-group <rgn>[sandbox resource group name]</rgn> \
  --name $(az vm list --resource-group <rgn>[sandbox resource group name]</rgn> --query [0].name -o tsv)

Continue