Придушення конкретної інструментації

Вимкнення агента повністю

Увімкнення лише конкретної інструментації

Ви можете вимкнути всю автоматичну стандартну інструментацію і вибірково знову увімкнути окремі інструментації. Це може бути бажано для зменшення часу запуску або для більшого контролю над тим, яка інструментація застосовується.

Увімкнення лише ручної інструментації

Ви можете придушити всю автоматичну інструментацію, але мати підтримку ручної інструментації з @WithSpan та звичайними взаємодіями API, використовуючи -Dotel.instrumentation.common.default-enabled=false -Dotel.instrumentation.opentelemetry-api.enabled=true -Dotel.instrumentation.opentelemetry-instrumentation-annotations.enabled=true

Придушення конкретної інструментації агента

Ви можете придушити інструментацію агента для конкретних бібліотек.

Примітка: При використанні змінних середовища, дефіси (-) слід замінити на підкреслення (_). Наприклад, щоб придушити трасування з бібліотеки akka-actor, встановіть OTEL_INSTRUMENTATION_AKKA_ACTOR_ENABLED на false.

Придушення відрізків контролера та/або представлення

Деякі інструментації (наприклад, інструментація Spring Web MVC) створюють SpanKind.Internal відрізки для захоплення виконання контролера та/або представлення. Ці відрізки можна придушити за допомогою наведених нижче налаштувань конфігурації, не придушуючи всю інструментацію, що також вимкне захоплення http.route та повʼязаної назви відрізка на батьківському SpanKind.Server відрізку.

Поведінка придушення відрізків інструментації

Деякі бібліотеки, які інструментує цей агент, своєю чергою використовують низькорівневі бібліотеки, які також інструментуються. Це зазвичай призводить до вкладених відрізків, що містять дубльовані телеметричні дані. Наприклад:

• Відрізки, створені інструментацією клієнта HTTP Reactor Netty, матимуть дубльовані відрізки клієнта HTTP, створені інструментацією Netty;
• Відрізки Dynamo DB, створені інструментацією AWS SDK, матимуть дочірні відрізки клієнта HTTP, створені його внутрішньою бібліотекою клієнта HTTP (яка також інструментується);
• Відрізки, створені інструментацією Tomcat, матимуть дубльовані відрізки сервера HTTP, створені загальною інструментацією API сервлета.

Java агент запобігає цим ситуаціям, виявляючи та придушуючи вкладені відрізки, що дублюють телеметричні дані. Поведінку придушення можна налаштувати за допомогою наступної опції конфігурації:

Наприклад, припустимо, що ми інструментуємо клієнт бази даних, який внутрішньо використовує клієнт HTTP Reactor Netty; який, своєю чергою, використовує Netty.

Використання стандартної стратегії придушення semconv призведе до 2 вкладених CLIENT відрізків:

• CLIENT відрізок з семантичними атрибутами клієнта бази даних, створений інструментацією клієнта бази даних;
• CLIENT відрізок з семантичними атрибутами клієнта HTTP, створений інструментацією Reactor Netty.

Інструментація Netty буде придушена, оскільки вона дублює інструментацію клієнта HTTP Reactor Netty.

Використання стратегії придушення span-kind призведе до одного відрізка:

• CLIENT відрізок з семантичними атрибутами клієнта бази даних, створений інструментацією клієнта бази даних.

Інструментації як Reactor Netty, так і Netty будуть придушені, оскільки вони також створюють CLIENT відрізки.

Нарешті, використання стратегії придушення none призведе до 3 відрізків:

• CLIENT відрізок з семантичними атрибутами клієнта бази даних, створений інструментацією клієнта бази даних;
• CLIENT відрізок з семантичними атрибутами клієнта HTTP, створений інструментацією Reactor Netty;
• CLIENT відрізок з семантичними атрибутами клієнта HTTP, створений інструментацією Netty.