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

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

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

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

Приложения

Навигация