Блокноты

Блокноты

Приложение

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

Разрешения

В следующей таблице описаны необходимые разрешения.

Разрешение	Описание
app-engine:apps:run	Позволяет пользователю запускать приложения.
app-engine:functions:run	Позволяет пользователю запускать функции.
document:documents:read	Позволяет пользователю получать доступ к блокнотам.
document:documents:write	Позволяет пользователю создавать и обновлять блокноты.
document:documents:delete	Позволяет пользователю удалять блокноты.
document:trash.documents:read	Позволяет пользователю получать доступ к удалённым блокнотам.
document:trash.documents:delete	Позволяет пользователю безвозвратно удалять блокноты.
document:trash.documents:restore	Позволяет пользователю восстанавливать удалённые блокноты.
document:environment-shares:read	Позволяет пользователю получать доступ к общим блокнотам.
document:direct-shares:read	Позволяет пользователю получать доступ к общим блокнотам.
state:user-app-states:read	Позволяет приложению читать настройки пользователя, такие как последний блокнот или скрыта ли боковая панель.
state:user-app-states:write	Позволяет приложению записывать настройки пользователя.
state:user-app-states:delete	Позволяет приложению удалять настройки пользователя.
davis:analyzers:read	Позволяет пользователю читать конфигурацию анализаторов ИИ.
davis:analyzers:execute	Позволяет пользователю запускать анализаторы ИИ.
storage:events:read	Позволяет пользователю запрашивать записи из таблицы событий.
storage:logs:read	Позволяет пользователю запрашивать записи из таблицы логов.
storage:user.events:read	Позволяет пользователю запрашивать записи из таблицы пользовательских событий.
storage:metrics:read	Позволяет пользователю запрашивать записи из таблицы метрик.
storage:entities:read	Позволяет пользователю запрашивать сущности через хранилище.
storage:bizevents:read	Позволяет пользователю запрашивать записи из таблицы бизнес-событий.
storage:system:read	Позволяет пользователю запрашивать записи из всех системных таблиц.
storage:spans:read	Позволяет пользователю запрашивать записи из таблицы спанов.
storage:buckets:read	Позволяет пользователю запрашивать записи из бакетов хранилища.
storage:smartscape:read	Позволяет пользователю запрашивать записи из таблицы Smartscape.
storage:fieldsets:read	Позволяет пользователю запрашивать маскированные/конфиденциальные поля.
storage:bucket-definitions:read	Позволяет пользователю читать определения бакетов хранилища через функции.
storage:application.snapshots:read	Позволяет пользователю запрашивать записи из таблицы снимков приложений.
storage:user.sessions:read	Позволяет пользователю запрашивать записи из таблицы пользовательских сессий.
storage:filter-segments:read	Позволяет пользователю использовать сегменты.
storage:security.events:read	Позволяет пользователю запрашивать записи из таблицы событий безопасности.
storage:files:read	Позволяет пользователю читать данные из хранилища ресурсов.
storage:external-data:load	Позволяет пользователю читать содержимое и метаданные из внешних хранилищ данных.
storage:external-data:list	Позволяет пользователю перечислять объекты во внешних хранилищах данных.
automation:workflows:read	Позволяет пользователю читать рабочие процессы автоматизации через функции.
automation:calendars:read	Позволяет пользователю читать календари автоматизации через функции.
automation:rules:read	Позволяет пользователю читать правила автоматизации через функции.
settings:objects:read	Позволяет пользователю читать объекты настроек через функции.
settings:schemas:read	Позволяет пользователю читать схемы настроек через функции.
app-engine:edge-connects:read	Позволяет пользователю читать конфигурацию EdgeConnect через функции.
davis-copilot:nl2dql:execute	Позволяет пользователю использовать генеративный ИИ для генерации DQL из естественного языка.
davis-copilot:dql2nl:execute	Позволяет пользователю использовать генеративный ИИ для объяснения DQL на естественном языке.
davis-copilot:conversations:execute	Позволяет пользователю использовать генеративный ИИ для интерактивных диалогов.
hub:catalog:read	Позволяет приложению читать информацию о списке изменений.
credential-vault:entries:read	Позволяет приложению читать секреты из хранилища.

Сценарии использования

Блокноты позволяют:

• Запрашивать, анализировать и визуализировать все ваши данные безопасности, наблюдаемости и бизнес-данные, такие как логи, метрики и события, на основе хранилища.
• Прогнозировать будущие тенденции с помощью встроенных возможностей прогнозирования ИИ.
• Создавать интерактивные, управляемые данными и постоянные документы и совместно работать над ними.
• Получать и включать внешние данные, запуская функции Ключ-АСТРОМ.
• Взаимодействовать с данными; запускать детализацию через сортировку, фильтрацию и агрегацию или даже запускать рабочие процессы.
• Аннотировать и добавлять контекст с помощью Markdown.

Разделы блокнота

Блокнот может состоять из нескольких разделов:

• Explore: исследование данных, таких как логи, метрики и бизнес-события, с помощью интерфейса point-and-click.
• Query: отображение данных, запрошенных через хранилище.
• Code: отображение данных, возвращаемых кодом, выполняемым через функции Ключ-АСТРОМ.
• Markdown: статическое содержимое, редактируемое в разметке Markdown.

Разделы Explore

Вы можете использовать опции Explore для исследования логов, метрик, бизнес-событий и многого другого с помощью интерфейса point-and-click. Без знаний DQL или программирования вы можете создавать и начинать использовать разделы блокнота за считанные минуты.

Раздел Query

Разделы запросов позволяют легко запрашивать данные из хранилища и визуализировать результат различными способами.

Раздел запроса состоит из поля ввода запроса, где вы можете написать запрос DQL. В поле ввода запроса используйте Ctrl+Space для вызова автодополнения в любой момент.

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

Раздел Code

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

Раздел Markdown

Раздел Markdown может быть чем угодно — от небольшой заметки о чём-то в блокноте до целой страницы форматированной информации со ссылками и изображениями.

• Легко редактировать.
• Привлекательно выглядит.

