Калькулейтед метрики: различия между версиями

Материал из Документация Ключ-АСТРОМ
(Создана пустая страница)
 
(Создание)
 
Строка 1: Строка 1:
Ключ-АСТРОМ автоматически собирает важные показатели услуг без необходимости настройки. Вам могут потребоваться дополнительные бизнес- или технические показатели, специфичные для вашего приложения. Эти метрики можно рассчитать и получить на основе широкого спектра доступных данных в захваченной распределенной трассировке. Вы также можете разделить эти метрики по нескольким измерениям, например по атрибуту запросов или методу HTTP.


== Создать метрику ==
# Откройте '''Настройки > Мониторинг серверных сервисов > Метрики сервисов'''.
# Нажмите кнопку '''Создать новую метрику'''.
# Назовите метрику обслуживания и дайте ей уникальный ключ.
# '''''необязательный''''' При необходимости настройте ключ метрики. Префикс <code>calc:service.</code>добавляется автоматически. Обратите внимание: после создания метрики вы не сможете изменить ее ключ.
# В списке '''Источник метрик''' выберите метрику, которую хотите проанализировать.
#* При необходимости выберите необходимый блок.
#* '''''необязательный''''' Чтобы исключить передачу данных из отключенных запросов , включите параметр '''Игнорировать отключенные запросы'''.
# '''''необязательный''''' Выберите зону управления. Новая метрика будет ограничена данными из этой зоны.
# Предоставьте условия для использования метрики. Условия определяют, какие запросы включаются в расчет. Если вы укажете несколько условий, для использования метрики должны быть выполнены все условия .
## Выберите Добавить условие .
## Выберите атрибут, который необходимо проверить.
## Выберите оператор условия.
## '''''необязательный''''' При необходимости укажите эталонное значение. Предварительный просмотр показывает список сервисов, которые необходимо включить в пользовательскую метрику, и оценку потребления DDU .  Предварительная версия учитывает только зону управления и условия на основе атрибутов службы. Эти атрибуты отмечены значком <code>[Service property]</code>в списке атрибутов.
# '''''необязательный''''' Добавьте измерение к вашей новой метрике.
## Включите '''Разбить по размерности'''.
## Поместите курсор в поле '''Шаблон значения размера''', чтобы просмотреть доступные размеры, и выберите необходимый размер. Если необходимый размер недоступен, вы можете создать собственный заполнитель. См. раздел '''Пользовательские шаблоны''' ниже.
## В поле '''Имя измерения''' укажите осмысленное имя для вашего измерения. Это имя будет использоваться в пользовательском интерфейсе и API. Обратите внимание: после создания метрики вы не сможете изменить имя измерения.
## В поле '''''Количество верхних значений''''' укажите количество верхних значений ''X'' , которое будет рассчитано для метрики.
## В списках '''''Сортировка значений''''' и '''''Агрегация значений''''' выберите сортировку и агрегацию верхних значений ''X.''
# Нажмите на кнопку '''Сохранить метрику'''.
== Пользовательские шаблоны ==
Возможна ситуация, когда вы не можете найти необходимый шаблон для своего измерения. В этом случае вы можете создать собственный шаблон. Обратите внимание, что обязательно использовать все созданные шаблоны в шаблоне значений измерения.
=== Методы извлечения ===
У вас есть два метода для извлечения значения заполнителя:
* На основе разделителей. В этом случае Ключ-АСТРОМ извлекает значение, проверяя значение источника по эталонному значению и указанному типу и положению разделителя.
* На основе регулярных выражений. В этом случае Ключ-АСТРОМ использует извлечение регулярных выражений.
=== Шаблоны атрибутов запроса ===
Шаблоны, основанные на атрибутах запроса, предоставляют три варианта извлечения значений:
* '''First''' : первое появление атрибута используется для извлечения значения.
* '''Last''' : последнее появление атрибута используется для извлечения значения.
* '''Count''' : значение равно количеству вхождений атрибута.
Кроме того, вы можете использовать атрибуты запроса из дочерних вызовов. Чтобы включить эту опцию, установите параметр '''Использование downstream сервисов'''. Вы можете ограничить дочерние вызовы теми, которые принадлежат определенной зоне управления или имеют определенный тег.
=== Создайте собственный шаблон ===
Создание пользовательского заполнителя
# При создании или редактировании вычисляемой метрики обслуживания выберите '''Добавить пользовательский шаблон'''.
# Укажите название шаблона. Название будет использоваться в поле '''Шаблон значения размера''' .
# Выберите источник измерения. Если источником является атрибут запроса, дополнительно выберите атрибут и метод извлечения.
# Выберите метод извлечения.
# Нажмите на кнопку '''Добавить''' .
# Используйте вновь созданный заполнитель в шаблоне значений размера.

