Выражение метрик - История изменений

IKuznetsov в 12:15, 29 декабря 2024

2024-12-29T12:15:50Z

← Предыдущая версия		Версия от 12:15, 29 декабря 2024
Строка 1:		Строка 1:
			'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты среды]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=DELETE%20%D1%82%D0%B5%D0%B3%D0%BE%D0%B2-,%D0%A0%D0%B0%D0%B7%D0%B2%D1%91%D1%80%D1%82%D1%8B%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Развёртывание] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=POST%20%D1%82%D0%BE%D1%87%D0%B5%D0%BA%20%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-,%D0%9C%D0%B5%D1%82%D1%80%D0%B8%D0%BA%D0%B8%20v2,-GET%20%D0%BC%D0%B5%D1%82%D1%80%D0%B8%D0%BA Метрики v2] / Выражение метрик'''''

	Выражения метрик позволяют использовать простые арифметические операции прямо в селекторе метрик.		Выражения метрик позволяют использовать простые арифметические операции прямо в селекторе метрик.

Строка 61:		Строка 63:
	builtin:host.cpu.usage:filter(eq("dt.entity.host","HOST-002")):splitBy()		builtin:host.cpu.usage:filter(eq("dt.entity.host","HOST-002")):splitBy()
	)		)
	/2~~</code>~~		/2
	При таком подходе есть две проблемы. Во-первых, выражение трудно читать и, следовательно, подвержено синтаксическим ошибкам. Во-вторых, если один из хостов находится в автономном режиме, результат выражения будет пустым. Несмотря на то, что вторая проблема может быть решена с помощью преобразования по умолчанию , использование средней агрегации более эффективно:		При таком подходе есть две проблемы. Во-первых, выражение трудно читать и, следовательно, подвержено синтаксическим ошибкам. Во-вторых, если один из хостов находится в автономном режиме, результат выражения будет пустым. Несмотря на то, что вторая проблема может быть решена с помощью преобразования по умолчанию , использование средней агрегации более эффективно:
	<builtin:host.cpu.usage		<builtin:host.cpu.usage
Строка 71:		Строка 73:
	)		)
	:splitBy()		:splitBy()
	:avg~~</code>~~		:avg

	=== Не конвертировать единицы ===		=== Не конвертировать единицы ===
Строка 82:		Строка 84:
	<builtin:host.cpu.usage:sort(value(avg,descending)):limit(10)		<builtin:host.cpu.usage:sort(value(avg,descending)):limit(10)
	+		+
	builtin:host.cpu.idle:sort(value(avg,descending)):limit(10)~~</code>~~		builtin:host.cpu.idle:sort(value(avg,descending)):limit(10)
	Если у вас большая среда с сотнями хостов, маловероятно, что 10 хостов с максимальной загрузкой ЦП входят в число 10 хостов с наибольшим временем простоя ЦП. У операндов не будет совпадающих записей, поэтому результат выражения будет пустым. Решение состоит в том, чтобы вместо этого применить ограничение к результату выражения:		Если у вас большая среда с сотнями хостов, маловероятно, что 10 хостов с максимальной загрузкой ЦП входят в число 10 хостов с наибольшим временем простоя ЦП. У операндов не будет совпадающих записей, поэтому результат выражения будет пустым. Решение состоит в том, чтобы вместо этого применить ограничение к результату выражения:
	<(		<(
Строка 90:		Строка 92:
	)		)
	:sort(value(auto,descending))		:sort(value(auto,descending))
	:limit(10)~~</code>~~		:limit(10)

	=== Закройте пробелы в данных с помощью преобразования по умолчанию ===		=== Закройте пробелы в данных с помощью преобразования по умолчанию ===
Строка 98:		Строка 100:
	<builtin:apps.other.keyUserActions.reportedErrorCount.os		<builtin:apps.other.keyUserActions.reportedErrorCount.os
	/		/
	builtin:apps.other.keyUserActions.requestCount.os~~</code>~~		builtin:apps.other.keyUserActions.requestCount.os
	Если запросов много, но ни одной ошибки на вашем таймфрейме, результат будет пустым, хотя коэффициент ошибок <code>0</code>был бы более значимым. Вы можете добиться этого с помощью <code>default(0)</code>преобразования:		Если запросов много, но ни одной ошибки на вашем таймфрейме, результат будет пустым, хотя коэффициент ошибок <code>0</code>был бы более значимым. Вы можете добиться этого с помощью <code>default(0)</code>преобразования:
	<builtin:apps.other.keyUserActions.reportedErrorCount.os:default(0)		<builtin:apps.other.keyUserActions.reportedErrorCount.os:default(0)
	/		/
	builtin:apps.other.keyUserActions.requestCount.os~~</code>~~		builtin:apps.other.keyUserActions.requestCount.os

	== Примеры ==		== Примеры ==
Строка 119:		Строка 121:
	+		+
	builtin:service.errors.total.count:value:default(0)		builtin:service.errors.total.count:value:default(0)
	)~~</code>~~		)
	Преобразование по умолчанию используется для замены значений временных интервалов, имеющих значение <code>null</code>0.		Преобразование по умолчанию используется для замены значений временных интервалов, имеющих значение <code>null</code>0.

Строка 149:		Строка 151:
	}		}
	]		]
	}~~</code>~~		}
	Метрика 2:		Метрика 2:
	<{		<{
Строка 177:		Строка 179:
	}		}
	]		]
	}~~</code>~~		}
	Результат:		Результат:
	<{		<{
Строка 205:		Строка 207:
	}		}
	]		]
	}~~</code>~~		}
	Пример 2. Вклад одного сервиса в общее количество ошибок		Пример 2. Вклад одного сервиса в общее количество ошибок

Строка 218:		Строка 220:
	<builtin:service.errors.total.count:filter(eq("dt.entity.service","SERVICE-B82BFBCB4E264A98")):value:default(0)		<builtin:service.errors.total.count:filter(eq("dt.entity.service","SERVICE-B82BFBCB4E264A98")):value:default(0)
	/		/
	builtin:service.errors.total.count:splitBy():value:default(0) * 100~~</code>~~		builtin:service.errors.total.count:splitBy():value:default(0) * 100
	Преобразование по умолчанию используется для замены значений временных интервалов, имеющих значение <code>null</code>0.		Преобразование по умолчанию используется для замены значений временных интервалов, имеющих значение <code>null</code>0.

Строка 240:		Строка 242:
	}		}
	]		]
	}~~</code>~~		}
	Общее количество:		Общее количество:
	<{		<{
Строка 258:		Строка 260:
	}		}
	]		]
	}~~</code>~~		}
	Процент:		Процент:
	<{		<{
Строка 278:		Строка 280:
	}		}
	]		]
	}~~</code>~~		}
	Пример 3. Средняя продолжительность GC		Пример 3. Средняя продолжительность GC

Строка 290:		Строка 292:
	/		/
	builtin:tech.jvm.memory.pool.collectionCount:splitBy("dt.entity.process_group_instance")		builtin:tech.jvm.memory.pool.collectionCount:splitBy("dt.entity.process_group_instance")
	):sort(value(max,descending))~~</code>~~		):sort(value(max,descending))
	Общее время GS		Общее время GS
	<{		<{
Строка 326:		Строка 328:
	}		}
	]		]
	}~~</code>~~		}
	Номер GS:		Номер GS:
	<{		<{
Строка 362:		Строка 364:
	}		}
	]		]
	}~~</code>~~		}
	Средняя продолжительность GC:		Средняя продолжительность GC:
	<{		<{
Строка 398:		Строка 400:
	}		}
	]		]
	}~~</code>~~		}

IKuznetsov в 11:45, 29 декабря 2024

2024-12-29T11:45:04Z

Внесённые изменения

ENetrebin: /* Разрешение выражений */

2022-10-10T13:28:27Z

Разрешение выражений

Внесённые изменения

ENetrebin: Новая страница: «Выражения метрик позволяют использовать простые арифметические операции прямо в селек...»

2022-10-05T16:05:33Z

Новая страница: «Выражения метрик позволяют использовать простые арифметические операции прямо в селек...»

Новая страница

Выражения метрик позволяют использовать простые арифметические операции прямо в селекторе метрик.

Например, это выражение вычисляет соотношение (в процентах) двух показателей:
<code>metric1 / metric2 * 100</code>
В качестве операндов выражения можно использовать метрики или числа.

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

== Ограничения ==

* Селектор должен содержать хотя бы один ключ метрики.
* Вы можете запрашивать точки данных до 10 метрик в одном запросе.

Для целей этого ограничения одно выражение (например, <code>metric2 + metric2</code>) считается одной метрикой.

== Приоритет ==
Применяются стандартные правила математического приоритета:

# Скобки, метрические преобразования
# Отрицание
# Умножение, деление
# Сложение, вычитание

== Агрегация ==
Если агрегация была применена в цепочке преобразования, используется эта агрегация. Если преобразование не применялось, используется агрегация по умолчанию. Ваши метрические операнды могут быть разных агрегатов. Например, <code>metric:max - metric:min</code>.

== Разрешение выражений ==
Метрические выражения разрешаются следующим образом:

# Сформируйте пары кортежей для каждой пары метрик.
# Выровняйте точки данных в каждом кортеже.
# Примените арифметическую операцию к выровненным точкам данных.

=== Кортежи ===
В арифметических операциях используются точки данных кортежей (уникальные комбинации метрика-измерение-значение измерения) метрик. Идентичные кортежи каждой метрики объединяются в пары, а затем их точки данных выравниваются.

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

Непарные кортежи игнорируются выражением и не представлены в результате.

=== Точки данных ===
После формирования пар кортежей точки данных выравниваются, а затем к выровненным точкам данных применяется желаемая арифметическая операция.

* Если какая-либо из выровненных точек данных равна <code>null</code>, выражение преобразуется в <code>null</code>.
* Если в операции задействовано число, оно выравнивается с каждой точкой данных метрического операнда.
* Если одна метрика представляет собой одну точку данных, а другая представляет собой ряд, одна точка данных выравнивается с каждой точкой данных ряда.
* Если обе метрики представляют собой одну точку данных, точки данных выравниваются, и результирующий временной интервал охватывает обе точки данных.
* Если обе метрики являются сериями, точки данных выравниваются по отметкам времени.

Для любых невыровненных точек данных выражение разрешается в <code>null</code>.

== Лучшие практики ==

=== Используйте только при необходимости ===
Используйте метрическое выражение только в том случае, если вы не можете достичь своей цели без него. Допустим, вы хотите рассчитать среднее использование ЦП двумя хостами <code>HOST-001</code>и <code>HOST-002</code>. Вы можете сделать это с помощью метрического выражения:
<code>(
builtin:host.cpu.usage:filter(eq("dt.entity.host","HOST-001")):splitBy()
+
builtin:host.cpu.usage:filter(eq("dt.entity.host","HOST-002")):splitBy()
)
/2</code>
При таком подходе есть две проблемы. Во-первых, выражение трудно читать и, следовательно, подвержено синтаксическим ошибкам. Во-вторых, если один из хостов находится в автономном режиме, результат выражения будет пустым. Несмотря на то, что вторая проблема может быть решена с помощью преобразования по умолчанию , использование средней агрегации более эффективно:
<code>builtin:host.cpu.usage
:filter(
or(
eq("dt.entity.host","HOST-001"),
eq("dt.entity.host","HOST-002")
)
)
:splitBy()
:avg</code>

=== Не конвертировать единицы ===
Не используйте метрическое выражение для преобразования единиц измерения данных. Вместо этого используйте преобразование toUnit . Единственным исключением из этого правила являются устройства, которые Dynatrace не поддерживает. Используйте запрос GET для всех единиц , чтобы получить список поддерживаемых единиц.

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

Рассмотрим следующий запрос, который пытается добавить 10 самых популярных периодов использования ЦП к 10 основным периодам простоя ЦП.
<code>builtin:host.cpu.usage:sort(value(avg,descending)):limit(10)
+
builtin:host.cpu.idle:sort(value(avg,descending)):limit(10)</code>
Если у вас большая среда с сотнями хостов, маловероятно, что 10 хостов с максимальной загрузкой ЦП входят в число 10 хостов с наибольшим временем простоя ЦП. У операндов не будет совпадающих кортежей, поэтому результат выражения будет пустым. Решение состоит в том, чтобы вместо этого применить ограничение к результату выражения:
<code>(
builtin:host.cpu.usage
+
builtin:host.cpu.idle
)
:sort(value(auto,descending))
:limit(10)</code>

=== Закройте пробелы в данных с помощью преобразования по умолчанию ===
Преобразование по умолчанию особенно ценно для метрических выражений . Хотя обычно преобразование не заполняет <code>null</code>точки данных, если метрика не имеет ни одной точки данных во временном интервале запроса, в контексте выражения метрики ее семантика немного отличается. Пока метрика с обеих сторон выражения имеет хотя бы одну точку данных, преобразование заполнит пробелы. Однако если во всех метриках в выражении отсутствуют данные, преобразование вернет пустые результаты.

Рассмотрим этот пример выражения соотношения, где мы вычисляем коэффициент ошибок для ключевых действий пользователя:
<code>builtin:apps.other.keyUserActions.reportedErrorCount.os
/
builtin:apps.other.keyUserActions.requestCount.os</code>
Если запросов много, но ни одной ошибки на вашем таймфрейме, результат будет пустым, хотя коэффициент ошибок <code>0</code>был бы более значимым. Вы можете добиться этого с помощью <code>default(0)</code>преобразования:
<code>builtin:apps.other.keyUserActions.reportedErrorCount.os:default(0)
/
builtin:apps.other.keyUserActions.requestCount.os</code>

== Примеры ==
Пример 1. Построение метрики соотношения

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

* встроенный:service.errors.total.count показывает количество ошибок любого типа в службе
* встроенный:service.errors.server.successCount показывает количество вызовов без ошибок на стороне сервера

Из них мы можем построить метрику коэффициента ошибок:
<code>builtin:service.errors.total.count:value:default(0)
/
(
builtin:service.errors.total.successCount:value:default(0)
+
builtin:service.errors.total.count:value:default(0)
)</code>
Преобразование по умолчанию используется для замены значений временных интервалов, имеющих значение <code>null</code>0.
<code>{
"totalCount": 3,
"nextPageKey": null,
"result": [
{
"metricId": "builtin:service.errors.total.count",
"data": [
{
"dimensions": ["SERVICE-B82BFBCB4E264A98"],
"dimensionMap": {
"dt.entity.service": "SERVICE-B82BFBCB4E264A98"
},
"timestamps": [1619913600000, 1620086400000, 1620259200000],
"values": [48763, 81283, 80798]
},
{
"dimensions": ["SERVICE-BE8B6928C46204B5"],
"dimensionMap": {
"dt.entity.service": "SERVICE-BE8B6928C46204B5"
},
"timestamps": [1619913600000, 1620086400000, 1620259200000],
"values": [1096, 1124, 1095]
}
]
}
]
}</code>
Пример 2. Вклад одного сервиса в общее количество ошибок

Встроенная метрика :service.errors.total.count показывает количество ошибок в ваших службах. Список может быть длинным, и вас может заинтересовать вклад каждой службы в количество ошибок. Эту информацию может предоставить комбинация метрических преобразований и метрических выражений.

Вам нужны эти преобразования:

* преобразования фильтра , чтобы получить количество ошибок для проверяемой службы.
* разделить путем преобразования, чтобы объединить отдельные счетчики ошибок каждой службы в один.

Затем используйте это выражение:
<code>builtin:service.errors.total.count:filter(eq("dt.entity.service","SERVICE-B82BFBCB4E264A98")):value:default(0)
/
builtin:service.errors.total.count:splitBy():value:default(0) * 100</code>
Преобразование по умолчанию используется для замены значений временных интервалов, имеющих значение <code>null</code>0.
<code>{
"totalCount": 1,
"nextPageKey": null,
"result": [
{
"metricId": "builtin:service.errors.total.count:filter(eq(\"dt.entity.service\",SERVICE-B82BFBCB4E264A98))",
"data": [
{
"dimensions": ["SERVICE-B82BFBCB4E264A98"],
"dimensionMap": {
"dt.entity.service": "SERVICE-B82BFBCB4E264A98"
},
"timestamps": [1619913600000, 1620086400000, 1620259200000],
"values": [48763, 81283, 80798]
}
]
}
]
}</code>
Пример 3. Средняя продолжительность GC

Встроенная метрика : tech.jvm.memory.gc.collectionTime показывает общую продолжительность всех сборок мусора во временном интервале. Информация об отдельных сборках мусора недоступна, но мы можем использовать встроенную метрику: tech.jvm.memory.pool.collectionCount , показывающую количество сборок мусора за раз, чтобы получить среднюю продолжительность сборки мусора.

Прежде чем мы начнем расчет, нам нужно выровнять измерения обеих метрик. Для этого нам нужно применить разделение по преобразованию с <code>dt.entity.process_group_instance</code>аргументом к встроенной метрике: tech.jvm.memory.pool.collectionCount .

Кроме того, мы можем отсортировать результат в порядке убывания, применив преобразование сортировки . Выражение выглядит так:
<code>(
builtin:tech.jvm.memory.gc.collectionTime
/
builtin:tech.jvm.memory.pool.collectionCount:splitBy("dt.entity.process_group_instance")
):sort(value(max,descending))</code>

<code>{
"totalCount": 3,
"nextPageKey": null,
"result": [
{
"metricId": "builtin:tech.jvm.memory.gc.collectionTime",
"data": [
{
"dimensions": ["PROCESS_GROUP_INSTANCE-18A5241823ABC769"],
"dimensionMap": {
"dt.entity.process_group_instance": "PROCESS_GROUP_INSTANCE-18A5241823ABC769"
},
"timestamps": [1619913600000, 1620086400000, 1620259200000],
"values": [164670, 171630, 163044]
},
{
"dimensions": ["PROCESS_GROUP_INSTANCE-92605BB8AE962F1C"],
"dimensionMap": {
"dt.entity.process_group_instance": "PROCESS_GROUP_INSTANCE-92605BB8AE962F1C"
},
"timestamps": [1619913600000, 1620086400000, 1620259200000],
"values": [6883411, 5977311, 6356225]
},
{
"dimensions": ["PROCESS_GROUP_INSTANCE-4285F2EF6B79E8A9"],
"dimensionMap": {
"dt.entity.process_group_instance": "PROCESS_GROUP_INSTANCE-4285F2EF6B79E8A9"
},
"timestamps": [1619913600000, 1620086400000, 1620259200000],
"values": [163368, 162924, 170502]
}
]
}
]
}</code>