IKuznetsov: Новая страница: « = Обнаружение проблем с помощью логов = Быстрое обнаружение и решение проблем в вашей среде критически важно для поддержания стабильной выручки и доверия клиентов. Однако ручной анализ старых приложений или сторонних приложений, к исходному коду кото...»

2026-10-13T22:59:43Z

Новая страница: « = Обнаружение проблем с помощью логов = Быстрое обнаружение и решение проблем в вашей среде критически важно для поддержания стабильной выручки и доверия клиентов. Однако ручной анализ старых приложений или сторонних приложений, к исходному коду кото...»

Новая страница

= Обнаружение проблем с помощью логов =
Быстрое обнаружение и решение проблем в вашей среде критически важно для поддержания стабильной выручки и доверия клиентов. Однако ручной анализ старых приложений или сторонних приложений, к исходному коду которых у вас нет доступа, может занимать много времени. Решение проблемы с помощью Ключ-АСТРОМ значительно ускоряет среднее время выявления ('''MTTI''') критических проблем и повышает скорость их исправления до того, как они повлияют на пользовательский опыт, минимизируя влияние сбоев на бизнес. Используя единую платформу наблюдаемости для всех сигналов, вы снижаете риск человеческих ошибок при ручной корреляции деталей проблемы. Ключ-АСТРОМ позволяет не просматривать все существующие записи, а показывать только те строки логов, которые непосредственно связаны с обнаруженной проблемой. Этот метод также позволяет быстро проверять детали ошибки, такие как сообщение, статус и строка кода ('''LOC'''), где произошла ошибка.

== Чему вы научитесь ==
Это руководство проведёт вас через процесс извлечения релевантной информации из логов через '''OpenPipeline''' и доступа к логам через приложение «Проблемы». Оно покажет, как использовать запросы '''DQL''' для поиска информации, релевантной вашей проблеме, и получить более глубокий, контекстный взгляд на проблему с помощью трассировок. К концу вы узнаете, как:

* Обогащать логи дополнительным контекстом по мере их сбора через '''ЕдиныйАгент''' или '''OpenTelemetry'''.
* Настраивать '''OpenPipeline''' для извлечения релевантной информации из логов и преобразования её в событие.
* Использовать приложение «Проблемы» для доступа к релевантным строкам логов.
* Находить первопричину с помощью логов.

Пример, используемый в этом руководстве, взят из лаборатории наблюдаемости: «Обнаружение проблем с помощью логов». Для полного опыта вы можете следовать этому практическому демо. Оно объясняет процесс создания проблемы и настройки тестовой среды.

== Перед началом работы ==

=== Предварительные требования ===

* Доступ к среде Ключ-АСТРОМ SaaS.
* Доступ к демо '''OpenTelemetry''' или '''ЕдиномуАгенту'''.
* Установленное приложение «Проблемы».
* Настроенная загрузка '''OpenPipeline'''.
* Сконфигурированный '''OpenPipeline'''.

== Шаги ==
Это руководство предполагает, что вы уже мониторите свою среду с помощью Ключ-АСТРОМ.

=== Создайте новый пайплайн для извлечения данных ===
'''OpenPipeline''' — это решение Ключ-АСТРОМ для обработки данных и загрузки. Вы можете настроить '''OpenPipeline''' для извлечения конкретной информации, релевантной для вашего случая, и преобразования её в событие, по которому можно создавать оповещения. Дополнительную информацию о возможностях обработки '''OpenPipeline''' см. в разделе «Обработка в OpenPipeline».

Чтобы создать новый пайплайн:

* В Ключ-АСТРОМ выберите или нажмите <code>Ctrl+K</code>, чтобы найти и выбрать '''OpenPipeline'''.
* Перейдите в '''Логи > Пайплайны > Пайплайн'''.
* Выберите и измените имя пайплайна на <code>Log Errors</code>.
* Выберите '''Сохранить'''.
* Перейдите в '''Davis > Событие Davis'''. Это создаст новый процессор.
* Заполните обязательные поля. Результат должен быть похож на пример, следующий за этой процедурой.
** Установите '''Имя''' на любое имя.
** '''Условие сопоставления''' должно быть установлено в <code>true</code>.
** Установите '''Имя события''' следующим образом: <code>[{priority}][{deployment.release_stage}][{deployment.release_product}][{dt.owner}] {alertmessage}</code>.
** Установите '''Описание события''' в <code>{supportInfo} - Log line: {content}</code>.
** Задайте следующие '''Свойства события''':
*** <code>event.type</code>: <code>ERROR_EVENT</code>
*** <code>dt.owner</code>: <code>{dt.owner}</code>
*** <code>dt.cost.costcenter</code>: <code>{dt.cost.costcenter}</code>
*** <code>dt.cost.product</code>: <code>{dt.cost.product}</code>
*** <code>deployment.release_product</code>: <code>{deployment.release_product}</code>
*** <code>deployment.release_stage</code>: <code>{deployment.release_stage}</code>
* Выберите '''Сохранить''', чтобы сохранить ваш пайплайн.

'''Пример создания нового пайплайна Log Error'''

