Унифицированные службы: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Клюx-АСТРОМ версия 1.274 Тип службы «Единая служба» представляет службы, обнаруженные на о...») |
ENetrebin (обсуждение | вклад) |
||
(не показано 6 промежуточных версий этого же участника) | |||
Строка 1: | Строка 1: | ||
'''''[https://doc.ruscomtech.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B Модули платформы] / [https://doc.ruscomtech.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B#.D0.9D.D0.B0.D0.B1.D0.BB.D1.8E.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B7.D0.B0_.D0.BF.D1.80.D0.B8.D0.BB.D0.BE.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5.D0.BC Наблюдение за приложением] / [https://doc.ruscomtech.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B#.D0.A1.D0.BB.D1.83.D0.B6.D0.B1.D1.8B Службы] / [https://doc.ruscomtech.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B#.D0.A1.D0.BB.D1.83.D0.B6.D0.B1.D1.8B Обнаружение и присвоение имени] / [https://doc.ruscomtech.ru/index.php/%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D0%B8_%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D1%8B#.D0.A2.D0.B8.D0.BF.D1.8B_.D1.81.D0.BB.D1.83.D0.B6.D0.B1 Типы служб] / Унифицированные службы''''' | |||
''Ключ-АСТРОМ версия 1.274'' | |||
Тип службы «Единая служба» представляет службы, обнаруженные на основе интервалов, и создан с учетом Cloud Native и OpenTelemetry. Унифицированные службы обеспечивают безагентную поддержку данных из API приема, например API приема трассировки . | Тип службы «Единая служба» представляет службы, обнаруженные на основе интервалов, и создан с учетом Cloud Native и OpenTelemetry. Унифицированные службы обеспечивают безагентную поддержку данных из API приема, например API приема трассировки . | ||
* Унифицированные службы, полученные через API-интерфейсы приема, перечислены вместе с другими службами и в топологии . После обогащения трассировок информацией о топологии взаимосвязи сопоставляются в вашей среде, обеспечивая полное вертикальное и горизонтальное представление топологии и упрощая анализ первопричин проблем. | * Унифицированные службы, полученные через API-интерфейсы приема, перечислены вместе с другими службами и в топологии . После обогащения трассировок информацией о топологии взаимосвязи сопоставляются в вашей среде, обеспечивая полное вертикальное и горизонтальное представление топологии и упрощая анализ первопричин проблем. | ||
* Ключ-АСТРОМ рассчитывает время отклика, пропускную способность и показатели частоты сбоев для этих сервисов, которые доступны через анализ | * Ключ-АСТРОМ рассчитывает время отклика, пропускную способность и показатели частоты сбоев для этих сервисов, которые доступны через анализ служб. | ||
* ИИ анализирует проблемы, связанные с базовыми ресурсами, с помощью готовых базовых показателей. Кроме того, вы можете создавать собственные оповещения на основе информации лога. | * ИИ анализирует проблемы, связанные с базовыми ресурсами, с помощью готовых базовых показателей. Кроме того, вы можете создавать собственные оповещения на основе информации лога. | ||
* Вы можете искать отслеживаемые объекты в Ключ-АСТРОМ по имени диапазона. | * Вы можете искать отслеживаемые объекты в Ключ-АСТРОМ по имени диапазона. | ||
Строка 10: | Строка 12: | ||
* Распределенные трассировки, логи и события помещаются в контекст. | * Распределенные трассировки, логи и события помещаются в контекст. | ||
* Вы можете отслеживать и настраивать оповещения для автоматически обнаруженных конечных точек. | * Вы можете отслеживать и настраивать оповещения для автоматически обнаруженных конечных точек. | ||
== Прежде чем вы начнете == | |||
Если вы уже используете тип службы Span ( <code>span:service</code>) в своей среде, мы рекомендуем перенести ваши экземпляры на тип службы Unified . Чтобы автоматически перенести экземпляры, включите обнаружение унифицированной службы. | |||
# Перейдите в настройки . | |||
# Выберите «Обнаружение службы» . | |||
# Выберите унифицированные службы для OpenTelemetry и включите параметр «Включить унифицированные службы» . | |||
''Критические изменения:'' | |||
''Миграция на другой тип службы повлияет на существующие запросы метрик API, панели мониторинга, а также имена служб и запросов.'' | |||
''Это действие можно отменить, однако для обеспечения высокого качества данных мониторинга мы рекомендуем свести к минимуму переключение между типами служб.'' | |||
== Правила обнаружения унифицированных служб == | |||
Затем создается унифицированная служба, когда Ключ-АСТРОМ обнаруживает промежутки, обработанные API . При обнаружении унифицированной службы следующие атрибуты ресурса оцениваются в следующем порядке. Значение первого соответствующего атрибута определяет имя объединенной службы. Обратите внимание, что замаскированные/заблокированные атрибуты игнорируются при обнаружении службы. | |||
{| class="wikitable" | |||
!Оцениваемый атрибут | |||
!Наименование службы | |||
|- | |||
|<code>k8s.workload.name</code> | |||
|Значение атрибута<sup>1</sup> | |||
|- | |||
|<code>dt.kubernetes.workload.name</code> | |||
|Значение атрибута<sup>1</sup> | |||
|- | |||
|<code>istio.canonical_service</code> | |||
|Значение атрибута | |||
|- | |||
|<code>service.name</code> | |||
|Значение атрибута | |||
|} | |||
<sup>1</sup>Если атрибут <code>k8s.namespace.name</code>присутствует, для каждого пространства имен создается уникальная служба с сохранением того же имени службы. Пространство имен можно найти в обзоре службы «Свойства и теги» . | |||
== Правила обнаружения конечных точек == | |||
Конечные точки автоматически создаются и базируются для каждого обнаруженного диапазона, служащего точкой входа. В случае OpenTelemetry это обычно серверные или потребительские диапазоны. | |||
Следующие атрибуты диапазона оцениваются в следующем порядке. | |||
{| class="wikitable" | |||
!Технологии | |||
!Оцениваемый атрибут | |||
!Имя конечной точки | |||
|- | |||
|gRPC | |||
|<code>rpc.service</code>(или <code>rpc.method</code>) | |||
|Значение атрибута | |||
|- | |||
|HTTP | |||
|<code>http.route</code> | |||
|Значение атрибута | |||
|- | |||
|Веб-серверы (NGINX, Apache) и входные шлюзы Istio. | |||
| | |||
|<code>"/"</code>как одно статическое имя конечной точки | |||
|- | |||
|Бессерверные функции (FaaS) | |||
| | |||
|<code>"invoke"</code>как единая статическая конечная точка | |||
|- | |||
|Неспецифические технологии | |||
| | |||
* <code>code.namespace</code>или<code>code.function</code> | |||
* <code>span.name</code> | |||
* <code>span.kind == server</code>или<code>span.kind == consumer</code> | |||
|Значение атрибута | |||
|- | |||
|HTTP | |||
|<code>http.method</code> | |||
|Значение атрибута | |||
|- | |||
|Неспецифические технологии | |||
| | |||
* <code>span.kind == server</code>или<code>span.kind == consumer</code> | |||
|Значение атрибута | |||
|} | |||
''Настройки атрибута диапазона влияют на обнаружение конечной точки.'' | |||
Значение первого соответствующего атрибута определяет имя конечной точки. Имена конечных точек обычно зависят от технологии. Имя конечной точки однозначно идентифицирует одну конечную точку конкретной службы. Обратите внимание, что замаскированные/заблокированные атрибуты игнорируются при обнаружении конечной точки. | |||
== Управление мониторингом конечных точек == | |||
Вы можете управлять метриками конечной точки, такими как время ответа, пропускная способность и частота сбоев, настроив сбор метрик конечной точки на уровне среды и переопределения на уровне обслуживания. | |||
''Когда метрики конечной точки используют DDU , изменения в настройках сбора метрик конечной точки имеют последствия для выставления счетов.'' | |||
{| class="wikitable" | |||
!Ключ метрики | |||
!Имя и описание | |||
!Единица | |||
!Агрегации | |||
!Мониторинг потребления | |||
|- | |||
|builtin:service.request.count | |||
|Общее количество запросов на обслуживание | |||
Количество запросов, полученных данной службой. | |||
|Количество | |||
|автозначение | |||
|DDU | |||
|- | |||
|builtin:service.request.failure_count | |||
|Счетчик отказов единого сервиса | |||
Количество неудачных запросов, полученных данной службой. | |||
|Количество | |||
|автозначение | |||
|Хост-юниты | |||
|- | |||
|builtin:service.request.response_time | |||
|Единое время ответа на запрос на обслуживание | |||
Время отклика службы измеряется в мс на стороне сервера (измерения на стороне сервера не включают, например, время прокси-сервера и время работы в сети). Время ответа — это время, пока ответ не будет отправлен вызывающему приложению, процессу или другой службе. Он не включает дальнейшую асинхронную обработку. Чтобы узнать, как | |||
|Миллисекунды | |||
|autocountmaxmedianminpercentile | |||
|DDU | |||
|} | |||
''Уровень среды:'' | |||
Для управления мониторингом конечных точек для всех унифицированных служб в вашей среде. | |||
# Перейдите в настройки . | |||
# Выберите «Обнаружение службы» . | |||
# Выберите «Метрики конечных точек унифицированных служб» и включите или выключите «Включить метрики конечных точек» . | |||
''Уровень службы:'' | |||
Чтобы переопределить мониторинг конечных точек для конкретной унифицированной службы | |||
# Перейдите в '''Службы''' . | |||
# ''необязательно'' На странице '''Службы''' в столбце '''Тип службы''' установите флажок '''Единая служба''' . | |||
# Найдите и выберите единую службу, для которого вы хотите настроить мониторинг конечных точек. | |||
# На странице обзора единой службы выберите '''Дополнительно ( … )''' > '''Настройки''' . | |||
# На странице настроек службы выберите '''Метрики конечной точки''' . | |||
# На странице '''«Метрики конечных точек унифицированных служб»''' включите или выключите параметр '''«Включить метрики конечных точек»''' . | |||
== Часто задаваемые вопросы == | |||
'''Как я могу проверить, что сигналы наблюдения правильно связаны с соответствующей унифицированной службы?''' | |||
Чтобы Ключ-АСТРОМ правильно коррелировала сигналы наблюдения, унифицированный сервис должен быть обнаружен на основе промежутков. Убедитесь, что логи содержат атрибут <code>trace_id</code>или <code>trace.id</code>. | |||
'''Что сохраняется?''' | |||
В целях соблюдения правил конфиденциальности Ключ-АСТРОМ сохраняет значения атрибутов только в том случае, если соответствующие ключи не заблокированы . Эта опция дает вам полную гибкость в выборе захватываемых данных, но основана на безопасных настройках по умолчанию. Это означает, что ничего больше не записывается, кроме того, что вы разрешаете. | |||
'''Нужно ли мне мигрировать непрозрачные сервисы?''' | |||
Нет. Непрозрачные сервисы (такие как исходящие сторонние сервисы Python, Rust или Ruby) автоматически переводятся в тип сервиса Unified . | |||
'''Нужно ли мне проверять определения зон управления?''' | |||
Да, вам необходимо просмотреть существующие правила зоны управления, нацеленные на метрики с измерением <code>service.name</code>, например зоны управления на основе процессов или групп процессов. Результаты правила зоны управления зависят от соответствия между основным объектом метрики и отслеживаемым объектом в зоне управления. Если основной объект метрики не соответствует отслеживаемому объекту, правило зоны управления не дает результатов. Поскольку унифицированные службы используют метрики, в которых основной объект является адаптивным, мы рекомендуем изменить такие правила зоны управления, включив в них унифицированные службы. Обратите внимание, что логи не затрагиваются напрямую. | |||
В следующем примере текстовое правило выбора объекта для существующей зоны управления обеспечивает доступ ко всем группам процессов с этим <code>aws-az-1</code>тегом. | |||
<code>type("PROCESS_GROUP"),tag("aws-az-1")</code> | |||
Чтобы включить единую службу, добавьте еще одно правило зоны управления следующим образом. | |||
<code>type(service),fromRelationship.runsOn(type("PROCESS_GROUP"),tag("aws-az-1"))</code> |
Текущая версия на 15:53, 4 марта 2024
Модули платформы / Наблюдение за приложением / Службы / Обнаружение и присвоение имени / Типы служб / Унифицированные службы
Ключ-АСТРОМ версия 1.274
Тип службы «Единая служба» представляет службы, обнаруженные на основе интервалов, и создан с учетом Cloud Native и OpenTelemetry. Унифицированные службы обеспечивают безагентную поддержку данных из API приема, например API приема трассировки .
- Унифицированные службы, полученные через API-интерфейсы приема, перечислены вместе с другими службами и в топологии . После обогащения трассировок информацией о топологии взаимосвязи сопоставляются в вашей среде, обеспечивая полное вертикальное и горизонтальное представление топологии и упрощая анализ первопричин проблем.
- Ключ-АСТРОМ рассчитывает время отклика, пропускную способность и показатели частоты сбоев для этих сервисов, которые доступны через анализ служб.
- ИИ анализирует проблемы, связанные с базовыми ресурсами, с помощью готовых базовых показателей. Кроме того, вы можете создавать собственные оповещения на основе информации лога.
- Вы можете искать отслеживаемые объекты в Ключ-АСТРОМ по имени диапазона.
- Вы можете отслеживать сетки сервисов Istio .
- Распределенные трассировки, логи и события помещаются в контекст.
- Вы можете отслеживать и настраивать оповещения для автоматически обнаруженных конечных точек.
Прежде чем вы начнете
Если вы уже используете тип службы Span ( span:service
) в своей среде, мы рекомендуем перенести ваши экземпляры на тип службы Unified . Чтобы автоматически перенести экземпляры, включите обнаружение унифицированной службы.
- Перейдите в настройки .
- Выберите «Обнаружение службы» .
- Выберите унифицированные службы для OpenTelemetry и включите параметр «Включить унифицированные службы» .
Критические изменения:
Миграция на другой тип службы повлияет на существующие запросы метрик API, панели мониторинга, а также имена служб и запросов.
Это действие можно отменить, однако для обеспечения высокого качества данных мониторинга мы рекомендуем свести к минимуму переключение между типами служб.
Правила обнаружения унифицированных служб
Затем создается унифицированная служба, когда Ключ-АСТРОМ обнаруживает промежутки, обработанные API . При обнаружении унифицированной службы следующие атрибуты ресурса оцениваются в следующем порядке. Значение первого соответствующего атрибута определяет имя объединенной службы. Обратите внимание, что замаскированные/заблокированные атрибуты игнорируются при обнаружении службы.
Оцениваемый атрибут | Наименование службы |
---|---|
k8s.workload.name
|
Значение атрибута1 |
dt.kubernetes.workload.name
|
Значение атрибута1 |
istio.canonical_service
|
Значение атрибута |
service.name
|
Значение атрибута |
1Если атрибут k8s.namespace.name
присутствует, для каждого пространства имен создается уникальная служба с сохранением того же имени службы. Пространство имен можно найти в обзоре службы «Свойства и теги» .
Правила обнаружения конечных точек
Конечные точки автоматически создаются и базируются для каждого обнаруженного диапазона, служащего точкой входа. В случае OpenTelemetry это обычно серверные или потребительские диапазоны.
Следующие атрибуты диапазона оцениваются в следующем порядке.
Технологии | Оцениваемый атрибут | Имя конечной точки |
---|---|---|
gRPC | rpc.service (или rpc.method )
|
Значение атрибута |
HTTP | http.route
|
Значение атрибута |
Веб-серверы (NGINX, Apache) и входные шлюзы Istio. | "/" как одно статическое имя конечной точки
| |
Бессерверные функции (FaaS) | "invoke" как единая статическая конечная точка
| |
Неспецифические технологии |
|
Значение атрибута |
HTTP | http.method
|
Значение атрибута |
Неспецифические технологии |
|
Значение атрибута |
Настройки атрибута диапазона влияют на обнаружение конечной точки.
Значение первого соответствующего атрибута определяет имя конечной точки. Имена конечных точек обычно зависят от технологии. Имя конечной точки однозначно идентифицирует одну конечную точку конкретной службы. Обратите внимание, что замаскированные/заблокированные атрибуты игнорируются при обнаружении конечной точки.
Управление мониторингом конечных точек
Вы можете управлять метриками конечной точки, такими как время ответа, пропускная способность и частота сбоев, настроив сбор метрик конечной точки на уровне среды и переопределения на уровне обслуживания.
Когда метрики конечной точки используют DDU , изменения в настройках сбора метрик конечной точки имеют последствия для выставления счетов.
Ключ метрики | Имя и описание | Единица | Агрегации | Мониторинг потребления |
---|---|---|---|---|
builtin:service.request.count | Общее количество запросов на обслуживание
Количество запросов, полученных данной службой. |
Количество | автозначение | DDU |
builtin:service.request.failure_count | Счетчик отказов единого сервиса
Количество неудачных запросов, полученных данной службой. |
Количество | автозначение | Хост-юниты |
builtin:service.request.response_time | Единое время ответа на запрос на обслуживание
Время отклика службы измеряется в мс на стороне сервера (измерения на стороне сервера не включают, например, время прокси-сервера и время работы в сети). Время ответа — это время, пока ответ не будет отправлен вызывающему приложению, процессу или другой службе. Он не включает дальнейшую асинхронную обработку. Чтобы узнать, как |
Миллисекунды | autocountmaxmedianminpercentile | DDU |
Уровень среды:
Для управления мониторингом конечных точек для всех унифицированных служб в вашей среде.
- Перейдите в настройки .
- Выберите «Обнаружение службы» .
- Выберите «Метрики конечных точек унифицированных служб» и включите или выключите «Включить метрики конечных точек» .
Уровень службы:
Чтобы переопределить мониторинг конечных точек для конкретной унифицированной службы
- Перейдите в Службы .
- необязательно На странице Службы в столбце Тип службы установите флажок Единая служба .
- Найдите и выберите единую службу, для которого вы хотите настроить мониторинг конечных точек.
- На странице обзора единой службы выберите Дополнительно ( … ) > Настройки .
- На странице настроек службы выберите Метрики конечной точки .
- На странице «Метрики конечных точек унифицированных служб» включите или выключите параметр «Включить метрики конечных точек» .
Часто задаваемые вопросы
Как я могу проверить, что сигналы наблюдения правильно связаны с соответствующей унифицированной службы?
Чтобы Ключ-АСТРОМ правильно коррелировала сигналы наблюдения, унифицированный сервис должен быть обнаружен на основе промежутков. Убедитесь, что логи содержат атрибут trace_id
или trace.id
.
Что сохраняется?
В целях соблюдения правил конфиденциальности Ключ-АСТРОМ сохраняет значения атрибутов только в том случае, если соответствующие ключи не заблокированы . Эта опция дает вам полную гибкость в выборе захватываемых данных, но основана на безопасных настройках по умолчанию. Это означает, что ничего больше не записывается, кроме того, что вы разрешаете.
Нужно ли мне мигрировать непрозрачные сервисы?
Нет. Непрозрачные сервисы (такие как исходящие сторонние сервисы Python, Rust или Ruby) автоматически переводятся в тип сервиса Unified .
Нужно ли мне проверять определения зон управления?
Да, вам необходимо просмотреть существующие правила зоны управления, нацеленные на метрики с измерением service.name
, например зоны управления на основе процессов или групп процессов. Результаты правила зоны управления зависят от соответствия между основным объектом метрики и отслеживаемым объектом в зоне управления. Если основной объект метрики не соответствует отслеживаемому объекту, правило зоны управления не дает результатов. Поскольку унифицированные службы используют метрики, в которых основной объект является адаптивным, мы рекомендуем изменить такие правила зоны управления, включив в них унифицированные службы. Обратите внимание, что логи не затрагиваются напрямую.
В следующем примере текстовое правило выбора объекта для существующей зоны управления обеспечивает доступ ко всем группам процессов с этим aws-az-1
тегом.
type("PROCESS_GROUP"),tag("aws-az-1")
Чтобы включить единую службу, добавьте еще одно правило зоны управления следующим образом.
type(service),fromRelationship.runsOn(type("PROCESS_GROUP"),tag("aws-az-1"))