Текущая версия на 19:08, 16 июня 2024

Ключ-АСТРОМ автоматически собирает важные показатели услуг без необходимости настройки. Вам могут потребоваться дополнительные бизнес- или технические показатели, специфичные для вашего приложения. Эти метрики можно рассчитать и получить на основе широкого спектра доступных данных в захваченной распределенной трассировке. Вы также можете разделить эти метрики по нескольким измерениям, например по атрибуту запросов или методу HTTP.

Создать метрику

  1. Откройте Настройки > Мониторинг серверных сервисов > Метрики сервисов.
  2. Нажмите кнопку Создать новую метрику.
  3. Назовите метрику обслуживания и дайте ей уникальный ключ.
  4. необязательный При необходимости настройте ключ метрики. Префикс calc:service.добавляется автоматически. Обратите внимание: после создания метрики вы не сможете изменить ее ключ.
  5. В списке Источник метрик выберите метрику, которую хотите проанализировать.
    • При необходимости выберите необходимый блок.
    • необязательный Чтобы исключить передачу данных из отключенных запросов , включите параметр Игнорировать отключенные запросы.
  6. необязательный Выберите зону управления. Новая метрика будет ограничена данными из этой зоны.
  7. Предоставьте условия для использования метрики. Условия определяют, какие запросы включаются в расчет. Если вы укажете несколько условий, для использования метрики должны быть выполнены все условия .
    1. Выберите Добавить условие .
    2. Выберите атрибут, который необходимо проверить.
    3. Выберите оператор условия.
    4. необязательный При необходимости укажите эталонное значение. Предварительный просмотр показывает список сервисов, которые необходимо включить в пользовательскую метрику, и оценку потребления DDU . Предварительная версия учитывает только зону управления и условия на основе атрибутов службы. Эти атрибуты отмечены значком [Service property]в списке атрибутов.
  8. необязательный Добавьте измерение к вашей новой метрике.
    1. Включите Разбить по размерности.
    2. Поместите курсор в поле Шаблон значения размера, чтобы просмотреть доступные размеры, и выберите необходимый размер. Если необходимый размер недоступен, вы можете создать собственный заполнитель. См. раздел Пользовательские шаблоны ниже.
    3. В поле Имя измерения укажите осмысленное имя для вашего измерения. Это имя будет использоваться в пользовательском интерфейсе и API. Обратите внимание: после создания метрики вы не сможете изменить имя измерения.
    4. В поле Количество верхних значений укажите количество верхних значений X , которое будет рассчитано для метрики.
    5. В списках Сортировка значений и Агрегация значений выберите сортировку и агрегацию верхних значений X.
  9. Нажмите на кнопку Сохранить метрику.

Пользовательские шаблоны

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

Методы извлечения

У вас есть два метода для извлечения значения заполнителя:

  • На основе разделителей. В этом случае Ключ-АСТРОМ извлекает значение, проверяя значение источника по эталонному значению и указанному типу и положению разделителя.
  • На основе регулярных выражений. В этом случае Ключ-АСТРОМ использует извлечение регулярных выражений.

Шаблоны атрибутов запроса

Шаблоны, основанные на атрибутах запроса, предоставляют три варианта извлечения значений:

  • First : первое появление атрибута используется для извлечения значения.
  • Last : последнее появление атрибута используется для извлечения значения.
  • Count : значение равно количеству вхождений атрибута.

Кроме того, вы можете использовать атрибуты запроса из дочерних вызовов. Чтобы включить эту опцию, установите параметр Использование downstream сервисов. Вы можете ограничить дочерние вызовы теми, которые принадлежат определенной зоне управления или имеют определенный тег.

Создайте собственный шаблон

Создание пользовательского заполнителя

  1. При создании или редактировании вычисляемой метрики обслуживания выберите Добавить пользовательский шаблон.
  2. Укажите название шаблона. Название будет использоваться в поле Шаблон значения размера .
  3. Выберите источник измерения. Если источником является атрибут запроса, дополнительно выберите атрибут и метод извлечения.
  4. Выберите метод извлечения.
  5. Нажмите на кнопку Добавить .
  6. Используйте вновь созданный заполнитель в шаблоне значений размера.