Перейти к содержимому

Исходный код вики System. Diagnostics

Версия 2.4 от Alexandr Fokin на 2022/12/13 20:47
Скрыть последних авторов
Alexandr Fokin 1.3 1 System.Diagnostics
2
Alexandr Fokin 2.1 3 [[Open Telemetry>>doc:Разработка.Логи, трассировка, метрики, мониторинг.Open Telemetry.WebHome]]
Alexandr Fokin 1.3 4
Alexandr Fokin 1.19 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]]
Alexandr Fokin 1.16 7
Alexandr Fokin 1.21 8 ----
Alexandr Fokin 1.19 9
Alexandr Fokin 1.21 10 Замечания:
11
12 1. ActivitySource не создает экземпляры Activity (возвращает null), если нет ни одного активного ActivityListener.
13 1. **!!!** Нижеприведенный код после публикации сборки (и в Release и в Debug) может никогда не выполниться, в случае, если к полю _Listener (и к классу FakeListener) нет других обращений.
14 И Activity не будут создаваться.
Alexandr Fokin 1.22 15 {{code language="с#"}}private static readonly FakeListener _Listener = new FakeListener();
Alexandr Fokin 1.21 16
Alexandr Fokin 1.22 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
Alexandr Fokin 1.21 33 ----
34
Alexandr Fokin 1.14 35 |(% colspan="2" rowspan="1" style="text-align:center; vertical-align:middle; width:59px" %)Metric|(% style="width:1278px" %)(((
Alexandr Fokin 1.13 36 System.Diagnostics.Metrics
Alexandr Fokin 1.11 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]]
Alexandr Fokin 1.13 38
39
Alexandr Fokin 2.2 40 (% style="width:802px" %)
41 |(% style="width:144px" %)NonObservable|(% style="width:657px" %)Хранит значение метрики самостоятельно
Alexandr Fokin 2.4 42 |(% style="width:144px" %)Observable|(% style="width:657px" %)Использует внешний делегат, для получения текущего значения метрики.
43 Предполагается, что внешний код будет периодически снимать показания.
Alexandr Fokin 2.2 44
Alexandr Fokin 1.13 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
Alexandr Fokin 1.17 48 ObservableCounter|(% style="width:957px" %)Допускает неотрицательные числовые значения.
49 Выполняет агрегацию поступающих значений, суммируя их.|(% style="width:957px" %)Add
50 |(% style="width:198px" %)Histogram|(% style="width:957px" %)Допускает числовые значения.
51 Без агрегации, просто фиксирует само значение.|(% style="width:957px" %)Record
Alexandr Fokin 1.13 52 |(% style="width:198px" %)UpDownCounter
53 ObservableUpDownCounter|(% style="width:957px" %)Допускает числовые значения.
Alexandr Fokin 1.17 54 Выполняет агрегацию поступающих значений, вычисляя дельты (изменения) значения (в сравнении с предыдущим).|(% style="width:957px" %)Add
Alexandr Fokin 1.13 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" %)
58 )))
Alexandr Fokin 1.15 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
Alexandr Fokin 1.11 67 )))
Alexandr Fokin 1.15 68 )))
Alexandr Fokin 1.14 69 |(% style="text-align:center; vertical-align:middle; width:128px" %)Activity|(% style="width:1278px" %)(((
Alexandr Fokin 1.15 70 (% style="width:1267px" %)
71 |ActivitySource|(% style="width:1082px" %)
72 |Activity|(% style="width:1082px" %)(((
Alexandr Fokin 1.23 73 (((
Alexandr Fokin 1.15 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.
Alexandr Fokin 1.23 80 |(% style="width:164px" %)Context|(% style="width:846px" %)Набор атрибутов, идентифицирующих Activity.
Alexandr Fokin 1.20 81 |(% style="width:164px" %)Links|(% style="width:846px" %)Набор ссылок ActivityLink.
Alexandr Fokin 1.15 82 |(% colspan="1" style="width:31px" %) |(% style="width:164px" %)Custom properties|(% style="width:846px" %)Коллекция прикрепленных объектов
Alexandr Fokin 1.6 83 )))
Alexandr Fokin 1.23 84
85 (((
86 В момент вызова Dispose activity фиксирует остановку и выполняется оповещение:
87 (Activity -> ActivitySource -> ActivityListener -> OpenTelemetry.SpanProcessor -> OpenTelemetry.Exporter).
88 )))
89 )))
Alexandr Fokin 1.15 90 |ActivityListener|(% style="width:1082px" %)
91 |ActivityEvent|(% style="width:1082px" %)
Alexandr Fokin 1.20 92 |ActivityLink|(% style="width:1082px" %)
Alexandr Fokin 1.11 93 )))
Alexandr Fokin 1.6 94
95