Monitoring sensor readings and event notifications

1. In the management console, select the folder you are using to complete this tutorial.

2. In the list of services, select IoT Core.

3. Click Create registry.

4. In the Name field, enter a name for the registry, e.g., my-registry.

5. In the Password field, set a password to access the registry. To create a password, you can use the password generator.

   Note

   Save the password as you will need it for authentication.

6. Click Create.

1. In the management console, select the folder you are using to complete this tutorial.

2. In the list of services, select IoT Core.

3. Select the registry you created in the previous step.

4. Select Devices in the left-hand menu.

5. Click Add device.

6. In the Name field, enter the device name, e.g., my-device.

7. In the Password field, set a password to access the device. To create a password, you can use the password generator.

   Note

   Save the password as you will need it for authentication.

8. Optionally, add an alias:

   1. Click Add alias.

   2. Fill in the fields: enter an alias, e.g., events, and the topic type after $devices/{id}, e.g., events.

      You can now use the events alias instead of the $devices/{id}/events topic.

   3. Repeat the steps for each alias you add.

9. Click Create.

10. Repeat the steps for each device you want to create.

1. In the management console, select the folder you are using to complete this tutorial.
2. In the list of services, select Cloud Functions.
3. Create a function:
   1. Click Create function.
   2. In the Name field, enter a name for the function, e.g., my-device-emulator-function.
   3. Click Create.
4. Create a function version:

   1. In the Editor window that opens, select Node.js 18.

   2. Disable the Add files with code examples option.

   3. Click Continue.

   4. In the Method field, select Code editor.

   5. Click Create file:

      • File name: device-emulator.js.
      • File contents: Function code from GitHub.

   6. Similarly, create a file named package.json with the following content:

      {
        "name": "my-app",
        "version": "1.0.0",
        "dependencies": {
          "yandex-cloud": "*"
        }
      }
      

   7. In the Entry point field, specify device-emulator.handler.

   8. Under Parameters, specify:

      • Timeout: 10.
      • Memory: 128 MB.
      • Service account: my-emulator-function-service-account.
      • Environment variables:

        Key	Description	Value
        HUMIDITY_SENSOR_VALUE	Baseline humidity sensor reading	80.15
        TEMPERATURE_SENSOR_VALUE	Baseline temperature sensor reading	25.25
        RACK_DOOR_SENSOR_VALUE	State of the open rack door sensor	False
        ROOM_DOOR_SENSOR_VALUE	State of the open server room door sensor	False
        SMOKE_SENSOR_VALUE	State of the smoke sensor	False
        WATER_SENSOR_VALUE	State of the water sensor	False
        IOT_CORE_DEVICE_ID	ID of the device you created	See the management console Yandex IoT Core
        DEVICE_ID	User-defined device name	Specified by the user

   9. Click Save changes.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

Run this command:

yc iot mqtt subscribe \
  --username <registry_ID> \
  --password <registry_password> \
  --topic '$devices/<device_ID>/events' \
  --qos 1

Where:

• --username and --password: Credentials for authentication with a username and password.
• --topic: Device topic for sending data or topic alias.
• --qos: Quality of service (QoS).

The command should continue running until the test is complete.

1. In the management console, select the folder you are using to complete this tutorial.

2. In the list of services, select Cloud Functions.

3. Select the my-device-emulator-function function.

4. In the left-hand menu, select Testing.

5. In the Version tag list, select $latest, which is the last created function.

6. Click Run test.

   If the function is successful, the Done status will be displayed in the Function status field and the result will appear in the Function output field:

   {
     "statusCode" : 200
   }
   

   If you subscribed to the Yandex IoT Core device topic, you will get the following JSON strings in the terminal:

   {
     "DeviceId":"my-device-id",
     "TimeStamp":"2024-06-14T15:29:59Z",
     "Values":[
         {"Type":"Float","Name":"Humidity","Value":"80.84"},
         {"Type":"Float","Name":"Temperature","Value":"25.46"},
         {"Type":"Bool","Name":"Water sensor","Value":"False"},
         {"Type":"Bool","Name":"Smoke sensor","Value":"False"},
         {"Type":"Bool","Name":"Room door sensor","Value":"False"},
         {"Type":"Bool","Name":"Rack door sensor","Value":"False"}
         ]
     }
   

