Комментарий

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

Подробности

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

Содержимое

...	...	@@ -1,95 +1,29 @@
1	1	System.Diagnostics
2	2
3		-[[Open Telemetry>>doc:Разработка.Логи, трассировка, метрики, мониторинг.Open Telemetry.WebHome]]
4	4
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]]
	4	+|(% style="width:153px" %)Metrics|(% style="width:1340px" %)System.Diagnostics.Metrics
	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]]|(% style="width:1340px" %)
	6	+|(% style="width:153px" %)DiagnosticSource|(% style="width:1340px" %)System.Diagnostics.DiagnosticSource
	7	+\\{{code language="c#"}}System.Diagnostics.DiagnosticListener
	8	+System.Diagnostics.DiagnosticSource{{/code}}|(% style="width:1340px" %)
	9	+|(% style="width:153px" %)Activity|(% style="width:1340px" %)(((
	10	+|ActivitySource|
	11	+|Activity|(((
	12	+|(% colspan="1" rowspan="2" style="width:31px" %)1|(% style="width:357px" %)OperationName
	13	+|(% style="width:357px" %)Duration
	14	+|(% colspan="1" rowspan="5" style="width:31px" %)2|(% style="width:357px" %)Tags
	15	+|(% style="width:357px" %)Baggage
	16	+|(% style="width:357px" %)Events
	17	+|(% style="width:357px" %)Context
	18	+|(% style="width:357px" %)Links
	19	+|(% colspan="1" style="width:31px" %) |(% style="width:357px" %)Custom properties
7	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
37		-[[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]]
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" %)
	21	+
58	58	)))
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
	23	+|ActivityListener|
	24	+|ActivityEvent|
61	61
	26	+
	27	+)))|(% style="width:1340px" %)
62	62
63		-(((
64		-(% style="width:293px" %)
65		-|(% style="width:290px" %)DiagnosticSource
66		-|(% style="width:290px" %)DiagnosticListener
67		-)))
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		-)))
84		-
85		-(((
86		-В момент вызова Dispose activity фиксирует остановку и выполняется оповещение:
87		-(Activity -> ActivitySource -> ActivityListener -> OpenTelemetry.SpanProcessor -> OpenTelemetry.Exporter).
88		-)))
89		-)))
90		-|ActivityListener|(% style="width:1082px" %)
91		-|ActivityEvent|(% style="width:1082px" %)
92		-|ActivityLink|(% style="width:1082px" %)
93		-)))
94		-
95	95