Чтобы вставлять запросы из вашего блокнота с автодополнением, используйте Ctrl+Space.

Добавление ссылок

Вы можете ссылаться на другие места в вашем блокноте и вне его.

Ссылка в Markdown — это метка и ссылка вида [метка](адрес), где:

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

Ссылка на	Синтаксис и примеры
Веб-сайт	[Моя метка](https://www.example.com/)
Приложение Блокноты	[Моя метка](/ui/apps/astromkey.notebooks/notebooks)
Конкретный блокнот	Синтаксис: [метка](/ui/apps/astromkey.notebooks/notebook/<notebookid>) Пример: [Моя метка](/ui/apps/astromkey.notebooks/notebook/274edae4-dfe8-41fb-aced-5020fb1270bc)
Конкретный раздел блокнота	Синтаксис: [метка](/ui/apps/astromkey.notebooks/notebook/<notebookid>#<sectionid>) Пример: [Моя метка](/ui/apps/astromkey.notebooks/notebook/274edae4-dfe8-41fb-aced-5020fb1270bc#cb69caf1-52ed-4e73-8a3e-120e8cd7e8f8)
Приложение Дашборды	[Моя метка](/ui/apps/astromkey.dashboards/)
Конкретный дашборд	Синтаксис: [метка](/ui/apps/astromkey.dashboards/dashboard/<dashboardid>) Пример: [Моя метка](/ui/apps/astromkey.dashboards/dashboard/9f24c36e-ca5f-401c-8e00-5e4b05c46bd2)
Конкретная плитка дашборда	Синтаксис: [метка](/ui/apps/astromkey.dashboards/dashboard/<dashboardid>#tileIds=n) Пример: [Моя метка](/ui/apps/astromkey.dashboards/dashboard/9f24c36e-ca5f-401c-8e00-5e4b05c46bd2#from=now%28%29-2h&to=now%28%29&tileIds=6)

Советы по обучению

Быстрый способ узнать о блокнотах — открыть готовый блокнот, сделать копию и начать экспериментировать. При необходимости вы можете отменять и повторять действия.

Откройте готовый блокнот

Чтобы открыть готовый блокнот

1. Перейдите в Блокноты.
2. На панели Блокноты выберите Готовые блокноты.
3. Как вариант, вы можете выбрать Все блокноты, а затем изменить вкладку в верхней части таблицы с Все на Готовые.
4. Выберите блокнот, чтобы открыть его.

Сделайте копию

Чтобы сделать копию текущего блокнота

1. В верхней части блокнота откройте меню рядом с именем блокнота.
2. Выберите Дублировать из меню.

Как вариант, перейдите в раздел Последние открытые вами на боковой панели, наведите курсор на блокнот, который хотите скопировать, и выберите > Дублировать.

Отмена и повтор

Вы можете быстро отменить или повторить редактирование блокнота.

Элементы управления Отменить и Повторить отображаются в левом верхнем углу вашего блокнота после внесения изменения.

Если предпочитаете, вы можете использовать сочетания клавиш.

Отменить	Повторить
Windows: Ctrl+Z	Windows: Ctrl+Shift+Z
Mac: Cmd+Z	Mac: Cmd+Shift+Z

Количество отмен может быть ограничено в зависимости от размера вашего блокнота.

Использование блокнотов

Использование сочетаний клавиш

Сочетания клавиш помогают работать быстрее в Блокнотах.

Чтобы просмотреть список сочетаний клавиш, в Блокнотах откройте меню и выберите Сочетания клавиш или используйте сочетание Shift+?.

Действие	Сочетание клавиш
Общие
Закрыть раздел	Esc
Добавить раздел	Ctrl/Cmd+Shift+Enter
Переместить раздел вниз	Ctrl/Cmd+Alt+↓
Переместить раздел вверх	Ctrl/Cmd+Alt+↑
Удалить выбранные разделы	Del
Дублировать выбранные разделы	Ctrl/Cmd+Shift+D
Выбрать все	Ctrl/Cmd+A
Отменить	Ctrl/Cmd+Z
Повторить	Ctrl/Cmd+Shift+Z
Открыть с помощью…	O
Разделы данных
Добавить раздел	Shift+D
Запустить запрос	Ctrl/Cmd+Enter
Разделы кода
Добавить раздел	Shift+C
Выполнить код	Ctrl/Cmd+Enter
Разделы Markdown
Добавить раздел	Shift+M
Переключение между режимом просмотра и редактирования	Ctrl/Cmd+Enter

Список блокнотов

Чтобы просмотреть список блокнотов

1. Перейдите в Блокноты.
2. На панели Блокноты выберите Все блокноты.
3. Чтобы отсортировать таблицу, выберите заголовок Имя, Создан, Изменён или Открыт вами.
4. Чтобы отфильтровать таблицу, у вас есть несколько вариантов:
   • Все: список всех блокнотов.
   • Мои: список только блокнотов, которыми вы владеете.
   • Поделились со мной: список только блокнотов, которыми владеет кто-то другой, но которые предоставлены вам.
   • Готовые: список только готовых блокнотов. Вы можете дополнительно отфильтровать вкладку Готовые по источнику блокнота: Все готовые, Ключ-АСТРОМ, Расширения.
   • Корзина: список блокнотов в корзине.
   • Фильтр по имени или ID блокнота.
   • Владелец: фильтр по владельцу (доступен на вкладках Все и Поделились со мной).
   • Фильтр по меткам: фильтр по одной или нескольким меткам.

Найдите блокнот

Самый простой способ найти блокнот — через глобальный поиск.

Поиск можно вызвать из любого контекста, используя сочетание клавиш Ctrl/Cmd+K. Блокноты с совпадающими заголовками появятся в результатах.

Как вариант, выведите список всех блокнотов, затем введите поисковый запрос, чтобы отобразить только совпадающие блокноты.

Управление метками

Метки позволяют организовывать и фильтровать ваши блокноты. Вы можете добавить несколько меток к блокноту, а затем использовать Фильтр по меткам в списке блокнотов для сужения результатов.

Чтобы добавить или удалить метки на блокноте

1. Откройте меню рядом с именем блокнота.
2. Выберите Информация и метки.
3. В разделе Метки выберите поле Добавить метки и введите имя метки.
   • Чтобы назначить существующую метку, выберите её из предложений.
   • Чтобы создать новую метку, введите имя и нажмите Enter.
4. Чтобы удалить метку, выберите соответствующую кнопку рядом с именем метки.

Чтобы отфильтровать список блокнотов по метке

1. Перейдите в Блокноты > Все блокноты.
2. Выберите Фильтр по меткам и выберите одну или несколько меток. Вы также можете искать метку по имени.
3. Список обновляется, показывая только блокноты с выбранными метками.

Создание блокнота

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

1. Перейдите в Блокноты.
2. В заголовке приложения выберите Новый блокнот.
3. Теперь вам нужно создать один или несколько разделов в вашем блокноте. Подробности см. в разделе «Создание раздела».

Дублирование блокнота

Чтобы сделать копию текущего блокнота

1. В верхней части блокнота откройте меню рядом с именем блокнота.
2. Выберите Дублировать из меню.

Как вариант, перейдите в раздел Последние открытые вами на боковой панели, наведите курсор на блокнот, который хотите скопировать, и выберите > Дублировать.

Закрепление блокнота в Dock

Чтобы добавить блокнот в Dock для удобного доступа

1. Отобразите блокнот.
2. Откройте меню рядом с именем блокнота (в левом верхнем углу блокнота).
3. Выберите Добавить в dock.

Если вы измените имя блокнота, оно автоматически обновится в Dock.

Чтобы удалить блокнот из Dock

1. Наведите курсор на имя блокнота в Dock.
2. Выберите Открепить от dock.

Удаление блокнота

Чтобы удалить блокнот

1. В верхней части блокнота откройте меню рядом с именем блокнота.
2. Выберите Удалить из меню.

Как вариант, вы также можете вызвать то же действие в разделе Последние открытые вами на боковой панели. Выберите > Удалить.

Чтобы удалить несколько блокнотов, выберите Все блокноты и используйте соответствующие кнопки в таблице.

Создание раздела

Каждому блокноту нужен один или несколько разделов.

Создание раздела Prompt

Чтобы создать раздел блокнота с использованием агентного и генеративного ИИ Ключ-АСТРОМ Intelligence для перевода ваших вопросов на естественном языке в запросы DQL

1. Перейдите в Блокноты и откройте или создайте блокнот, который можете редактировать.
2. Откройте меню Добавить и выберите Prompt. Создаётся новый раздел генеративного ИИ с пустым полем ввода.
3. В поле ввода введите запрос. Попробуйте average cpu usage percentage by host или посмотрите примеры, отображаемые в веб-интерфейсе, для вдохновения.
4. Необязательно: если ваш запрос не указывает временной диапазон, вы всё равно можете указать его в заголовке раздела. По умолчанию — Последние 2 часа.
5. Выберите Запустить. Генеративный ИИ создаёт и выполняет запрос за вас.
6. Необязательно: если вы хотите увидеть сгенерированный запрос перед его выполнением, откройте меню рядом с кнопкой Запустить и выберите Сгенерировать только DQL.
7. Просмотрите результаты.
   • Вы можете просмотреть запрос, развернув DQL справа.
   • Необязательно: вы не можете редактировать запрос напрямую в генеративном ИИ, но у вас есть два варианта его повторного использования:
     • Скопируйте запрос и вставьте его в другое место вручную.
     • Откройте меню в заголовке раздела и выберите Создать раздел DQL, чтобы создать раздел DQL из этого запроса.
8. Вы можете отредактировать ваш исходный запрос, перегенерировать запрос и выполнить его для обновления результатов.
   • Если вы выбираете Перезапустить разделы, приложение Блокноты сначала проверит, были ли отредактированы какие-либо запросы.
     • Если запрос был отредактирован, DQL сначала будет перегенерирован, а затем выполнен.
     • Если никакие запросы не были отредактированы, существующий сгенерированный DQL будет просто выполнен.
9. Необязательно: выберите Параметры в заголовке раздела, чтобы изменить визуализацию.

Создание раздела Explore

Разделы Explore предлагают самый простой способ начать работу.

• Чтобы сначала узнать больше о разделах Explore, см. раздел «Исследование данных».
• Чтобы сразу приступить, просто отобразите блокнот, откройте меню Добавить и выберите опцию Explore, такую как Логи, Метрики, События, Проблемы или Бизнес-события.

Создание раздела Grail query

Самый быстрый и простой способ исследовать данные — с помощью раздела Explore. За несколько секунд вы можете найти и проанализировать свои логи, метрики или бизнес-события. DQL не требуется!

Устарело: поля dt.entity.*

Если вы видите следующее сообщение:

Поля dt.entity.* устарели. Пожалуйста, используйте поля dt.smartscape.* вместо них.

мы рекомендуем использовать эквивалентное поле dt.smartscape.*.

Устаревшие поля dt.entity.* в конечном итоге будут удалены.

Чтобы добавить данные в блокнот

1. Откройте меню Добавить и выберите DQL.
   • Сочетание клавиш: Shift+D
2. В блокнот добавляется пустой раздел, и справа открывается боковая панель Параметры.
3. В поле редактирования раздела используйте Ключ-АСТРОМ Query Language (DQL) для определения вашего запроса.
4. Выберите Запустить, чтобы выполнить запрос DQL.
   • Сочетание клавиш: Ctrl/Cmd+Enter
5. Блокноты автоматически визуализируют результат.
6. Выберите Добавить заголовок, чтобы добавить заголовок к этому разделу блокнота.
7. Выберите визуализацию, чтобы отобразить результаты в предпочитаемом формате. Настройте параметры визуализации по мере необходимости.

Автоматический выбор визуализации

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

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

Создание раздела кода

Чтобы добавить код, получающий данные для вашего блокнота с помощью функций Ключ-АСТРОМ

1. Откройте меню Добавить и выберите Код.
   • Сочетание клавиш: Shift+C
2. Блокноты создают раздел кода с примером кода JavaScript в поле редактирования.
3. Выберите Запустить, чтобы выполнить код.
   • Сочетание клавиш: Ctrl/Cmd+Enter
4. Блокноты выполняют пример кода и отображают результат: «Hello, world!»
5. Отредактируйте раздел по мере необходимости.
   • Чтобы изменить код, отредактируйте его непосредственно в поле редактирования над результатом. Подробности см. в разделе «Функции приложений».
   • Чтобы настроить визуализацию, выберите Параметры. Подробности см. в разделе «Редактирование визуализаций для Блокнотов и Дашбордов».

Чтобы попробовать пример раздела кода

1. В вашем блокноте откройте меню Добавить, прокрутите меню вниз до раздела Библиотека и выберите любой из примеров раздела кода.
2. Это добавит выбранный пример раздела кода в ваш блокнот.
3. Прочитайте комментарии в примере кода для получения важных сведений.

Создание раздела Markdown

Чтобы добавить раздел в формате Markdown в блокнот

1. Откройте меню Добавить и выберите Markdown.
   • Сочетание клавиш: Shift+M
2. Введите ваш текст. Используйте Markdown для форматирования текста и добавления ссылок и изображений.
   • Во время ввода в поле редактирования ваш Markdown отображается в разделе.
   • Нажмите Ctrl+Space на пустой строке, чтобы вызвать список доступных элементов Markdown.
   • Вы можете использовать панель инструментов для вставки общих элементов, таких как заголовок, полужирный текст или ссылка:
     • Курсив: оберните текст в одинарные звёздочки (*вот так*), чтобы получить курсив.
     • Полужирный: оберните текст в двойные звёздочки (**вот так**), чтобы получить полужирный текст.
     • Зачёркивание: оберните текст в двойные тильды (~~вот так~~), чтобы получить зачёркнутый текст.
     • Цитата: начните строку с >, чтобы получить цитату.
     • Код:
       • Оберните текст в обратные кавычки (`вот так`), чтобы получить код.
       • Оберните текст в тройные обратные кавычки (```вот так```), чтобы показать блок кода.
     • Заголовки: начните строку с одного или нескольких символов # для создания заголовков.
     • Горизонтальная линия: добавьте горизонтальную линию тремя дефисами (---).
     • Списки: каждая строка неупорядоченного (маркированного) списка начинается со звёздочки (*):
       • Строка 1
       • Строка 2
       • Как вариант, можно использовать дефис (-).
       • Упорядоченный (нумерованный) список начинается с числа и точки (1.), за которыми следует пробел и ваш текст.
     • Таблицы: чтобы добавить таблицу, определите заголовки, строку форматирования столбцов, а затем строки данных.
     • Специальные символы: вы можете использовать любые печатаемые символы, включая эмодзи.
     • Ссылки: вы можете ссылаться на другие места в вашем блокноте и вне его (см. синтаксис выше).
     • Изображения: есть три способа добавить изображение в Markdown:
       • Добавить URL изображения.
       • Загрузить файл изображения в библиотеку.
       • Выбрать изображение из библиотеки.
     • Чтобы добавить изображение в ваш Markdown**:
       • Добавьте или отредактируйте Markdown.
       • На панели инструментов Markdown выберите соответствующий значок и выберите источник изображения:
         • Вставить из URL: чтобы добавить ссылку на изображение, используя формат: ![альтернативный текст](https://www.example.com/file-name.jpg).
         • Загрузить изображение: чтобы загрузить ваш файл изображения в библиотеку изображений и добавить его в ваш Markdown.
         • Медиатека: чтобы выбрать изображение из библиотеки уже загруженных вами изображений.

Начните с предопределённого раздела

Используйте предопределённые разделы из библиотеки, чтобы начать свой путь в аналитике данных.

Чтобы добавить предопределённый раздел в блокнот

1. В блокноте выберите Добавить.
   • Сочетание клавиш: Ctrl/Cmd+Shift+Enter
2. Прокрутите вниз до раздела Библиотека и выберите предопределённый раздел. Например, выберите Последние логи, который отображается на панели предварительного просмотра.

Поиск

Используйте поле поиска в верхней части меню, чтобы найти раздел по имени.

Когда вы выбираете предопределённый раздел, он добавляется в ваш блокнот.

Отредактируйте запрос или код (в зависимости от выбранного раздела) и настройки визуализации по мере необходимости.

Выберите Запустить, чтобы увидеть результаты.

• Сочетание клавиш: Ctrl/Cmd+Enter

Список доступных предопределённых разделов обширен и постоянно растёт. Создайте новый блокнот и попробуйте их.

Когда найдёте что-то интересное:

• Изучите это, чтобы понять, как это работает.
• Посмотрите, сможете ли вы доработать и адаптировать это под свои задачи.

Добавление аннотаций в раздел

Аннотации отмечают события — такие как развёртывания, инциденты или изменения конфигурации — на графиках временных рядов раздела, позволяя вам коррелировать поведение метрик с реальными событиями во время анализа.

В Блокнотах аннотации специфичны для раздела, к которому они добавлены. Здесь нет глобального управления аннотациями, как в Дашбордах** — каждый раздел управляет своими аннотациями независимо. Аннотации автоматически обновляются при каждом перезапуске раздела.

Аннотации доступны только для визуализаций линия, область и столбец.

Чтобы добавить аннотацию в раздел

1. Выберите раздел, отображающий линейный график, график области или столбчатую диаграмму.
2. Выберите Параметры, чтобы открыть панель Параметры.
3. Прокрутите до раздела Аннотации и выберите соответствующую кнопку, затем выберите тип аннотации:
   • DQL: определите аннотации с помощью запроса DQL.
   • Код: определите аннотации с помощью кода JavaScript.
   • Оповещение: выберите одно или несколько оповещений из вашей среды.
4. Определите данные аннотации:
   • DQL: напишите запрос в редакторе или выберите одну из кнопок-примеров под редактором запроса (например, Открытые оповещения) для вставки готового запроса.
   • Код: напишите код JavaScript в редакторе или выберите одну из кнопок-примеров под редактором кода (например, Пользовательские события) для вставки готового примера.
   • Оповещение: установите флажки рядом с оповещениями, которые хотите использовать в качестве источников аннотаций. Используйте фильтр типа оповещения в верхней части таблицы, чтобы сузить результаты по Пользовательское оповещение, Облачное оповещение или Фронтенд-оповещение.
5. Выберите Запустить, чтобы получить данные, затем выберите вкладку Предварительный просмотр, чтобы проверить, как аннотации отображаются на графике.
6. Настройте Сопоставление данных по мере необходимости. Поля сопоставляются автоматически, но вы можете уточнить эти настройки.
7. Настройте Настройки отображения по мере необходимости.
   • Закрепить индикатор: когда это выбрано, линия и области на самом графике (под маркерами) подсвечиваются, чтобы соответствовать аннотации для события.
   • Цвет: цвет аннотации и закреплённого индикатора.
   • Значок: значок для отображения на аннотации.
8. Закройте редактор, чтобы вернуться к вашему разделу.

Чтобы управлять аннотациями в разделе

1. Выберите раздел.
2. Выберите Параметры, затем прокрутите и разверните раздел Аннотации.
3. Откройте меню рядом с именем аннотации и выберите действие:
   • Редактировать открывает аннотацию в редакторе.
   • Переименовать делает имя аннотации редактируемым.
     • Как вариант, вы можете дважды щёлкнуть по имени в списке аннотаций.
   • Переместить вверх или Переместить вниз перемещает выбранную аннотацию выше или ниже в списке аннотаций.
     • Как вариант, вы можете перетаскивать аннотации вверх или вниз по списку.
     • Почему важен порядок аннотаций: если на графике есть несколько событий одновременно, аннотация, расположенная выше в списке, отображается поверх одновременных событий на графике. Упорядочивайте аннотации от наиболее важных к наименее важным.
   • Дублировать создаёт копию выбранной аннотации с префиксом copy_ перед исходным именем.
   • Удалить удаляет выбранную аннотацию.

Редактирование раздела

Отмена и повтор

Вы можете быстро отменить или повторить редактирование блокнота.

Элементы управления Отменить и Повторить отображаются в левом верхнем углу вашего блокнота после внесения изменения.

Если предпочитаете, вы можете использовать сочетания клавиш.

Отменить	Повторить
Windows: Ctrl+Z	Windows: Ctrl+Shift+Z
Mac: Cmd+Z	Mac: Cmd+Shift+Z

Количество отмен может быть ограничено в зависимости от размера вашего блокнота.

Элементы управления редактированием раздела

Чтобы увидеть команды редактирования для раздела, выберите раздел. Если у вас есть разрешение на редактирование, команды редактирования отображаются.

• Перетаскивание раздела за соответствующую ручку перемещает выбранный раздел на другую позицию.
• Запустить запускает ваш запрос. Сочетание клавиш: Ctrl/Cmd+Enter
• Устанавливает сегмент.
• Отображает параметры временного диапазона.
• Уменьшает и увеличивает временной диапазон.
• Скрывает и показывает ввод.
• Открывает панель параметров, где вы можете выбрать и настроить визуализацию.
• Открывает меню дополнительных опций:
  • Копировать раздел копирует выбранный раздел в буфер обмена.
  • Дублировать раздел создаёт копию выбранного раздела.
  • Создать раздел DQL создаёт раздел DQL из выбранного раздела Explore.
  • Переместить раздел вверх и Переместить раздел вниз перемещают раздел на одну строку вверх или вниз.
  • Очистить результат очищает результат.
  • Удалить раздел удаляет раздел из блокнота.
  • Объяснить запрос отображает сгенерированное ИИ резюме запроса.
  • Ключ-АСТРОМ Query Language открывает документацию по DQL.
  • Копировать ссылку на запрос копирует ссылку в буфер обмена.
  • Скачать результат скачивает (экспортирует) результат текущего раздела блокнота.
  • Дашборды Добавить на дашборд открывает выбранный раздел в дашборде.
  • Открыть с помощью открывает раздел в другом документе. Подробности см. в разделе «Детализация и навигация».

Вы можете выбрать несколько разделов и затем применить одну и ту же команду ко всем сразу. Подробности см. в разделе «Управление несколькими разделами».

Панели редактирования разделов

Доступные параметры редактирования различаются в зависимости от типа редактируемого раздела.

• Раздел Prompt: введите текстовый запрос в поле редактирования и выберите Запустить (или Ctrl+Enter), чтобы получить ответ.
• Раздел данных Explore: эти разделы — отличный быстрый путь к результатам. Дополнительную информацию о разделах Explore см. в разделе «Исследование данных».
• Раздел DQL
• Раздел Code
• Раздел Markdown

Выбор сегментов раздела

Чтобы отфильтровать данные для раздела, вы можете указать сегменты для раздела.

1. На панели действий для этого раздела выберите соответствующую кнопку и в разделе Фильтровать по сегментам выберите сегмент.
2. Если сегмент требует дополнительного выбора значения, выберите его сейчас.
3. Чтобы добавить другой сегмент, выберите Сегмент. Повторите этот шаг для каждого сегмента, который хотите добавить для выбранного раздела блокнота.
4. Выберите Применить, чтобы применить выбор.

Селектор сегментов для этого раздела теперь отображает имя выбранного сегмента или, если вы выбрали более одного сегмента, количество выбранных сегментов.

• Чтобы изменить выбор сегмента, выберите селектор снова, внесите изменения и выберите Применить.
• Чтобы управлять сегментами в целом, выберите селектор и затем выберите ссылку Управление сегментами.

Настройка параметров раздела

Чтобы открыть панель «Параметры»** (где вы можете выбрать и настроить визуализацию для вашего раздела)

1. Выберите раздел.
2. Выберите Параметры.

Управление разделами

Просмотр и управление разделами

Чтобы навигировать и реорганизовывать блокноты — особенно большие блокноты — используйте панель Разделы.

1. Выберите Настройки в правом верхнем углу блокнота, чтобы отобразить панель настроек блокнота.
2. Выберите Разделы, чтобы отобразить панель Разделы блокнота, которая перечисляет все разделы в текущем блокноте.
3. Как вариант, вы можете открыть меню с количеством разделов в правом верхнем углу блокнота и выбрать Управление разделами.

Из панели Разделы:

• Чтобы перейти к разделу, выберите имя раздела на панели Разделы.
• Чтобы переместить раздел, перетащите его на новую позицию на панели Разделы.
• Откройте меню для быстрого доступа к другим командам раздела:
  • Переименовать делает имя выбранного раздела редактируемым.
  • Как вариант, вы можете дважды щёлкнуть по имени раздела на панели Разделы, чтобы сделать его редактируемым.
  • Дублировать создаёт копию выбранного раздела и вставляет её под выбранным разделом.
  • Скрыть скрывает выбранный раздел и делает имя раздела серым на панели Разделы.
  • Показать снова отображает раздел.
  • Удалить удаляет выбранный раздел из вашего блокнота.
  • Открыть с помощью открывает выбранный раздел в другом приложении Ключ-АСТРОМ (например, Дашборды).

Отмена и повтор

См. выше.

Перемещение раздела

1. Отобразите панель Разделы.
2. Выберите и перетащите раздел на новую позицию на панели Разделы. Это автоматически переместит соответствующий раздел в блокноте.

Альтернативный способ 1:

1. Выберите раздел в вашем блокноте.
2. На панели редактирования раздела выберите и перетащите раздел на новое место в блокноте.

Альтернативный способ 2:

1. Выберите раздел в вашем блокноте.
2. На панели редактирования раздела откройте меню и выберите Переместить раздел вверх или Переместить раздел вниз.
   • Сочетание клавиш: Ctrl/Cmd+Alt+↑** или **Ctrl/Cmd+Alt+↓.

Копирование и вставка разделов

Вы можете копировать и вставлять разделы в тот же блокнот или в другой блокнот.

Простой способ начать новый блокнот — скопировать многоразовые разделы из существующих блокнотов в новый блокнот, а затем отредактировать скопированные разделы в новом блокноте.

Чтобы скопировать и вставить один или несколько разделов

1. Щёлкните по одному разделу, чтобы выбрать его.
   • Вы можете выбрать несколько разделов и затем скопировать все сразу.
     • Shift+Click** — выбирает один или несколько последовательных разделов.
     • **Ctrl/Cmd+Click** — выбирает один или несколько непоследовательных разделов.
     • **Ctrl/Cmd+A** — выбирает все разделы.
   • Каждый выбранный раздел выделяется.
2. Нажмите Ctrl/Cmd+C, чтобы скопировать выбранные разделы в буфер обмена.
   • Альтернатива в меню: на панели команд раздела выберите Копировать раздел.
3. Нажмите Ctrl/Cmd+V, чтобы вставить скопированные разделы.
   • Вставка скопированных разделов в текущий блокнот эквивалентна команде меню > Дублировать раздел.
   • Чтобы вставить скопированные разделы в другой блокнот, переключитесь на другой блокнот (или выберите Блокнот, чтобы создать пустой блокнот), затем вставьте (Ctrl/Cmd+V) скопированные разделы туда.
4. Чтобы переместить скопированные разделы на новые позиции, выберите и перетащите их по мере необходимости.
   • Вы можете выбрать и перетащить один или несколько разделов за раз.
     • Shift+Click** — выбирает один или несколько последовательных разделов.
     • **Ctrl/Cmd+Click** — выбирает один или несколько непоследовательных разделов.
     • Элемент управления отображается на последнем выбранном разделе.

Удаление раздела

Чтобы удалить раздел из вашего блокнота

1. Отобразите панель Разделы.
2. Откройте меню и выберите Удалить.

Альтернативный способ:

1. Выберите раздел.
2. На панели редактирования раздела откройте меню и выберите Удалить раздел.
   • Сочетание клавиш: Del.

Копирование ссылки на раздел

Чтобы скопировать ссылку на раздел

1. Выберите раздел.
2. Выберите > Копировать ссылку [тип раздела].

Скачивание результатов раздела

Чтобы скачать (экспортировать) результат текущей плитки дашборда или раздела блокнота в локальный файл

1. Выберите плитку или раздел.
2. На панели команд откройте меню и выберите Скачать результат > [формат].

Доступные форматы зависят от визуализации.

• CSV: результат скачивается в локальный файл с разделителями-запятыми (*.csv). Этот параметр включает форматирование таблицы.
• CSV (необработанный): результат скачивается в локальный файл с разделителями-запятыми (*.csv). Этот параметр включает полные неформатированные данные.
• JSON: результат скачивается в локальный файл JSON (*.json).

Некоторые визуализации не предлагают возможности скачать результат.

Возможная проблема с импортом CSV в Excel

Когда вы экспортируете результаты в файл CSV** — будь то **CSV** или **CSV (необработанный)** — с разрывами строк в любом столбце/поле результата, а затем открываете файл в **Microsoft Excel** или пытаетесь преобразовать файл в таблицу с помощью опции Excel **Данные > Текст по столбцам**, вы можете столкнуться с проблемой, когда разрывы строк неправильно отображаются в Excel. Это вызвано ограничением Excel.

Чтобы избежать этой проблемы, используйте опцию Excel Данные > Из текста/CSV.

Редактирование блокнота только для чтения

Когда вы открываете документ (дашборд или блокнот), на который у вас нет прав на запись, вы всё равно можете редактировать документ во время сессии. После завершения у вас есть два варианта:

• Сохранить изменения в новый документ.
• Отменить изменения.

Пример:

1. Перейдите в Блокноты, откройте список готовых блокнотов и выберите блокнот Начало работы.
2. В левом верхнем углу рядом с именем документа указано Готовый.
3. Выберите раздел линейного графика и затем выберите Параметры.
4. Измените визуализацию с линии на область.
5. Теперь вам предлагаются две кнопки: Сохранить как новый и Отменить изменения.
6. Используйте обновлённый блокнот по мере необходимости. У вас есть полный доступ на редактирование для этой сессии.
7. Когда закончите, выберите, что делать с изменениями:
   • Сохранить как новый — сохраняет изменения в новой копии отредактированного блокнота.
   • Отменить изменения — отменяет изменения и возвращает вас к неотредактированному блокноту только для чтения.

Управление несколькими разделами

Вы можете выбрать несколько разделов и затем применить одну и ту же команду ко всем сразу.

• Shift+Click** — выбирает один или несколько последовательных разделов.
• **Ctrl/Cmd+Click** — выбирает один или несколько непоследовательных разделов.
• **Ctrl/Cmd+A** — выбирает все разделы.

Меню с количеством разделов в правом верхнем углу блокнота предлагает команды, применяемые ко всем разделам:

• Выбрать все выбирает все разделы в блокноте.
• Запустить все запускает все разделы в блокноте.

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

• Перетаскивание выбранных разделов на другую позицию.
• Запустить x запускает все выбранные разделы.
• Устанавливает сегменты для всех выбранных разделов.
• Устанавливает временной диапазон для всех выбранных разделов.
• Скрывает и показывает ввод для всех выбранных разделов.
• Открывает меню дополнительных опций:
  • Дублировать разделы создаёт копию выбранных разделов.
  • Очистить результаты очищает результаты выбранных разделов.
  • Удалить разделы удаляет выбранные разделы из блокнота.
  • Дашборды Добавить на дашборд открывает выбранные разделы в дашборде.
  • Открыть с помощью открывает выбранные разделы в другом документе.

Запуск раздела

Запуск кода

Чтобы запустить раздел кода

1. Выберите раздел.
2. Выберите Запустить.

После запуска раздела кода вы можете очистить результаты кода:

1. Выберите раздел.
2. Выберите > Очистить результат.

Показать/скрыть код

Чтобы отобразить код в разделе кода

1. Выберите раздел.
2. Выберите Показать код.

Код отображается на панели над разделом.

Чтобы снова скрыть панель кода, выберите Скрыть код.

Запуск запроса

Чтобы запустить раздел запроса

1. Выберите раздел.
2. Выберите Запустить.

После запуска раздела запроса вы можете очистить результаты запроса:

1. Выберите раздел.
2. Выберите > Очистить результат.

Показать/скрыть запрос

Чтобы отобразить запрос в разделе запроса

1. Выберите раздел.
2. Выберите Показать запрос.

Запрос отображается на панели над разделом.

Чтобы снова скрыть панель запроса, выберите Скрыть запрос.

Совместное использование с другими

Совместное использование блокнота

Если вы владеете дашбордом или блокнотом, вы можете поделиться им.

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

• Доступ для всех (только просмотр): предоставить доступ только для просмотра всем в вашей среде Ключ-АСТРОМ.
• Поделиться доступом: создать и поддерживать список пользователей и групп пользователей с доступом к документу.
• Поделиться ссылками: создать ссылки (URL), указывающие на ваш документ, и распространить их по удобным вам каналам (например, электронная почта).

Эти методы не являются взаимоисключающими. Например, вы можете вести список пользователей для постоянного доступа к документу и создавать и распространять ссылки только для просмотра для более широкой аудитории по мере необходимости.

В любом случае вы контролируете, могут ли люди редактировать документ или только просматривать его.

Подробности о совместном использовании документов см. в разделе «Совместное использование документов».

Вы также можете экспортировать блокнот как файл JSON и отправить JSON другим, и затем они смогут импортировать JSON.

Экспорт блокнота

Чтобы экспортировать блокнот

1. В верхней части блокнота откройте меню рядом с именем блокнота.
2. Выберите Скачать из меню.

Как вариант, вы также можете вызвать то же действие в разделе Последние открытые вами на боковой панели. Выберите > Экспортировать как JSON.

Импорт блокнота

Чтобы импортировать блокнот из файла JSON

1. Выберите Все блокноты на боковой панели документов.
2. В правом верхнем углу страницы откройте меню и выберите Загрузить. Откроется окно файлового браузера.
3. Найдите и откройте файл JSON-определения блокнота.

Определение импортируется как новый блокнот и отображается на странице Блокноты с Последним изменением, установленным на дату и время импорта.

Смена владельца блокнота

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

1. Откройте меню документа и выберите Сменить владельца.
2. Найдите и выберите нового владельца, затем выберите Сменить владельца.

Когда вы меняете владельца документа, вы немедленно теряете доступ к документу.

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

Печать или экспорт в PDF

Чтобы распечатать блокнот или экспортировать его в PDF

1. Откройте ваш блокнот.
2. Необязательно: подготовьте разделы блокнота к печати. Например:
   • Выберите Запустить, чтобы получить последний результат перед печатью.
   • Выберите Скрыть ввод, чтобы скрыть запрос раздела и отобразить только результат.
   • Настройте параметры визуализации, например скрытие конфиденциальных или неактуальных столбцов таблицы, которые вы не хотите печатать и распространять.
3. В меню блокнота выберите Версия для печати.

Печатная версия блокнота отображается на странице Предварительный просмотр печати с настройками печати в верхней части.

1. Выберите размер страницы (A4 или US Letter) и ориентацию (Книжная или Альбомная), затем выберите Печать.
2. Блокнот отображается в окне параметров печати. Каждый раздел блокнота печатается на новой странице.
3. Внесите дополнительные настройки печати по мере необходимости, затем выберите Сохранить или Печать (в зависимости от назначения печати), чтобы завершить.

Известные ограничения печати

• При печати в альбомном режиме таблица может перекрывать следующий раздел.
• Когда Ключ-АСТРОМ находится в тёмном режиме, печать блокнота использует цветовые схемы тёмного режима. Чтобы избежать этого, вы можете временно переключить Ключ-АСТРОМ в светлый режим: из пользовательского меню Ключ-АСТРОМ (в левом нижнем углу Ключ-АСТРОМ) выберите Внешний вид > Светлый.

Анализ данных

Анализ данных с помощью ИИ

Чтобы анализировать данные с помощью анализаторов данных Ключ-АСТРОМ Intelligence

Исследуйте временной ряд.

Пример:

В вашем документе (дашборде или блокноте):

1. Выберите соответствующую кнопку, чтобы добавить новый раздел или плитку, затем выберите Метрики для исследования метрик.
2. В разделе Выбрать метрику выберите Инфраструктура > CPU > CPU usage %.
3. Установите Разделить по в host.name.
4. Установите Лимит на максимальное количество серий для анализа. Анализатор данных Ключ-АСТРОМ Intelligence в настоящее время поддерживает анализ до 1000 серий.
5. Запустите запрос.
6. На панели параметров справа прокрутите вниз и разверните ИИ.
7. На панели ИИ установите Анализаторы на анализатор, который хотите использовать, и затем настройте анализатор.
   • Обзор обнаружения аномалий см. в разделе «Обнаружение аномалий».
   • Подробности о настройках обнаружения аномалий см. в разделе «Конфигурация обнаружения аномалий».
   • Подробности о настройках анализатора прогнозирования см. в разделе «Предиктивный анализ ИИ Ключ-АСТРОМ Intelligence».

Обнаружение аномалий: Автоадаптивное пороговое обнаружение аномалий

• Количество колебаний сигнала** — сколько раз колебание сигнала добавляется к базовой линии для получения фактического порога для оповещения.
• **Условие оповещения** — ваш выбор зависит от того, хотите ли вы знать, когда метрика выше, ниже или вне (выше или ниже) нормального диапазона.
• Подробности см. в разделе «Конфигурация обнаружения аномалий».

Обнаружение аномалий: Сезонное базовое обнаружение аномалий

• Допуск** — чем выше допуск, тем шире доверительная полоса, что приводит к меньшему количеству срабатываний.
• **Условие оповещения** — ваш выбор зависит от того, хотите ли вы знать, когда метрика выше, ниже или вне нормального диапазона.
• Подробности см. в разделе «Конфигурация обнаружения аномалий».

Обнаружение аномалий: Статическое пороговое обнаружение аномалий

• Порог** — жёсткий предел, который метрика не должна нарушать.
• **Единица измерения** — единица значения.
• **Условие оповещения** — ваш выбор зависит от того, хотите ли вы знать, когда метрика выше или ниже порогового значения.
• **Предложить порог** — ИИ может помочь вам найти правильный порог на основе исторических данных.
• Подробности см. в разделе «Конфигурация обнаружения аномалий».

Прогнозирование: Прогноз

• Точки данных для прогнозирования** — общее количество шагов, на которые прогнозируется временной ряд. Большее количество шагов обычно приводит к менее надёжным прогнозам и более длительному времени выполнения анализатора.
• **Смещение прогноза** — смещение для начала прогноза.
• Подробности см. в разделе «Предиктивный анализ ИИ Ключ-АСТРОМ Intelligence».

Расширенные настройки (для обнаружения аномалий)

Вы можете использовать значения по умолчанию или включить Показать расширенные свойства для точной настройки этих параметров.

• Оповещать о missing data** — оповещать, если данные не обнаружены в скользящем окне.
• **Нарушающие образцы** — количество образцов в скользящем окне, которые должны нарушить, чтобы вызвать событие.
• **Скользящее окно** — количество образцов, формирующих скользящее окно.
• **Образцы для снятия оповещения** — количество образцов в скользящем окне, которые должны вернуться к норме, чтобы закрыть событие.

По умолчанию анализатор не включён. Чтобы включить его, переключите переключатель в верхней части панели редактирования (переключите с Анализ данных ИИ не активен на Анализ данных ИИ активен).

Чтобы просмотреть результаты, выберите визуализацию Анализ ИИ и разверните раздел графика Анализ ИИ, чтобы просмотреть или изменить настройки, специфичные для визуализации.

Визуализация Анализ ИИ имеет два раздела: график и визуализация. Вы можете использовать настройку Видимые разделы для отображения одного или обоих из них.

• Все** — показать график и таблицу. График отражает выбор в вашей таблице.
• **Таблица** — показать только таблицу.
• **График** — показать только график.

Пример: аномальный процент использования CPU

Чтобы обнаружить, когда процент использования CPU превышает 70 процентов, в вашем документе (дашборде или блокноте):

1. Выберите соответствующую кнопку, чтобы добавить новый раздел или плитку, затем выберите Метрики для исследования метрик.
2. В разделе Выбрать метрику выберите Инфраструктура > CPU > CPU usage %.
3. Установите Разделить по в host.name.
4. Установите Лимит на максимальное количество серий для анализа.
5. Выберите Запустить.
6. На панели редактирования разверните ИИ.
7. В списке Анализаторы выберите Статическое пороговое обнаружение аномалий.
8. Установите Порог равным 70 (введите значение) и Условие оповещения — Оповещать, если метрика выше (по умолчанию).
9. Активируйте анализатор: в верхней части панели редактирования переключите с Анализ данных ИИ не активен на Анализ данных ИИ активен.
10. Чтобы просмотреть результаты, выберите визуализацию Анализ ИИ.
11. В разделе графика Анализ ИИ установите Видимые разделы на Все.
12. Просмотрите результаты.

Запуск анализа прогноза

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

В этом примере мы выдаём следующий запрос:

timeseries avg(dt.host.cpu.usage), by:{ dt.entity.host }

и затем запускаем прогноз для временного ряда, выбранного в результатах.

1. В блокноте выберите > DQL.
2. Введите запрос, такой как timeseries avg(dt.host.cpu.usage), by:{ dt.entity.host }, чтобы построить график временного ряда.
3. Выберите Запустить запрос.
4. Наведите курсор на нужный временной ряд на боковой панели и выберите > Фильтровать и прогнозировать.

Запрос автоматически обновляется для фильтрации по выбранному временному ряду, и график расширяется, чтобы показать прогноз для выбранного ряда.

Подробности см. в разделе «Предиктивный анализ ИИ Ключ-АСТРОМ Intelligence».