1. In the management console, select the folder you are using to complete this tutorial.
2. In the list of services, select Cloud Functions.
3. In the left-hand panel, select Triggers.
4. Click Create trigger.
5. In the Name field, enter a name for the trigger, e.g., my-emulator-function-trigger.
6. In the Type field, select Timer.
7. In the Cron expression field, enter * * * * ? * (invoke once per minute).
8. Under Function settings, enter the parameters previously set for the function:
   • Function: my-device-emulator-function.
   • Function version tag: $latest.
   • Service account: my-emulator-function-service-account.
9. Optionally, configure the Repeat request settings and Dead Letter Queue settings section parameters. They provide data security.

   • Repeat request settings allow you to repeatedly call the function if the current function call fails.

   • Dead Letter Queue settings allow you to redirect messages that consumers could not process in common queues.

     You can configure a standard message queue as a DLQ. If you do not have a message queue yet, create one in Yandex Message Queue.

10. Click Create trigger.

1. In the management console, select the folder you are using to complete this tutorial.
2. In the list of services, select Cloud Functions.
3. In the left-hand panel, select Functions.
4. Create a function:
   1. Click Create function.
   2. In the Name field, enter a name for the function, e.g., my-monitoring-func.
   3. Click Create.
5. Create a function version:

   1. In the Editor window that opens, select Python 3.12.

   2. Disable the Add files with code examples option.

   3. Click Continue.

   4. In the Method field, select Code editor.

   5. Click Create file:

      • File name: monitoring.py.

      • File contents: Function code from GitHub.

        In this function, the data to send to the monitoring service is in the makeAllMetrics method. If you want to add or remove parameters, make changes to this method.

   6. In the Entry point field, specify monitoring.msgHandler.

   7. Under Parameters, specify:

      • Timeout: 10.

      • Memory: 128 MB.

      • Service account: my-metrics-function-service-account.

      • Environment variables:

        Key	Description	Value
        VERBOSE_LOG	Turning data logging on and off	True
        METRICS_FOLDER_ID	ID of the folder where the services are deployed and for which you will create a dashboard in Monitoring.	See the management console

   8. Click Save changes.

1. In the management console, select the folder you are using to complete this tutorial.

2. In the list of services, select Cloud Functions.

3. Select the my-monitoring-func function.

4. In the left-hand menu, select Testing.

5. In the Version tag list, select $latest, which is the last created function.

6. In the Payload field, paste the following data:

   {
     "messages": [
     {
       "event_metadata": {
         "event_id": "160d239876d9714800",
         "event_type": "yandex.cloud.events.iot.IoTMessage",
         "created_at": "2020-05-08T19:16:21.267616072Z",
         "folder_id": "b112345678910"
       },
       "details": {
         "registry_id": "are1234567890",
         "device_id": "are0987654321",
         "mqtt_topic": "$devices/are0987654321/events",
         "payload": "eyJWYWx1ZXMiOiBbeyJUeXBlIjogIkZsb2F0IiwgIlZhbHVlIjogIjI1Ljc0IiwgIk5hbWUiOiAiSHVtaWRpdHkifSwgeyJUeXBlIjogIkZsb2F0IiwgIlZhbHVlIjogIjgwLjY1IiwgIk5hbWUiOiAiVGVtcGVyYXR1cmUifSwgeyJUeXBlIjogIkJvb2wiLCAiVmFsdWUiOiAiRmFsc2UiLCAiTmFtZSI6ICJXYXRlciBzZW5zb3IifSwgeyJUeXBlIjogIkJvb2wiLCAiVmFsdWUiOiAiRmFsc2UiLCAiTmFtZSI6ICJTbW9rZSBzZW5zb3IifSwgeyJUeXBlIjogIkJvb2wiLCAiVmFsdWUiOiAiRmFsc2UiLCAiTmFtZSI6ICJSb29tIGRvb3Igc2Vuc29yIn0sIHsiVHlwZSI6ICJCb29sIiwgIlZhbHVlIjogIkZhbHNlIiwgIk5hbWUiOiAiUmFjayBkb29yIHNlbnNvciJ9XSwgIlRpbWVTdGFtcCI6ICIyMDIwLTA1LTIxVDIzOjEwOjE2WiIsICJEZXZpY2VJZCI6ICIwZTNjZTFkMC0xNTA0LTQzMjUtOTcyZi01NWM5NjEzMTk4MTQifQ=="
       }
     }]
   }
   

7. Click Run test.

   If the function is successful, you will see the Done status in the Function status field and the Function output field will display this result:

   {
     "statusCode" : 200 ,
     "headers" : {
       "Content-Type" : "text/plain"
     },
   "isBase64Encoded" : false
   }
   

