Диагностика ЕдиногоАгента

Материал из Документация Ключ-АСТРОМ

Начиная с версии Ключ-АСТРОМ 1.208, вы можете запустить полностью автоматизированное устранение неполадок ЕдиногоАгента для сред Ключ-АСТРОМ.

Рабочий процесс позволяет вам:

  • Автоматически выявлять проблемы, связанные с OneAgent, в высокодинамичных средах в определенный момент времени
  • Легко собирайте диагностические данные для определенного объекта и автоматически получайте потенциальные решения для обнаруженных аномалий.
  • Быстро решайте распространенные проблемы самостоятельно, сокращая время, затрачиваемое на диагностику
  • Напрямую предоставьте службе поддержки Dynatrace всю необходимую информацию для диагностики проблемы.
Диагностика командной строкой

Если у вас нет доступа к Ключ-АСТРОМ или вы хотите создать скрипт для сбора диагностических данных, вы можете использовать команду oneagentctl для сбора подмножества полных диагностических данных прямо на хосте, где установлен ЕдиныйАгент.

Требования

  • SaaS-среда Ключ-АСТРОМ: Ключ-АСТРОМ версии 1.202+
  • Управляемая среда Ключ-АСТРОМ: Ключ-АСТРОМ версии 1.208+
  • Разрешение на просмотр сред данных конфиденциального запроса

Автоматический анализ

Описание процедуры по умолчанию: Ключ-АСТРОМ собирает диагностические данные для хоста или процесса и немедленно анализирует их.

Если вы предпочитаете собирать и просматривать данные перед их ручной отправкой в ​​Ключ-АСТРОМ для анализа, см. раздел Локальный сбор и просмотр ниже.

  1. Перейдите в раздел Хосты .
  2. Выберите хост, неполадки которого вы хотите устранить.
  3. Запустите диагностику на уровне хоста или процесса.
    • Уровень хоста: на странице хоста откройте меню обзора ( … ) и выберите пункт Запуск диагностики ЕдиногоАгента. 1018.png
    • Уровень процесса: на странице хоста откройте страницу процесса, а затем выберите Запуск диагностики ЕдиногоАгента в меню обзора ( … ) на странице процесса.
  4. На странице диагностики Запуск диагностики ЕдиногоАгента кратко опишите, что, с вашей точки зрения, работает не так, как ожидалось.
  5. необязательный По умолчанию для анализа собираются данные за 24 часа (1 день). Если вам нужно больше данных, выберите Расширенные опции , измените количество дней и нажмите Применить .
  6. Нажмите Начать сбор .

Что будет дальше?

Ключ-АСТРОМ делает следующее:

  • Собирает диагностические данные за последние 24 часа (если вы не изменили настройки по умолчанию) затронутого хоста или процесса.
  • Сохраняет собранные диагностические данные
  • Загружает диагностические данные в контейнер S3 в регионе AWS вашей среды для дальнейшего анализа.

Состояния процесса

Столбец Состояние описывает текущую фазу процесса.

Состояние не обновляется автоматически. Выберите Обновить , чтобы проверить изменение состояния.
  • Collecting - Сбор данных продолжается. Во время сбора данных вы можете:
    • Обновите страницу, чтобы увидеть ход выполнения.
    • Отменить сбор диагностических данных.
  • Collected - Ключ-АСТРОМ закончил сбор диагностических данных. После сбора данных вы можете:
    • Анализировать, чтобы отправить собранные данные в Ключ-АСТРОМ для анализа.
    • Загрузить собранные данные локально для проверки.
    • Удалить проблему, включая собранные диагностические данные.
  • Sending in progress - Диагностические данные передаются в Ключ-АСТРОМ для анализа. При отправке данных вы можете:
    • Обновите страницу, чтобы увидеть ход выполнения.
    • Загрузить собранные диагностические данные.
    • Удалить проблему, включая собранные диагностические данные.
  • Sent to Astromkey cloud - Диагностические данные переданы в Ключ-АСТРОМ для анализа.
  • Analyzing - Ключ-АСТРОМ сейчас анализирует диагностические данные. Анализируя данные, вы можете:
    • Обновить страницу, чтобы увидеть ход выполнения.
    • Загрузить собранные диагностические данные.
    • Удалить проблему, включая собранные диагностические данные.
  • Analyzed - Анализ выполнен. Количество связанных оповещений указано в скобках. После анализа вы можете:
    • Загрузить собранные диагностические данные.
    • Удалить проблему, включая собранные диагностические данные.
  • Delete in progress - Диагностические данные удаляются. При удалении данных вы можете:
    • Обновить страницу, чтобы увидеть ход выполнения.
  • Deleted - Диагностические данные были удалены. Ключ-АСТРОМ хранит только небольшой набор информации о том, кто, когда, где и почему собирал диагностические данные.
  • Canceled - Процесс диагностики был отменен вручную до его завершения.

Просмотрите анализ Ключ-АСТРОМ

Когда анализ завершен, Ключ-АСТРОМ отправляет результаты обратно в вашу среду. Если потенциальное решение обнаружено, Ключ-АСТРОМ перечисляет его в разделе Alerts.

Локальный сбор и просмотр

Эта процедура описывает, как собирать диагностические данные для хоста или процесса локально. Используйте эту опцию, если вы предпочитаете собирать и просматривать данные перед тем, как вручную отправлять их в Ключ-АСТРОМ для анализа.

