CoreTelemetry¶
- public interface CoreTelemetry¶
Added in version AS: 1.23.0-ms5
Интерфейс является точкой входа в телеметрию решения.
Methods¶
getAttributeKeyProvider¶
- CoreAttributeKeyProvider getAttributeKeyProvider()¶
Возвращает поставщика ключей атрибутов.
- Returns:
поставщик
getContextKeyProvider¶
- CoreContextKeyProvider getContextKeyProvider()¶
Added in version 1.23.0-rc12.
Возвращает поставщика ключей контекста
CoreContext.- Returns:
поставщик
getCurrentContext¶
- CoreContext getCurrentContext()¶
Верните контекст, связанный с текущим
CoreScope.- Returns:
экземпляр контекста
getCurrentSpan¶
- CoreSpan getCurrentSpan()¶
Возвращает
CoreSpanиз текущегоCoreContext, если в текущем контексте нет диапазона, возвращает значениеCoreSpanпо умолчанию, без операций.
getInvalidSpan¶
getMeter¶
- CoreMeter getMeter(String instrumentationScopeName)¶
Получает или создает именованный экземпляр измерителя
CoreMeterдля этогоCoreTelemetry.- Parameters:
instrumentationScopeName – Имя, уникально идентифицирующее область инструментирования, например: библиотека инструментов, пакет или полное имя класса. Не должно быть нулевым.
- Returns:
экземпляр счетчика.
getMeter¶
- CoreMeter getMeter(String instrumentationScopeName, String instrumentationScopeVersion)¶
Added in version 1.23.0-rc12.
Получает или создает именованный экземпляр измерителя
CoreMeterдля этогоCoreTelemetry.- Parameters:
instrumentationScopeName – Имя, уникально идентифицирующее область инструментирования, например: библиотека инструментов, пакет или полное имя класса. Не должно быть нулевым.
instrumentationScopeVersion – Версия области инструментирования (например, «1.0.0»). Может быть нулевым.
- Returns:
экземпляр счетчика.
getRootContext¶
- CoreContext getRootContext()¶
Возвращает корневой
CoreContext, из которого получены все остальныеCoreContext.Как правило, не требуется использовать корневой
CoreContextнапрямую — вместо этого используйтеgetCurrentContext()для работы с текущимCoreContext. Используйте этот метод только в том случае, если вы абсолютно уверены, что вам нужно игнорировать текущийCoreContext— это почти всегда — это всего лишь обходной путь, скрывающий основную проблему распространения контекста.
getSpanFromContext¶
- CoreSpan getSpanFromContext(CoreContext coreContext)¶
Возвращает
CoreSpanиз указанногоCoreContext, возвращаясь к значению по умолчанию, без операций.CoreSpan, если в контексте нет диапазона.
getSpanFromContextOrNull¶
- CoreSpan getSpanFromContextOrNull(CoreContext coreContext)¶
Возвращает
CoreSpanиз указанногоCoreContextилиnull, если диапазона нет в контексте.
getTracer¶
- CoreTracer getTracer(String instrumentationScopeName)¶
Получает или создает именованный экземпляр трассировщика
CoreTracerс указанием версии в этомCoreTelemetry.- Parameters:
instrumentationScopeName – Имя, уникально идентифицирующее область инструментирования, например: библиотека инструментов, пакет или полное имя класса. Не должно быть нулевым.
- Returns:
экземпляр трассировщика.
getTracer¶
- CoreTracer getTracer(String instrumentationScopeName, String instrumentationScopeVersion)¶
Получает или создает именованный экземпляр трассировщика
CoreTracerс указанием версии в этомCoreTelemetry.- Parameters:
instrumentationScopeName – Имя, уникально идентифицирующее область инструментирования, например: библиотека инструментов, пакет или полное имя класса. Не должно быть нулевым.
instrumentationScopeVersion – Версия области инструментирования (например, «1.0.0»). Может быть нулевым.
- Returns:
экземпляр трассировщика.
isEnabled¶
- boolean isEnabled()¶
Возвращает значение флага активности телеметрии для сервера.
- Returns:
true, если активно, иначе false.
wrapSpan¶
- CoreSpan wrapSpan(CoreSpanContext coreSpanContext)¶
Возвращает незаписываемый объект
CoreSpan, который содержит предоставленныйCoreSpanContext, но не имеет функциональности. Он не будет экспортирован, и все операции трассировки не выполняются, но его можно использовать для распространенияCoreSpanContextв нисходящем направлении.