1. In the management console, select the folder you are using to complete this tutorial.
2. In the list of services, select Cloud Functions.
3. In the left-hand panel, select Triggers.
4. Click Create trigger.
5. In the Name field, enter a name for the trigger, e.g., my-monitoring-func-trigger.
6. In the Type field, select IoT Core (device).
7. Under IoT Core message settings, enter the parameters previously set for the registry and device:
   • Registry: my-registry.
   • Device: my-device.
   • MQTT topic: $devices/<device_ID>/events, where <device_ID> is the device ID in Yandex IoT Core.
8. Under Function settings, enter the parameters previously set for the function:
   • Function: my-monitoring-func.
   • Function version tag: $latest.
   • Service account: my-metrics-function-service-account.
9. Optionally, configure the Repeat request settings and Dead Letter Queue settings section parameters. They provide data security.

   • Repeat request settings allow you to repeatedly call the function if the current function call fails.

   • Dead Letter Queue settings allow you to redirect messages that consumers could not process in common queues.

     You can configure a standard message queue as a DLQ. If you do not have a message queue yet, create one in Yandex Message Queue.

10. Click Create trigger.

All data from the device will be automatically sent to Monitoring.

1. In the management console, select the folder you are using to complete this tutorial.
2. In the list of services, select Monitoring.
3. Navigate to the Dashboards tab.
4. Click Create.
5. At the top right, click Save.
6. In the window that opens, enter a name for the dashboard and click Save.

1. In the management console, select the folder you are using to complete this tutorial.

2. In the list of services, select Monitoring.

3. Navigate to the Dashboards tab.

4. Next to the dashboard name you need, click → Edit.

5. In the bottom section, click Graph.

6. Create a query for the chart:

   1. In the query editor, click .
   2. In the list of services (service=), select Custom Metrics.
   3. In the list of chart types (name=), select Temperature, which is room temperature.
   4. In the device_id= list, select the ID of the device that you want to create a chart for.

7. At the top right, click Save.

Create other charts in a similar way:

• Humidity: Room air humidity.
• Water sensor: Water on the floor (yes/no).
• Smoke sensor: Smoke in the room (yes/no).
• Room door sensor: Room door status (door open/door closed).
• Rack door sensor: Server rack door status (door open/door closed).

The dashboard is available via a link to all Yandex Cloud users with the viewer role. You can customize it, zoom in or out, and enable or disable automatic data updates.

1. In the management console, select the folder you are using to complete this tutorial.

2. In the list of services, select Cloud Functions.

3. Select the my-device-emulator-function function.

4. Click the Editor tab.

5. Replace some original variable values with any other under Environment variables in the Value field at the bottom of the window.

   Key	Original value	New value
   HUMIDITY_SENSOR_VALUE	80.15	40
   TEMPERATURE_SENSOR_VALUE	25.25	15
   RACK_DOOR_SENSOR_VALUE	False	True
   ROOM_DOOR_SENSOR_VALUE	False	True
   SMOKE_SENSOR_VALUE	False	True
   WATER_SENSOR_VALUE	False	True

6. Click Save changes and wait until the operation is complete.

1. In the management console, select the folder you are using to complete this tutorial.
2. In the list of services, select Monitoring and see how the chart metrics have changed.

1. In the management console, select the folder you are using to complete this tutorial.

2. In the list of services, select Monitoring.

3. Navigate to the Notification channels tab.

4. Click Create channel.

5. In the Name field, specify the channel name, e.g., my-message-channel.

6. In the Method list, select Email.

   You can also set up notifications through text messages, push notifications, or Telegram.

7. In the Recipients list, select an account.

   You can select multiple recipients for notifications. You can specify the accounts of users who have access to your cloud as recipients. Learn more about how to add users to Yandex Cloud.

8. Click Create.

1. In the management console, select the folder you are using to complete this tutorial.
2. In the list of services, select Monitoring.
3. Click Create alert.
4. In the Name field, enter a name for the alert.
5. Under Alert configuration, click and fill out the fields:
   1. In the list of services (service=), select Custom Metrics.
   2. In the list of name= alert types, select Temperature.
   3. In the device_id= list, select the ID of the device that you want to create an alert for.
6. Under Alert conditions, set the conditions to trigger the alert:
   1. In the Aggregation function list, select Average.
   2. In the Comparison function list, select Greater than.
   3. In the Warning field, enter 50.
   4. In the Alarm field, enter 70.
   5. In the Evaluation window list, select 5 minutes.
7. Under Notifications, click Edit, and then Add.
8. In the Notification method field of the window that opens, select my-message-channel and click Add.
9. At the bottom of the window, click Create.