Если вместо этого вы хотите собирать данные и автоматически отправлять их в Ключ-АСТРОМ для анализа, см. раздел Автоматический анализ выше.

  1. Перейдите в раздел Хосты .
  2. Выберите хост, неполадки которого вы хотите устранить.
  3. Запустите диагностику на уровне хоста или процесса.
    • Уровень хоста: на странице хоста откройте меню обзора ( … ) и выберите пункт Запуск диагностики ЕдиногоАгента. 1018.png
    • Уровень процесса: на странице хоста откройте страницу процесса, а затем выберите Запуск диагностики ЕдиногоАгента в меню обзора ( … ) на странице процесса.
  4. На странице диагностики Запуск диагностики ЕдиногоАгента кратко опишите, что, с вашей точки зрения, работает не так, как ожидалось.
  5. Выберите ссылку Расширенные опции .
  6. Выбрать и хранить локально .
    • Пока вы здесь, вы также можете изменить количество дней, за которые будут собираться данные (по умолчанию = 1 day).
  7. Выберите Применить .
  8. Выберите Начать сбор , чтобы собрать диагностические данные и сохранить их локально.

Что будет дальше?

Ключ-АСТРОМ делает следующее:

  • Собирает диагностические данные за последние 24 часа (если вы не изменили настройки по умолчанию) затронутого хоста или процесса.
  • Сохраняет собранные диагностические данные
  • Загружает диагностические данные в контейнер S3 в регионе AWS вашей среды для дальнейшего анализа.

Состояния процесса

Столбец Состояние описывает текущую фазу процесса.

Состояние не обновляется автоматически. Выберите Обновить , чтобы проверить изменение состояния.
  • Collecting - Сбор данных продолжается. Во время сбора данных вы можете:
    • Обновите страницу, чтобы увидеть ход выполнения.
    • Отменить сбор диагностических данных.
  • Collected - Ключ-АСТРОМ закончил сбор диагностических данных. После сбора данных вы можете:
    • Анализировать, чтобы отправить собранные данные в Ключ-АСТРОМ для анализа.
    • Загрузить собранные данные локально для проверки.
    • Удалить проблему, включая собранные диагностические данные.

Что делать с собранными данными

Теперь, когда данные собраны, вы можете:

  • Загрузите собранные данные.
    • Вы можете просмотреть данные. Смотрите Содержание диагностических данных ниже для обзора того, что находится в загрузке.
    • Вы можете добавить данные в свой тикет в службу поддержки.
  • Проанализировать данные.
  • Удалить проблему, включая собранные диагностические данные.

Обзор диагностики ЕдиногоАгента

Для обзора всех запусков устранения неполадок ЕдиногоАгента в вашей среде

  1. Перейдите в раздел Хосты .
  2. Откройте меню обзора ( … ) и выберите Обзор диагностики ЕдиногоАгента . 1019.png

Страница обзора диагностики Ключ-АСТРОМ ЕдиногоАгента содержит список всех диагностических действий ЕдиногоАгента в вашей среде. Разверните любую запись, чтобы увидеть подробности. Если данные не были удалены (все диагностические данные автоматически удаляются через 30 дней), вы можете загрузить или удалить их.

Содержание диагностических данных

Все собранные диагностические данные сжимаются в ZIP-файл SupportArchive<ID number>, включающий следующие папки и файлы:

Папка или файл Описание
host (папка) Содержит snapshot топологической информации хост-сущности, включая любые связи с другими хостами.
monitored_entities (папка) Содержит snapshot топологической информации всех задействованных групп процессов, экземпляров групп процессов, служб и экземпляров служб.
agent_registration_entries (JSON-файл) Содержит информацию о том, какие модули кода ЕдиногоАгента подключены к Ключ-АСТРОМ.
archive (JSON-файл) Содержит информацию о том, кто, когда, где и почему собирал диагностические данные.
monitoring_state (JSON-файл) Содержит информацию о состоянии мониторинга процессов и связанных с ними проблемах.
support_archive (Почтовый индекс) Содержит локальную конфигурацию ЕдиногоАгента, установленного на хосте или в процессе, где вы запустили устранение неполадок, а также файлы логов, связанные с ЕдинымАгентом.
diagnostic_files (Почтовый индекс) Содержит информацию об обнаружении группы процессов, проблемах автовнедрения и конфигурации расширения ЕдиногоАгента.

Конфиденциальность данных

Для соблюдения региональных правил защиты данных и конфиденциальности Ключ-АСТРОМ выполняет следующие действия:

  • Маскирует некоторые персональные данные перед сохранением архива поддержки в Cassandra и загрузкой его в корзину AWS S3. Например, учетные данные IBAN и URI заменяются на <masked>. Однако некоторые персональные данные могут не маскироваться.
  • Записывает сообщения лога аудита при создании, анализе, доступе и удалении архивов поддержки для обеспечения прозрачности использования архивов поддержки.
  • Предоставляет доступ к архивам поддержки ЕдиногоАгента только пользователям, имеющим разрешение на просмотр среды конфиденциальных данных запросов .
  • Автоматически удаляет все диагностические данные через 30 дней после их сбора. Этот период хранения данных можно настроить. Вы также можете удалить собранные диагностические данные ранее вручную.