Изменения документа System. Diagnostics

Редактировал(а) Alexandr Fokin 2022/12/30 00:19

<
От версии < 1.24 >
отредактировано Alexandr Fokin
на 2022/12/10 09:33
К версии < 1.10 >
отредактировано Alexandr Fokin
на 2022/12/03 05:18
>
Изменить комментарий: К данной версии нет комментариев

Комментарий

Подробности

Свойства страницы
Содержимое
... ... @@ -1,91 +1,27 @@
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]]
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 -|(% colspan="1" rowspan="5" style="width:117px" %)Наблюдаемые инструменты|(% style="width:198px" %)Instrument
41 -ObservableInstrument|(% style="width:957px" %)Базовый класс|(% style="width:957px" %)
42 -|(% style="width:198px" %)Counter
43 -ObservableCounter|(% style="width:957px" %)Допускает неотрицательные числовые значения.
44 -Выполняет агрегацию поступающих значений, суммируя их.|(% style="width:957px" %)Add
45 -|(% style="width:198px" %)Histogram|(% style="width:957px" %)Допускает числовые значения.
46 -Без агрегации, просто фиксирует само значение.|(% style="width:957px" %)Record
47 -|(% style="width:198px" %)UpDownCounter
48 -ObservableUpDownCounter|(% style="width:957px" %)Допускает числовые значения.
49 -Выполняет агрегацию поступающих значений, вычисляя дельты (изменения) значения (в сравнении с предыдущим).|(% style="width:957px" %)Add
50 -|(% style="width:198px" %)ObservableGauge|(% style="width:957px" %) |(% style="width:957px" %)
51 -|(% colspan="1" rowspan="2" style="width:117px" %)Инфраструктура|(% style="width:198px" %)Meter|(% style="width:957px" %)Создание и отслеживание|(% style="width:957px" %)
52 -|(% style="width:198px" %)MeterListener|(% style="width:957px" %)Прослушивание|(% style="width:957px" %)
4 +|(% style="width:153px" %)Metric|(% style="width:153px" %)Metrics|(% style="width:925px" %)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:430px" %)
6 +|(% colspan="1" rowspan="2" style="width:153px" %)Tracing|(% style="width:153px" %)DiagnosticSource|(% style="width:925px" %)System.Diagnostics.DiagnosticSource
7 +\\{{code language="c#"}}System.Diagnostics.DiagnosticListener
8 +System.Diagnostics.DiagnosticSource{{/code}}|(% style="width:430px" %)
9 +|(% style="width:153px" %)Activity|(% style="width:925px" %)(((
10 +|ActivitySource|
11 +|Activity|(((
12 +|(% colspan="1" rowspan="2" style="width:31px" %)1|(% style="width:199px" %)OperationName|(% style="width:426px" %)Имя
13 +|(% style="width:199px" %)Duration|(% style="width:426px" %)Длительность
14 +|(% colspan="1" rowspan="5" style="width:31px" %)2|(% style="width:199px" %)Tags|(% style="width:426px" %)Key-value коллекция
15 +|(% style="width:199px" %)Baggage|(% style="width:426px" %)Key-value коллекция элементов, передаваемых дочерним Activity
16 +|(% style="width:199px" %)Events|(% style="width:426px" %)Набор событий ActivityEvent.
17 +|(% style="width:199px" %)Context|(% style="width:426px" %)
18 +|(% style="width:199px" %)Links|(% style="width:426px" %)
19 +|(% colspan="1" style="width:31px" %) |(% style="width:199px" %)Custom properties|(% style="width:426px" %)Коллекция прикрепленных объектов
53 53  )))
54 -|(% 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" %)(((
55 -System.Diagnostics.DiagnosticSource
21 +|ActivityListener|
22 +|ActivityEvent|
56 56  
24 +
25 +)))|(% style="width:430px" %)
57 57  
58 -(((
59 -(% style="width:293px" %)
60 -|(% style="width:290px" %)DiagnosticSource
61 -|(% style="width:290px" %)DiagnosticListener
62 -)))
63 -)))
64 -|(% style="text-align:center; vertical-align:middle; width:128px" %)Activity|(% style="width:1278px" %)(((
65 -(% style="width:1267px" %)
66 -|ActivitySource|(% style="width:1082px" %)
67 -|Activity|(% style="width:1082px" %)(((
68 -(((
69 -(% style="width:1048px" %)
70 -|(% colspan="1" rowspan="2" style="width:31px" %)1|(% style="width:164px" %)OperationName|(% style="width:846px" %)Имя
71 -|(% style="width:164px" %)Duration|(% style="width:846px" %)Длительность
72 -|(% colspan="1" rowspan="5" style="width:31px" %)2|(% style="width:164px" %)Tags|(% style="width:846px" %)Key-value коллекция
73 -|(% style="width:164px" %)Baggage|(% style="width:846px" %)Key-value коллекция элементов, передаваемых дочерним Activity
74 -|(% style="width:164px" %)Events|(% style="width:846px" %)Набор событий ActivityEvent.
75 -|(% style="width:164px" %)Context|(% style="width:846px" %)Набор атрибутов, идентифицирующих Activity.
76 -|(% style="width:164px" %)Links|(% style="width:846px" %)Набор ссылок ActivityLink.
77 -|(% colspan="1" style="width:31px" %) |(% style="width:164px" %)Custom properties|(% style="width:846px" %)Коллекция прикрепленных объектов
78 -)))
79 -
80 -(((
81 -В момент вызова Dispose activity фиксирует остановку и выполняется оповещение:
82 -(Activity -> ActivitySource -> ActivityListener -> OpenTelemetry.SpanProcessor -> OpenTelemetry.Exporter).
83 -В случае синхронного экспорта значений, первичная установка соединения может занять сравнительно много времени.
84 -)))
85 -)))
86 -|ActivityListener|(% style="width:1082px" %)
87 -|ActivityEvent|(% style="width:1082px" %)
88 -|ActivityLink|(% style="width:1082px" %)
89 -)))
90 -
91 91