=== Добавьте динамический маршрут для пайплайна ===
Загруженные и извлечённые данные должны быть направлены в пайплайн до их обработки. Создание маршрута необходимо, чтобы ваши данные направлялись в правильный пайплайн, особенно в случаях, когда у вас несколько пайплайнов. Дополнительную информацию см. в разделе «Маршрутизация».

Чтобы добавить новый динамический маршрут:

* Перейдите в '''Логи > Динамическая маршрутизация > Динамический маршрут'''.
* Заполните обязательные поля:
** Установите '''Имя''' на любое имя.
** '''Условие сопоставления''' должно быть установлено в <code>isNotNull(alertmessage) and isNotNull(priority) and priority == "1"</code>.
* Выберите '''Добавить''', чтобы создать новый динамический маршрут.

'''Пример создания нового динамического маршрута для пайплайна Log Errors'''

=== Доступ к проблемам через приложение «Проблемы» ===
После того как проблема обнаружена и записана в логах, вы можете проверить её статус в приложении «Проблемы». Приложение «Проблемы» — это инструмент, предназначенный для помощи операционным командам и командам надёжности в сокращении среднего времени восстановления ('''MTTR''') путём представления всех аспектов инцидента. Дополнительную информацию см. в разделе «Приложение Проблемы».

Чтобы получить доступ к приложению «Проблемы»:

* В Ключ-АСТРОМ выберите или нажмите <code>Ctrl+K</code>, чтобы найти и выбрать приложение «Проблемы».
* Выберите ID открытой проблемы, чтобы увидеть запись. Открытые проблемы перечислены со статусом '''Активна'''.

'''Список только ошибок в приложении Проблемы'''

=== Просмотр логов через записи проблем ===
Запись проблемы показывает количество событий, SLO, затронутых пользователей и затронутых сущностей. По умолчанию запись показывает затронутое развёртывание и график, иллюстрирующий проблему. Вы можете переключаться между '''Графиком''' и '''Свойствами''', а также отображать '''Развёртывание''', '''События''' или '''Логи''', связанные с проблемой.

'''Вид записи проблемы'''

* Выберите '''Логи''', чтобы получить доступ к логам из записи проблемы. На вкладке «Логи» вы увидите график загруженных записей и список рекомендуемых запросов, которые помогут быстрее проанализировать проблему.
* Выберите '''Запустить запрос для показа X ошибок''', где X — количество ошибок, зафиксированных для вашей проблемы.
* Выберите запись лога, которую хотите развернуть. Развёрнутая запись предоставляет полезные метаданные, такие как:
** Временная метка строки лога.
** <code>host.name</code>, соответствующее имени контейнера.
** <code>loglevel</code> (например, ERROR).
** <code>span_id</code> и <code>trace_id</code> '''OpenTelemetry''' или '''ЕдиногоАгента'''.
** <code>dt.owner</code>, владелец компонента.
** <code>dt.cost.product</code> и <code>dt.cost.costcenter</code>, соответствующие информации о затратах.

'''Пример развёрнутой записи лога, содержащей информацию метаданных'''

* Выберите '''Показать окружающие логи''', чтобы увидеть логи, связанные с проблемой.
* Выберите фильтр для окружающих логов:
** '''На основе трассировки (по умолчанию)''': отобразить все логи с тем же <code>trace_id</code>.
** '''На основе топологии''': показать ошибку в контексте всех логов для сбойного сервиса на момент ошибки.
* Логи, связанные с ошибкой, такие как информационные события, могут содержать дополнительную информацию, которая поможет вам в локализации первопричины. Примеры дополнительной информации включают:
** <code>statuscode</code> содержит код статуса ошибки. Например, <code>FailedPrecondition</code>.
** <code>detail</code> содержит сообщение об ошибке и строку кода, где произошла ошибка.

'''Пример дополнительной информации, связанной с событием'''

=== Просмотр деталей в распределённых трассировках ===
Трассировки предоставляют более глубокий обзор и дополнительный контекст для информации, доступной в логах. Чтобы иметь доступ к трассировкам через логи, вам нужно связать данные логов с трассировками через '''OpenTelemetry''' или '''ЕдиныйАгент'''.

Чтобы получить доступ к трассировкам через логи:

* Выберите <code>trace_id</code>, пока находитесь в развёрнутом представлении лога.
* Перейдите в '''Исследовать''', выберите '''Открыть поле с помощью''' и выберите '''Распределённые трассировки''' во всплывающем окне. Приложение «Распределённые трассировки» отображает хронологический список вызванных функций, который можно использовать для пошагового анализа проблемы. Точка сбоя будет отмечена красной линией.

'''Пример вида приложения «Распределённые трассировки»'''

== Итог ==
Если вы выполнили все шаги, вы:

* Создали пайплайн, предназначенный для обнаружения ошибок.
* Нашли первопричину с помощью приложения «Проблемы» и логов.

Если ваш разработчик предоставил вам runbook, который можно использовать в качестве руководства для устранения ошибок, вы можете следовать ему в качестве следующего шага. В противном случае вашим следующим шагом должно быть обращение к команде, ответственной за сопровождение сервиса или функции, которые привели к ошибке. Если вы являетесь частью этой команды, вы можете начать процесс отладки проблемы.

Обнаружение проблем с помощью логов - История изменений