Групповые показатели

Материал из Документация Ключ-АСТРОМ
Версия от 07:15, 27 декабря 2023; ENetrebin (обсуждение | вклад) (Новая страница: «Когда вы сообщаете показатели всей группы устройств, выходя за рамки одного устройства,...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

Когда вы сообщаете показатели всей группы устройств, выходя за рамки одного устройства, вы можете получить представление об общем состоянии группы, производительности групповой обработки или подсчете элементов группы (устройств). Групповые метрики ведут себя как стандартные метрики, и аналогичным образом вы можете использовать их в:

  • Таблицах плагинов АктивногоШлюза
  • Ключевых показателях производительности плагинов
  • Оповещениях
  • Пользовательских диаграммах

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

Как использовать метрики группы устройств

JSON-декларация

Чтобы изменить основной объект метрики на группу, необходимо указать ее в объявлении метрики JSON в разделе metrics.

{

  "name": "custom.remote.python.my_plugin",

  "version": "1.001",

  "type": "python",

  "entity": "CUSTOM_DEVICE",

  "processTypeNames": ["PYTHON"],

  "technologies": ["example technology"],

  "source": {

    "package": "my_plugin",

    "className": "MyPlugin",

    "activation": "Remote"

  },

  "metrics": [

    {

      "entity": "CUSTOM_DEVICE_GROUP",

      "timeseries": {

        "key": "cluster_nodes_ok",

        "unit": "Count",

        "displayname": "cluster node ok"

      }

    }

  ],

  "ui": {

    "keymetrics": [

      {

        "key": "cluster_nodes_ok",

        "displayname": "Group key metric"

      }

    ],

    "charts": [

      {

        "group": "Cluster charts",

        "title": "My chart",

        "series": [

          {

            "key": "cluster_nodes_ok",

            "displayname": " "

          }

        ]

      }

    ]

  }

}

Оставшийся код JSON такой же, как и для стандартных метрик. Обратите внимание: нельзя использовать одновременно показатель устройства и показатель группы устройств на одной диаграмме, поскольку их будет сложно сравнивать.

Использование Python

Чтобы использовать метрику группы устройств с кодом Python, вам необходимо сначала создать группу topology builder. Затем вы можете добавить значение absoluteили relativeв группу устройств.

def query(self, **kwargs):

    group = self.topology_builder.create_group("group_id", "group_name")

    group.absolute(key='cluster_nodes_ok', value=5)

Хорошей практикой является отчет о метриках группы устройств с masterустройства, поскольку умножение метрик с одинаковой отметкой времени на одном и том же объекте может привести к неисключенному поведению.