Мониторинг показаний датчиков и уведомления о событиях

1. В консоли управления выберите каталог, в котором вы выполняете руководство.

2. В списке сервисов выберите IoT Core.

3. Нажмите кнопку Создать реестр.

4. В поле Имя введите имя реестра. Например, my-registry.

5. В поле Пароль задайте пароль доступа к реестру. Для создания пароля можно воспользоваться генератором паролей.

   Примечание

   Сохраните пароль, он понадобится вам для аутентификации.

6. Нажмите кнопку Создать.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.

2. В списке сервисов выберите IoT Core.

3. Выберите реестр, созданный на предыдущем шаге.

4. В меню слева выберите раздел Устройства.

5. Нажмите кнопку Добавить устройство.

6. В поле Имя введите имя устройства. Например, my-device.

7. В поле Пароль задайте пароль доступа к устройству. Для создания пароля можно воспользоваться генератором паролей.

   Примечание

   Сохраните пароль, он понадобится вам для аутентификации.

8. (Опционально) Добавьте алиас:

   1. Нажмите кнопку Добавить алиас.

   2. Заполните поля: введите алиас (например events) и тип топика после $devices/{id} (например, events).

      Вы сможете использовать алиас events вместо топика $devices/{id}/events.

   3. Повторите действия для каждого добавляемого алиаса.

9. Нажмите кнопку Создать.

10. Повторите действия для каждого устройства, которое вы хотите создать.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.
2. В списке сервисов выберите Cloud Functions.
3. Создайте функцию:
   1. Нажмите кнопку Создать функцию.
   2. В поле Имя введите имя функции. Например, my-device-emulator-function.
   3. Нажмите кнопку Создать.
4. Создайте версию функции:

   1. В открывшемся окне Редактор выберите Node.js 18.

   2. Отключите опцию Добавить файлы с примерами кода.

   3. Нажмите кнопку Продолжить.

   4. В поле Способ выберите Редактор кода.

   5. Нажмите кнопку Создать файл:

      • Имя файла — device-emulator.js.
      • Содержимое файла — код функции с GitHub.

   6. Аналогичным образом создайте файл package.json со следующим содержимым:

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

   7. В поле Точка входа укажите device-emulator.handler.

   8. В блоке Параметры укажите:

      • Таймаут, c — 10.
      • Память — 128 МБ.
      • Сервисный аккаунт — my-emulator-function-service-account.
      • Переменные окружения:

        Ключ	Описание	Значение
        HUMIDITY_SENSOR_VALUE	Базовое значение показания датчика влажности.	80.15
        TEMPERATURE_SENSOR_VALUE	Базовое значение показания датчика температуры.	25.25
        RACK_DOOR_SENSOR_VALUE	Показания датчика открытия дверцы стойки.	False
        ROOM_DOOR_SENSOR_VALUE	Показания датчика открытия двери в серверную комнату.	False
        SMOKE_SENSOR_VALUE	Показания детектора дыма.	False
        WATER_SENSOR_VALUE	Показания детектора воды.	False
        IOT_CORE_DEVICE_ID	Идентификатор устройства, которое вы создали.	См. в консоли управления сервиса Yandex IoT Core.
        DEVICE_ID	Пользовательское название устройства.	Задается пользователем.

   9. Нажмите кнопку Сохранить изменения.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

Выполните команду:

yc iot mqtt subscribe \
  --username <идентификатор_реестра> \
  --password <пароль_реестра> \
  --topic '$devices/<идентификатор_устройства>/events' \
  --qos 1

Где:

• --username и --password — параметры авторизации с помощью логина и пароля.
• --topic — топик устройства для отправки данных или алиас топика.
• --qos — уровень качества обслуживания (QoS).

Команда должна продолжать выполняться до завершения тестирования.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.

2. В списке сервисов выберите Cloud Functions.

3. Выберите функцию my-device-emulator-function.

4. В меню слева выберите Тестирование.

5. В списке Тег версии выберите $latest — последнюю созданную функцию.

