System. Diagnostics

1

System.Diagnostics

2

3

[[Open Telemetry>>doc:Разработка.Логи, трассировка, мониторинг.Open Telemetry.WebHome]]

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]]

----

Замечания:

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(

ActivityListener

);

}

}{{/code}}

----

|(% 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" %)

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

(((

(% style="width:293px" %)

65

|(% style="width:290px" %)DiagnosticSource

66

|(% style="width:290px" %)DiagnosticListener