Комментарий

• Свойства страницы (1 изменено, 0 добавлено, 0 удалено)

Подробности

Свойства страницы

Содержимое

...	...	@@ -1,29 +1,95 @@
1	1	System.Diagnostics
2	2
	3	+[[Open Telemetry>>doc:Разработка.Логи, трассировка, метрики, мониторинг.Open Telemetry.WebHome]]
3	3
4		-|(% style="width:59px" %)Metric|(% style="width:128px" %)Metrics|(% style="width:1278px" %)System.Diagnostics.Metrics
	5	+System.Diagnostics Пространство имен
	6	+[[https:~~/~~/learn.microsoft.com/ru-ru/dotnet/api/system.diagnostics?view=net-7.0>>https://learn.microsoft.com/ru-ru/dotnet/api/system.diagnostics?view=net-7.0]]
	7	+
	8	+----
	9	+
	10	+Замечания:
	11	+
	12	+1. ActivitySource не создает экземпляры Activity (возвращает null), если нет ни одного активного ActivityListener.
	13	+1. **!!!** Нижеприведенный код после публикации сборки (и в Release и в Debug) может никогда не выполниться, в случае, если к полю _Listener (и к классу FakeListener) нет других обращений.
	14	+И Activity не будут создаваться.
	15	+{{code language="с#"}}private static readonly FakeListener _Listener = new FakeListener();
	16	+
	17	+internal class FakeListener
	18	+{
	19	+ public FakeListener()
	20	+ {
	21	+ ActivityListener = new ActivityListener()
	22	+ {
	23	+ ShouldListenTo = (source) => true,
	24	+ SampleUsingParentId = (ref ActivityCreationOptions<string> activityOptions) => ActivitySamplingResult.AllData,
	25	+ Sample = (ref ActivityCreationOptions<ActivityContext> activityOptions) => ActivitySamplingResult.AllData
	26	+ };
	27	+ ActivitySource.AddActivityListener(
	28	+ ActivityListener
	29	+ );
	30	+ }
	31	+}{{/code}}
	32	+
	33	+----
	34	+
	35	+|(% colspan="2" rowspan="1" style="text-align:center; vertical-align:middle; width:59px" %)Metric|(% style="width:1278px" %)(((
	36	+System.Diagnostics.Metrics
5	5	[[https:~~/~~/learn.microsoft.com/ru-ru/dotnet/api/system.diagnostics.metrics?view=net-7.0>>https://learn.microsoft.com/ru-ru/dotnet/api/system.diagnostics.metrics?view=net-7.0]]
6		-|(% colspan="1" rowspan="2" style="width:59px" %)Tracing|(% style="width:128px" %)DiagnosticSource|(% style="width:1278px" %)System.Diagnostics.DiagnosticSource
7		- (((
8		-|System.Diagnostics.DiagnosticSource|
9		-|System.Diagnostics.DiagnosticListener|
	38	+
	39	+
	40	+(% style="width:802px" %)
	41	+|(% style="width:144px" %)NonObservable|(% style="width:657px" %)Хранит значение метрики самостоятельно
	42	+|(% style="width:144px" %)Observable|(% style="width:657px" %)Использует внешний делегат, для получения текущего значения метрики.
	43	+Предполагается, что внешний код будет периодически снимать показания.
	44	+
	45	+|(% colspan="1" rowspan="5" style="width:117px" %)Наблюдаемые инструменты|(% style="width:198px" %)Instrument
	46	+ObservableInstrument|(% style="width:957px" %)Базовый класс|(% style="width:957px" %)
	47	+|(% style="width:198px" %)Counter
	48	+ObservableCounter|(% style="width:957px" %)Допускает неотрицательные числовые значения.
	49	+Выполняет агрегацию поступающих значений, суммируя их.|(% style="width:957px" %)Add
	50	+|(% style="width:198px" %)Histogram|(% style="width:957px" %)Допускает числовые значения.
	51	+Без агрегации, просто фиксирует само значение.|(% style="width:957px" %)Record
	52	+|(% style="width:198px" %)UpDownCounter
	53	+ObservableUpDownCounter|(% style="width:957px" %)Допускает числовые значения.
	54	+Выполняет агрегацию поступающих значений, вычисляя дельты (изменения) значения (в сравнении с предыдущим).|(% style="width:957px" %)Add
	55	+|(% style="width:198px" %)ObservableGauge|(% style="width:957px" %) |(% style="width:957px" %)
	56	+|(% colspan="1" rowspan="2" style="width:117px" %)Инфраструктура|(% style="width:198px" %)Meter|(% style="width:957px" %)Создание и отслеживание|(% style="width:957px" %)
	57	+|(% style="width:198px" %)MeterListener|(% style="width:957px" %)Прослушивание|(% style="width:957px" %)
10	10	)))
11		-|(% style="width:128px" %)Activity|(% style="width:1278px" %)(((
12		-|ActivitySource|
13		-|Activity|(((
14		-|(% colspan="1" rowspan="2" style="width:31px" %)1|(% style="width:199px" %)OperationName|(% style="width:426px" %)Имя
15		-|(% style="width:199px" %)Duration|(% style="width:426px" %)Длительность
16		-|(% colspan="1" rowspan="5" style="width:31px" %)2|(% style="width:199px" %)Tags|(% style="width:426px" %)Key-value коллекция
17		-|(% style="width:199px" %)Baggage|(% style="width:426px" %)Key-value коллекция элементов, передаваемых дочерним Activity
18		-|(% style="width:199px" %)Events|(% style="width:426px" %)Набор событий ActivityEvent.
19		-|(% style="width:199px" %)Context|(% style="width:426px" %)
20		-|(% style="width:199px" %)Links|(% style="width:426px" %)
21		-|(% colspan="1" style="width:31px" %) |(% style="width:199px" %)Custom properties|(% style="width:426px" %)Коллекция прикрепленных объектов
	59	+|(% colspan="1" rowspan="2" style="text-align:center; vertical-align:middle; width:59px" %)Tracing|(% style="text-align:center; vertical-align:middle; width:128px" %)DiagnosticSource|(% style="width:1278px" %)(((
	60	+System.Diagnostics.DiagnosticSource
	61	+
	62	+
	63	+(((
	64	+(% style="width:293px" %)
	65	+|(% style="width:290px" %)DiagnosticSource
	66	+|(% style="width:290px" %)DiagnosticListener
22	22	)))
23		-|ActivityListener|
24		-|ActivityEvent|
	68	+)))
	69	+|(% style="text-align:center; vertical-align:middle; width:128px" %)Activity|(% style="width:1278px" %)(((
	70	+(% style="width:1267px" %)
	71	+|ActivitySource|(% style="width:1082px" %)
	72	+|Activity|(% style="width:1082px" %)(((
	73	+(((
	74	+(% style="width:1048px" %)
	75	+|(% colspan="1" rowspan="2" style="width:31px" %)1|(% style="width:164px" %)OperationName|(% style="width:846px" %)Имя
	76	+|(% style="width:164px" %)Duration|(% style="width:846px" %)Длительность
	77	+|(% colspan="1" rowspan="5" style="width:31px" %)2|(% style="width:164px" %)Tags|(% style="width:846px" %)Key-value коллекция
	78	+|(% style="width:164px" %)Baggage|(% style="width:846px" %)Key-value коллекция элементов, передаваемых дочерним Activity
	79	+|(% style="width:164px" %)Events|(% style="width:846px" %)Набор событий ActivityEvent.
	80	+|(% style="width:164px" %)Context|(% style="width:846px" %)Набор атрибутов, идентифицирующих Activity.
	81	+|(% style="width:164px" %)Links|(% style="width:846px" %)Набор ссылок ActivityLink.
	82	+|(% colspan="1" style="width:31px" %) |(% style="width:164px" %)Custom properties|(% style="width:846px" %)Коллекция прикрепленных объектов
	83	+)))
25	25
26		-
	85	+(((
	86	+В момент вызова Dispose activity фиксирует остановку и выполняется оповещение:
	87	+(Activity -> ActivitySource -> ActivityListener -> OpenTelemetry.SpanProcessor -> OpenTelemetry.Exporter).
27	27	)))
	89	+)))
	90	+|ActivityListener|(% style="width:1082px" %)
	91	+|ActivityEvent|(% style="width:1082px" %)
	92	+|ActivityLink|(% style="width:1082px" %)
	93	+)))
28	28
29	29