6. Нажмите кнопку Запустить тест.

   При успешном выполнении функции в поле Состояние функции отобразится статус Выполнена, и в поле Ответ функции появится результат:

   {
     "statusCode" : 200
   }
   

   Если вы подписались на топик устройства Yandex IoT Core, вы получите в терминале JSON вида:

   {
     "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. В консоли управления выберите каталог, в котором вы выполняете руководство.
2. В списке сервисов выберите Cloud Functions.
3. На панели слева выберите Триггеры.
4. Нажмите кнопку Создать триггер.
5. В поле Имя введите имя триггера. Например, my-emulator-function-trigger.
6. В поле Тип выберите Таймер.
7. В поле Cron-выражение введите * * * * ? * (вызов один раз в минуту).
8. В блоке Настройки функции введите ранее заданные параметры функции:
   • Функция — my-device-emulator-function.
   • Тег версии функции — $latest.
   • Сервисный аккаунт — my-emulator-function-service-account.
9. (Опционально) Настройте параметры блоков Настройки повторных запросов и Настройки Dead Letter Queue. Они обеспечивают сохранность данных.

   • Настройки повторных запросов позволяют повторно вызывать функцию, если текущий вызов функции завершается с ошибкой.

   • Настройки Dead Letter Queue позволяют перенаправлять сообщения, которые не смогли обработать получатели в обычных очередях.

     В качестве DLQ очереди вы можете настроить стандартную очередь сообщений. Если вы еще не создавали очередь сообщений, создайте ее в сервисе Yandex Message Queue.

10. Нажмите кнопку Создать триггер.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.
2. В списке сервисов выберите Cloud Functions.
3. На панели слева выберите раздел Функции.
4. Создайте функцию:
   1. Нажмите кнопку Создать функцию.
   2. В поле Имя введите имя функции. Например, my-monitoring-func.
   3. Нажмите кнопку Создать.
5. Создайте версию функции:

   1. В открывшемся окне Редактор выберите Python 3.12.

   2. Отключите опцию Добавить файлы с примерами кода.

   3. Нажмите кнопку Продолжить.

   4. В поле Способ выберите Редактор кода.

   5. Нажмите кнопку Создать файл:

      • Имя файла — monitoring.py.

      • Содержимое файла — код функции с GitHub.

        В этой функции подготовка данных для отправки в сервис мониторинга находится в методе makeAllMetrics. Если вы захотите добавить или удалить параметры, выполните изменения в этом методе.

   6. В поле Точка входа укажите monitoring.msgHandler.

   7. В блоке Параметры укажите:

      • Таймаут, c — 10.

      • Память — 128 МБ.

      • Сервисный аккаунт — my-metrics-function-service-account.

      • Переменные окружения:

        Ключ	Описание	Значение
        VERBOSE_LOG	Включение и отключение записи данных.	True
        METRICS_FOLDER_ID	Идентификатор каталога, в котором развернуты сервисы и для которого вы создадите дашборд в сервисе Monitoring.	См. в консоли управления.

   8. Нажмите кнопку Сохранить изменения.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.

2. В списке сервисов выберите Cloud Functions.

3. Выберите функцию my-monitoring-func.

4. В меню слева выберите Тестирование.

5. В списке Тег версии выберите $latest — последнюю созданную функцию.

6. В поле Входные данные вставьте данные:

   {
     "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. Нажмите кнопку Запустить тест.

   При успешном выполнении функции в поле Состояние функции отобразится статус Выполнена, а в поле Ответ функции появится результат:

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

1. В консоли управления выберите каталог, в котором вы выполняете руководство.
2. В списке сервисов выберите Cloud Functions.
3. На панели слева выберите Триггеры.
4. Нажмите кнопку Создать триггер.
5. В поле Имя введите имя триггера. Например, my-monitoring-func-trigger.
6. В поле Тип выберите IoT Core (устройство).
7. В блоке Настройки сообщений IoT Core введите ранее заданные параметры реестра и устройства:
   • Реестр — my-registry.
   • Устройство — my-device.
   • MQTT-топик — $devices/<идентификатор_устройства>/events, где <идентификатор_устройства> — это идентификатор устройства в сервисе Yandex IoT Core.
8. В блоке Настройки функции введите ранее заданные параметры функции:
   • Функция — my-monitoring-func.
   • Тег версии функции — $latest.
   • Сервисный аккаунт — my-metrics-function-service-account.
9. (Опционально) Настройте параметры блоков Настройки повторных запросов и Настройки Dead Letter Queue. Они обеспечивают сохранность данных.

   • Настройки повторных запросов позволяют повторно вызывать функцию, если текущий вызов функции завершается с ошибкой.

   • Настройки Dead Letter Queue позволяют перенаправлять сообщения, которые не смогли обработать получатели в обычных очередях.

     В качестве DLQ очереди вы можете настроить стандартную очередь сообщений. Если вы еще не создавали очередь сообщений, создайте ее в сервисе Yandex Message Queue.

10. Нажмите кнопку Создать триггер.

Все данные от устройства автоматически попадут в сервис Monitoring.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.
2. В списке сервисов выберите Monitoring.
3. Перейдите на вкладку Дашборды.
4. Нажмите кнопку Создать.
5. Справа вверху нажмите кнопку Сохранить.
6. В открывшемся окне введите название дашборда и нажмите кнопку Сохранить.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.

2. В списке сервисов выберите Monitoring.

3. Перейдите на вкладку Дашборды.

4. Напротив названия нужного дашборда нажмите значок → Редактировать.

5. В нижнем блоке нажмите График.

6. Создайте запрос для графика:

   1. В редакторе запроса нажмите значок .
   2. В списке сервисов service= выберите Custom Metrics.
   3. В списке типов графиков name= выберите Temperature — температура в помещении.
   4. В списке device_id= выберите идентификатор устройства, по которому вы хотите создать график.

7. Справа вверху нажмите кнопку Сохранить.

Аналогичным способом создайте другие графики:

• Humidity — влажность в помещении;
• Water sensor — вода на полу (есть вода / нет воды);
• Smoke sensor — дым (есть дым / нет дыма);
• Room door sensor — открытие двери в помещение (дверь открыта / дверь закрыта);
• Rack door sensor — открытие дверцы серверной стойки (дверца открыта / дверца закрыта).

Дашборд доступен по ссылке всем пользователям Yandex Cloud с ролью viewer. Вы можете его настраивать, изменять масштаб, включать и отключать автоматическое обновление данных.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.

2. В списке сервисов выберите Cloud Functions.

3. Выберите функцию my-device-emulator-function.

4. Нажмите на вкладку Редактор.

5. В нижней части окна в блоке Переменные окружения в поле Значение замените несколько исходных значений переменных на любые другие.

   Ключ	Исходное значение	Новое значение
   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. Нажмите кнопку Сохранить изменения и дождитесь завершения операции.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.
2. В списке сервисов выберите Monitoring и посмотрите, как изменились показатели графиков.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.

2. В списке сервисов выберите Monitoring.

3. Перейдите на вкладку Каналы уведомлений.

4. Нажмите кнопку Создать канал.

5. В поле Имя укажите название канала. Например, my-message-channel.

6. В списке Метод выберите Email.

   Вы также можете настроить уведомления через SMS, push-уведомления или в Telegram.

7. В списке Получатели выберите учетную запись.

   Вы можете выбрать несколько получателей уведомлений. В качестве получателей вы можете указать аккаунты пользователей, у которых есть доступ к вашему облаку. Подробнее о том, как добавить пользователя в Yandex Cloud.

8. Нажмите кнопку Создать.

1. В консоли управления выберите каталог, в котором вы выполняете руководство.
2. В списке сервисов выберите Monitoring.
3. Нажмите кнопку Создать алерт.
4. В поле Имя введите имя алерта.
5. В блоке Настройки алерта нажмите значок и заполните поля:
   1. В списке сервисов service= выберите Custom Metrics.
   2. В списке типов алертов name= выберите Temperature.
   3. В списке device_id= выберите идентификатор устройства, по которому вы хотите создать алерт.
6. В блоке Условия срабатывания задайте условия срабатывания алерта:
   1. В списке Функция агрегации выберите Среднее.
   2. В списке Функция сравнения выберите Больше.
   3. В поле Warning введите 50.
   4. В поле Alarm введите 70.
   5. В списке Окно вычисления выберите 5 минут.
7. В блоке Уведомления нажмите кнопку Редактировать, затем кнопку Добавить.
8. В открывшемся окне в поле Способ уведомления выберите my-message-channel и нажмите кнопку Добавить.
9. В нижней части окна нажмите кнопку Создать.