Диаграммы: различия между версиями

Материал из Документация Ключ-АСТРОМ
Строка 188: Строка 188:


Определения диаграмм должны входить в массивы <code>charts</code>или <code>keycharts</code>. Каждая группа, определенная в разделе, <code>keycharts</code>будет отображаться в виде вкладки в представлении сведений об объекте , а группы, определенные в <code>charts</code>разделе, будут размещены внутри них на вкладке «Дополнительные сведения» .
Определения диаграмм должны входить в массивы <code>charts</code>или <code>keycharts</code>. Каждая группа, определенная в разделе, <code>keycharts</code>будет отображаться в виде вкладки в представлении сведений об объекте , а группы, определенные в <code>charts</code>разделе, будут размещены внутри них на вкладке «Дополнительные сведения» .
У вас есть следующие варианты презентации:
=== Различные типы серий ===
Вы можете выбрать один из трех типов серий: <code>line</code>, <code>bar</code>или <code>area</code>. На всех трех диаграммах ниже представлена ​​одна и та же метрика с использованием разных типов рядов.
=== Несколько серий на одном графике ===
Вы можете использовать несколько рядов в одной диаграмме. Вы можете переместить значения оси вправо для конкретной серии, установив <code>rightaxis</code>для поля значение <code>true</code>.
=== Сложенная серия ===
Вы также можете складывать серии. Установите <code>stacked</code>для поля значение <code>true</code>. Красная серия на изображении представляет функцию с наибольшим значением, а синяя — с наименьшим.
=== Агрегация ===
Агрегация определяет метод агрегирования минутных значений при работе на более длительном таймфрейме. Возможные значения: <code>sum</code>, <code>avg</code>, <code>min</code>, <code>max</code>. Посмотрите разницу в значениях каждой серии при просмотре графиков на 24-часовом таймфрейме. Обратите внимание, что <code>sum</code>агрегированные серии имеют более высокую ценность, чем другие.
=== Слияние-агрегирование ===
Если ваша метрика содержит несколько измерений, вы можете объединить их в одну диаграмму. Объединение определяет, как объединить значения измерения в одно измерение. Возможные значения: <code>sum</code>, <code>avg</code>, <code>min</code>, <code>max</code>. Сначала взгляните на метрику, сегментированную по четырем измерениям, а затем посмотрите на результат слияния.
=== Диаграммы состояний ===
Вы также можете определять диаграммы, используя временные ряды состояний. В результате получается диаграмма, показывающая количество состояний на каждую временную метку, и круговая диаграмма, показывающая процент определенных состояний в выбранном временном интервале. Диаграмма ключевых состояний представляет сумму состояний по всем измерениям. Обратите внимание, что одна диаграмма не может содержать одновременно числовые временные ряды и временные ряды состояний.

Версия 06:52, 27 декабря 2023

После определения собственных показателей вы можете настроить способ их отображения на страницах «Пользовательское устройство» и «Группы пользовательских устройств». Чтобы настроить пользовательские диаграммы показателей, отредактируйте раздел расширения JSON uiи определения диаграммы.

{

  "ui": {

    "charts": [

      {

        "group": "Trigonometric functions",

        "title": "sinus",

        "series": [

          {

            "key": "baseSin",

            "aggregation": "avg",

            "mergeaggregation": "avg",

            "displayname": "basic sinus metric",

            "seriestype": "line",

            "color": "#00ff00",

            "rightaxis": false,

            "stacked": false

          },

          {

            "key": "baseCos",

            "aggregation": "avg",

            "mergeaggregation": "avg",

            "displayname": "basic cosinus metric",

            "seriestype": "line",

            "color": "#0000ff",

            "rightaxis": true,

            "stacked": false

          }

        ]

      },

      {

        "group": "State",

        "title": "State metric",

        "series": [

          {

            "key": "state_metric",

            "displayname": "State",

            "statecolors": ["#008cdb", "#5ead35", "#e6be00"],

            "statechart": true

          }

        ]

      }

    ],

    "keycharts": [

      {

        "group": "Random charts",

        "title": "random bar metric",

        "series": [

          {

            "key": "random",

            "aggregation": "avg",

            "mergeaggregation": "avg",

            "displayname": "random metric",

            "seriestype": "bar",

            "color": "#00ff00",

            "rightaxis": false,

            "stacked": false

          }

        ]

      }

    ]

  },

  "metrics": [

    {

      "timeseries": {

        "key": "random",

        "unit": "Count",

        "displayname": "random key metric"

      }

    },

    {

      "timeseries": {

        "key": "baseSin",

        "unit": "Count",

        "displayname": "basic sinus metric"

      }

    },

    {

      "timeseries": {

        "key": "baseCos",

        "unit": "Count",

        "displayname": "basic cosinus metric"

      }

    },

    {

      "statetimeseries": {

        "key": "state_metric",

        "states": ["state1", "state2", "state3"],

        "displayname": "Battery status"

      }

    }

  ]

}

Сначала определите одну серию диаграмм. Не забудьте сопоставить keyполе с keyзначением, определенным в определении таймсерии в metricsразделе. Затем добавьте свою серию в определения диаграмм. Обратите внимание, что вы можете использовать любые серии в одной диаграмме. Вы также можете дать названия своим диаграммам, распределить их по группам и уточнить, где они находятся.

Определения диаграмм должны входить в массивы chartsили keycharts. Каждая группа, определенная в разделе, keychartsбудет отображаться в виде вкладки в представлении сведений об объекте , а группы, определенные в chartsразделе, будут размещены внутри них на вкладке «Дополнительные сведения» .

У вас есть следующие варианты презентации:

Различные типы серий

Вы можете выбрать один из трех типов серий: line, barили area. На всех трех диаграммах ниже представлена ​​одна и та же метрика с использованием разных типов рядов.

Несколько серий на одном графике

Вы можете использовать несколько рядов в одной диаграмме. Вы можете переместить значения оси вправо для конкретной серии, установив rightaxisдля поля значение true.

Сложенная серия

Вы также можете складывать серии. Установите stackedдля поля значение true. Красная серия на изображении представляет функцию с наибольшим значением, а синяя — с наименьшим.

Агрегация

Агрегация определяет метод агрегирования минутных значений при работе на более длительном таймфрейме. Возможные значения: sum, avg, min, max. Посмотрите разницу в значениях каждой серии при просмотре графиков на 24-часовом таймфрейме. Обратите внимание, что sumагрегированные серии имеют более высокую ценность, чем другие.

Слияние-агрегирование

Если ваша метрика содержит несколько измерений, вы можете объединить их в одну диаграмму. Объединение определяет, как объединить значения измерения в одно измерение. Возможные значения: sum, avg, min, max. Сначала взгляните на метрику, сегментированную по четырем измерениям, а затем посмотрите на результат слияния.

Диаграммы состояний

Вы также можете определять диаграммы, используя временные ряды состояний. В результате получается диаграмма, показывающая количество состояний на каждую временную метку, и круговая диаграмма, показывающая процент определенных состояний в выбранном временном интервале. Диаграмма ключевых состояний представляет сумму состояний по всем измерениям. Обратите внимание, что одна диаграмма не может содержать одновременно числовые временные ряды и временные ряды состояний.