Документация АппОптима - Вклад [ru]

GET все SLO

2024-10-14T18:16:08Z

ENetrebin:

'''''API Ключ-АСТРОМ / [https://doc.ruscomtech.ru/index.php/API_%D0%9A%D0%BB%D1%8E%D1%87-%D0%90%D0%A1%D0%A2%D0%A0%D0%9E%D0%9C#.D0.A0.D0.B0.D0.B7.D0.B2.D1.91.D1.80.D1.82.D1.8B.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5 Развёртывание] / Цели уровня обслуживания (SLO) / GET все SLO'''''

Перечисляет все цели уровня обслуживания и их расчетные значения.

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

# Установите для параметра timeFrame<code>GTF</code> значение .
# Укажите временные рамки в параметрах from и to .

Запрос создает в качестве нагрузки <code>application/json</code> объект.
{| class="wikitable"
| rowspan="2" |GET
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/slo</nowiki></code>
|-
|Среда АктивногоШлюза
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/slo</nowiki></code>
|}

== Аутентификация ==
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Read SLO ( <code>slo.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!In
!Необходимость
|-
|nextPageKey
|string
|Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.

Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey .

Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса.
|query
|по желанию
|-
|pageSize
|integer
|Количество SLO в полезной нагрузке одного ответа.

Максимально допустимый размер страницы — 10000.

Если не установлено, используется 10.
|query
|по желанию
|-
|from
|string
|Начало запрошенного таймфрейма.

Вы можете использовать один из следующих форматов:

* Отметка времени в миллисекундах UTC.
* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.
* Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма:
** <code>m</code>: минуты
** <code>h</code>: часы
** <code>d</code>: дни
** <code>w</code>: недели
** <code>M</code>: месяцы
** <code>y</code>: годы

Если не задано, используется относительный двухнедельный таймфрейм ( <code>now-2w</code>).
|query
|по желанию
|-
|to
|string
|Конец запрошенного периода времени.

Вы можете использовать один из следующих форматов:

* Отметка времени в миллисекундах UTC.
* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.
* Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма:
** <code>m</code>: минуты
** <code>h</code>: часы
** <code>d</code>: дни
** <code>w</code>: недели
** <code>M</code>: месяцы
** <code>y</code>: годы

Если не установлено, используется текущая метка времени.
|query
|по желанию
|-
|sloSelector
|string
|Объем запроса. В ответ включаются только SLO, соответствующие заданным критериям.

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

* Идентификатор: идентификатор ("идентификатор"). Фильтры для SLO с заданным идентификатором.
* Имя: имя("имя"). Фильтры для SLO с заданным названием. Фильтр чувствителен к регистру.
* Состояние работоспособности: HealthState("ЗДОРОВО") или HealthState("НЕЗДОРОВО"). Можно указать только одно состояние работоспособности.
* Текст: текст ("значение"). Фильтры для всех SLO, которые содержат данное значение в своем имени или описании. Фильтр нечувствителен к регистру.
* Проблема: имя_проблемы("значение"). Фильтры для всех SLO, связанных с данным отображаемым именем проблемы (например, P-12345).

Чтобы задать несколько критериев, разделите их запятой (,). В ответ включаются только результаты, соответствующие всем критериям. например, .../api/v2/slo?sloSelector=name("Доступность службы"), .../api/v2/slo?sloSelector=id("id"), .../api/v2/slo ?sloSelector=текст("Описание"),healthState("ЗДОРОВО").

Специальные символы ~ и " необходимо экранировать с помощью символа ~ (например, текст поиска в двойных кавычках ("~"").
|query
|по желанию
|-
|sort
|string
|Сортировка записей SLO:

* <code>name</code>: Имена в порядке возрастания.
* <code>-name</code>: Имена в порядке убывания.

Если не установлено, используется восходящий порядок.
|query
|по желанию
|-
|timeFrame
|string
|Таймфрейм для расчета значений SLO:

* <code>CURRENT</code>: собственный таймфрейм SLO.
* <code>GTF</code>: период времени, заданный параметрами from и to .

Если не задано, используется <code>CURRENT</code>значение.

Элемент может содержать эти значения

* <code>CURRENT</code>
* <code>GTF</code>
|query
|по желанию
|-
|demo
|boolean
|Получите свои SLO ( <code>false</code>) или набор демонстрационных SLO ( <code>true</code>).
|query
|по желанию
|-
|evaluate
|boolean
|Получите SLO без их оценки ( <code>false</code>) или с оценками ( <code>true</code>) с максимальным <code>pageSize</code>количеством 25.
|query
|по желанию
|-
|enabledSlos
|string
|Получите включенные SLO ( <code>true</code>), отключенные ( <code>false</code>) или как включенные, так и отключенные ( <code>all</code>).

Элемент может содержать эти значения

* <code>true</code>
* <code>false</code>
* <code>all</code>
|query
|по желанию
|-
|showGlobalSlos
|boolean
|Получите свои глобальные SLO ( <code>true</code>) независимо от выбранного фильтра или отфильтруйте их ( <code>false</code>).
|query
|по желанию
|}

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|SLOs
|Успех. Ответ содержит параметры и расчетные значения запрошенного SLO.
|-
|400
|ErrorEnvelope
|Не удалось. Ввод недействителен.
|}

=== Объекты тела ответа ===

==== Объект <code>SLOs</code> ====
Содержит SLO и пейджинговую информацию.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|slo
|SLO[]
|Список SLO.
|-
|nextPageKey
|string
|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице.

Используйте его в параметре запроса nextPageKey для получения последующих страниц результата.
|-
|pageSize
|integer
|Количество записей на странице.
|-
|totalCount
|integer
|Общее количество записей в результате.
|}

==== Объект <code>SLO</code> ====
Параметры целевого уровня обслуживания (SLO).
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|<s>problemFilters</s>
|string[]
|УСТАРЕЛО

Фильтр сущностей для получения количества проблем, связанных с SLO. Генерируется автоматически, если в SLO не был добавлен фильтр.
|-
|metricExpression
|string
|Процентное выражение метрики для расчета SLO.
|-
|<s>useRateMetric</s>
|boolean
|УСТАРЕЛО

Тип метрики для расчета SLO:

* <code>true</code>: существующая процентная метрика.
* <code>false</code>: соотношение двух показателей.

Список доступных метрик см. на странице встроенных метрик или попробуйте вызов API GET метрик .
|-
|<s>metricRate</s>
|string
|УСТАРЕЛО

Процентная метрика для расчета SLO.

Требуется, если для параметра useRateMetric установлено значение <code>true</code>.
|-
|<s>metricNumerator</s>
|string
|УСТАРЕЛО

Метрика количества успехов (числитель при расчете рейтинга).

Требуется, если для параметра useRateMetric установлено значение <code>false</code>.
|-
|<s>metricDenominator</s>
|string
|УСТАРЕЛО

Метрика общего количества (знаменатель при расчете скорости).

Требуется, если для параметра useRateMetric установлено значение <code>false</code>.
|-
|evaluationType
|string
|Тип оценки SLO.

Элемент может содержать эти значения

* <code>AGGREGATE</code>
|-
|errorBudgetBurnRate
|SloBurnRate
|Ошибка оценки скорости сжигания бюджета для целевого уровня обслуживания (SLO).
|-
|evaluatedPercentage
|number
|Расчетное значение SLO. Имеет значение оцениваемого SLO или значение <code>-1</code>:

* Если есть ошибка при расчете SLO; в этом случае проверьте значение свойства ошибки .
* Если для параметра оценки не установлено значение <code>true</code>; в этом случае свойство error не будет содержать ошибки.
|-
|burnRateMetricKey
|string
|Ключ скорости сжигания бюджета ошибок для выражения метрики.
|-
|errorBudgetMetricKey
|string
|Ключ бюджета ошибок для выражения метрики.
|-
|normalizedErrorBudgetMetricKey
|string
|Ключ нормализованного бюджета ошибок для выражения метрики.
|-
|<s>numeratorValue</s>
|number
|УСТАРЕЛО

Значение числителя, используемое для оценки SLO, когда для параметра useRateMetric установлено значение <code>false</code>.
|-
|<s>denominatorValue</s>
|number
|УСТАРЕЛО

Значение знаменателя, используемое для оценки SLO, когда для параметра useRateMetric установлено значение <code>false</code>.
|-
|relatedOpenProblems
|integer
|Количество ОТКРЫТЫХ проблем, связанных с SLO.

Имеет значение, <code>-1</code>если возникла ошибка при получении проблем, связанных с SLO.
|-
|relatedTotalProblems
|integer
|Общее количество проблем, связанных с SLO.

Имеет значение, <code>-1</code>если возникла ошибка при получении проблем, связанных с SLO.
|-
|hasAccess
|boolean
|SLO доступен через настройки, если hasAccess имеет значение <code>true</code>.
|-
|errorBudget
|number
|Бюджет ошибки рассчитанного SLO.

Бюджет ошибок — это разница между расчетным и целевым значениями. Положительное число означает, что все хорошо; отрицательное число означает проблемы.
|-
|metricKey
|string
|Ключ для метрического выражения. После создания метрические ключи нельзя изменить.
|-
|timeframe
|string
|Сроки оценки SLO. Используйте синтаксис глобального селектора таймфреймов.
|-
|filter
|string
|Фильтр объектов для оценки SLO. Используйте синтаксис селектора объектов .
|-
|description
|string
|Краткое описание SLO.
|-
|enabled
|boolean
|SLO включен ( <code>true</code>) или отключен ( <code>false</code>).
|-
|status
|string
|Статус рассчитанного SLO.

Элемент может содержать эти значения

* <code>FAILURE</code>
* <code>SUCCESS</code>
* <code>WARNING</code>
|-
|error
|string
|Ошибка расчета SLO.

Если значение отличается от <code>NONE</code>, значит, что-то не так с расчетом SLO.
|-
|warning
|number
|Предупреждающее значение SLO.

В состоянии предупреждения SLO все еще выполняется, но приближается к отказу.
|-
|name
|string
|Название SLO.
|-
|id
|string
|Идентификатор SLO
|-
|target
|number
|Целевое значение SLO.
|}

==== Объект <code>SloBurnRate</code> ====
Ошибка оценки скорости сжигания бюджета для целевого уровня обслуживания (SLO).
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|burnRateVisualizationEnabled
|boolean
|Визуализация скорости сжигания бюджета ошибок включена ( <code>true</code>) или отключена ( <code>false</code>).

В случае <code>false</code>, здесь не будет вычисляемых значений.
|-
|fastBurnThreshold
|number
|Порог между медленной и быстрой скоростью горения.
|-
|sloValue
|number
|Расчетное значение SLO для таймфрейма, выбранного для расчета скорости выгорания.
|-
|estimatedTimeToConsumeErrorBudget
|number
|Расчетное время, оставшееся для использования бюджета ошибок в часах.
|-
|burnRateType
|string
|Расчетный тип скорости горения.

Имеет значение «БЫСТРО», «МЕДЛЕННО» или «НЕТ».

Элемент может содержать эти значения

* <code>FAST</code>
* <code>NONE</code>
* <code>SLOW</code>
|-
|burnRateValue
|number
|Скорость записи SLO, рассчитанная за последний час.
|}

=== JSON-модель тела ответа ===
<code>{
"slo": [
{
"problemFilters": "[type(\"SERVICE\")]",
"metricExpression": "(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())",
"useRateMetric": true,
"metricRate": "builtin:service.successes.server.rate",
"metricNumerator": "builtin:service.errors.server.successCount",
"metricDenominator": "builtin:service.requestCount.server",
"evaluationType": "AGGREGATE",
"errorBudgetBurnRate": {
"burnRateVisualizationEnabled": true,
"fastBurnThreshold": 1.5,
"sloValue": 95,
"estimatedTimeToConsumeErrorBudget": 24,
"burnRateType": "SLOW",
"burnRateValue": 1.25
},
"evaluatedPercentage": 96.25,
"burnRateMetricKey": "func:slo.errorBudgetBurnRate.payment_service_availability",
"errorBudgetMetricKey": "func:slo.errorBudget.payment_service_availability",
"normalizedErrorBudgetMetricKey": "func:slo.normalizedErrorBudget.payment_service_availability",
"numeratorValue": 80,
"denominatorValue": 90,
"relatedOpenProblems": 1,
"relatedTotalProblems": 1,
"hasAccess": true,
"errorBudget": 1.25,
"metricKey": "func:slo.payment_service_availability",
"timeframe": "-1d",
"filter": "type(\"SERVICE\")",
"description": "Rate of successful payments per week",
"enabled": true,
"status": "WARNING",
"error": "NONE",
"warning": 97.5,
"name": "Payment service availability",
"id": "123e4567-e89b-42d3-a456-556642440000",
"target": 95
}
],
"nextPageKey": "AQAAABQBAAAABQ==",
"pageSize": 1,
"totalCount": 1
}</code>

Примечания к релизу 280

2024-10-08T08:36:35Z

ENetrebin:

'''''[[Примечания к релизам]] / Примечания к релизу 280'''''

== '''Ключ-АСТРОМ''' ==

=== Объявления ===

==== Поддержка Red Hat Enterprise Linux ====
Обновление до этой версии Ключ-АСТРО Managed теперь доступно для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

==== Обновление конфигурации источника логов и хранилища ====
''Наблюдаемость за инфраструктурой | Логи''

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

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

Обновленная конфигурация, определенная на страницах «Настраиваемая конфигурация источника логов» и «Источники логов и хранилище», предоставит вам:

* Большую гибкость в определении источников логов (например, путь к логу, уровень лога, пространство имен Kubernetes, развертывание Kubernetes).
* Гибкость в определении источников логов (с использованием среды, группы хостов и областей хостов)
* Детализация управления правами доступа к источнику логов.
* Использование REST API для управления источниками логов.
* Возможность фильтровать и маскировать данные лога при захвате

=== Критические изменения ===

==== Изменение настроек REST API: автоматическое внедрение хоста ====
''Критические изменения''

''Наблюдаемость за инфраструктурой | Хосты''

В веб-интерфейсе Ключ-АСТРОМ на странице мониторинга хоста для выбранного хоста переключатель «Автоматическое внедрение» был перенесен с вкладки «Мониторинг» на вкладку «Дополнительные настройки» и переименован в «Внедрение ProcessAgent» .

# Перейдите в раздел Хосты и выберите хост, который вы хотите настроить.
# На странице сведений о хосте выберите> Настройки .
# На странице настроек хоста выберите Мониторинг хоста .
# Выберите вкладку «Дополнительные настройки» .

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

До:

<code>builtin:host.monitoring</code>/<code>autoInjection</code>

После:

<code>builtin:host.monitoring.advanced</code>/<code>processAgentInjection</code>

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

==== Единые настройки конфиденциальности атрибутов ====
''Наблюдение за приложением | Распределенные трассировки''

''Критические изменения''

Настройки атрибутов диапазона , атрибутов ресурса и событий диапазона были объединены в настройки захвата атрибутов .

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

# Перейдите в настройки .
# Выберите Мониторинг служб на стороне сервера > Сбор атрибутов .
# На странице «Захват атрибутов» выполните следующие действия.
#* Выберите Разрешенные атрибуты, чтобы просмотреть список сохраненных ключей атрибутов.
#* Выберите Маскирование данных атрибута , чтобы проверить конфигурацию маскировки для сохраненного атрибута.

=== Новые функции и улучшения ===

==== Новости о продуктах ====

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

==== Информация о сертификате узла скрыта в деталях выполнения HTTP-мониторов. ====
''Цифровой опыт | Синтетический мониторинг''

Вы можете скрыть конфиденциальную информацию от отображения в деталях выполнения HTTP-мониторов с помощью параметра «Не хранить и отображать тела запросов и ответов, а также значения заголовков в деталях выполнения» . Включение этого параметра теперь также скрывает информацию о сертификате узла в деталях выполнения.

==== События мониторинга служб ОС ====
''Наблюдаемость за инфраструктурой | Хосты''

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

==== Новый API для разблокировки автоматического обновления ====
''Наблюдаемость за инфраструктурой | Хосты''

''Наблюдаемость за инфраструктурой | Развертывание''

Определенные типы сбоев автоматического обновления блокируют дальнейшее развертывание этой версии в качестве меры безопасности. <code>/api/v1/oneagents/autoUpdateProblems</code>Был добавлен API самообслуживания для выявления и удаления этих проблем, чтобы разблокировать развертывание автоматического обновления.

==== Входные DNS-имена службы Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Входные DNS-имена службы Kubernetes теперь отображаются на странице службы Kubernetes. Обычно это используется в балансировщиках нагрузки AWS.

Соответствующее поле в Kubernetes API:<code>service.status.loadBalancer.ingress.hostname</code>

==== Конфиденциальность данных атрибутов: возможность хранить все атрибуты по умолчанию ====
''Наблюдение за приложением | Распределенные трассировки''

Теперь вы можете хранить все атрибуты по умолчанию.

==== Отмена фильтра свойств профиля оповещения ====
''Наблюдаемость за инфраструктурой | Проблемы''

''Наблюдаемость за инфраструктурой | Оповещение''

Фильтры свойств профиля оповещения теперь можно отменить, поэтому оповещение не будет срабатывать, если событие проблемы соответствует фильтру свойств.

==== Ограничение правила обнаружения аномалий диска ====
''Наблюдаемость за инфраструктурой | Хосты''

Максимальное количество правил обнаружения аномалий диска теперь составляет 1000.

==== Адаптивное управление трафиком с учетом индивидуальных особенностей ====
''Наблюдение за приложением | Распределенная трассировка''

Вы можете настроить правила управления трафиком для HTTP-трафика. Настраивая вклад конкретных транзакций, вы получаете лучший контроль над сбором данных в пределах доступного объема трассировки вашей среды и можете сразу понять скорость захвата конкретной службы, (ключевого) запроса или результата. Требуется ЕдиныйАгент версии 1.281 для активации правил.

=== Поддержка операционных систем ===
Добавлена поддержка:

* Red Hat Enterprise Linux 9.3
* Rocky Linux 9.3
* Oracle Linux 9.3

===== Следующие операционные системы перестанут поддерживаться с 1 ноября 2024 г. =====

* Linux : Ubuntu 16.04 LTS.
** х86-64
** Объявление поставщика

===== Следующие операционные системы больше не поддерживаются с 1 января 2024 г. =====

* Linux : Red Hat Enterprise Linux 8.4.
** х86-64
** Последняя совместимая версия: 1.280.
* Linux : Oracle Linux 8.4.
** х86-64
** Последняя совместимая версия: 1.280.
* Linux : SUSE Enterprise Linux 12.4.
** х86-64
** Последняя совместимая версия: 1.280.

===== Следующие операционные системы перестанут поддерживаться с 1 ноября 2024 г. =====
* Linux : Ubuntu 16.04 LTS.
** х86-64
** Объявление поставщика

=== Решенные проблемы ===
Версия 1.280 GA содержит 14 решенных проблем.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Безопасность приложений
|1
|-
|Кластер
|11
|-
|Синтетический мониторинг
|2
|}

==== Безопасность приложений ====

* Правила мониторинга сторонних организаций теперь рассматривают объекты для оценки только тогда, когда они стабильны в среде. Новые хосты, которые не могут быть немедленно оценены по правилам мониторинга, теперь изначально устанавливаются на «Не контролировать».

==== Кластер ====

* Повторные запуски мониторов синтетического браузера при ошибке больше не запускаются во время периодов обслуживания.
* Исправлена ссылка на страницу развертывания, указав на недавно выпущенный оператор Ключ-АСТРОМ v0.14.1.
* События теперь можно принимать через REST API в будущем, даже если временная метка окончания не установлена. Параметр timeout затем используется для расчета того, как долго событие остается открытым.
* В таблице «Хосты» теперь отображается индикатор проблемы для узла не только тогда, когда проблема затрагивает узел напрямую, но также и тогда, когда связанный объект имеет постоянную проблему.
* Пользователи, у которых нет доступа на запись к настройкам обновления ЕдиногоАгента, больше не могут нажать кнопку «Обновить сейчас», чтобы запустить обновление ЕдиногоАгента. (Кнопка была включена неправильно; выбор ее без необходимого разрешения привел к появлению страницы ошибки 403.).
* Повышена надежность классического списка проблем, который в редких случаях может привести к сбою, если навести курсор на отображаемый идентификатор проблемы с многочисленными подробностями.
* Исправлено зависание навигации по распределенным трассировкам и MDA. Вы можете получить доступ к глобальному MDA и распределенным трассировкам, выбрав первый элемент в навигационной цепочке.
* Селектор метрики больше не поддерживает оператор `:filter` без аргументов.
* Исправлена долгая загрузка данных при переключении вкладок на экранах Unified Analysis.
* Решена проблема, из-за которой, начиная с версии ЕдиногоАгента 1.273, кластер больше не мог обрабатывать узлы с ESB и вложениями для обмена сообщениями с приоритетом службы Enterprise Service Bus, а вместо этого прибегал к отображению простой службы обмена сообщениями.
* Исправлена ошибка, приводившая к высокому использованию памяти при чтении данных о доступности.

==== Синтетический мониторинг ====

* Добавлено владение API в общий API событий приема.
* Если выбрана опция не хранить конфиденциальные данные HTTP-запроса (т. е. тела запроса и ответа, а также значения заголовков), сведения о сертификате узла также скрыты.

== '''ЕдиныйАгент Ключ-АСТРОМ''' ==

=== Технологическая поддержка ===

==== Поддержка новых технологий ====

* JMS 3.0 (Java-модуль)
* Spring Webflux 6 (модуль Java)
* Spring WebFlux WebClient 6 (модуль Java)

=== Окончание поддержки ===
''Критические изменения''

Модуль ЕдиныйАгент Envoy зависит от OpenTracing. Envoy прекратил поддержку OpenTracing версии 1.29, поэтому ЕдиныйАгент больше не может отслеживать Envoy версии 1.29 и новее. Это касается всех версий ЕдиногоАгента.

Однако ЕдиныйАгент по-прежнему может отслеживать версии Envoy до 1.29. В будущем Ключ-АСТРОМ будет поддерживать мониторинг Envoy на основе OpenTelemetry.

=== Новые функции и улучшения ===

==== Пакетная публикация RabbitMQ ====
''Наблюдение за приложением | .NET''

Добавлена поддержка пакетной публикации для клиента .NET RabbitMQ.

==== Улучшенная группировка контроллера расширений. ====
''Наблюдаемость за инфраструктурой | Хосты''

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

==== Группировка процессов для источника данных ловушек SNMP ====
''Наблюдаемость за инфраструктурой | Хосты''

Добавлена группировка расширения SNMPTraps в группу с именем <code>Astromkey ActiveGate Source SNMP Traps</code>.

=== Решенные проблемы ===
Версия 279 содержит 13 решенных проблем.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|NGINX
|2
|-
|Все модули
|1
|-
|Общий
|2
|-
|Мэйнфрейм
|1
|-
|модуль ОС
|2
|-
|Модуль OpenTracing
|1
|-
|Java
|2
|-
|PHP
|2
|}

==== NGINX ====

* Исправлена проблема в модуле кода ЕдиныйАгент NGINX, приводившая к сбою функции пополнения лога.
* Исправлена проблема в модуле кода NGINX ЕдиныйАгент, которая потенциально вызывала сбои в показателях работоспособности NGINX и вышестоящих одноранговых узлов (сообщалось неверное количество работоспособных и неработоспособных одноранговых узлов).

==== Все модули ====

* Устранена несовместимость с версиями glibc > 2.33.

==== Общий ====

* Улучшено форматирование MAC-адресов для расширений на основе SNMP.
* Решена проблема, приводившая к сбою контроллера выполнения расширений (EEC) при приеме большого количества метрик.

==== Мэйнфрейм ====

* Модуль Java z/OS теперь корректно поддерживает классы Lambda Java 8+.

==== модуль ОС ====

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

==== Модуль OpenTracing ====

* Повышена надежность модуля кода ЕдиныйАгент Envoy, включая исправление проблемы, из-за которой Envoy не запускался, если в конфигурации модуля была ошибка (например, пустой набор исходных URL-адресов). В этом случае ошибка теперь регистрируется, и отправляющему разрешено продолжать работу без контроля.

==== Java ====

* Исправлена проблема, из-за которой тела HTTP-запросов неправильно фиксировались модулем кода Java ЕдиныйАгент, когда приложение использовало API ServletRequest::getReader.
* Бизнес-события для HTTP-запросов, обрабатываемых асинхронными сервлетами, больше не пропадают.

==== PHP ====

* Решена проблема с прокси-объектами Doctrine при установке атрибута запроса.
* Исправлена проблема, из-за которой PHP-FPM с opcache.preload не взаимодействовал с кластером и не сообщал данные мониторинга на уровне сервиса и кода.

=== ЕдиныйАгент для Android ===
Версия 279 содержит 1 решенную проблему.

* Изменено значение по умолчанию для метода withCrashReporting на true в технической документации ЕдиныйАгент SDK.

=== ЕдиныйАгент для iOS ===
Версия 279 содержит 3 решенные проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|ЕдиныйАгент для iOS
|1
|-
|Воспроизведение сеанса для iOS
|2
|}

==== ЕдиныйАгент для iOS ====

* Инструмент SwiftUI: улучшен инструментарий модификаторов SwiftUI.

==== Воспроизведение сеанса для iOS ====

* Воспроизведение сеанса iOS: решена проблема, приводившая к сбою устройства iOS 17 в некоторых редких случаях.
* Воспроизведение сеанса iOS: устранен сбой ЕдиногоАгента для угловых случаев со снимками экрана размером 0.

=== Решённые проблемы ЕдиногоАгента для JavaScript ===
Версия 279 содержит 1 решенную проблему.

==== Воспроизведение сеанса ====

* Исправлена проблема, из-за которой ресурсы не загружались в воспроизведении сеанса в следующих ситуациях: (1) в воспроизведении, когда ресурс был запрошен на исходном сервере, сервер возвращал различное содержимое в зависимости от заголовка «Принять»; (2) В Replay при загрузке ресурсов по относительному пути на странице с тегом <base>; (3) При записи ресурсов с относительным путем внутри iframe; (4) При воспроизведении сеанса после более чем 30 секунд отсутствия активности.

== '''API Ключ-АСТРОМ''' ==

=== API среды ===

* API токенов доступа
** Новое возможное значение в поле областей объекта ApiToken : <code>unifiedAnalysis.read</code>

* API уязвимостей
** Новое возможное поле в объектах RiskAssessmentDetails и remediationProgressEntityAssessment : vulnerableFunctionRestartRequired ( <code>boolean</code>).

* API синтетических местоположений v2
** Новые возможные поля в объекте LocationCollectionElement : geoCity ( <code>string</code>) geoContinent ( <code>string</code>) geoCountry ( <code>string</code>) geoLatitude ( <code>number</code>) geoLongitude ( <code>number</code>)

* Настройки API - Таблица схем мониторинга
** ''Критические изменения'' Переименование

<code>builtin:host.monitoring</code>/ <code>autoInjection</code>в <code>builtin:host.monitoring.advanced</code>/<code>processAgentInjection</code>

=== API конфигурации ===

* API расширений – GET доступные хосты
** Новые возможные значения параметра технологического пути: <code>COSMOSDB</code> <code>JAVA_HTTPURLCONNETION</code>
* API атрибутов запроса
** Новые возможные значения в поле serviceTechnology объекта ScopeConditions : <code>COSMOSDB</code> <code>JAVA_HTTPURLCONNETION</code>

=== Кластерный API ===

* <code>/iam/organizational-levels/{level-type}/{level-id}</code>
** Новое возможное поле в объектах Level и LevelList : DisableAt ( <code>string</code>)

* <code>/synthetic/locations</code>
** Новые возможные поля в объекте LocationCollectionElement : geoCity ( <code>string</code>) geoContinent ( <code>string</code>) geoCountry ( <code>string</code>) geoLatitude ( <code>number</code>) geoLongitude ( <code>number</code>)
* <code>/settings/schemas</code>
** ''Критические изменения'' Переименование

<code>builtin:host.monitoring</code>/ <code>autoInjection</code>в <code>builtin:host.monitoring.advanced</code>/<code>processAgentInjection</code>

=== Доступность для ранних пользователей ===
Следующий API теперь доступен в версии Early Adopter :

* API среды <code>POST /ua/entity</code>
* API среды <code>POST /ua/list</code>
* API среды <code>GET /ua/schema/{entityType}</code>

Примечания к релизу 284

2024-09-30T07:47:30Z

ENetrebin: /* Возможность загрузки полного набора результатов логов */

'''''[[Примечания к релизам]] / Примечания к релизу 284'''''

== '''Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Разрешить все атрибуты по умолчанию ====
''Наблюдаемость приложений | Распределенные трассировки''

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

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

Чтобы изменить сохранение атрибутов OpenTelemetry по умолчанию, перейдите в ''Настройки > Мониторинг служб на стороне сервера > Захват атрибутов > Настройки'' и выберите ''Разрешить все атрибуты'' (чтобы использовать список заблокированных атрибутов ) или ''Блокировать все атрибуты'' (чтобы использовать список разрешенных атрибутов ). Обратите внимание, что эти настройки применяются как к OpenTelemetry, так и к OpenTracing.

=== Окончание поддержки Log Monitoring v1 ===
Log Monitoring версии 1 достигла конца жизненного цикла и отключена в этом выпуске (Ключ-АСТРОМ Managed версии 1.284). В результате применяются следующие изменения:

* Log Viewer не отображает никаких данных лога.
* API Log Monitoring v1 отключен.
* Метрики лога (v1) не фиксируются. Конфигурация доступна только для чтения.
* События лога (v1) не запускаются. Конфигурация доступна только для чтения.
* Прием логов (v1) отключен.
* Конфигурация источника лога сохраняется для будущего использования.
* На страницах объектов, таких как «Хост», «Процесс» и «Группа процессов», не отображаются файлы логов.
* Подключенный том NFS для хранения логов больше не используется.

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

=== Новые функции и улучшения ===

==== Возможность выбора формата команд cURL в API Explorer ====
''Платформа | API''

В API Explorer теперь можно выбрать формат команд cURL:

* bash
* PowerShell (Windows)
* Командная строка (Windows)

==== Отображение данных сервиса AWS Lambda ====
''Наблюдаемость инфраструктуры | AWS''

Страница сервиса Lambda теперь беспрепятственно отображает данные как из AWS Lambda (встроенной), так и из новой интеграции AWS Lambda CloudWatch, что обеспечивает плавный переход.

* Старые и новые данные сервиса Lambda, поступающие из интеграции с AWS, теперь отображаются на странице сервиса Lambda (интеграция уровня Lambda) вместе с данными ЕдиногоАгента, когда включена интеграция с AWS CloudWatch и отслеживается сервис Lambda (встроенный или новый).
* На странице сервиса Lambda теперь вы можете найти метрики и свойства CloudWatch для нового сервиса Lambda.
* Если вы хотите изучить больше показателей CloudWatch, перейдите по ссылке на отдельную страницу для нового сервиса Lambda.
* Логи интеграции ЕдиногоАгента и пересылки журналов AWS также связаны с новым сервисом AWS Lambda.
* Вы можете включить предопределенную конфигурацию событий метрики для высокого уровня ошибок Lambda на основе нового сервиса AWS Lambda на странице настроек для интеграций AWS.

==== Возможность загрузки полного набора результатов логов ====
''Инфраструктура Наблюдаемость | Логи''

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

==== Временная метка создания узла Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Добавлена информация о временной метке создания узла Kubernetes на карточку свойств и в API.

==== Обновление минимальной версии АктивногоШлюза до 1.279 ====
''Наблюдаемость инфраструктуры | Kubernetes''

В связи с недавними изменениями в мониторинге Kubernetes минимальная версия АктивногоШлюза была обновлена до 1.279, чтобы обеспечить доступность новейших функций.

==== Улучшенная обработка запросов на события и проблемы для сред с несколькими центрами обработки данных ====
Улучшена обработка запросов на события и проблемы для сред с несколькими центрами обработки данных, что повысило стабильность в отношении дублирования документов о проблемах/событиях между различными центрами обработки данных и позволило решить такие проблемы, как ошибочное отображение закрытой проблемы как открытой.

==== Ограничение изменений в NGINX ====
Лимиты NGINX были изменены следующим образом:

* <code>worker_rlimit_nofile</code>: 102,400
* <code>worker_connections</code>: 100,000

=== Поддержка операционных систем ===
Обновление кластера Ключ-АСТРОМ Managed больше невозможно в Red Hat Enterprise Linux 8.4, Oracle Linux 8.4 и Suse Linux Enterprise Server 12.4.

==== Поддержка добавлена ====

* Обновление до этой версии Ключ-АСТРОМ Managed поддерживается для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

* Elasticsearch теперь работает в среде выполнения Java 17.0.8.

==== Следующие операционные системы больше не будут поддерживаться с 1 октября 2024 г. ====

* Linux : SUSE Enterprise Linux 15.2
** x86-64
** Последняя совместимая версия: 1.300

==== Следующие операционные системы больше не поддерживаются с 01 июля 2024 г. ====

* Linux : Amazon Linux AMI 2018.x
** x86-64
** Последняя совместимая версия: 1.290

==== Следующие операционные системы больше не поддерживаются с 01 августа 2024 г. ====

* Linux : Oracle Linux 8.9
** x86-64
** Последняя совместимая версия: 1.292

=== Решенные проблемы ===
В выпуске 284 решены 26 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Кластер
|22
|-
|Health
|1
|-
|Синтетический мониторинг
|3
|}

==== Кластер ====

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

* Улучшена обработка связей между объектами в контексте проблемы при построении ссылок в пользовательском интерфейсе.
* Исправлена проблема, при которой пользователи без разрешений на запись настроек, но с соответствующими разрешениями на зону управления получали ошибку при попытке массового закрытия проблем в списке проблем (веб-интерфейс) в средах, где запись настроек не требуется для выполнения закрытия проблемы (настройка по умолчанию). Это также исправляет обработку REST API закрытия проблемы, требующую разрешения на запись настроек только в средах, где запись настроек не требуется для выполнения закрытия проблемы.
* Исправлена информация о времени возникновения проблемы на странице сведений о проблеме (в разделе под заголовком проблемы) для проблем, которые начинались как частые проблемы. (Теперь используются правильные временные метки для времени, когда были зарегистрированы события и когда проблема изменилась с частой на ненормальную.)
* Исправлено переполнение текста на странице сведений о проблеме в разделе «Запрос Grail», возникавшее в некоторых браузерах (например, Firefox) при проблемах с длинными запросами DQL.
* Классические панели мониторинга: теперь хост правильно выделяется красным цветом в сотовой визуализации на панели мониторинга, когда связанный объект имеет открытую проблему.
* Чтобы точнее показать, что использовалось для анализа, в метрической диаграмме сведений о проблеме для метрических событий вверху теперь используется разрешение в 1 минуту, если временной интервал проблемы короче дня.
* Внутри операторов сопоставления можно использовать открывающие и закрывающие скобки как часть свойства службы или хоста.
* Решена проблема, которая препятствовала доступу к нескольким страницам глобальных настроек для пользователей с назначенными условными политиками IAM.
* Окно обслуживания может подавлять события для оповещения или создания проблемы. Если новый отчет о событии пришел после окончания ранее соответствующего окна обслуживания для его существующего события, время окончания подавленного события устанавливалось на конечную временную метку нового отчета. Это исправление изменяет это поведение на начальную временную метку нового отчета, так что подавленное событие заканчивается в то же время, когда открывается и оповещается новое неподавленное событие.
* Пользователи больше не могут отменять извлеченные службы, если у них нет прав на запись настроек на уровне клиента.
* Чтобы предотвратить большие времена отклика и задержки в решении проблем, вызванные тем, что менеджер по проблемам тратит слишком много времени на оценку регулярных выражений профиля оповещения, регулярные выражения в новых фильтрах заголовков/описаний событий профиля оповещения теперь ограничены.
* Отключено редактирование местоположений, назначенных синтетическому монитору, и кнопка «Установить ЕдиныйАгент» для пользователей, к которым применяется политика «только для чтения».
* В проводнике данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлена ошибка, из-за которой определенные приложения, требующие разрешений, были невидимы для пользователей, привязанных к зонам управления.
* Лимиты по умолчанию теперь правильно применяются в существующих клиентах для отчетов о событиях лога Kubernetes, доступности и метрик.
* Уровень риска метрики количества затронутых объектов теперь основан на уровне риска в контексте данной объкута. Это делает метрику еще более осведомленной о зоне управления.
* Исправлен фильтр селектора метрик, оценивавший условия независимо и возвращавший слишком много данных.
* В обозревателе данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлен процесс миграции кластера в режим поддержки стойки.
* Java v17.0.8 была заменена на v17.0.10.

==== Health ====

* Исправлен расчет критического статуса для ЕдиныхАгентов для просроченных дат.

==== Синтетический мониторинг ====

* Учетные данные, предоставленные списку пользователей, теперь можно фильтровать по типу общего доступа.
* Исправлена ошибка, из-за которой синтетическое расположение Kubernetes, развернутое в кластере с ограниченными ресурсами и интенсивно используемое, могло использовать больше памяти, чем разрешено, и быть уничтожено кластером Kubernetes из-за ошибки OOM.
* Решена проблема, из-за которой синтетические мониторы с общими учетными данными могли редактироваться пользователями, не имеющими доступа к этим учетным данным.

== '''ЕдиныйАгент Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Прием контейнера логов через ЕдиныйАгент ====
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Лог мониторинга''

Логи, собранные с помощью ЕдиногоАгента из систем оркестровки контейнеров Kubernetes и неоркестрованных сред Docker, теперь сообщаются с <code>log.source</code>указанием вывода контейнера вместо пути к физическому файлу, из которого они были получены.

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

Однако правила приема логов для логов Kubernetes и Docker обычно основаны на определенных атрибутах, связанных с контейнером, таких как пространство имен Kubernetes или имя контейнера .

Обновление : <code>log.source</code>теперь можно использовать сопоставление для управления приемом логов контейнеризованных приложений. ''устаревшее.''

* <code>log.source</code>Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуется переход на использование атрибутов, связанных с Kubernetes, вместо атрибута.
* Аналогичная миграция для учета изменений атрибутов <code>log.source</code>контейнеров требуется в правилах обработки логов, а также в метриках логов и конфигурациях событий логов.

=== Удалены значения по умолчанию dt_security_context ===
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Хосты''

Поле разрешения <code>dt.security_context</code>в <code>dt_host_metadata</code>файле зарезервировано только для значений, определяемых пользователем. Оно больше не имеет значения по умолчанию, если пользователем явно не указаны значения.

=== Технологическая поддержка ===

==== Поддержка новых технологий ====

* MongoDB 1.3 - 1.13 (модуль Go). Функция ЕдиногоАгента: Go MongoDB
* OpenResty 25.3.1 (модуль NGINX)
* z/OS 3.1 (модуль zDC)

==== Окончание поддержки ====

* Node.js 19 (модуль Node.js)
** Окончание поддержки поставщика: 2023-06-01

=== Новые функции и улучшения ===

==== Исключен адаптер обратной связи Microsoft KM-TEST из обнаруженных сетевых карт ====
''Наблюдаемость инфраструктуры | Хосты''

Адаптер обратной связи Microsoft KM-TEST исключен из обнаружения и не сообщается в Ключ-АСТРОМ.

=== Решенные проблемы ===
В выпуске 282 решены 23 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Обшие
|3
|-
| Java
|2
|-
|Мейефрейм
|1
|-
|Модуль ОС
|1
|-
|Apache
|1
|-
|Модуль OpenTracing
|1
|-
|.NET
|2
|}
====Общие====

* Чтобы ограничить влияние критических изменений «Прием логов контейнеров через ЕдиныйАгент»: использование сопоставления `log.source` для управления приемом логов контейнерных приложений теперь устарело. Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуют перехода на использование атрибутов, связанных с Kubernetes, вместо атрибута `log.source`. Аналогичная миграция для учета изменений в атрибуте `log.source` для контейнеров требуется в правилах обработки логов.
* Исправлено поведение в крайних случаях для настроенных асинхронных методов как службы обмена сообщениями .NET.
* Исправлены (удалены) чрезмерно подробные записи лога для PHP, которые приводили к большому количеству записей, связанных с WorkProxy, которые невозможно было отключить.

==== Java ====

* Данные Ключ-АСТРОМ, обогащенные неструктурированными логами Logback, теперь заключены в скобки `[!dt ]`.
* Исправлена проблема, которая иногда приводила к сбою ЕдиногоАгента, если приложение выдавало `StackOverflowError` во время запуска.

==== Мейнфрейм ====

* Исправлена ошибка последовательности функций SQL Fetch (CLI0125E).

==== модуль ОС ====

* Исправлена ошибка, из-за которой расширения не запускались на серверах Azure.

==== Apache ====

* Исправлена проблема сбоя переименованного Apache Web Server (IHS) путем отключения функциональности Apache Log Enrichment для таких серверов по умолчанию.

==== Модуль OpenTracing ====

* Добавлена поддержка Envoy 1.29.x.

==== .NET ====

* Исправлена ошибка, из-за которой запросы к URL-адресу RUM-маяка могли влиять на доступность приложения при определенных условиях.
* Исправлена ошибка в функции WCF v2, которая приводила к дублированию вызовов служб для одного и того же запроса.

=== ЕдиныйАгент для Android ===
''Цифровой опыт | RUM Mobile''

* Новый вариант метода <code>stopWebRequestTiming</code>API был добавлен в ЕдиныйАгентSDK для Android. Используйте новый <code>stopWebRequestTiming(URI requestUri, int respCode, String respPhrase, long requestSize, long responseSize)</code>метод API для дополнительной передачи размеров запроса и ответа при сообщении веб-запроса . Эта дополнительно указанная информация будет затем показана в веб-интерфейсе Ключ-АСТРОМ на следующих страницах.
** На странице сведений о веб-запросах отображается только размер запроса
** На странице анализа действий пользователя для веб-запросов, прикрепленных к действиям пользователя, отображаются размеры как запроса, так и ответа.

=== ЕдиныйАгент для iOS ===

==== Инициализаторы кнопок и меню ====
''Цифровой опыт | RUM Mobile''

Добавлен инструментарий для инициализаторов кнопок и меню iOS 17.

==== Решённые проблемы ====

===== ЕдиныйАгент для iOS =====

* Инструментарий SwiftUI: переменные привязки констант теперь инструментируются правильно.
* Инструмент SwiftUI: имена элементов управления с неявными ссылками на константы теперь разрешаются правильно.

=== Решённые проблемы ЕдиногоАгента для JavaScript ===

* Исправлена проблема, когда модуль XHR создавал события прогресса как `Event` вместо `ProgressEvent`, из-за чего проверки `instanceof` не срабатывали. Это было особенно актуально для оболочки XHR, которую использует Flutter.

== '''API Ключ-АСТРОМ''' ==

=== API конфигурации ===

* API метрик обслуживания
** Новое возможное значение в поле метрики объекта metricDefinition : <code>CAPTURED_FULL_SERVICE_CALLS</code>

* API атрибутов запроса
** Технология обслуживания объектов недвижимости в сфере объектов имеет новое возможное значение: <code>ORACLE_DB_LISTENER</code>

=== API среды ===

* Атаки Early Adopter
** Новое возможное значение в поле attackType объекта атаки : <code>SSRF</code>
** Новое возможное значение в поле типа объекта unreliableFunctionInput : <code>HTTP_CLIENT</code>
* Проблемы безопасности
** Новое возможное значение в поле типа объекта codeLevelVulnerabilityDetails : <code>SSRF</code>
** Новое возможное значение в поле типа объекта unreliableFunctionInput : <code>HTTP_CLIENT</code>

* Расширения 2.0 API - GET active
** Новые возможные значения в поле типа объекта активов : <code>DQL_LOG_PROCESSING_RULE</code> <code>LQL_LOG_PROCESSING_RULE</code>

* API логов мониторинга — GET Export Logs ''Early Adopter''
** Изменено: <code>[ssoAuth=[environment-api]]</code>на<code>[ssoAuth=[storage:logs:read]]</code>

* Унифицированный анализ ''Early Adopter''
** Новое возможное значение в поле logsCard объекта UAEntityScreenDefinition : <code>logRecommendationQueries</code>

* API контролируемых состояний
** Новое возможное значение в свойстве состояния объекта monitoringStates : <code>restart_required_host_group_inconsistent</code>

=== Доступность для Early Adopter ===
Следующий API теперь доступен в версии Early Adopter :

* <code>GET /extensions/{technology}/availableHosts</code> Изменена технология в пути: добавлено значение перечисления:<code>ORACLE_DB_LISTENER</code>

=== Устаревшее ===
Следующие конечные точки Log Monitoring API v1 устарели.

* Log Monitoring API v1
** <code>GET /entity/infrastructure/custom-devices/{customDeviceId}/logs</code>
** <code>GET /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}</code>
** <code>DELETE /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}</code>
** <code>GET /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}/records/top</code>
** <code>POST /entity/infrastructure/custom-devices/{customDeviceId}/logs/{logPath}</code>
** <code>GET /entity/infrastructure/hosts/{hostId}/logs</code>
** <code>GET /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}</code>
** <code>DELETE /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}</code>
** <code>GET /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}/records/top</code>
** <code>POST /entity/infrastructure/hosts/{hostId}/logs/{logPath}</code>
** <code>GET /entity/infrastructure/process-groups/{pgId}/logs</code>
** <code>GET /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}</code>
** <code>DELETE /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}</code>
** <code>GET /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}/records/top</code>
** <code>POST /entity/infrastructure/process-groups/{pgId}/logs/{logPath}</code>
* Log Monitoring v1 metrics API
** <code>GET /calculatedMetrics/log</code>
** <code>GET /calculatedMetrics/log/{metricKey}</code>
** <code>PUT /calculatedMetrics/log/{metricKey}</code>
** <code>DELETE /calculatedMetrics/log/{metricKey}</code>
** <code>POST /calculatedMetrics/log/{metricKey}/validator</code>

Примечания к релизу 282

2024-09-30T07:45:46Z

ENetrebin:

'''''[[Примечания к релизам]] / Примечания к релизу 282'''''

== '''Ключ-АСТРОМ''' ==

=== Новые функции и улучшения ===

==== Обновленная информация об уязвимых функциях при перезапуске процесса ====
''Безопасность приложений | Уязвимости''

ЕдиныйАгент версии 1.279+

Если доступна новая информация об уязвимых функциях уязвимости, уведомление Restart required информирует вас о том, что требуется перезапуск процесса для ЕдиногоАгента, чтобы получить и использовать новые данные. Вы можете легко перейти к конкретным процессам, требующим перезапуска, отфильтровав по <code>Vulnerable functions: Restart required</code>на страницах отслеживания исправлений для групп процессов и процессов.

==== Новая схема настроек для параметров мобильного приложения в среде ====
''Наблюдаемость инфраструктуры| События''

Новая схема настроек, <code>builtin:mobile.notifications</code>, была введена для настроек мобильных приложений в среде. Управляемые клиенты также могут адаптировать настройку на уровне кластера. Новая настройка позволяет включать/отключать все уведомления для мобильных приложений для среды. Для управляемых клиентов это также включает/отключает генерацию QR-кода для подключения новых мобильных приложений.

Перейдите в «Настройки» и выберите «Интеграция» > «Мобильное приложение Ключ-АСТРОМ» .

==== Автоматическое оповещение о высокой активности GC теперь также поддерживает облачный сценарий Full-Stack ====
''Наблюдение за приложениями | Службы''

Автоматические оповещения о высокой активности GC теперь оцениваются на стороне кластера, поэтому они работают для облачных сценариев Full-Stack и автономных/PaaS. Благодаря этому улучшению автоматические оповещения о высокой активности GC также будут работать в облачных сценариях Full-Stack и Application-only. Чтобы проверить настройки, см. События и оповещения Out-of-memory (OOM) и out-of-threads (OOT) .

==== Обфускация URL в уведомлениях о проблемах ====
''Наблюдаемость инфраструктуры | Проблемы''

Проблема с пользовательской интеграцией теперь позволяет настроить URL как секретный.

==== Информационные события ИИ, полученные более чем через день в будущем, могут быть немедленно запрошены ====
''Наблюдаемость инфраструктуры | События''

Информационные события ИИ, полученные более чем через день в будущем, теперь можно немедленно запросить с указанием будущих временных рамок.

==== Улучшение производительности проблемного фида ====
''Наблюдаемость инфраструктуры | Проблемы''

Теперь доступны следующие улучшения производительности подачи проблем:

* Множественный выбор проблем для массового закрытия.
* Текстовая подсказка с описанием события для быстрого получения подробной информации о проблеме в ленте проблем.

==== Увеличены лимиты отчетов по умолчанию для известных контекстов событий на одном сервере ====
''Наблюдаемость инфраструктуры | События''

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

==== Доступ к учетным данным расширен для определенных пользователей ====
''Цифровой опыт | Синтетический мониторинг''

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

==== Контейнерные объекты, созданные на основе данных мониторинга АктивногоШлюза Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Контейнерные объекты создаются на основе данных мониторинга АктивногоШлюза Kubernetes для кластеров с поддержкой приложений (приложение Kubernetes).

==== Сведения об узле Kubernetes ссылаются на хост ====
''Наблюдаемость инфраструктуры | Kubernetes''

Ссылка на хост теперь отображается в заголовке страницы сведений об узле Kubernetes.

==== Увеличен лимит ЦП для синтетического контейнера ====
''Цифровой опыт | Синтетический мониторинг''

Чтобы избежать чрезмерного регулирования ЦП контейнеров Synthetic VUC Worker в местах с высокой нагрузкой, лимит ЦП был увеличен с 1 до 1,5 ядер в шаблоне Kubernetes/OpenShift. Новое значение включено в требования к оборудованию.

==== Новые источники атрибутов запроса доступны для CICS/IMS ====
''Наблюдаемость приложений | Распределенные трассировки''

Добавлена поддержка следующих источников атрибутов запроса:

* Идентификатор пользователя CICS
* Идентификатор единицы работы CICS
* Идентификатор пользователя IMS
* Идентификатор единицы работы IMS

==== Обновление Кассандры ====
Начиная с версии Ключ-АСТРОМ Managed 1.282, служба хранения конфигураций и метрик обновлена до Cassandra 4.0.11 для оптимизации производительности и устойчивости.

=== Поддержка операционных систем ===

==== Добавлена поддержка ====

* Добавлена поддержка Red Hat Enterprise Linux 9.3, Rocky Linux 9.3 и Oracle Linux 9.3
* Добавлена поддержка Red Hat Enterprise Linux 8.9 и Oracle Linux 8.9

* Обновление до этой версии Ключ-АСТРОМ Managed поддерживается для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

==== Следующие операционные системы больше не поддерживаются ====
* Linux : Red Hat Enterprise Linux 8.4
** x86-64
** Последняя совместимая версия: 1.280
* Linux : Oracle Linux 8.4
** x86-64
** Последняя совместимая версия: 1.280
* Linux : SUSE Enterprise Linux 12.4
** x86-64
** Последняя совместимая версия: 1.280
** Linux : Amazon Linux AMI 2018.x
*** x86-64
*** Последняя совместимая версия: 1.290
** Linux : Oracle Linux 8.9
*** x86-64
*** Последняя совместимая версия: 1.292

=== Решенные проблемы ===
В выпуске 282 решены 23 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Безопасность приложений
|5
|-
|Кластер
|16 (1 уязвимость)
|-
|Синтетический мониторинг
|2
|}

==== Безопасность приложений ====

* Исправлена отчетность для связанных объектов на панели множественной уязвимости. Проблема с разделами «Сводка экспозиции» и «Анализ среды» привела к неправильной отчетности для связанных и затронутых объектов на панели. Данные из старых панелей следует считать неверными. Пользователи, которые не использовали кнопку «Открыть с помощью», не затронуты.
* Исправлено неверное количество затронутых объектов, отображаемых в сгенерированных отдельных блокнотах уязвимостей (плитка «Затронутые объекты по оценке риска»)
* Исправлены агрегированные значения в панелях мониторинга отдельных уязвимостей. В разделах «Анализ кода», «Анализ рисков», «Сводка по воздействию» и «Анализ среды» панелей мониторинга отдельных уязвимостей была проблема, из-за которой возникали неверные отчеты для связанных и затронутых объектов на панели мониторинга. Эта проблема была решена и может быть устранена с помощью кнопки «Открыть с помощью» в приложении «Уязвимости сторонних производителей» для создания новой панели мониторинга. Данные из старых панелей мониторинга следует считать неверными. Пользователи, которые до сих пор не использовали кнопку «Открыть с помощью», не затронуты.
* Исправлена ошибка, из-за которой отчеты о состоянии на уровне объектов экспортировались с неправильным состоянием отключения звука в определенном случае.
* Исправлено поведение фильтра статуса в сгенерированных панелях мониторинга для скрытия скрытых уязвимостей, если статус не выбран или выбрано «открыто» или «решено» в приложении «Сторонние уязвимости».

==== Кластер ====

* Решена проблема, из-за которой в некоторых конфигурациях Cassandra не запускалась из-за недостаточных прав доступа к файлам, связанным с JNA.
* Экраны UA для объектов, не относящихся к службам, больше не дают сбоев, поскольку «Действие x» недопустимо для текущего контекста на экранах UA для типов объектов, отличных от служб.
* Исправлена ошибка, из-за которой при некоторых условиях пул соединений Mission Control был склонен к исчерпанию, что приводило к потере соединения с Mission Control.
* Исправлена ошибка, приводившая к высокому использованию памяти при чтении данных о доступности.

* ''Уязвимость:'' для смягчения возможных уязвимостей, связанных с подменой X-Forwarded-For, балансировщик нагрузки кластера теперь сбрасывает заголовок X-Forwarded-For для новых установок. Чтобы изменить это поведение, используйте опцию `--drop-x-forwarded-for` для установки или перенастройки.
* Исправлена ошибка, из-за которой веб-интерфейс становился недоступным из-за исчерпания потоков
* Технологии, определенные для декларативной группировки процессов, теперь отображаются на странице «Обзор технологий» («Технологии и процессы»).
* Исправлено отсутствие указания на то, почему окна обслуживания в обновлениях ЕдиногоАгента могут быть пустыми. (Когда у пользователя есть доступ к странице настроек «Обновления ЕдиногоАгента», но нет доступа к настройкам «Окна обслуживания для обновлений ЕдиногоАгента», невозможно изменить окно обслуживания, поскольку раскрывающийся список с ними пуст. Теперь сообщение объясняет, что конкретная политика IAM отсутствует.)
* Исправлена ссылка на страницу развертывания, чтобы она указывала на недавно выпущенный Ключ-АСТРОМ Operator v0.14.2. ( K8S-8303 )
* Производительность страницы "Deployment status" для ЕдиногоАгента была значительно улучшена, особенно время загрузки для более крупных сред. Обратите внимание, что это улучшение удаляет функциональность для маркировки и сортировки хостов с проблемами на уровне процесса. Чтобы отслеживать проблемы на уровне процесса, перейдите на страницу "ЕдиныйАгент health".
* Улучшено выражение фильтрации кластера VMware для отклонения недопустимых входных данных.
* Исправлена ошибка, из-за которой на странице «Кластеры Kubernetes» отображались прочерки в столбце состояния для некоторых кластеров Kubernetes.
* Теги уведомлений о событиях ServiceNow теперь имеют правильный формат `key:value`, который соответствует остальной части Ключ-АСТРОМ. Теги, созданные клиентом (вручную/автоматически с помощью правил), теперь не имеют префикса [CONTEXTLESS]. Кроме того, некоторые контексты для автоматически импортируемых тегов изменились: `AZURE` на `Azure`, `ENVIRONMENT` на `Environment`, `CLOUD_FOUNDRY` на `CloudFoundry`, `KUBERNETES` на `Kubernetes`, `GOOGLE_COMPUTE_ENGINE` на `GoogleCloud` и `AWS_GENERIC` на `AWSGeneric`.
* Страница настроек "Обновления Ключ-АСТРОМ" представляет краткую сводку автоматических статусов обновления для ЕдиногоАгента. Для актуального состояния в некоторых случаях отображалась неверная версия ЕдиногоАгента. Теперь она правильно отображает, сколько ЕдиныхАгентов обновлены до определенной версии.
* Исправлена кодировка определенных символов в японском переводе кода Ключ-АСТРОМ Cluster. Исправлен процесс миграции кластера в режим поддержки стойки.

==== Синтетический мониторинг ====

* Исправлена проблема, связанная с несогласованными конфигурациями монитора Synthetic Browser, возвращаемыми конечной точкой GET Synthetic monitor.
* Плитка панели синтетического монитора «Сторонний монитор» теперь отображает «Длительность» в миллисекундах для значений ниже 100 миллисекунд.

== '''ЕдиныйАгент Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== ЕдиныйАгент SDK для Android обновлен до Kotlin 1.9.10 ====
'''!Критические изменения!'''

ЕдиныйАгент SDK для Android обновлен до Kotlin 1.9.10.

* Приложения, использующие Kotlin 1.8, должны быть по-прежнему совместимы.
* Более ранние версии могут потребовать корректировки для компиляции. В этом случае обратитесь к официальной документации Kotlin. Большинство проблем можно решить, убедившись, что у вас установлены последние версии Gradle и плагина Android Gradle, как описано в документации Kotlin

=== Технологическая поддержка ===

==== Поддержка новых технологий ====

* NGINX Plus R31 (модуль NGINX)
* Node.js 21 (модуль Node.js)
* Node.js 14, 16, 18, 20, 21 на Linux s390x (модуль Node.js)
* OpenTelemetry 1.0.0 (модуль PHP)

==== Окончание поддержки ====

* Red Hat Enterprise Linux CoreOS 4.9 (модуль ОС)
** Окончание поддержки поставщика: 2023-04-18

=== Новые функции и улучшения ===

==== CRI-O hook удаляется при остановке ЕдиногоАгента в контейнере ====
''Наблюдаемость инфраструктуры | Kubernetes''

CRI-O hook теперь удаляется каждый раз, когда останавливается ЕдиныйАгент, работающий внутри контейнера.

=== Решенные проблемы ===
В выпуске 281 содержится 16 решенных проблем.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Общие
|5
|-
|Java
|2
|-
|.NET
|1
|-
|IIB
|1
|-
|Мейнфрейм
|1
|-
|модуль ОС
|4
|-
|Установщик ЕдиногоАгента
|1
|-
|Модуль OpenTracing
|1
|}

==== Общие ====

* Исправлена возможная дублирующая отчетность об IP-адресах для служб баз данных (приводящая к обнаружению службы на стороне кластера, создающему дублирующую службу базы данных), когда распознаватель имен хостов ЕдиногоАгента периодически обновляет записи DNS.
* Исправлена несовместимость с библиотекой musl-libc `gcompat`, которая могла приводить к сбою любых приложений (независимо от того, связаны ли они с musl или glibc), которые выполнялись в musl-libc с ее библиотекой-оболочкой `gcompat` при загрузке ЕдиногоАгента.
* Имя pod Kubernetes можно определить по имени хоста. В Windows вместо имени хоста использовалось полное доменное имя, что могло привести к неправильному распознаванию имени pod. С этим исправлением теперь используется имя физической машины, что является ожидаемым поведением.
* Если при первой попытке подключения к устройству SNMP не удается разрешить DNS-имя, источник данных повторит попытку подключения в следующем интервале.
* Исправлено развертывание ЕдиногоАгента на экземплярах RKE2 (установка не удалась из-за завершения процесса oneagenthelper из-за недостаточных прав доступа к файлу containerd meta.db).

==== Java ====

* Тело ответа HTTP бизнес-событий теперь фиксируется правильно, даже если сжатие GZIP происходит вне цепочки фильтров сервлетов.
* Исправлена утечка памяти, возникавшая при отключении метрик Grail.

==== .NET ====

* Тело запроса больше не удаляется, если установлено правило бизнес-события для захвата тела запроса. ( OA-25428 )

==== IIB ====

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

==== Мейнфрейм ====

* Распределенные трассировки из CICS и IMS теперь правильно помечаются как дефектные, если превышен лимит узлов.

==== модуль ОС ====

* Исправлена ошибка, из-за которой процесс Spring Boot иногда назначался недопустимому объекту процесса.
* Теперь обнаруживаются контейнеры, работающие в частном пространстве имен пользователя.
* Исправлена группировка и обнаружение Spring Boot версии 3.2.
* Процессы Java теперь корректно сообщаются в случаях, когда JRE недоступен из модуля ОС.

==== Установщик ЕдиногоАгента ====

* Изменены политики SELinux, позволяющие системному вызову `ioctl` получать доступ к файлам метаданных обогащения Ключ-АСТРОМ.

==== Модуль OpenTracing ====

* Начиная с ЕдиногоАгента 281, модуль кода ЕдиныйАгент Envoy больше не внедряется в (и нет глубокого мониторинга) Envoy версии 1.29+. Ранее Envoy мог прервать запуск с ошибкой в версиях Envoy, которые больше не поддерживают определенные функции, требуемые ЕдинымАгентом.

===ЕдиныйАгент для Android===
Версия 281 не содержит решенных проблем, с которыми сталкиваются пользователи.

=== ЕдиныйАгент для iOS ===

==== ЕдиныйАгент для обновлений iOS ====
''Цифровой опыт | RUM Mobile''

* Обновлена цель развертывания до iOS 12.
* Добавлен манифест о конфиденциальности.
* Большая часть использования CoreTelephony заменена на сетевой API.
* Подписанный фреймворк Ключ-АСТРОМ.

==== Повтор сеанса для обновлений iOS ====
''Цифровой опыт | RUM Mobile''

* Обновлена цель развертывания до iOS 12.
* Добавлен манифест о конфиденциальности.
* Подписанная структура воспроизведения сеанса.

==== Решенные проблемы ====
Версия 281 не содержит решенных проблем, с которыми сталкиваются пользователи.
===Решённые проблемы ЕдиногоАгента для JavaScript===
Версия 281 содержит 1 решенную проблему.

* Исправлена ошибка, из-за которой агент JavaScript вызывал утечку отсоединенных элементов iframe на странице.

== '''API Ключ-АСТРОМ''' ==

=== API среды ===

* ЕдиныйАгент на хостовом API
** Новое возможное значение в поле monitoringType : <code>DISCOVERY</code>
** Новый параметр запроса в <code>GET /oneagents</code>запросе unlicensed ( <code>boolean</code>)

* API токенов доступа
** Новое возможное значение в поле scopes объектов ApiToken , ApiTokenCreate и ApiTokenUpdate : <code>extensionConfigurationActions.write</code>

* API хранилища учетных данных
** Новое поле в объектах Credentials и CredentialsResponseElement : allowContextlessRequests ( <code>boolean</code>)

* Проблемы безопасности API
** Изменен тип поля relatedContainerImages<code>array</code> с на <code>object</code>в объекте SecurityProblemDetails .

* Расширения 2.0 API
** Новое возможное поле в объекте PropertyDefinition : migrationPattern ( <code>String</code>)
* Настройки 2.0 - Доступные схемы
** Новое возможное поле в объекте PropertyDefinition : migrationPattern ( <code>String</code>)

* Унифицированный анализ ''Ранний пользователь''
** Новое обязательное поле в объекте UAEventsCard : ключ ( <code>String</code>)

=== API конфигурации ===

* API конфигурации веб-приложения
** Новое возможное поле в объекте MonitoringSettings : useCors ( <code>boolean</code>)
** Поле изменено с обязательного на необязательное в объекте MonitoringSettings : cookiePlacementDomain

=== API кластера ===

* <code>/settings/schemas/{schemaId}</code>
** Новое поле в объекте PropertyDefinition : migrationPattern ( <code>String</code>)

=== Доступность GA ===

* API среды <code>PUT /extensions/{extensionName}/monitoringConfigurations/{configurationId}/actions</code>

=== Устаревшее ===
Следующие API теперь устарели:

* API автоматически применяемых тегов устаревший
** <code>GET /autoTags</code>
** <code>POST /autoTags</code>
** <code>POST /autoTags/validator</code>
** <code>GET /autoTags/{id}</code>
** <code>PUT /autoTags/{id}</code>
** <code>DELETE /autoTags/{id}</code>
** <code>POST /autoTags/{id}/validator</code> Вместо этого используйте API настроек со схемой «Автоматически применяемые теги» ( <code>builtin:tags.auto-tagging</code>).
* API зон управления ''устаревшее''
** <code>GET /managementZones</code>
** <code>POST /managementZones</code>
** <code>POST /managementZones/validator</code>
** <code>GET /managementZones/{id}</code>
** <code>PUT /managementZones/{id}</code>
** <code>DELETE /managementZones/{id}</code>
** <code>POST /managementZones/{id}/validator</code> Вместо этого используйте API настроек со схемой настроек зон управления ( <code>builtin:management-zones</code>).

Примечания к релизу 284

2024-09-30T07:45:13Z

ENetrebin: /* API Ключ-АСТРОМ */

'''''[[Примечания к релизам]] / Примечания к релизу 284'''''

== '''Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Разрешить все атрибуты по умолчанию ====
''Наблюдаемость приложений | Распределенные трассировки''

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

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

Чтобы изменить сохранение атрибутов OpenTelemetry по умолчанию, перейдите в ''Настройки > Мониторинг служб на стороне сервера > Захват атрибутов > Настройки'' и выберите ''Разрешить все атрибуты'' (чтобы использовать список заблокированных атрибутов ) или ''Блокировать все атрибуты'' (чтобы использовать список разрешенных атрибутов ). Обратите внимание, что эти настройки применяются как к OpenTelemetry, так и к OpenTracing.

=== Окончание поддержки Log Monitoring v1 ===
Log Monitoring версии 1 достигла конца жизненного цикла и отключена в этом выпуске (Ключ-АСТРОМ Managed версии 1.284). В результате применяются следующие изменения:

* Log Viewer не отображает никаких данных лога.
* API Log Monitoring v1 отключен.
* Метрики лога (v1) не фиксируются. Конфигурация доступна только для чтения.
* События лога (v1) не запускаются. Конфигурация доступна только для чтения.
* Прием логов (v1) отключен.
* Конфигурация источника лога сохраняется для будущего использования.
* На страницах объектов, таких как «Хост», «Процесс» и «Группа процессов», не отображаются файлы логов.
* Подключенный том NFS для хранения логов больше не используется.

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

=== Новые функции и улучшения ===

==== Возможность выбора формата команд cURL в API Explorer ====
''Платформа | API''

В API Explorer теперь можно выбрать формат команд cURL:

* bash
* PowerShell (Windows)
* Командная строка (Windows)

==== Отображение данных сервиса AWS Lambda ====
''Наблюдаемость инфраструктуры | AWS''

Страница сервиса Lambda теперь беспрепятственно отображает данные как из AWS Lambda (встроенной), так и из новой интеграции AWS Lambda CloudWatch, что обеспечивает плавный переход.

* Старые и новые данные сервиса Lambda, поступающие из интеграции с AWS, теперь отображаются на странице сервиса Lambda (интеграция уровня Lambda) вместе с данными ЕдиногоАгента, когда включена интеграция с AWS CloudWatch и отслеживается сервис Lambda (встроенный или новый).
* На странице сервиса Lambda теперь вы можете найти метрики и свойства CloudWatch для нового сервиса Lambda.
* Если вы хотите изучить больше показателей CloudWatch, перейдите по ссылке на отдельную страницу для нового сервиса Lambda.
* Логи интеграции ЕдиногоАгента и пересылки журналов AWS также связаны с новым сервисом AWS Lambda.
* Вы можете включить предопределенную конфигурацию событий метрики для высокого уровня ошибок Lambda на основе нового сервиса AWS Lambda на странице настроек для интеграций AWS.

==== Возможность загрузки полного набора результатов логов ====
''Инфраструктура Наблюдаемость | Логи''

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

==== Временная метка создания узла Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Добавлена информация о временной метке создания узла Kubernetes на карточку свойств и в API.

==== Обновление минимальной версии АктивногоШлюза до 1.279 ====
''Наблюдаемость инфраструктуры | Kubernetes''

В связи с недавними изменениями в мониторинге Kubernetes минимальная версия АктивногоШлюза была обновлена до 1.279, чтобы обеспечить доступность новейших функций.

==== Улучшенная обработка запросов на события и проблемы для сред с несколькими центрами обработки данных ====
Улучшена обработка запросов на события и проблемы для сред с несколькими центрами обработки данных, что повысило стабильность в отношении дублирования документов о проблемах/событиях между различными центрами обработки данных и позволило решить такие проблемы, как ошибочное отображение закрытой проблемы как открытой.

==== Ограничение изменений в NGINX ====
Лимиты NGINX были изменены следующим образом:

* <code>worker_rlimit_nofile</code>: 102,400
* <code>worker_connections</code>: 100,000

=== Поддержка операционных систем ===
Обновление кластера Ключ-АСТРОМ Managed больше невозможно в Red Hat Enterprise Linux 8.4, Oracle Linux 8.4 и Suse Linux Enterprise Server 12.4.

==== Поддержка добавлена ====

* Обновление до этой версии Ключ-АСТРОМ Managed поддерживается для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

* Elasticsearch теперь работает в среде выполнения Java 17.0.8.

==== Следующие операционные системы больше не будут поддерживаться с 1 октября 2024 г. ====

* Linux : SUSE Enterprise Linux 15.2
** x86-64
** Последняя совместимая версия: 1.300

==== Следующие операционные системы больше не поддерживаются с 01 июля 2024 г. ====

* Linux : Amazon Linux AMI 2018.x
** x86-64
** Последняя совместимая версия: 1.290

==== Следующие операционные системы больше не поддерживаются с 01 августа 2024 г. ====

* Linux : Oracle Linux 8.9
** x86-64
** Последняя совместимая версия: 1.292

=== Решенные проблемы ===
В выпуске 284 решены 26 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Кластер
|22
|-
|Health
|1
|-
|Синтетический мониторинг
|3
|}

==== Кластер ====

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

* Улучшена обработка связей между объектами в контексте проблемы при построении ссылок в пользовательском интерфейсе.
* Исправлена проблема, при которой пользователи без разрешений на запись настроек, но с соответствующими разрешениями на зону управления получали ошибку при попытке массового закрытия проблем в списке проблем (веб-интерфейс) в средах, где запись настроек не требуется для выполнения закрытия проблемы (настройка по умолчанию). Это также исправляет обработку REST API закрытия проблемы, требующую разрешения на запись настроек только в средах, где запись настроек не требуется для выполнения закрытия проблемы.
* Исправлена информация о времени возникновения проблемы на странице сведений о проблеме (в разделе под заголовком проблемы) для проблем, которые начинались как частые проблемы. (Теперь используются правильные временные метки для времени, когда были зарегистрированы события и когда проблема изменилась с частой на ненормальную.)
* Исправлено переполнение текста на странице сведений о проблеме в разделе «Запрос Grail», возникавшее в некоторых браузерах (например, Firefox) при проблемах с длинными запросами DQL.
* Классические панели мониторинга: теперь хост правильно выделяется красным цветом в сотовой визуализации на панели мониторинга, когда связанный объект имеет открытую проблему.
* Чтобы точнее показать, что использовалось для анализа, в метрической диаграмме сведений о проблеме для метрических событий вверху теперь используется разрешение в 1 минуту, если временной интервал проблемы короче дня.
* Внутри операторов сопоставления можно использовать открывающие и закрывающие скобки как часть свойства службы или хоста.
* Решена проблема, которая препятствовала доступу к нескольким страницам глобальных настроек для пользователей с назначенными условными политиками IAM.
* Окно обслуживания может подавлять события для оповещения или создания проблемы. Если новый отчет о событии пришел после окончания ранее соответствующего окна обслуживания для его существующего события, время окончания подавленного события устанавливалось на конечную временную метку нового отчета. Это исправление изменяет это поведение на начальную временную метку нового отчета, так что подавленное событие заканчивается в то же время, когда открывается и оповещается новое неподавленное событие.
* Пользователи больше не могут отменять извлеченные службы, если у них нет прав на запись настроек на уровне клиента.
* Чтобы предотвратить большие времена отклика и задержки в решении проблем, вызванные тем, что менеджер по проблемам тратит слишком много времени на оценку регулярных выражений профиля оповещения, регулярные выражения в новых фильтрах заголовков/описаний событий профиля оповещения теперь ограничены.
* Отключено редактирование местоположений, назначенных синтетическому монитору, и кнопка «Установить ЕдиныйАгент» для пользователей, к которым применяется политика «только для чтения».
* В проводнике данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлена ошибка, из-за которой определенные приложения, требующие разрешений, были невидимы для пользователей, привязанных к зонам управления.
* Лимиты по умолчанию теперь правильно применяются в существующих клиентах для отчетов о событиях лога Kubernetes, доступности и метрик.
* Уровень риска метрики количества затронутых объектов теперь основан на уровне риска в контексте данной объкута. Это делает метрику еще более осведомленной о зоне управления.
* Исправлен фильтр селектора метрик, оценивавший условия независимо и возвращавший слишком много данных.
* В обозревателе данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлен процесс миграции кластера в режим поддержки стойки.
* Java v17.0.8 была заменена на v17.0.10.

==== Health ====

* Исправлен расчет критического статуса для ЕдиныхАгентов для просроченных дат.

==== Синтетический мониторинг ====

* Учетные данные, предоставленные списку пользователей, теперь можно фильтровать по типу общего доступа.
* Исправлена ошибка, из-за которой синтетическое расположение Kubernetes, развернутое в кластере с ограниченными ресурсами и интенсивно используемое, могло использовать больше памяти, чем разрешено, и быть уничтожено кластером Kubernetes из-за ошибки OOM.
* Решена проблема, из-за которой синтетические мониторы с общими учетными данными могли редактироваться пользователями, не имеющими доступа к этим учетным данным.

== '''ЕдиныйАгент Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Прием контейнера логов через ЕдиныйАгент ====
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Лог мониторинга''

Логи, собранные с помощью ЕдиногоАгента из систем оркестровки контейнеров Kubernetes и неоркестрованных сред Docker, теперь сообщаются с <code>log.source</code>указанием вывода контейнера вместо пути к физическому файлу, из которого они были получены.

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

Однако правила приема логов для логов Kubernetes и Docker обычно основаны на определенных атрибутах, связанных с контейнером, таких как пространство имен Kubernetes или имя контейнера .

Обновление : <code>log.source</code>теперь можно использовать сопоставление для управления приемом логов контейнеризованных приложений. ''устаревшее.''

* <code>log.source</code>Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуется переход на использование атрибутов, связанных с Kubernetes, вместо атрибута.
* Аналогичная миграция для учета изменений атрибутов <code>log.source</code>контейнеров требуется в правилах обработки логов, а также в метриках логов и конфигурациях событий логов.

=== Удалены значения по умолчанию dt_security_context ===
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Хосты''

Поле разрешения <code>dt.security_context</code>в <code>dt_host_metadata</code>файле зарезервировано только для значений, определяемых пользователем. Оно больше не имеет значения по умолчанию, если пользователем явно не указаны значения.

=== Технологическая поддержка ===

==== Поддержка новых технологий ====

* MongoDB 1.3 - 1.13 (модуль Go). Функция ЕдиногоАгента: Go MongoDB
* OpenResty 25.3.1 (модуль NGINX)
* z/OS 3.1 (модуль zDC)

==== Окончание поддержки ====

* Node.js 19 (модуль Node.js)
** Окончание поддержки поставщика: 2023-06-01

=== Новые функции и улучшения ===

==== Исключен адаптер обратной связи Microsoft KM-TEST из обнаруженных сетевых карт ====
''Наблюдаемость инфраструктуры | Хосты''

Адаптер обратной связи Microsoft KM-TEST исключен из обнаружения и не сообщается в Ключ-АСТРОМ.

=== Решенные проблемы ===
В выпуске 282 решены 23 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Обшие
|3
|-
| Java
|2
|-
|Мейефрейм
|1
|-
|Модуль ОС
|1
|-
|Apache
|1
|-
|Модуль OpenTracing
|1
|-
|.NET
|2
|}
====Общие====

* Чтобы ограничить влияние критических изменений «Прием логов контейнеров через ЕдиныйАгент»: использование сопоставления `log.source` для управления приемом логов контейнерных приложений теперь устарело. Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуют перехода на использование атрибутов, связанных с Kubernetes, вместо атрибута `log.source`. Аналогичная миграция для учета изменений в атрибуте `log.source` для контейнеров требуется в правилах обработки логов.
* Исправлено поведение в крайних случаях для настроенных асинхронных методов как службы обмена сообщениями .NET.
* Исправлены (удалены) чрезмерно подробные записи лога для PHP, которые приводили к большому количеству записей, связанных с WorkProxy, которые невозможно было отключить.

==== Java ====

* Данные Ключ-АСТРОМ, обогащенные неструктурированными логами Logback, теперь заключены в скобки `[!dt ]`.
* Исправлена проблема, которая иногда приводила к сбою ЕдиногоАгента, если приложение выдавало `StackOverflowError` во время запуска.

==== Мейнфрейм ====

* Исправлена ошибка последовательности функций SQL Fetch (CLI0125E).

==== модуль ОС ====

* Исправлена ошибка, из-за которой расширения не запускались на серверах Azure.

==== Apache ====

* Исправлена проблема сбоя переименованного Apache Web Server (IHS) путем отключения функциональности Apache Log Enrichment для таких серверов по умолчанию.

==== Модуль OpenTracing ====

* Добавлена поддержка Envoy 1.29.x.

==== .NET ====

* Исправлена ошибка, из-за которой запросы к URL-адресу RUM-маяка могли влиять на доступность приложения при определенных условиях.
* Исправлена ошибка в функции WCF v2, которая приводила к дублированию вызовов служб для одного и того же запроса.

=== ЕдиныйАгент для Android ===
''Цифровой опыт | RUM Mobile''

* Новый вариант метода <code>stopWebRequestTiming</code>API был добавлен в ЕдиныйАгентSDK для Android. Используйте новый <code>stopWebRequestTiming(URI requestUri, int respCode, String respPhrase, long requestSize, long responseSize)</code>метод API для дополнительной передачи размеров запроса и ответа при сообщении веб-запроса . Эта дополнительно указанная информация будет затем показана в веб-интерфейсе Ключ-АСТРОМ на следующих страницах.
** На странице сведений о веб-запросах отображается только размер запроса
** На странице анализа действий пользователя для веб-запросов, прикрепленных к действиям пользователя, отображаются размеры как запроса, так и ответа.

=== ЕдиныйАгент для iOS ===

==== Инициализаторы кнопок и меню ====
''Цифровой опыт | RUM Mobile''

Добавлен инструментарий для инициализаторов кнопок и меню iOS 17.

==== Решённые проблемы ====

===== ЕдиныйАгент для iOS =====

* Инструментарий SwiftUI: переменные привязки констант теперь инструментируются правильно.
* Инструмент SwiftUI: имена элементов управления с неявными ссылками на константы теперь разрешаются правильно.

=== Решённые проблемы ЕдиногоАгента для JavaScript ===

* Исправлена проблема, когда модуль XHR создавал события прогресса как `Event` вместо `ProgressEvent`, из-за чего проверки `instanceof` не срабатывали. Это было особенно актуально для оболочки XHR, которую использует Flutter.

== '''API Ключ-АСТРОМ''' ==

=== API конфигурации ===

* API метрик обслуживания
** Новое возможное значение в поле метрики объекта metricDefinition : <code>CAPTURED_FULL_SERVICE_CALLS</code>

* API атрибутов запроса
** Технология обслуживания объектов недвижимости в сфере объектов имеет новое возможное значение: <code>ORACLE_DB_LISTENER</code>

=== API среды ===

* Атаки Early Adopter
** Новое возможное значение в поле attackType объекта атаки : <code>SSRF</code>
** Новое возможное значение в поле типа объекта unreliableFunctionInput : <code>HTTP_CLIENT</code>
* Проблемы безопасности
** Новое возможное значение в поле типа объекта codeLevelVulnerabilityDetails : <code>SSRF</code>
** Новое возможное значение в поле типа объекта unreliableFunctionInput : <code>HTTP_CLIENT</code>

* Расширения 2.0 API - GET active
** Новые возможные значения в поле типа объекта активов : <code>DQL_LOG_PROCESSING_RULE</code> <code>LQL_LOG_PROCESSING_RULE</code>

* API логов мониторинга — GET Export Logs ''Early Adopter''
** Изменено: <code>[ssoAuth=[environment-api]]</code>на<code>[ssoAuth=[storage:logs:read]]</code>

* Унифицированный анализ ''Early Adopter''
** Новое возможное значение в поле logsCard объекта UAEntityScreenDefinition : <code>logRecommendationQueries</code>

* API контролируемых состояний
** Новое возможное значение в свойстве состояния объекта monitoringStates : <code>restart_required_host_group_inconsistent</code>

=== Доступность для Early Adopter ===
Следующий API теперь доступен в версии Early Adopter :

* <code>GET /extensions/{technology}/availableHosts</code> Изменена технология в пути: добавлено значение перечисления:<code>ORACLE_DB_LISTENER</code>

=== Устаревшее ===
Следующие конечные точки Log Monitoring API v1 устарели.

* Log Monitoring API v1
** <code>GET /entity/infrastructure/custom-devices/{customDeviceId}/logs</code>
** <code>GET /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}</code>
** <code>DELETE /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}</code>
** <code>GET /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/custom-devices/{customDeviceId}/logs/jobs/{jobId}/records/top</code>
** <code>POST /entity/infrastructure/custom-devices/{customDeviceId}/logs/{logPath}</code>
** <code>GET /entity/infrastructure/hosts/{hostId}/logs</code>
** <code>GET /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}</code>
** <code>DELETE /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}</code>
** <code>GET /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/hosts/{hostId}/logs/jobs/{jobId}/records/top</code>
** <code>POST /entity/infrastructure/hosts/{hostId}/logs/{logPath}</code>
** <code>GET /entity/infrastructure/process-groups/{pgId}/logs</code>
** <code>GET /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}</code>
** <code>DELETE /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}</code>
** <code>GET /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}/records</code>
** <code>POST /entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}/records/top</code>
** <code>POST /entity/infrastructure/process-groups/{pgId}/logs/{logPath}</code>
* Log Monitoring v1 metrics API
** <code>GET /calculatedMetrics/log</code>
** <code>GET /calculatedMetrics/log/{metricKey}</code>
** <code>PUT /calculatedMetrics/log/{metricKey}</code>
** <code>DELETE /calculatedMetrics/log/{metricKey}</code>
** <code>POST /calculatedMetrics/log/{metricKey}/validator</code>

Примечания к релизу 284

2024-09-30T07:38:37Z

ENetrebin: /* Решённые проблемы ЕдиногоАгента для JavaScript */

'''''[[Примечания к релизам]] / Примечания к релизу 284'''''

== '''Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Разрешить все атрибуты по умолчанию ====
''Наблюдаемость приложений | Распределенные трассировки''

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

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

Чтобы изменить сохранение атрибутов OpenTelemetry по умолчанию, перейдите в ''Настройки > Мониторинг служб на стороне сервера > Захват атрибутов > Настройки'' и выберите ''Разрешить все атрибуты'' (чтобы использовать список заблокированных атрибутов ) или ''Блокировать все атрибуты'' (чтобы использовать список разрешенных атрибутов ). Обратите внимание, что эти настройки применяются как к OpenTelemetry, так и к OpenTracing.

=== Окончание поддержки Log Monitoring v1 ===
Log Monitoring версии 1 достигла конца жизненного цикла и отключена в этом выпуске (Ключ-АСТРОМ Managed версии 1.284). В результате применяются следующие изменения:

* Log Viewer не отображает никаких данных лога.
* API Log Monitoring v1 отключен.
* Метрики лога (v1) не фиксируются. Конфигурация доступна только для чтения.
* События лога (v1) не запускаются. Конфигурация доступна только для чтения.
* Прием логов (v1) отключен.
* Конфигурация источника лога сохраняется для будущего использования.
* На страницах объектов, таких как «Хост», «Процесс» и «Группа процессов», не отображаются файлы логов.
* Подключенный том NFS для хранения логов больше не используется.

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

=== Новые функции и улучшения ===

==== Возможность выбора формата команд cURL в API Explorer ====
''Платформа | API''

В API Explorer теперь можно выбрать формат команд cURL:

* bash
* PowerShell (Windows)
* Командная строка (Windows)

==== Отображение данных сервиса AWS Lambda ====
''Наблюдаемость инфраструктуры | AWS''

Страница сервиса Lambda теперь беспрепятственно отображает данные как из AWS Lambda (встроенной), так и из новой интеграции AWS Lambda CloudWatch, что обеспечивает плавный переход.

* Старые и новые данные сервиса Lambda, поступающие из интеграции с AWS, теперь отображаются на странице сервиса Lambda (интеграция уровня Lambda) вместе с данными ЕдиногоАгента, когда включена интеграция с AWS CloudWatch и отслеживается сервис Lambda (встроенный или новый).
* На странице сервиса Lambda теперь вы можете найти метрики и свойства CloudWatch для нового сервиса Lambda.
* Если вы хотите изучить больше показателей CloudWatch, перейдите по ссылке на отдельную страницу для нового сервиса Lambda.
* Логи интеграции ЕдиногоАгента и пересылки журналов AWS также связаны с новым сервисом AWS Lambda.
* Вы можете включить предопределенную конфигурацию событий метрики для высокого уровня ошибок Lambda на основе нового сервиса AWS Lambda на странице настроек для интеграций AWS.

==== Возможность загрузки полного набора результатов логов ====
''Инфраструктура Наблюдаемость | Логи''

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

==== Временная метка создания узла Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Добавлена информация о временной метке создания узла Kubernetes на карточку свойств и в API.

==== Обновление минимальной версии АктивногоШлюза до 1.279 ====
''Наблюдаемость инфраструктуры | Kubernetes''

В связи с недавними изменениями в мониторинге Kubernetes минимальная версия АктивногоШлюза была обновлена до 1.279, чтобы обеспечить доступность новейших функций.

==== Улучшенная обработка запросов на события и проблемы для сред с несколькими центрами обработки данных ====
Улучшена обработка запросов на события и проблемы для сред с несколькими центрами обработки данных, что повысило стабильность в отношении дублирования документов о проблемах/событиях между различными центрами обработки данных и позволило решить такие проблемы, как ошибочное отображение закрытой проблемы как открытой.

==== Ограничение изменений в NGINX ====
Лимиты NGINX были изменены следующим образом:

* <code>worker_rlimit_nofile</code>: 102,400
* <code>worker_connections</code>: 100,000

=== Поддержка операционных систем ===
Обновление кластера Ключ-АСТРОМ Managed больше невозможно в Red Hat Enterprise Linux 8.4, Oracle Linux 8.4 и Suse Linux Enterprise Server 12.4.

==== Поддержка добавлена ====

* Обновление до этой версии Ключ-АСТРОМ Managed поддерживается для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

* Elasticsearch теперь работает в среде выполнения Java 17.0.8.

==== Следующие операционные системы больше не будут поддерживаться с 1 октября 2024 г. ====

* Linux : SUSE Enterprise Linux 15.2
** x86-64
** Последняя совместимая версия: 1.300

==== Следующие операционные системы больше не поддерживаются с 01 июля 2024 г. ====

* Linux : Amazon Linux AMI 2018.x
** x86-64
** Последняя совместимая версия: 1.290

==== Следующие операционные системы больше не поддерживаются с 01 августа 2024 г. ====

* Linux : Oracle Linux 8.9
** x86-64
** Последняя совместимая версия: 1.292

=== Решенные проблемы ===
В выпуске 284 решены 26 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Кластер
|22
|-
|Health
|1
|-
|Синтетический мониторинг
|3
|}

==== Кластер ====

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

* Улучшена обработка связей между объектами в контексте проблемы при построении ссылок в пользовательском интерфейсе.
* Исправлена проблема, при которой пользователи без разрешений на запись настроек, но с соответствующими разрешениями на зону управления получали ошибку при попытке массового закрытия проблем в списке проблем (веб-интерфейс) в средах, где запись настроек не требуется для выполнения закрытия проблемы (настройка по умолчанию). Это также исправляет обработку REST API закрытия проблемы, требующую разрешения на запись настроек только в средах, где запись настроек не требуется для выполнения закрытия проблемы.
* Исправлена информация о времени возникновения проблемы на странице сведений о проблеме (в разделе под заголовком проблемы) для проблем, которые начинались как частые проблемы. (Теперь используются правильные временные метки для времени, когда были зарегистрированы события и когда проблема изменилась с частой на ненормальную.)
* Исправлено переполнение текста на странице сведений о проблеме в разделе «Запрос Grail», возникавшее в некоторых браузерах (например, Firefox) при проблемах с длинными запросами DQL.
* Классические панели мониторинга: теперь хост правильно выделяется красным цветом в сотовой визуализации на панели мониторинга, когда связанный объект имеет открытую проблему.
* Чтобы точнее показать, что использовалось для анализа, в метрической диаграмме сведений о проблеме для метрических событий вверху теперь используется разрешение в 1 минуту, если временной интервал проблемы короче дня.
* Внутри операторов сопоставления можно использовать открывающие и закрывающие скобки как часть свойства службы или хоста.
* Решена проблема, которая препятствовала доступу к нескольким страницам глобальных настроек для пользователей с назначенными условными политиками IAM.
* Окно обслуживания может подавлять события для оповещения или создания проблемы. Если новый отчет о событии пришел после окончания ранее соответствующего окна обслуживания для его существующего события, время окончания подавленного события устанавливалось на конечную временную метку нового отчета. Это исправление изменяет это поведение на начальную временную метку нового отчета, так что подавленное событие заканчивается в то же время, когда открывается и оповещается новое неподавленное событие.
* Пользователи больше не могут отменять извлеченные службы, если у них нет прав на запись настроек на уровне клиента.
* Чтобы предотвратить большие времена отклика и задержки в решении проблем, вызванные тем, что менеджер по проблемам тратит слишком много времени на оценку регулярных выражений профиля оповещения, регулярные выражения в новых фильтрах заголовков/описаний событий профиля оповещения теперь ограничены.
* Отключено редактирование местоположений, назначенных синтетическому монитору, и кнопка «Установить ЕдиныйАгент» для пользователей, к которым применяется политика «только для чтения».
* В проводнике данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлена ошибка, из-за которой определенные приложения, требующие разрешений, были невидимы для пользователей, привязанных к зонам управления.
* Лимиты по умолчанию теперь правильно применяются в существующих клиентах для отчетов о событиях лога Kubernetes, доступности и метрик.
* Уровень риска метрики количества затронутых объектов теперь основан на уровне риска в контексте данной объкута. Это делает метрику еще более осведомленной о зоне управления.
* Исправлен фильтр селектора метрик, оценивавший условия независимо и возвращавший слишком много данных.
* В обозревателе данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлен процесс миграции кластера в режим поддержки стойки.
* Java v17.0.8 была заменена на v17.0.10.

==== Health ====

* Исправлен расчет критического статуса для ЕдиныхАгентов для просроченных дат.

==== Синтетический мониторинг ====

* Учетные данные, предоставленные списку пользователей, теперь можно фильтровать по типу общего доступа.
* Исправлена ошибка, из-за которой синтетическое расположение Kubernetes, развернутое в кластере с ограниченными ресурсами и интенсивно используемое, могло использовать больше памяти, чем разрешено, и быть уничтожено кластером Kubernetes из-за ошибки OOM.
* Решена проблема, из-за которой синтетические мониторы с общими учетными данными могли редактироваться пользователями, не имеющими доступа к этим учетным данным.

== '''ЕдиныйАгент Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Прием контейнера логов через ЕдиныйАгент ====
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Лог мониторинга''

Логи, собранные с помощью ЕдиногоАгента из систем оркестровки контейнеров Kubernetes и неоркестрованных сред Docker, теперь сообщаются с <code>log.source</code>указанием вывода контейнера вместо пути к физическому файлу, из которого они были получены.

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

Однако правила приема логов для логов Kubernetes и Docker обычно основаны на определенных атрибутах, связанных с контейнером, таких как пространство имен Kubernetes или имя контейнера .

Обновление : <code>log.source</code>теперь можно использовать сопоставление для управления приемом логов контейнеризованных приложений. ''устаревшее.''

* <code>log.source</code>Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуется переход на использование атрибутов, связанных с Kubernetes, вместо атрибута.
* Аналогичная миграция для учета изменений атрибутов <code>log.source</code>контейнеров требуется в правилах обработки логов, а также в метриках логов и конфигурациях событий логов.

=== Удалены значения по умолчанию dt_security_context ===
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Хосты''

Поле разрешения <code>dt.security_context</code>в <code>dt_host_metadata</code>файле зарезервировано только для значений, определяемых пользователем. Оно больше не имеет значения по умолчанию, если пользователем явно не указаны значения.

=== Технологическая поддержка ===

==== Поддержка новых технологий ====

* MongoDB 1.3 - 1.13 (модуль Go). Функция ЕдиногоАгента: Go MongoDB
* OpenResty 25.3.1 (модуль NGINX)
* z/OS 3.1 (модуль zDC)

==== Окончание поддержки ====

* Node.js 19 (модуль Node.js)
** Окончание поддержки поставщика: 2023-06-01

=== Новые функции и улучшения ===

==== Исключен адаптер обратной связи Microsoft KM-TEST из обнаруженных сетевых карт ====
''Наблюдаемость инфраструктуры | Хосты''

Адаптер обратной связи Microsoft KM-TEST исключен из обнаружения и не сообщается в Ключ-АСТРОМ.

=== Решенные проблемы ===
В выпуске 282 решены 23 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Обшие
|3
|-
| Java
|2
|-
|Мейефрейм
|1
|-
|Модуль ОС
|1
|-
|Apache
|1
|-
|Модуль OpenTracing
|1
|-
|.NET
|2
|}
====Общие====

* Чтобы ограничить влияние критических изменений «Прием логов контейнеров через ЕдиныйАгент»: использование сопоставления `log.source` для управления приемом логов контейнерных приложений теперь устарело. Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуют перехода на использование атрибутов, связанных с Kubernetes, вместо атрибута `log.source`. Аналогичная миграция для учета изменений в атрибуте `log.source` для контейнеров требуется в правилах обработки логов.
* Исправлено поведение в крайних случаях для настроенных асинхронных методов как службы обмена сообщениями .NET.
* Исправлены (удалены) чрезмерно подробные записи лога для PHP, которые приводили к большому количеству записей, связанных с WorkProxy, которые невозможно было отключить.

==== Java ====

* Данные Ключ-АСТРОМ, обогащенные неструктурированными логами Logback, теперь заключены в скобки `[!dt ]`.
* Исправлена проблема, которая иногда приводила к сбою ЕдиногоАгента, если приложение выдавало `StackOverflowError` во время запуска.

==== Мейнфрейм ====

* Исправлена ошибка последовательности функций SQL Fetch (CLI0125E).

==== модуль ОС ====

* Исправлена ошибка, из-за которой расширения не запускались на серверах Azure.

==== Apache ====

* Исправлена проблема сбоя переименованного Apache Web Server (IHS) путем отключения функциональности Apache Log Enrichment для таких серверов по умолчанию.

==== Модуль OpenTracing ====

* Добавлена поддержка Envoy 1.29.x.

==== .NET ====

* Исправлена ошибка, из-за которой запросы к URL-адресу RUM-маяка могли влиять на доступность приложения при определенных условиях.
* Исправлена ошибка в функции WCF v2, которая приводила к дублированию вызовов служб для одного и того же запроса.

=== ЕдиныйАгент для Android ===
''Цифровой опыт | RUM Mobile''

* Новый вариант метода <code>stopWebRequestTiming</code>API был добавлен в ЕдиныйАгентSDK для Android. Используйте новый <code>stopWebRequestTiming(URI requestUri, int respCode, String respPhrase, long requestSize, long responseSize)</code>метод API для дополнительной передачи размеров запроса и ответа при сообщении веб-запроса . Эта дополнительно указанная информация будет затем показана в веб-интерфейсе Ключ-АСТРОМ на следующих страницах.
** На странице сведений о веб-запросах отображается только размер запроса
** На странице анализа действий пользователя для веб-запросов, прикрепленных к действиям пользователя, отображаются размеры как запроса, так и ответа.

=== ЕдиныйАгент для iOS ===

==== Инициализаторы кнопок и меню ====
''Цифровой опыт | RUM Mobile''

Добавлен инструментарий для инициализаторов кнопок и меню iOS 17.

==== Решённые проблемы ====

===== ЕдиныйАгент для iOS =====

* Инструментарий SwiftUI: переменные привязки констант теперь инструментируются правильно.
* Инструмент SwiftUI: имена элементов управления с неявными ссылками на константы теперь разрешаются правильно.

=== Решённые проблемы ЕдиногоАгента для JavaScript ===

* Исправлена проблема, когда модуль XHR создавал события прогресса как `Event` вместо `ProgressEvent`, из-за чего проверки `instanceof` не срабатывали. Это было особенно актуально для оболочки XHR, которую использует Flutter.

== '''API Ключ-АСТРОМ''' ==

=== API конфигурации ===

* API метрик обслуживания
** Новое возможное значение в поле метрики объекта metricDefinition : <code>CAPTURED_FULL_SERVICE_CALLS</code>

=== API среды ===

* Атаки Early Adopter
** Новое возможное значение в поле attackType объекта атаки : <code>SSRF</code>
** Новое возможное значение в поле типа объекта unreliableFunctionInput : <code>HTTP_CLIENT</code>
* Проблемы безопасности
** Новое возможное значение в поле типа объекта codeLevelVulnerabilityDetails : <code>SSRF</code>
** Новое возможное значение в поле типа объекта unreliableFunctionInput : <code>HTTP_CLIENT</code>

* Расширения 2.0 API - GET active
** Новые возможные значения в поле типа объекта активов : <code>DQL_LOG_PROCESSING_RULE</code> <code>LQL_LOG_PROCESSING_RULE</code>

* API логов мониторинга — GET Export Logs ''Early Adopter''
** Изменено: <code>[ssoAuth=[environment-api]]</code>на<code>[ssoAuth=[storage:logs:read]]</code>

* Унифицированный анализ ''Early Adopter''
** Новое возможное значение в поле logsCard объекта UAEntityScreenDefinition : <code>logRecommendationQueries</code>

Примечания к релизу 284

2024-09-30T07:27:30Z

ENetrebin: /* .NET */

'''''[[Примечания к релизам]] / Примечания к релизу 284'''''

== '''Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Разрешить все атрибуты по умолчанию ====
''Наблюдаемость приложений | Распределенные трассировки''

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

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

Чтобы изменить сохранение атрибутов OpenTelemetry по умолчанию, перейдите в ''Настройки > Мониторинг служб на стороне сервера > Захват атрибутов > Настройки'' и выберите ''Разрешить все атрибуты'' (чтобы использовать список заблокированных атрибутов ) или ''Блокировать все атрибуты'' (чтобы использовать список разрешенных атрибутов ). Обратите внимание, что эти настройки применяются как к OpenTelemetry, так и к OpenTracing.

=== Окончание поддержки Log Monitoring v1 ===
Log Monitoring версии 1 достигла конца жизненного цикла и отключена в этом выпуске (Ключ-АСТРОМ Managed версии 1.284). В результате применяются следующие изменения:

* Log Viewer не отображает никаких данных лога.
* API Log Monitoring v1 отключен.
* Метрики лога (v1) не фиксируются. Конфигурация доступна только для чтения.
* События лога (v1) не запускаются. Конфигурация доступна только для чтения.
* Прием логов (v1) отключен.
* Конфигурация источника лога сохраняется для будущего использования.
* На страницах объектов, таких как «Хост», «Процесс» и «Группа процессов», не отображаются файлы логов.
* Подключенный том NFS для хранения логов больше не используется.

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

=== Новые функции и улучшения ===

==== Возможность выбора формата команд cURL в API Explorer ====
''Платформа | API''

В API Explorer теперь можно выбрать формат команд cURL:

* bash
* PowerShell (Windows)
* Командная строка (Windows)

==== Отображение данных сервиса AWS Lambda ====
''Наблюдаемость инфраструктуры | AWS''

Страница сервиса Lambda теперь беспрепятственно отображает данные как из AWS Lambda (встроенной), так и из новой интеграции AWS Lambda CloudWatch, что обеспечивает плавный переход.

* Старые и новые данные сервиса Lambda, поступающие из интеграции с AWS, теперь отображаются на странице сервиса Lambda (интеграция уровня Lambda) вместе с данными ЕдиногоАгента, когда включена интеграция с AWS CloudWatch и отслеживается сервис Lambda (встроенный или новый).
* На странице сервиса Lambda теперь вы можете найти метрики и свойства CloudWatch для нового сервиса Lambda.
* Если вы хотите изучить больше показателей CloudWatch, перейдите по ссылке на отдельную страницу для нового сервиса Lambda.
* Логи интеграции ЕдиногоАгента и пересылки журналов AWS также связаны с новым сервисом AWS Lambda.
* Вы можете включить предопределенную конфигурацию событий метрики для высокого уровня ошибок Lambda на основе нового сервиса AWS Lambda на странице настроек для интеграций AWS.

==== Возможность загрузки полного набора результатов логов ====
''Инфраструктура Наблюдаемость | Логи''

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

==== Временная метка создания узла Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Добавлена информация о временной метке создания узла Kubernetes на карточку свойств и в API.

==== Обновление минимальной версии АктивногоШлюза до 1.279 ====
''Наблюдаемость инфраструктуры | Kubernetes''

В связи с недавними изменениями в мониторинге Kubernetes минимальная версия АктивногоШлюза была обновлена до 1.279, чтобы обеспечить доступность новейших функций.

==== Улучшенная обработка запросов на события и проблемы для сред с несколькими центрами обработки данных ====
Улучшена обработка запросов на события и проблемы для сред с несколькими центрами обработки данных, что повысило стабильность в отношении дублирования документов о проблемах/событиях между различными центрами обработки данных и позволило решить такие проблемы, как ошибочное отображение закрытой проблемы как открытой.

==== Ограничение изменений в NGINX ====
Лимиты NGINX были изменены следующим образом:

* <code>worker_rlimit_nofile</code>: 102,400
* <code>worker_connections</code>: 100,000

=== Поддержка операционных систем ===
Обновление кластера Ключ-АСТРОМ Managed больше невозможно в Red Hat Enterprise Linux 8.4, Oracle Linux 8.4 и Suse Linux Enterprise Server 12.4.

==== Поддержка добавлена ====

* Обновление до этой версии Ключ-АСТРОМ Managed поддерживается для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

* Elasticsearch теперь работает в среде выполнения Java 17.0.8.

==== Следующие операционные системы больше не будут поддерживаться с 1 октября 2024 г. ====

* Linux : SUSE Enterprise Linux 15.2
** x86-64
** Последняя совместимая версия: 1.300

==== Следующие операционные системы больше не поддерживаются с 01 июля 2024 г. ====

* Linux : Amazon Linux AMI 2018.x
** x86-64
** Последняя совместимая версия: 1.290

==== Следующие операционные системы больше не поддерживаются с 01 августа 2024 г. ====

* Linux : Oracle Linux 8.9
** x86-64
** Последняя совместимая версия: 1.292

=== Решенные проблемы ===
В выпуске 284 решены 26 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Кластер
|22
|-
|Health
|1
|-
|Синтетический мониторинг
|3
|}

==== Кластер ====

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

* Улучшена обработка связей между объектами в контексте проблемы при построении ссылок в пользовательском интерфейсе.
* Исправлена проблема, при которой пользователи без разрешений на запись настроек, но с соответствующими разрешениями на зону управления получали ошибку при попытке массового закрытия проблем в списке проблем (веб-интерфейс) в средах, где запись настроек не требуется для выполнения закрытия проблемы (настройка по умолчанию). Это также исправляет обработку REST API закрытия проблемы, требующую разрешения на запись настроек только в средах, где запись настроек не требуется для выполнения закрытия проблемы.
* Исправлена информация о времени возникновения проблемы на странице сведений о проблеме (в разделе под заголовком проблемы) для проблем, которые начинались как частые проблемы. (Теперь используются правильные временные метки для времени, когда были зарегистрированы события и когда проблема изменилась с частой на ненормальную.)
* Исправлено переполнение текста на странице сведений о проблеме в разделе «Запрос Grail», возникавшее в некоторых браузерах (например, Firefox) при проблемах с длинными запросами DQL.
* Классические панели мониторинга: теперь хост правильно выделяется красным цветом в сотовой визуализации на панели мониторинга, когда связанный объект имеет открытую проблему.
* Чтобы точнее показать, что использовалось для анализа, в метрической диаграмме сведений о проблеме для метрических событий вверху теперь используется разрешение в 1 минуту, если временной интервал проблемы короче дня.
* Внутри операторов сопоставления можно использовать открывающие и закрывающие скобки как часть свойства службы или хоста.
* Решена проблема, которая препятствовала доступу к нескольким страницам глобальных настроек для пользователей с назначенными условными политиками IAM.
* Окно обслуживания может подавлять события для оповещения или создания проблемы. Если новый отчет о событии пришел после окончания ранее соответствующего окна обслуживания для его существующего события, время окончания подавленного события устанавливалось на конечную временную метку нового отчета. Это исправление изменяет это поведение на начальную временную метку нового отчета, так что подавленное событие заканчивается в то же время, когда открывается и оповещается новое неподавленное событие.
* Пользователи больше не могут отменять извлеченные службы, если у них нет прав на запись настроек на уровне клиента.
* Чтобы предотвратить большие времена отклика и задержки в решении проблем, вызванные тем, что менеджер по проблемам тратит слишком много времени на оценку регулярных выражений профиля оповещения, регулярные выражения в новых фильтрах заголовков/описаний событий профиля оповещения теперь ограничены.
* Отключено редактирование местоположений, назначенных синтетическому монитору, и кнопка «Установить ЕдиныйАгент» для пользователей, к которым применяется политика «только для чтения».
* В проводнике данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлена ошибка, из-за которой определенные приложения, требующие разрешений, были невидимы для пользователей, привязанных к зонам управления.
* Лимиты по умолчанию теперь правильно применяются в существующих клиентах для отчетов о событиях лога Kubernetes, доступности и метрик.
* Уровень риска метрики количества затронутых объектов теперь основан на уровне риска в контексте данной объкута. Это делает метрику еще более осведомленной о зоне управления.
* Исправлен фильтр селектора метрик, оценивавший условия независимо и возвращавший слишком много данных.
* В обозревателе данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлен процесс миграции кластера в режим поддержки стойки.
* Java v17.0.8 была заменена на v17.0.10.

==== Health ====

* Исправлен расчет критического статуса для ЕдиныхАгентов для просроченных дат.

==== Синтетический мониторинг ====

* Учетные данные, предоставленные списку пользователей, теперь можно фильтровать по типу общего доступа.
* Исправлена ошибка, из-за которой синтетическое расположение Kubernetes, развернутое в кластере с ограниченными ресурсами и интенсивно используемое, могло использовать больше памяти, чем разрешено, и быть уничтожено кластером Kubernetes из-за ошибки OOM.
* Решена проблема, из-за которой синтетические мониторы с общими учетными данными могли редактироваться пользователями, не имеющими доступа к этим учетным данным.

== '''ЕдиныйАгент Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Прием контейнера логов через ЕдиныйАгент ====
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Лог мониторинга''

Логи, собранные с помощью ЕдиногоАгента из систем оркестровки контейнеров Kubernetes и неоркестрованных сред Docker, теперь сообщаются с <code>log.source</code>указанием вывода контейнера вместо пути к физическому файлу, из которого они были получены.

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

Однако правила приема логов для логов Kubernetes и Docker обычно основаны на определенных атрибутах, связанных с контейнером, таких как пространство имен Kubernetes или имя контейнера .

Обновление : <code>log.source</code>теперь можно использовать сопоставление для управления приемом логов контейнеризованных приложений. ''устаревшее.''

* <code>log.source</code>Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуется переход на использование атрибутов, связанных с Kubernetes, вместо атрибута.
* Аналогичная миграция для учета изменений атрибутов <code>log.source</code>контейнеров требуется в правилах обработки логов, а также в метриках логов и конфигурациях событий логов.

=== Удалены значения по умолчанию dt_security_context ===
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Хосты''

Поле разрешения <code>dt.security_context</code>в <code>dt_host_metadata</code>файле зарезервировано только для значений, определяемых пользователем. Оно больше не имеет значения по умолчанию, если пользователем явно не указаны значения.

=== Технологическая поддержка ===

==== Поддержка новых технологий ====

* MongoDB 1.3 - 1.13 (модуль Go). Функция ЕдиногоАгента: Go MongoDB
* OpenResty 25.3.1 (модуль NGINX)
* z/OS 3.1 (модуль zDC)

==== Окончание поддержки ====

* Node.js 19 (модуль Node.js)
** Окончание поддержки поставщика: 2023-06-01

=== Новые функции и улучшения ===

==== Исключен адаптер обратной связи Microsoft KM-TEST из обнаруженных сетевых карт ====
''Наблюдаемость инфраструктуры | Хосты''

Адаптер обратной связи Microsoft KM-TEST исключен из обнаружения и не сообщается в Ключ-АСТРОМ.

=== Решенные проблемы ===
В выпуске 282 решены 23 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Обшие
|3
|-
| Java
|2
|-
|Мейефрейм
|1
|-
|Модуль ОС
|1
|-
|Apache
|1
|-
|Модуль OpenTracing
|1
|-
|.NET
|2
|}
====Общие====

* Чтобы ограничить влияние критических изменений «Прием логов контейнеров через ЕдиныйАгент»: использование сопоставления `log.source` для управления приемом логов контейнерных приложений теперь устарело. Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуют перехода на использование атрибутов, связанных с Kubernetes, вместо атрибута `log.source`. Аналогичная миграция для учета изменений в атрибуте `log.source` для контейнеров требуется в правилах обработки логов.
* Исправлено поведение в крайних случаях для настроенных асинхронных методов как службы обмена сообщениями .NET.
* Исправлены (удалены) чрезмерно подробные записи лога для PHP, которые приводили к большому количеству записей, связанных с WorkProxy, которые невозможно было отключить.

==== Java ====

* Данные Ключ-АСТРОМ, обогащенные неструктурированными логами Logback, теперь заключены в скобки `[!dt ]`.
* Исправлена проблема, которая иногда приводила к сбою ЕдиногоАгента, если приложение выдавало `StackOverflowError` во время запуска.

==== Мейнфрейм ====

* Исправлена ошибка последовательности функций SQL Fetch (CLI0125E).

==== модуль ОС ====

* Исправлена ошибка, из-за которой расширения не запускались на серверах Azure.

==== Apache ====

* Исправлена проблема сбоя переименованного Apache Web Server (IHS) путем отключения функциональности Apache Log Enrichment для таких серверов по умолчанию.

==== Модуль OpenTracing ====

* Добавлена поддержка Envoy 1.29.x.

==== .NET ====

* Исправлена ошибка, из-за которой запросы к URL-адресу RUM-маяка могли влиять на доступность приложения при определенных условиях.
* Исправлена ошибка в функции WCF v2, которая приводила к дублированию вызовов служб для одного и того же запроса.

=== ЕдиныйАгент для Android ===
''Цифровой опыт | RUM Mobile''

* Новый вариант метода <code>stopWebRequestTiming</code>API был добавлен в ЕдиныйАгентSDK для Android. Используйте новый <code>stopWebRequestTiming(URI requestUri, int respCode, String respPhrase, long requestSize, long responseSize)</code>метод API для дополнительной передачи размеров запроса и ответа при сообщении веб-запроса . Эта дополнительно указанная информация будет затем показана в веб-интерфейсе Ключ-АСТРОМ на следующих страницах.
** На странице сведений о веб-запросах отображается только размер запроса
** На странице анализа действий пользователя для веб-запросов, прикрепленных к действиям пользователя, отображаются размеры как запроса, так и ответа.

=== ЕдиныйАгент для iOS ===

==== Инициализаторы кнопок и меню ====
''Цифровой опыт | RUM Mobile''

Добавлен инструментарий для инициализаторов кнопок и меню iOS 17.

==== Решённые проблемы ====

===== ЕдиныйАгент для iOS =====

* Инструментарий SwiftUI: переменные привязки констант теперь инструментируются правильно.
* Инструмент SwiftUI: имена элементов управления с неявными ссылками на константы теперь разрешаются правильно.

=== Решённые проблемы ЕдиногоАгента для JavaScript ===

* Исправлена проблема, когда модуль XHR создавал события прогресса как `Event` вместо `ProgressEvent`, из-за чего проверки `instanceof` не срабатывали. Это было особенно актуально для оболочки XHR, которую использует Flutter.

Примечания к релизу 284

2024-09-30T06:56:30Z

ENetrebin: /* Удалены значения по умолчанию dt_security_context */

'''''[[Примечания к релизам]] / Примечания к релизу 284'''''

== '''Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Разрешить все атрибуты по умолчанию ====
''Наблюдаемость приложений | Распределенные трассировки''

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

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

Чтобы изменить сохранение атрибутов OpenTelemetry по умолчанию, перейдите в ''Настройки > Мониторинг служб на стороне сервера > Захват атрибутов > Настройки'' и выберите ''Разрешить все атрибуты'' (чтобы использовать список заблокированных атрибутов ) или ''Блокировать все атрибуты'' (чтобы использовать список разрешенных атрибутов ). Обратите внимание, что эти настройки применяются как к OpenTelemetry, так и к OpenTracing.

=== Окончание поддержки Log Monitoring v1 ===
Log Monitoring версии 1 достигла конца жизненного цикла и отключена в этом выпуске (Ключ-АСТРОМ Managed версии 1.284). В результате применяются следующие изменения:

* Log Viewer не отображает никаких данных лога.
* API Log Monitoring v1 отключен.
* Метрики лога (v1) не фиксируются. Конфигурация доступна только для чтения.
* События лога (v1) не запускаются. Конфигурация доступна только для чтения.
* Прием логов (v1) отключен.
* Конфигурация источника лога сохраняется для будущего использования.
* На страницах объектов, таких как «Хост», «Процесс» и «Группа процессов», не отображаются файлы логов.
* Подключенный том NFS для хранения логов больше не используется.

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

=== Новые функции и улучшения ===

==== Возможность выбора формата команд cURL в API Explorer ====
''Платформа | API''

В API Explorer теперь можно выбрать формат команд cURL:

* bash
* PowerShell (Windows)
* Командная строка (Windows)

==== Отображение данных сервиса AWS Lambda ====
''Наблюдаемость инфраструктуры | AWS''

Страница сервиса Lambda теперь беспрепятственно отображает данные как из AWS Lambda (встроенной), так и из новой интеграции AWS Lambda CloudWatch, что обеспечивает плавный переход.

* Старые и новые данные сервиса Lambda, поступающие из интеграции с AWS, теперь отображаются на странице сервиса Lambda (интеграция уровня Lambda) вместе с данными ЕдиногоАгента, когда включена интеграция с AWS CloudWatch и отслеживается сервис Lambda (встроенный или новый).
* На странице сервиса Lambda теперь вы можете найти метрики и свойства CloudWatch для нового сервиса Lambda.
* Если вы хотите изучить больше показателей CloudWatch, перейдите по ссылке на отдельную страницу для нового сервиса Lambda.
* Логи интеграции ЕдиногоАгента и пересылки журналов AWS также связаны с новым сервисом AWS Lambda.
* Вы можете включить предопределенную конфигурацию событий метрики для высокого уровня ошибок Lambda на основе нового сервиса AWS Lambda на странице настроек для интеграций AWS.

==== Возможность загрузки полного набора результатов логов ====
''Инфраструктура Наблюдаемость | Логи''

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

==== Временная метка создания узла Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Добавлена информация о временной метке создания узла Kubernetes на карточку свойств и в API.

==== Обновление минимальной версии АктивногоШлюза до 1.279 ====
''Наблюдаемость инфраструктуры | Kubernetes''

В связи с недавними изменениями в мониторинге Kubernetes минимальная версия АктивногоШлюза была обновлена до 1.279, чтобы обеспечить доступность новейших функций.

==== Улучшенная обработка запросов на события и проблемы для сред с несколькими центрами обработки данных ====
Улучшена обработка запросов на события и проблемы для сред с несколькими центрами обработки данных, что повысило стабильность в отношении дублирования документов о проблемах/событиях между различными центрами обработки данных и позволило решить такие проблемы, как ошибочное отображение закрытой проблемы как открытой.

==== Ограничение изменений в NGINX ====
Лимиты NGINX были изменены следующим образом:

* <code>worker_rlimit_nofile</code>: 102,400
* <code>worker_connections</code>: 100,000

=== Поддержка операционных систем ===
Обновление кластера Ключ-АСТРОМ Managed больше невозможно в Red Hat Enterprise Linux 8.4, Oracle Linux 8.4 и Suse Linux Enterprise Server 12.4.

==== Поддержка добавлена ====

* Обновление до этой версии Ключ-АСТРОМ Managed поддерживается для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

* Elasticsearch теперь работает в среде выполнения Java 17.0.8.

==== Следующие операционные системы больше не будут поддерживаться с 1 октября 2024 г. ====

* Linux : SUSE Enterprise Linux 15.2
** x86-64
** Последняя совместимая версия: 1.300

==== Следующие операционные системы больше не поддерживаются с 01 июля 2024 г. ====

* Linux : Amazon Linux AMI 2018.x
** x86-64
** Последняя совместимая версия: 1.290

==== Следующие операционные системы больше не поддерживаются с 01 августа 2024 г. ====

* Linux : Oracle Linux 8.9
** x86-64
** Последняя совместимая версия: 1.292

=== Решенные проблемы ===
В выпуске 284 решены 26 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Кластер
|22
|-
|Health
|1
|-
|Синтетический мониторинг
|3
|}

==== Кластер ====

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

* Улучшена обработка связей между объектами в контексте проблемы при построении ссылок в пользовательском интерфейсе.
* Исправлена проблема, при которой пользователи без разрешений на запись настроек, но с соответствующими разрешениями на зону управления получали ошибку при попытке массового закрытия проблем в списке проблем (веб-интерфейс) в средах, где запись настроек не требуется для выполнения закрытия проблемы (настройка по умолчанию). Это также исправляет обработку REST API закрытия проблемы, требующую разрешения на запись настроек только в средах, где запись настроек не требуется для выполнения закрытия проблемы.
* Исправлена информация о времени возникновения проблемы на странице сведений о проблеме (в разделе под заголовком проблемы) для проблем, которые начинались как частые проблемы. (Теперь используются правильные временные метки для времени, когда были зарегистрированы события и когда проблема изменилась с частой на ненормальную.)
* Исправлено переполнение текста на странице сведений о проблеме в разделе «Запрос Grail», возникавшее в некоторых браузерах (например, Firefox) при проблемах с длинными запросами DQL.
* Классические панели мониторинга: теперь хост правильно выделяется красным цветом в сотовой визуализации на панели мониторинга, когда связанный объект имеет открытую проблему.
* Чтобы точнее показать, что использовалось для анализа, в метрической диаграмме сведений о проблеме для метрических событий вверху теперь используется разрешение в 1 минуту, если временной интервал проблемы короче дня.
* Внутри операторов сопоставления можно использовать открывающие и закрывающие скобки как часть свойства службы или хоста.
* Решена проблема, которая препятствовала доступу к нескольким страницам глобальных настроек для пользователей с назначенными условными политиками IAM.
* Окно обслуживания может подавлять события для оповещения или создания проблемы. Если новый отчет о событии пришел после окончания ранее соответствующего окна обслуживания для его существующего события, время окончания подавленного события устанавливалось на конечную временную метку нового отчета. Это исправление изменяет это поведение на начальную временную метку нового отчета, так что подавленное событие заканчивается в то же время, когда открывается и оповещается новое неподавленное событие.
* Пользователи больше не могут отменять извлеченные службы, если у них нет прав на запись настроек на уровне клиента.
* Чтобы предотвратить большие времена отклика и задержки в решении проблем, вызванные тем, что менеджер по проблемам тратит слишком много времени на оценку регулярных выражений профиля оповещения, регулярные выражения в новых фильтрах заголовков/описаний событий профиля оповещения теперь ограничены.
* Отключено редактирование местоположений, назначенных синтетическому монитору, и кнопка «Установить ЕдиныйАгент» для пользователей, к которым применяется политика «только для чтения».
* В проводнике данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлена ошибка, из-за которой определенные приложения, требующие разрешений, были невидимы для пользователей, привязанных к зонам управления.
* Лимиты по умолчанию теперь правильно применяются в существующих клиентах для отчетов о событиях лога Kubernetes, доступности и метрик.
* Уровень риска метрики количества затронутых объектов теперь основан на уровне риска в контексте данной объкута. Это делает метрику еще более осведомленной о зоне управления.
* Исправлен фильтр селектора метрик, оценивавший условия независимо и возвращавший слишком много данных.
* В обозревателе данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлен процесс миграции кластера в режим поддержки стойки.
* Java v17.0.8 была заменена на v17.0.10.

==== Health ====

* Исправлен расчет критического статуса для ЕдиныхАгентов для просроченных дат.

==== Синтетический мониторинг ====

* Учетные данные, предоставленные списку пользователей, теперь можно фильтровать по типу общего доступа.
* Исправлена ошибка, из-за которой синтетическое расположение Kubernetes, развернутое в кластере с ограниченными ресурсами и интенсивно используемое, могло использовать больше памяти, чем разрешено, и быть уничтожено кластером Kubernetes из-за ошибки OOM.
* Решена проблема, из-за которой синтетические мониторы с общими учетными данными могли редактироваться пользователями, не имеющими доступа к этим учетным данным.

== '''ЕдиныйАгент Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Прием контейнера логов через ЕдиныйАгент ====
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Лог мониторинга''

Логи, собранные с помощью ЕдиногоАгента из систем оркестровки контейнеров Kubernetes и неоркестрованных сред Docker, теперь сообщаются с <code>log.source</code>указанием вывода контейнера вместо пути к физическому файлу, из которого они были получены.

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

Однако правила приема логов для логов Kubernetes и Docker обычно основаны на определенных атрибутах, связанных с контейнером, таких как пространство имен Kubernetes или имя контейнера .

Обновление : <code>log.source</code>теперь можно использовать сопоставление для управления приемом логов контейнеризованных приложений. ''устаревшее.''

* <code>log.source</code>Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуется переход на использование атрибутов, связанных с Kubernetes, вместо атрибута.
* Аналогичная миграция для учета изменений атрибутов <code>log.source</code>контейнеров требуется в правилах обработки логов, а также в метриках логов и конфигурациях событий логов.

=== Удалены значения по умолчанию dt_security_context ===
'''!Критические изменения!''' ''Наблюдаемость инфраструктуры | Хосты''

Поле разрешения <code>dt.security_context</code>в <code>dt_host_metadata</code>файле зарезервировано только для значений, определяемых пользователем. Оно больше не имеет значения по умолчанию, если пользователем явно не указаны значения.

=== Технологическая поддержка ===

==== Поддержка новых технологий ====

* MongoDB 1.3 - 1.13 (модуль Go). Функция ЕдиногоАгента: Go MongoDB
* OpenResty 25.3.1 (модуль NGINX)
* z/OS 3.1 (модуль zDC)

==== Окончание поддержки ====

* Node.js 19 (модуль Node.js)
** Окончание поддержки поставщика: 2023-06-01

=== Новые функции и улучшения ===

==== Исключен адаптер обратной связи Microsoft KM-TEST из обнаруженных сетевых карт ====
''Наблюдаемость инфраструктуры | Хосты''

Адаптер обратной связи Microsoft KM-TEST исключен из обнаружения и не сообщается в Ключ-АСТРОМ.

=== Решенные проблемы ===
В выпуске 282 решены 23 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Обшие
|3
|-
| Java
|2
|-
|Мейефрейм
|1
|-
|Модуль ОС
|1
|-
|Apache
|1
|-
|Модуль OpenTracing
|1
|-
|.NET
|2
|}
====Общие====

* Чтобы ограничить влияние критических изменений «Прием логов контейнеров через ЕдиныйАгент»: использование сопоставления `log.source` для управления приемом логов контейнерных приложений теперь устарело. Такие конфигурации все еще временно действительны, но в ближайшем будущем потребуют перехода на использование атрибутов, связанных с Kubernetes, вместо атрибута `log.source`. Аналогичная миграция для учета изменений в атрибуте `log.source` для контейнеров требуется в правилах обработки логов.
* Исправлено поведение в крайних случаях для настроенных асинхронных методов как службы обмена сообщениями .NET.
* Исправлены (удалены) чрезмерно подробные записи лога для PHP, которые приводили к большому количеству записей, связанных с WorkProxy, которые невозможно было отключить.

==== Java ====

* Данные Ключ-АСТРОМ, обогащенные неструктурированными логами Logback, теперь заключены в скобки `[!dt ]`.
* Исправлена проблема, которая иногда приводила к сбою ЕдиногоАгента, если приложение выдавало `StackOverflowError` во время запуска.

==== Мейнфрейм ====

* Исправлена ошибка последовательности функций SQL Fetch (CLI0125E).

==== модуль ОС ====

* Исправлена ошибка, из-за которой расширения не запускались на серверах Azure.

==== Apache ====

* Исправлена проблема сбоя переименованного Apache Web Server (IHS) путем отключения функциональности Apache Log Enrichment для таких серверов по умолчанию.

==== Модуль OpenTracing ====

* Добавлена поддержка Envoy 1.29.x.

==== .NET ====

* Исправлена ошибка, из-за которой запросы к URL-адресу RUM-маяка могли влиять на доступность приложения при определенных условиях.
* Исправлена ошибка в функции WCF v2, которая приводила к дублированию вызовов служб для одного и того же запроса.

Примечания к релизу 284

2024-09-30T06:11:43Z

ENetrebin:

Примечания к релизу 284

2024-09-30T05:50:55Z

ENetrebin:

Примечания к релизу 282

2024-09-25T08:45:12Z

ENetrebin:

'''''[[Примечания к релизам]] / Примечания к релизу 282'''''

== '''Ключ-АСТРОМ''' ==

=== Новые функции и улучшения ===

==== Обновленная информация об уязвимых функциях при перезапуске процесса ====
''Безопасность приложений | Уязвимости''

ЕдиныйАгент версии 1.279+

Если доступна новая информация об уязвимых функциях уязвимости, уведомление Restart required информирует вас о том, что требуется перезапуск процесса для ЕдиногоАгента, чтобы получить и использовать новые данные. Вы можете легко перейти к конкретным процессам, требующим перезапуска, отфильтровав по <code>Vulnerable functions: Restart required</code>на страницах отслеживания исправлений для групп процессов и процессов.

==== Новая схема настроек для параметров мобильного приложения в среде ====
''Наблюдаемость инфраструктуры| События''

Новая схема настроек, <code>builtin:mobile.notifications</code>, была введена для настроек мобильных приложений в среде. Управляемые клиенты также могут адаптировать настройку на уровне кластера. Новая настройка позволяет включать/отключать все уведомления для мобильных приложений для среды. Для управляемых клиентов это также включает/отключает генерацию QR-кода для подключения новых мобильных приложений.

Перейдите в «Настройки» и выберите «Интеграция» > «Мобильное приложение Ключ-АСТРОМ» .

==== Автоматическое оповещение о высокой активности GC теперь также поддерживает облачный сценарий Full-Stack ====
''Наблюдение за приложениями | Службы''

Автоматические оповещения о высокой активности GC теперь оцениваются на стороне кластера, поэтому они работают для облачных сценариев Full-Stack и автономных/PaaS. Благодаря этому улучшению автоматические оповещения о высокой активности GC также будут работать в облачных сценариях Full-Stack и Application-only. Чтобы проверить настройки, см. События и оповещения Out-of-memory (OOM) и out-of-threads (OOT) .

==== Обфускация URL в уведомлениях о проблемах ====
''Наблюдаемость инфраструктуры | Проблемы''

Проблема с пользовательской интеграцией теперь позволяет настроить URL как секретный.

==== Информационные события ИИ, полученные более чем через день в будущем, могут быть немедленно запрошены ====
''Наблюдаемость инфраструктуры | События''

Информационные события ИИ, полученные более чем через день в будущем, теперь можно немедленно запросить с указанием будущих временных рамок.

==== Улучшение производительности проблемного фида ====
''Наблюдаемость инфраструктуры | Проблемы''

Теперь доступны следующие улучшения производительности подачи проблем:

* Множественный выбор проблем для массового закрытия.
* Текстовая подсказка с описанием события для быстрого получения подробной информации о проблеме в ленте проблем.

==== Увеличены лимиты отчетов по умолчанию для известных контекстов событий на одном сервере ====
''Наблюдаемость инфраструктуры | События''

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

==== Доступ к учетным данным расширен для определенных пользователей ====
''Цифровой опыт | Синтетический мониторинг''

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

==== Контейнерные объекты, созданные на основе данных мониторинга АктивногоШлюза Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Контейнерные объекты создаются на основе данных мониторинга АктивногоШлюза Kubernetes для кластеров с поддержкой приложений (приложение Kubernetes).

==== Сведения об узле Kubernetes ссылаются на хост ====
''Наблюдаемость инфраструктуры | Kubernetes''

Ссылка на хост теперь отображается в заголовке страницы сведений об узле Kubernetes.

==== Увеличен лимит ЦП для синтетического контейнера ====
''Цифровой опыт | Синтетический мониторинг''

Чтобы избежать чрезмерного регулирования ЦП контейнеров Synthetic VUC Worker в местах с высокой нагрузкой, лимит ЦП был увеличен с 1 до 1,5 ядер в шаблоне Kubernetes/OpenShift. Новое значение включено в требования к оборудованию.

==== Новые источники атрибутов запроса доступны для CICS/IMS ====
''Наблюдаемость приложений | Распределенные трассировки''

Добавлена поддержка следующих источников атрибутов запроса:

* Идентификатор пользователя CICS
* Идентификатор единицы работы CICS
* Идентификатор пользователя IMS
* Идентификатор единицы работы IMS

==== Обновление Кассандры ====
Начиная с версии Ключ-АСТРОМ Managed 1.282, служба хранения конфигураций и метрик обновлена до Cassandra 4.0.11 для оптимизации производительности и устойчивости.

=== Поддержка операционных систем ===

==== Добавлена поддержка ====

* Добавлена поддержка Red Hat Enterprise Linux 9.3, Rocky Linux 9.3 и Oracle Linux 9.3
* Добавлена поддержка Red Hat Enterprise Linux 8.9 и Oracle Linux 8.9

* Обновление до этой версии Ключ-АСТРОМ Managed поддерживается для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

==== Следующие операционные системы больше не поддерживаются ====
* Linux : Red Hat Enterprise Linux 8.4
** x86-64
** Последняя совместимая версия: 1.280
* Linux : Oracle Linux 8.4
** x86-64
** Последняя совместимая версия: 1.280
* Linux : SUSE Enterprise Linux 12.4
** x86-64
** Последняя совместимая версия: 1.280
** Linux : Amazon Linux AMI 2018.x
*** x86-64
*** Последняя совместимая версия: 1.290
** Linux : Oracle Linux 8.9
*** x86-64
*** Последняя совместимая версия: 1.292

==== Решенные проблемы ====
В выпуске 282 решены 23 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Безопасность приложений
|5
|-
|Кластер
|16 (1 уязвимость)
|-
|Синтетический мониторинг
|2
|}

==== Безопасность приложений ====

* Исправлена отчетность для связанных объектов на панели множественной уязвимости. Проблема с разделами «Сводка экспозиции» и «Анализ среды» привела к неправильной отчетности для связанных и затронутых объектов на панели. Данные из старых панелей следует считать неверными. Пользователи, которые не использовали кнопку «Открыть с помощью», не затронуты.
* Исправлено неверное количество затронутых объектов, отображаемых в сгенерированных отдельных блокнотах уязвимостей (плитка «Затронутые объекты по оценке риска»)
* Исправлены агрегированные значения в панелях мониторинга отдельных уязвимостей. В разделах «Анализ кода», «Анализ рисков», «Сводка по воздействию» и «Анализ среды» панелей мониторинга отдельных уязвимостей была проблема, из-за которой возникали неверные отчеты для связанных и затронутых объектов на панели мониторинга. Эта проблема была решена и может быть устранена с помощью кнопки «Открыть с помощью» в приложении «Уязвимости сторонних производителей» для создания новой панели мониторинга. Данные из старых панелей мониторинга следует считать неверными. Пользователи, которые до сих пор не использовали кнопку «Открыть с помощью», не затронуты.
* Исправлена ошибка, из-за которой отчеты о состоянии на уровне объектов экспортировались с неправильным состоянием отключения звука в определенном случае.
* Исправлено поведение фильтра статуса в сгенерированных панелях мониторинга для скрытия скрытых уязвимостей, если статус не выбран или выбрано «открыто» или «решено» в приложении «Сторонние уязвимости».

==== Кластер ====

* Решена проблема, из-за которой в некоторых конфигурациях Cassandra не запускалась из-за недостаточных прав доступа к файлам, связанным с JNA.
* Экраны UA для объектов, не относящихся к службам, больше не дают сбоев, поскольку «Действие x» недопустимо для текущего контекста на экранах UA для типов объектов, отличных от служб.
* Исправлена ошибка, из-за которой при некоторых условиях пул соединений Mission Control был склонен к исчерпанию, что приводило к потере соединения с Mission Control.
* Исправлена ошибка, приводившая к высокому использованию памяти при чтении данных о доступности.

* ''Уязвимость:'' для смягчения возможных уязвимостей, связанных с подменой X-Forwarded-For, балансировщик нагрузки кластера теперь сбрасывает заголовок X-Forwarded-For для новых установок. Чтобы изменить это поведение, используйте опцию `--drop-x-forwarded-for` для установки или перенастройки.
* Исправлена ошибка, из-за которой веб-интерфейс становился недоступным из-за исчерпания потоков
* Технологии, определенные для декларативной группировки процессов, теперь отображаются на странице «Обзор технологий» («Технологии и процессы»).
* Исправлено отсутствие указания на то, почему окна обслуживания в обновлениях ЕдиногоАгента могут быть пустыми. (Когда у пользователя есть доступ к странице настроек «Обновления ЕдиногоАгента», но нет доступа к настройкам «Окна обслуживания для обновлений ЕдиногоАгента», невозможно изменить окно обслуживания, поскольку раскрывающийся список с ними пуст. Теперь сообщение объясняет, что конкретная политика IAM отсутствует.)
* Исправлена ссылка на страницу развертывания, чтобы она указывала на недавно выпущенный Ключ-АСТРОМ Operator v0.14.2. ( K8S-8303 )
* Производительность страницы "Deployment status" для ЕдиногоАгента была значительно улучшена, особенно время загрузки для более крупных сред. Обратите внимание, что это улучшение удаляет функциональность для маркировки и сортировки хостов с проблемами на уровне процесса. Чтобы отслеживать проблемы на уровне процесса, перейдите на страницу "ЕдиныйАгент health".
* Улучшено выражение фильтрации кластера VMware для отклонения недопустимых входных данных.
* Исправлена ошибка, из-за которой на странице «Кластеры Kubernetes» отображались прочерки в столбце состояния для некоторых кластеров Kubernetes.
* Теги уведомлений о событиях ServiceNow теперь имеют правильный формат `key:value`, который соответствует остальной части Ключ-АСТРОМ. Теги, созданные клиентом (вручную/автоматически с помощью правил), теперь не имеют префикса [CONTEXTLESS]. Кроме того, некоторые контексты для автоматически импортируемых тегов изменились: `AZURE` на `Azure`, `ENVIRONMENT` на `Environment`, `CLOUD_FOUNDRY` на `CloudFoundry`, `KUBERNETES` на `Kubernetes`, `GOOGLE_COMPUTE_ENGINE` на `GoogleCloud` и `AWS_GENERIC` на `AWSGeneric`.
* Страница настроек "Обновления Ключ-АСТРОМ" представляет краткую сводку автоматических статусов обновления для ЕдиногоАгента. Для актуального состояния в некоторых случаях отображалась неверная версия ЕдиногоАгента. Теперь она правильно отображает, сколько ЕдиныхАгентов обновлены до определенной версии.
* Исправлена кодировка определенных символов в японском переводе кода Ключ-АСТРОМ Cluster. Исправлен процесс миграции кластера в режим поддержки стойки.

==== Синтетический мониторинг ====

* Исправлена проблема, связанная с несогласованными конфигурациями монитора Synthetic Browser, возвращаемыми конечной точкой GET Synthetic monitor.
* Плитка панели синтетического монитора «Сторонний монитор» теперь отображает «Длительность» в миллисекундах для значений ниже 100 миллисекунд.

== '''ЕдиныйАгент Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== ЕдиныйАгент SDK для Android обновлен до Kotlin 1.9.10 ====
'''!Критические изменения!'''

ЕдиныйАгент SDK для Android обновлен до Kotlin 1.9.10.

* Приложения, использующие Kotlin 1.8, должны быть по-прежнему совместимы.
* Более ранние версии могут потребовать корректировки для компиляции. В этом случае обратитесь к официальной документации Kotlin. Большинство проблем можно решить, убедившись, что у вас установлены последние версии Gradle и плагина Android Gradle, как описано в документации Kotlin

=== Технологическая поддержка ===

==== Поддержка новых технологий ====

* NGINX Plus R31 (модуль NGINX)
* Node.js 21 (модуль Node.js)
* Node.js 14, 16, 18, 20, 21 на Linux s390x (модуль Node.js)
* OpenTelemetry 1.0.0 (модуль PHP)

==== Окончание поддержки ====

* Red Hat Enterprise Linux CoreOS 4.9 (модуль ОС)
** Окончание поддержки поставщика: 2023-04-18

=== Новые функции и улучшения ===

==== CRI-O hook удаляется при остановке ЕдиногоАгента в контейнере ====
''Наблюдаемость инфраструктуры | Kubernetes''

CRI-O hook теперь удаляется каждый раз, когда останавливается ЕдиныйАгент, работающий внутри контейнера.

=== Решенные проблемы ===
В выпуске 281 содержится 16 решенных проблем.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Общие
|5
|-
|Java
|2
|-
|.NET
|1
|-
|IIB
|1
|-
|Мейнфрейм
|1
|-
|модуль ОС
|4
|-
|Установщик ЕдиногоАгента
|1
|-
|Модуль OpenTracing
|1
|}

==== Общие ====

* Исправлена возможная дублирующая отчетность об IP-адресах для служб баз данных (приводящая к обнаружению службы на стороне кластера, создающему дублирующую службу базы данных), когда распознаватель имен хостов ЕдиногоАгента периодически обновляет записи DNS.
* Исправлена несовместимость с библиотекой musl-libc `gcompat`, которая могла приводить к сбою любых приложений (независимо от того, связаны ли они с musl или glibc), которые выполнялись в musl-libc с ее библиотекой-оболочкой `gcompat` при загрузке ЕдиногоАгента.
* Имя pod Kubernetes можно определить по имени хоста. В Windows вместо имени хоста использовалось полное доменное имя, что могло привести к неправильному распознаванию имени pod. С этим исправлением теперь используется имя физической машины, что является ожидаемым поведением.
* Если при первой попытке подключения к устройству SNMP не удается разрешить DNS-имя, источник данных повторит попытку подключения в следующем интервале.
* Исправлено развертывание ЕдиногоАгента на экземплярах RKE2 (установка не удалась из-за завершения процесса oneagenthelper из-за недостаточных прав доступа к файлу containerd meta.db).

==== Java ====

* Тело ответа HTTP бизнес-событий теперь фиксируется правильно, даже если сжатие GZIP происходит вне цепочки фильтров сервлетов.
* Исправлена утечка памяти, возникавшая при отключении метрик Grail.

==== .NET ====

* Тело запроса больше не удаляется, если установлено правило бизнес-события для захвата тела запроса. ( OA-25428 )

==== IIB ====

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

==== Мейнфрейм ====

* Распределенные трассировки из CICS и IMS теперь правильно помечаются как дефектные, если превышен лимит узлов.

==== модуль ОС ====

* Исправлена ошибка, из-за которой процесс Spring Boot иногда назначался недопустимому объекту процесса.
* Теперь обнаруживаются контейнеры, работающие в частном пространстве имен пользователя.
* Исправлена группировка и обнаружение Spring Boot версии 3.2.
* Процессы Java теперь корректно сообщаются в случаях, когда JRE недоступен из модуля ОС.

==== Установщик ЕдиногоАгента ====

* Изменены политики SELinux, позволяющие системному вызову `ioctl` получать доступ к файлам метаданных обогащения Ключ-АСТРОМ.

==== Модуль OpenTracing ====

* Начиная с OneAgent 281, модуль кода ЕдиныйАгент Envoy больше не внедряется в (и нет глубокого мониторинга) Envoy версии 1.29+. Ранее Envoy мог прервать запуск с ошибкой в версиях Envoy, которые больше не поддерживают определенные функции, требуемые ЕдинымАгентом.

===ЕдиныйАгент для Android===
Версия 281 не содержит решенных проблем, с которыми сталкиваются пользователи.

=== ЕдиныйАгент для iOS ===

==== ЕдиныйАгент для обновлений iOS ====
''Цифровой опыт | RUM Mobile''

* Обновлена цель развертывания до iOS 12.
* Добавлен манифест о конфиденциальности.
* Большая часть использования CoreTelephony заменена на сетевой API.
* Подписанный фреймворк Ключ-АСТРОМ.

==== Повтор сеанса для обновлений iOS ====
''Цифровой опыт | RUM Mobile''

* Обновлена цель развертывания до iOS 12.
* Добавлен манифест о конфиденциальности.
* Подписанная структура воспроизведения сеанса.

==== Решенные проблемы ====
Версия 281 не содержит решенных проблем, с которыми сталкиваются пользователи.
===Решённые проблемы ЕдиногоАгента для JavaScript===
Версия 281 содержит 1 решенную проблему.

* Исправлена ошибка, из-за которой агент JavaScript вызывал утечку отсоединенных элементов iframe на странице.

== '''API Ключ-АСТРОМ''' ==

=== API среды ===

* ЕдиныйАгент на хостовом API
** Новое возможное значение в поле monitoringType : <code>DISCOVERY</code>
** Новый параметр запроса в <code>GET /oneagents</code>запросе unlicensed ( <code>boolean</code>)

* API токенов доступа
** Новое возможное значение в поле scopes объектов ApiToken , ApiTokenCreate и ApiTokenUpdate : <code>extensionConfigurationActions.write</code>

* API хранилища учетных данных
** Новое поле в объектах Credentials и CredentialsResponseElement : allowContextlessRequests ( <code>boolean</code>)

* Проблемы безопасности API
** Изменен тип поля relatedContainerImages<code>array</code> с на <code>object</code>в объекте SecurityProblemDetails .

* Расширения 2.0 API
** Новое возможное поле в объекте PropertyDefinition : migrationPattern ( <code>String</code>)
* Настройки 2.0 - Доступные схемы
** Новое возможное поле в объекте PropertyDefinition : migrationPattern ( <code>String</code>)

* Унифицированный анализ ''Ранний пользователь''
** Новое обязательное поле в объекте UAEventsCard : ключ ( <code>String</code>)

=== API конфигурации ===

* API конфигурации веб-приложения
** Новое возможное поле в объекте MonitoringSettings : useCors ( <code>boolean</code>)
** Поле изменено с обязательного на необязательное в объекте MonitoringSettings : cookiePlacementDomain

=== API кластера ===

* <code>/settings/schemas/{schemaId}</code>
** Новое поле в объекте PropertyDefinition : migrationPattern ( <code>String</code>)

=== Доступность GA ===

* API среды <code>PUT /extensions/{extensionName}/monitoringConfigurations/{configurationId}/actions</code>

=== Устаревшее ===
Следующие API теперь устарели:

* API автоматически применяемых тегов устаревший
** <code>GET /autoTags</code>
** <code>POST /autoTags</code>
** <code>POST /autoTags/validator</code>
** <code>GET /autoTags/{id}</code>
** <code>PUT /autoTags/{id}</code>
** <code>DELETE /autoTags/{id}</code>
** <code>POST /autoTags/{id}/validator</code> Вместо этого используйте API настроек со схемой «Автоматически применяемые теги» ( <code>builtin:tags.auto-tagging</code>).
* API зон управления ''устаревшее''
** <code>GET /managementZones</code>
** <code>POST /managementZones</code>
** <code>POST /managementZones/validator</code>
** <code>GET /managementZones/{id}</code>
** <code>PUT /managementZones/{id}</code>
** <code>DELETE /managementZones/{id}</code>
** <code>POST /managementZones/{id}/validator</code> Вместо этого используйте API настроек со схемой настроек зон управления ( <code>builtin:management-zones</code>).

Примечания к релизу 284

2024-09-17T15:00:58Z

ENetrebin: /* Следующие операционные системы больше не поддерживаются с 01 августа 2024 г. */

'''''[[Примечания к релизам]] / Примечания к релизу 282'''''

== '''Ключ-АСТРОМ''' ==

=== Критические изменения ===

==== Разрешить все атрибуты по умолчанию ====
''Наблюдаемость приложений | Распределенные трассировки''

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

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

Чтобы изменить сохранение атрибутов OpenTelemetry по умолчанию, перейдите в ''Настройки > Мониторинг служб на стороне сервера > Захват атрибутов > Настройки'' и выберите ''Разрешить все атрибуты'' (чтобы использовать список заблокированных атрибутов ) или ''Блокировать все атрибуты'' (чтобы использовать список разрешенных атрибутов ). Обратите внимание, что эти настройки применяются как к OpenTelemetry, так и к OpenTracing.

=== Окончание поддержки Log Monitoring v1 ===
Log Monitoring версии 1 достигла конца жизненного цикла и отключена в этом выпуске (Ключ-АСТРОМ Managed версии 1.284). В результате применяются следующие изменения:

* Log Viewer не отображает никаких данных лога.
* API Log Monitoring v1 отключен.
* Метрики лога (v1) не фиксируются. Конфигурация доступна только для чтения.
* События лога (v1) не запускаются. Конфигурация доступна только для чтения.
* Прием логов (v1) отключен.
* Конфигурация источника лога сохраняется для будущего использования.
* На страницах объектов, таких как «Хост», «Процесс» и «Группа процессов», не отображаются файлы логов.
* Подключенный том NFS для хранения логов больше не используется.

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

=== Новые функции и улучшения ===

==== Возможность выбора формата команд cURL в API Explorer ====
''Платформа | API''

В API Explorer теперь можно выбрать формат команд cURL:

* bash
* PowerShell (Windows)
* Командная строка (Windows)

==== Отображение данных сервиса AWS Lambda ====
''Наблюдаемость инфраструктуры | AWS''

Страница сервиса Lambda теперь беспрепятственно отображает данные как из AWS Lambda (встроенной), так и из новой интеграции AWS Lambda CloudWatch, что обеспечивает плавный переход.

* Старые и новые данные сервиса Lambda, поступающие из интеграции с AWS, теперь отображаются на странице сервиса Lambda (интеграция уровня Lambda) вместе с данными ЕдиногоАгента, когда включена интеграция с AWS CloudWatch и отслеживается сервис Lambda (встроенный или новый).
* На странице сервиса Lambda теперь вы можете найти метрики и свойства CloudWatch для нового сервиса Lambda.
* Если вы хотите изучить больше показателей CloudWatch, перейдите по ссылке на отдельную страницу для нового сервиса Lambda.
* Логи интеграции ЕдиногоАгента и пересылки журналов AWS также связаны с новым сервисом AWS Lambda.
* Вы можете включить предопределенную конфигурацию событий метрики для высокого уровня ошибок Lambda на основе нового сервиса AWS Lambda на странице настроек для интеграций AWS.

==== Возможность загрузки полного набора результатов логов ====
''Инфраструктура Наблюдаемость | Логи''

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

==== Временная метка создания узла Kubernetes ====
''Наблюдаемость инфраструктуры | Kubernetes''

Добавлена информация о временной метке создания узла Kubernetes на карточку свойств и в API.

==== Обновление минимальной версии АктивногоШлюза до 1.279 ====
''Наблюдаемость инфраструктуры | Kubernetes''

В связи с недавними изменениями в мониторинге Kubernetes минимальная версия АктивногоШлюза была обновлена до 1.279, чтобы обеспечить доступность новейших функций.

==== Улучшенная обработка запросов на события и проблемы для сред с несколькими центрами обработки данных ====
Улучшена обработка запросов на события и проблемы для сред с несколькими центрами обработки данных, что повысило стабильность в отношении дублирования документов о проблемах/событиях между различными центрами обработки данных и позволило решить такие проблемы, как ошибочное отображение закрытой проблемы как открытой.

==== Ограничение изменений в NGINX ====
Лимиты NGINX были изменены следующим образом:

* <code>worker_rlimit_nofile</code>: 102,400
* <code>worker_connections</code>: 100,000

=== Поддержка операционных систем ===
Обновление кластера Ключ-АСТРОМ Managed больше невозможно в Red Hat Enterprise Linux 8.4, Oracle Linux 8.4 и Suse Linux Enterprise Server 12.4.

==== Поддержка добавлена ====

* Обновление до этой версии Ключ-АСТРОМ Managed поддерживается для узлов кластера, работающих на Red Hat Enterprise Linux 8.x или 9.x.

* Elasticsearch теперь работает в среде выполнения Java 17.0.8.

==== Следующие операционные системы больше не будут поддерживаться с 1 октября 2024 г. ====

* Linux : SUSE Enterprise Linux 15.2
** x86-64
** Последняя совместимая версия: 1.300

==== Следующие операционные системы больше не поддерживаются с 01 июля 2024 г. ====

* Linux : Amazon Linux AMI 2018.x
** x86-64
** Последняя совместимая версия: 1.290

==== Следующие операционные системы больше не поддерживаются с 01 августа 2024 г. ====

* Linux : Oracle Linux 8.9
** x86-64
** Последняя совместимая версия: 1.292

=== Решенные проблемы ===
В выпуске 284 решены 26 проблемы.
{| class="wikitable"
!Компонент
!Решенные проблемы
|-
|Кластер
|22
|-
|Health
|1
|-
|Синтетический мониторинг
|3
|}

==== Кластер ====

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

* Улучшена обработка связей между объектами в контексте проблемы при построении ссылок в пользовательском интерфейсе.
* Исправлена проблема, при которой пользователи без разрешений на запись настроек, но с соответствующими разрешениями на зону управления получали ошибку при попытке массового закрытия проблем в списке проблем (веб-интерфейс) в средах, где запись настроек не требуется для выполнения закрытия проблемы (настройка по умолчанию). Это также исправляет обработку REST API закрытия проблемы, требующую разрешения на запись настроек только в средах, где запись настроек не требуется для выполнения закрытия проблемы.
* Исправлена информация о времени возникновения проблемы на странице сведений о проблеме (в разделе под заголовком проблемы) для проблем, которые начинались как частые проблемы. (Теперь используются правильные временные метки для времени, когда были зарегистрированы события и когда проблема изменилась с частой на ненормальную.)
* Исправлено переполнение текста на странице сведений о проблеме в разделе «Запрос Grail», возникавшее в некоторых браузерах (например, Firefox) при проблемах с длинными запросами DQL.
* Классические панели мониторинга: теперь хост правильно выделяется красным цветом в сотовой визуализации на панели мониторинга, когда связанный объект имеет открытую проблему.
* Чтобы точнее показать, что использовалось для анализа, в метрической диаграмме сведений о проблеме для метрических событий вверху теперь используется разрешение в 1 минуту, если временной интервал проблемы короче дня.
* Внутри операторов сопоставления можно использовать открывающие и закрывающие скобки как часть свойства службы или хоста.
* Решена проблема, которая препятствовала доступу к нескольким страницам глобальных настроек для пользователей с назначенными условными политиками IAM.
* Окно обслуживания может подавлять события для оповещения или создания проблемы. Если новый отчет о событии пришел после окончания ранее соответствующего окна обслуживания для его существующего события, время окончания подавленного события устанавливалось на конечную временную метку нового отчета. Это исправление изменяет это поведение на начальную временную метку нового отчета, так что подавленное событие заканчивается в то же время, когда открывается и оповещается новое неподавленное событие.
* Пользователи больше не могут отменять извлеченные службы, если у них нет прав на запись настроек на уровне клиента.
* Чтобы предотвратить большие времена отклика и задержки в решении проблем, вызванные тем, что менеджер по проблемам тратит слишком много времени на оценку регулярных выражений профиля оповещения, регулярные выражения в новых фильтрах заголовков/описаний событий профиля оповещения теперь ограничены.
* Отключено редактирование местоположений, назначенных синтетическому монитору, и кнопка «Установить ЕдиныйАгент» для пользователей, к которым применяется политика «только для чтения».
* В проводнике данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлена ошибка, из-за которой определенные приложения, требующие разрешений, были невидимы для пользователей, привязанных к зонам управления.
* Лимиты по умолчанию теперь правильно применяются в существующих клиентах для отчетов о событиях лога Kubernetes, доступности и метрик.
* Уровень риска метрики количества затронутых объектов теперь основан на уровне риска в контексте данной объкута. Это делает метрику еще более осведомленной о зоне управления.
* Исправлен фильтр селектора метрик, оценивавший условия независимо и возвращавший слишком много данных.
* В обозревателе данных при нажатии кнопки «Открыть с помощью» больше не отображается сообщение об ошибке, если ошибок не произошло.
* Исправлен процесс миграции кластера в режим поддержки стойки.
* Java v17.0.8 была заменена на v17.0.10.

==== Health ====

* Исправлен расчет критического статуса для ЕдиныхАгентов для просроченных дат.

==== Синтетический мониторинг ====

* Учетные данные, предоставленные списку пользователей, теперь можно фильтровать по типу общего доступа.
* Исправлена ошибка, из-за которой синтетическое расположение Kubernetes, развернутое в кластере с ограниченными ресурсами и интенсивно используемое, могло использовать больше памяти, чем разрешено, и быть уничтожено кластером Kubernetes из-за ошибки OOM.
* Решена проблема, из-за которой синтетические мониторы с общими учетными данными могли редактироваться пользователями, не имеющими доступа к этим учетным данным.

Примечания к релизу 284

2024-09-17T14:37:10Z

ENetrebin: /* Следующие операционные системы больше не поддерживаются с 01 августа 2024 г. */

Примечания к релизу 284

2024-09-17T14:36:07Z

ENetrebin:

Примечания к релизу 284

2024-09-17T14:32:23Z

ENetrebin: Новая страница: «'''''Примечания к релизам / Примечания к релизу 282''''' == '''Ключ-АСТРОМ''' == === Критические и...»

Примечания к релизам

2024-09-17T14:03:17Z

ENetrebin:

Примечания к релизам:

* [[Примечания к релизу 218]]
* [[Примечания к релизу 220]]
* [[Примечания к релизу 222]]
* [[Примечания к выпуску 224|Примечания к релизу 224]]
* [[Примечания к релизу 226]]
*[[Примечания к релизу 228]]
*[[Примечания к релизу 230]]
*[[Примечания к релизу 232]]
*[[Примечания к релизу 234]]
*[[Примечания к релизу 236]]
*[[Примечания к релизу 238]]
*[[Примечания к релизу 240]]
*[[Примечания к релизу 242]]
*[[Примечания к релизу 244]]
*[[Примечания к релизу 246]]
*[[Примечания к релизу 248]]
*[[Примечания к релизу 250]]
*[[Примечания к релизу 252]]
*[[Примечания к релизу 254]]
*[[Примечания к релизу 256]]
*[[Примечания к релизу 258]]
*[[Примечания к релизу 260]]
*[[Примечания к релизу 262]]
*[[Примечания к релизу 264]]
*[[Примечания к релизу 266]]
*[[Примечания к релизу 268]]
*[[Примечания к релизу 270]]
*[[Примечания к релизу 272]]
*[[Примечания к релизу 274]]
*[[Примечания к релизу 276]]
*[[Примечания к релизу 278]]
*[[Примечания к релизу 280]]
*[[Примечания к релизу 282]]
*[[Примечания к релизу 284]]

[[Новости о прекращении поддержки]]

Предпросмотр и бета версии (API)

2024-09-17T12:04:38Z

ENetrebin:

'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.9E.D1.81.D0.BD.D0.BE.D0.B2.D0.BD.D0.BE.D0.B5|Основное]] / Предпросмотр и бета версии (API)'''''

Некоторые запросы API доступны как функции Бета-версии или как часть предварительной версии. Эти запросы помечены примечаниями «Ранний переход» и «Предварительный просмотр» на соответствующих страницах в документации Ключ-АСТРОМ и в проводнике API (см. Примеры ниже).

== Бета-версии ==
Запросы на выпуск Бета-версий доступны на основе согласия. Они не являются полнофункциональными, но общедоступны, полностью поддерживаются и готовы к производству.

Несовместимые изменения вряд ли будут внесены в запросы API Бета-версии, но мы не можем гарантировать полную обратную совместимость версии GA с Бета-версией.

Запросы Бета-версии помечаются в обозревателе API этой отметкой:

[[Файл:pred1.png]]

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

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

Запросы на предварительный просмотр имеют такую отметку в проводнике API:

[[Файл:pred2.png]]

Ограничение доступа (API)

2024-09-17T12:03:39Z

ENetrebin:

'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.9E.D1.81.D0.BD.D0.BE.D0.B2.D0.BD.D0.BE.D0.B5|Основное]] / Ограничение доступа (API)'''''

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

== Лимит полезной нагрузки ==
Размер полезной нагрузки ограничен 1 МБ. Исключения составляют:

* API конфигурации Mobile Symbolication API - вы можете загружать файлы символики размером до 100 МБ.
* API конфигурации Extensions API - вы можете загружать файлы ZIP с расширениями размером до 50 МБ.
* API конфигурации API плагинов - вы можете загружать ZIP-файлы плагинов размером до 50 МБ.

== Регулирование запросов ==
Каждая среда имеет ограниченный пул потоков (с очередью) для обработки запросов. Вы достигли предела, когда и пул потоков, и его очередь заполнены или время ожидания запроса в очереди (тайм-аут составляет 10 секунд). Когда вы достигнете предела, ваши запросы вернут код ответа 429.

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

Коды ответа (API)

2024-09-17T12:01:51Z

ENetrebin:

'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.9E.D1.81.D0.BD.D0.BE.D0.B2.D0.BD.D0.BE.D0.B5|Основное]] / Коды ответа (API)'''''

Если не указано иное, используются следующие коды ответов:

{| class="wikitable"
!Код
!Описание
|-
|200
|ОК. Запрос выполнен.
|-
|400
|Плохой запрос. Запрос не прошел. В теле ответа приводятся дополнительные сведения.
|-
|401
|Несанкционированный. Аутентификация токена не удалась. Проверьте, есть ли у вашего токена необходимые разрешения.
|-
|404
|Не найдено. Запрошенный ресурс не найден в вашей среде. Проверьте правильность ввода.
|-
|420
|Слишком много запросов. Вы достигли предела использования API.
|}

Примечания к релизам

2024-09-17T11:45:18Z

ENetrebin:

Примечания к релизам:

* [[Примечания к релизу 218]]
* [[Примечания к релизу 220]]
* [[Примечания к релизу 222]]
* [[Примечания к выпуску 224|Примечания к релизу 224]]
* [[Примечания к релизу 226]]
*[[Примечания к релизу 228]]
*[[Примечания к релизу 230]]
*[[Примечания к релизу 232]]
*[[Примечания к релизу 234]]
*[[Примечания к релизу 236]]
*[[Примечания к релизу 238]]
*[[Примечания к релизу 240]]
*[[Примечания к релизу 242]]
*[[Примечания к релизу 244]]
*[[Примечания к релизу 246]]
*[[Примечания к релизу 248]]
*[[Примечания к релизу 250]]
*[[Примечания к релизу 252]]
*[[Примечания к релизу 254]]
*[[Примечания к релизу 256]]
*[[Примечания к релизу 258]]
*[[Примечания к релизу 260]]
*[[Примечания к релизу 262]]
*[[Примечания к релизу 264]]
*[[Примечания к релизу 266]]
*[[Примечания к релизу 268]]
*[[Примечания к релизу 270]]
*[[Примечания к релизу 272]]
*[[Примечания к релизу 274]]
*[[Примечания к релизу 276]]
*[[Примечания к релизу 278]]
*[[Примечания к релизу 280]]
*[[Примечания к релизу 282]]

[[Новости о прекращении поддержки]]

Примечания к релизам

2024-09-17T11:19:27Z

ENetrebin:

Токены и аутентификация (API)

2024-09-16T15:27:52Z

ENetrebin:

'''''[[API Ключ-АСТРОМ]] / [https://doc.ruscomtech.ru/index.php/API_Ключ-АСТРОМ#.D0.9E.D1.81.D0.BD.D0.BE.D0.B2.D0.BD.D0.BE.D0.B5 Основное] / Токены и аутентификация (API)'''''

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

== Формат токена ==
Ключ-АСТРОМ использует уникальный формат токенов, состоящий из трех компонентов, разделенных точками (.). Например: 
dt0c01.ST2EY72KQINMH574WMNVI7YN.G3DFPBEJYMODIDAEX454M7YWBUVEFOWKPRVMWFASS64NFH52PX6BNDVFFM572RZM

* dt0c01 - Префикс для идентификации токена.
* ST2...7YN - Открытая часть токена. 24-значный открытый идентификатор токена. Это значение можно безопасно отображать в пользовательском интерфейсе и использовать для ведения журнала.
* G3D...RZM - Секретная часть токена. 64-символьная секретная часть токена, которую можно рассматривать как пароль, поэтому она не отображается в веб-интерфейсе Ключ-АСТРОМ (после первоначального создания) и не сохраняется в файлах журнала.
== Создание токена ==
=== Токен API ===
Чтобы сгенерировать токен доступа

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

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

В качестве альтернативы вы можете использовать [[POST запрос (токен)]] к API токенов аутентификации для создания токена.

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

=== Токен персонального доступа ===
Для создания токена личного доступа

# Выберите меню пользователя в правом верхнем углу страницы.
# Выберите токены личного доступа .
# Выберите Создать новый токен .
# Введите имя для вашего токена.
# Выберите необходимые разрешения для токена.
# Выберите «Создать» .
# Скопируйте сгенерированный токен в буфер обмена. Сохраните токен в диспетчере паролей для использования в будущем. 
'''Вы можете получить доступ к своему токену только один раз после его создания.'''

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

В качестве альтернативы вы можете использовать [[POST запрос (токен)]] к API токенов аутентификации для создания токена личного доступа.

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

== Разрешения токена ==
=== Токен API ===
Ключ-АСТРОМ предоставляет следующие разрешения для токенов API. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через [[API токенов аутентификации]]. Некоторые области доступны только через API. 

{| class="wikitable"
|+API v2
!Имя
!Значение API
!Описание
|-
|Чтение метрик
|metrics.read
|Предоставляет доступ к GET-запросам [[Metrics API v2]] .
|-
|Запись метрик
|metrics.write
|Предоставляет доступ к [[удалению пользовательской метрики]] для запроса к Metrics API v2.
|-
|Метрики загрузки
|metrics.ingest
|Предоставляет доступ к POST запросу ingest data points Metrics API v2.
|-
|Чтение логов
|logs.read
|Предоставляет доступ к GET запросам [[Log Monitoring API v2]].
|-
|Логи загрузки
|logs.ingest
|Предоставляет доступ к POST запросу логов загрузки Log Monitoring API v2.
|-
|
|
|

|}

=== Токен персонального доступа ===
Ключ-АСТРОМ предоставляет следующие разрешения для токенов личного доступа. Вы можете установить их в пользовательском интерфейсе, как описано выше, или через [[API токенов аутентификации]]. 

{| class="wikitable"
!Имя
!Значение API
!Описание
|-
|Чтение токенов API
|apiTokens.read
|Предоставляет доступ к GET запросам [[API токенов аутентификации]]
|-
|Запись токенов API
|apiTokens.write
|Предоставляет доступ к POST, PUT и DELETE запросам [[API токенов аутентификации]]
|}

== Аутентификация ==
У вас есть два варианта передачи токена API: в HTTP-заголовке авторизации или в параметре запроса '''api-token''' .

Мы рекомендуем использовать заголовок авторизации, поскольку URL-адреса (вместе с переданными в них токенами) могут регистрироваться в разных местах. Пользователи также могут добавлять URL-адреса в закладки или делиться ими в виде обычного текста. Следовательно, размещение токенов аутентификации в URL-адресе увеличивает риск того, что они будут захвачены злоумышленником.

=== Используя заголовок HTTP ===
Вы можете пройти аутентификацию, прикрепив токен к HTTP-заголовку авторизации. В следующем примере показана аутентификация через HTTP-заголовок: 

<code>
curl --request GET \ 
--url <nowiki>https://mySampleEnv.ruscomtech.ru/api/v1/config/clusterversion</nowiki> \ 
--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ </code>

=== Используя параметр запроса ===
Вы можете пройти аутентификацию, добавив токен в качестве значения параметра запроса api-token.

<code>
curl --request GET \ 
--url '<nowiki>https://mySampleEnv.live.ruscomtech.eu/api/v1/config/clusterversion?api-token=abcdefjhij1234567890'</nowiki> \ </code>

== Аутентификация в API Explorer ==
Выберите значок замока рядом с любым эндпоинтом, чтобы отобразить информацию о токенах API, которые защищают этот эндпоинт. Каждый эндпоинт требует определенного типа токена.

Вы также можете разблокировать все эндпоинты, выбрав '''Авторизовать'''. В отображаемом диалоговом окне вы можете увидеть, какие разрешения токена необходимы для каждого эндпоинта API. Введя свой токен API в диалоговое окно Доступные авторизации , вы можете разблокировать все связанные эндпоинты API.

DDU для пользовательских трассировок (Trace API)

2024-09-16T14:54:35Z

ENetrebin:

'''''[[Ресурсы мониторинга|Лицензирование]] / Расширение Ключ-АСТРОМ (блоки данных ИИ) / DDU для пользовательских трассировок (Trace API)'''''

Хотя нет никаких дополнительных затрат или лицензий, связанных с интеграцией данных OpenTracing и OpenTelemetry span в Ключ-АСТРОМ через ЕдиныйАгент, у вас есть возможность настроить Ключ-АСТРОМ Trace API для приема диапазонов OpenTelemetry и OpenTracing; они известны как «специальные трейсы». Этот подход полезен для интеграции данных трассировки OpenTelemetry, которые отправляются сторонними службами. Прием интервалов через конечную точку Trace API потребляет ВИД, потому что этот подход требует большей вычислительной и аналитической мощности, чем прием через ЕдиныйАгент.

Дополнительные сведения о приеме диапазонов OpenTelemetry и OpenTracing на основе ЕдиныйАгент, который не использует ВИД, см. В разделе Поддержка ЕдиныйАгент OpenTracing и OpenTelemetry .

== Потребление ВИД для приема пользовательской трассировки ==
Хотя трассировка может содержать диапазоны, захваченные с помощью ЕдиныйАгент и Ключ-АСТРОМ Trace API, только диапазоны, полученные через Ключ-АСТРОМ Trace API, потребляют ВИД. Для службы API, оснащенной OpenTelemetry, и диапазоны захватываются через ЕдиныйАгент, ВИД не используются. Пользовательские трассировки, загружаемые через Ключ-АСТРОМ Trace API, лицензируются на основе приема диапазонов (каждый диапазон соответствует одной операции в трассировке).

=== Пример потребления ВИД ===
Чтобы рассчитать потребление ВИД для пользовательских трассировок, умножьте общее количество вызовов на общее количество интервалов, умноженное на вес ВИД, за измеренный период времени. Рассмотрим службу API, оснащенную OpenTelemetry, которая получает в среднем 10 диапазонов на один вызов API через Ключ-АСТРОМ Trace API. Если среднее количество вызовов API в месяц составляет 1 миллион, ежемесячное потребление ВИД составляет 7000 DDU ( <code>1,000,000 invocations x 10 spans x .0007 ВИД = 7,000 ВИД</code>), что эквивалентно 84000 ВИД в год ( <code>7,000 ВИД x 12 months = 84,000 ВИД</code>).

Пулы ВИД

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

DDU для лога мониторинга

2024-09-16T14:53:46Z

ENetrebin:

'''''[[Ресурсы мониторинга|Лицензирование]] / Расширение Ключ-АСТРОМ (блоки данных ИИ) / DDU для лога мониторинга'''''

На этой странице объясняется концепция мониторинга журналов, как мы рассчитываем ВИД для мониторинга журналов и как вы можете оценивать и отслеживать потребление ВИД, если вы используете мониторинг журналов.

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

== Как Ключ-АСТРОМ рассчитывает потребление ВИД для мониторинга журналов? ==
ВИД подсчитывает все входящие записи журнала (записи) из ваших данных журнала. Каждая запись журнала (строка, сообщение, запись) вычитается <code>0.0005 ВИД</code>из доступной квоты. Например, 1 миллион записей журнала, умноженный на вес ВИД, равный 0,0005, потребляет всего 500 ВИД.

Запись журнала распознается двумя способами:

* Отметка времени
* Объект JSON

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

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

Ввод файла журнала
<code>1: Oct 18 05:56:11 INFO ip-10-176-34-132 DHCPREQUEST on eth0 to 10.176.34.1
2: Oct 18 05:56:12 INFO ip-10-176-34-132 DHCPACK from 10.176.34.1
3: Oct 18 05:56:13 INFO ip-10-176-34-132 bound to 10.176.34.132 -- renewal in 1551s4:
4: Oct 18 05:56:15 INFO ip-10-176-34-132 [get_meta] Getting token for IMDSv
5: Oct 18 05:56:16 INFO ip-10-176-34-132 [get_meta] Trying to get <nowiki>http://169.23.2.3</nowiki>
6: Oct 18 05:56:18 INFO ip-10-176-34-132 [rewrite_aliases] Rewriting aliases
7: Oct 18 06:22:06 INFO ip-10-176-34-132 DHCPREQUEST on eth0 to 10.176.34.1 port 67
8: Oct 18 06:22:07 INFO ip-10-176-34-132 DHCPACK from 10.176.34.1 (xid=0x3a182c8c)
9: Oct 18 06:22:10 INFO ip-10-176-34-132 bound to 10.176.34.132 -- renewal in 1364s</code>
Общие входные данные для приема
<code>curl -X POST "<nowiki>https://my.activegate/api/v2/logs/ingest</nowiki>"
-H "accept: application/json; charset=utf-8"
-H "Content-Type: text/plain; charset=utf-8"
-d "Oct 18 05:56:11 INFO ip-10-176-34-132 DHCPREQUEST on eth0 to 10.176.34.1Oct 18 05:56:12 INFO ip-10-176-34-132 DHCPACK from 10.176.34.1Oct 18 05:56:13 INFO ip-10-176-34-132 bound to 10.176.34.132 -- renewal in 1551s4:Oct 18 05:56:15 INFO ip-10-176-34-132 [get_meta] Getting token for IMDSvOct 18 05:56:16 INFO ip-10-176-34-132 [get_meta] Trying to get <nowiki>http://169.23.2.3Oct</nowiki> 18 05:56:18 INFO ip-10-176-34-132 [rewrite_aliases] Rewriting aliasesOct 18 06:22:06 INFO ip-10-176-34-132 DHCPREQUEST on eth0 to 10.176.34.1 port 67Oct 18 06:22:07 INFO ip-10-176-34-132 DHCPACK from 10.176.34.1 (xid=0x3a182c8c)Oct 18 06:22:10 INFO ip-10-176-34-132 bound to 10.176.34.132 -- renewal in 1364s"</code>
<code>9</code>строк журнала / записи x <code>0.0005</code>вес журнала = <code>0.0045 ВИД</code>

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

Например, в следующих данных журнала Ключ-АСТРОМ подсчитывает три записи журнала на основе вхождения объекта JSON:

Лог-файл
<code>[
{
"timestamp": "2021-07-29T10:54:40.962165022Z",
"level": "error",
"log.source": "/var/log/syslog",
"application.id": "PaymentService-Prod",
"content": "DHCPREQUEST on eth0 to 10.176.34.1"
},
{
"log.source": "/var/log/syslog",
"content": "[get_meta] Getting token for IMDSv"
},
{
"content": "DHCPACK from 10.176.34.1 (xid=0x3a182c8c)"
}
]</code>

<code>curl -X POST "<nowiki>https://my.activegate/api/v2/logs/ingest</nowiki>"
-H "accept: application/json; charset=utf-8"
-H "Content-Type: application/json; charset=utf-8"
-d "[{\"timestamp\":\"2021-07-29T10:54:40.962165022Z\",\"level\":\"error\",\"log.source\":\"/var/log/syslog\",\"application.id\":\"PaymentService-Prod\",\"content\":\"DHCPREQUEST on eth0 to 10.176.34.1\"},{\"log.source\":\"/var/log/syslog\",\"content\":\"[get_meta] Getting token for IMDSv\"},{\"content\":\"DHCPACK from 10.176.34.1 (xid=0x3a182c8c)\"}]"</code>
<code>3</code>строки журнала / записи x <code>0.0005</code>вес журнала = <code>0.0015</code>DDU.

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

Например, оба следующих журнала ( Log1 и Log2 ) содержат 14 строк данных журнала. Ключ-АСТРОМ вычисляет записи журнала, которые используют ВИД с действительной меткой времени. В результате Log1 генерировал стоимость <code>0.007 ВИД</code>, а Log2 генерировал стоимость <code>0.001 ВИД</code>.

Журнал1
<code>1: Oct 18 05:56:11 INFO ip-10-176-34-132 DHCPREQUEST on eth0 to 10.176.34.1
2: Oct 18 05:56:12 INFO ip-10-176-34-132 DHCPACK from 10.176.34.1
3: Oct 18 05:56:13 INFO ip-10-176-34-132 bound to 10.176.34.132 -- renewal in 1551s4:
4: Oct 18 05:56:15 INFO ip-10-176-34-132 [get_meta] Getting token for IMDSv
5: Oct 18 05:56:16 INFO ip-10-176-34-132 [get_meta] Trying to get <nowiki>http://169.23.2.3</nowiki>
6: Oct 18 05:56:15 INFO ip-10-176-34-132 [get_meta] Getting token for IMDSv
7: Oct 18 06:16:16 INFO ip-10-176-34-132 [get_meta] Trying to get <nowiki>http://169.23.2.3</nowiki>
8: Oct 18 06:16:18 INFO ip-10-176-34-132 [rewrite_aliases] Rewriting aliases
9: Oct 18 06:21:26 INFO ip-10-176-34-132 DHCPREQUEST on eth0 to 10.176.34.1 port 67
10: Oct 18 06:22:06 INFO ip-10-176-34-132 DHCPREQUEST on eth0 to 10.176.34.1 port 67
11: Oct 18 06:22:07 INFO ip-10-176-34-132 DHCPACK from 10.176.34.1 (xid=0x3a182c8c)
12: Oct 18 06:22:10 INFO ip-10-176-34-132 bound to 10.176.34.132 -- renewal in 1364s
13: Oct 18 14:51:22 ERROR ip-10-176-34-32 classOne: Index out of range
14: Oct 18 16:52:10 ERROR ip-10-176-34-32 classOne: Index out of range</code>
<code>14</code>записей <code>0.0005</code>журнала x вес журнала = <code>0.007 ВИД</code>.

Журнал2
<code>1: Oct 18 14:51:22 ERROR ip-10-176-34-32 classOne: Index out of range
2: java.lang.StringIndexOutOfBoundsException: String index out of range: 18
3: at java.lang.String.charAt(String.java:658)
4: at com.example.app.loggingApp.classOne.getResult(classOne.java:15)
5: at com.example.app.loggingApp.AppController.tester(AppController.java:27)
6: at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
7: at sun.reflect.NativeMethodAccessorImpl.invoke0(NativeMethodAccessorImpl.java:62)
8: Oct 18 16:52:10 ERROR ip-10-176-34-32 classOne: Index out of range
9: java.lang.StringIndexOutOfBoundsException: String index out of range: 18
10: at java.lang.String.charAt(String.java:658)
11: at com.example.app.loggingApp.classOne.getResult(classOne.java:15)
12: at com.example.app.loggingApp.AppController.tester(AppController.java:27)
13: at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
14: at sun.reflect.NativeMethodAccessorImpl.invoke0(NativeMethodAccessorImpl.java:62)</code>
<code>2</code>записи <code>0.0005</code>журнала x вес журнала = <code>0.001</code>DDU.

Ресурсы мониторинга

2024-09-16T14:48:28Z

ENetrebin:

'''''[https://doc.ruscomtech.ru/index.php/Ресурсы_мониторинга Лицензирование] /'''''

[[Мониторинг приложений и инфраструктуры (хост-модули)|Мониторинг приложений и инфраструктуры (Единый Агент)]]

[[Цифровой мониторинг опыта (единицы DEM)|мониторинг Цифрового опыта (ЦО)]]

[[Расширение Ключ-АСТРОМ (блоки данных ИИ)|Расширение Ключ-АСТРОМ (Внешние Источники Данных - ВИД)]]

* [[DDU для лога мониторинга|ВИД]] [[DDU для лога мониторинга|для мониторинга логов]]
* [[DDU для пользовательских трассировок (Trace API)|ВИД]] [[DDU для пользовательских трассировок (Trace API)|для пользовательских трассировок (Trace API)]]
Потребление мониторинга Ключ-АСТРОМ основано на различных типах модулей мониторинга, которые используются вашей средой Ключ-АСТРОМ во время мониторинга ваших приложений и связанных служб.

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

Ресурсы мониторинга

2024-09-16T14:44:45Z

ENetrebin:

'''''[https://doc.ruscomtech.ru/index.php/Ресурсы_мониторинга Лицензирование] /'''''

[[Мониторинг приложений и инфраструктуры (хост-модули)|Мониторинг приложений и инфраструктуры (Единый Агент)]]

[[Цифровой мониторинг опыта (единицы DEM)|мониторинг Цифрового опыта (ЦО)]]

[[Расширение Ключ-АСТРОМ (блоки данных Дэвиса)|Расширение Ключ-АСТРОМ (Внешние Источники Данных - ВИД)]]

* [[DDU для лога мониторинга|ВИД]] [[DDU для лога мониторинга|для мониторинга логов]]
* [[DDU для пользовательских трассировок (Trace API)|ВИД]] [[DDU для пользовательских трассировок (Trace API)|для пользовательских трассировок (Trace API)]]
Потребление мониторинга Ключ-АСТРОМ основано на различных типах модулей мониторинга, которые используются вашей средой Ключ-АСТРОМ во время мониторинга ваших приложений и связанных служб.

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

Мониторинг приложений и инфраструктуры (хост-модули)

2024-09-16T14:43:37Z

ENetrebin:

'''''[https://doc.ruscomtech.ru/index.php/Ресурсы_мониторинга Лицензирование] / Мониторинг приложений и инфраструктуры (хост-модули)'''''

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

Однако не все хосты одинакового размера. Более крупные узлы потребляют больше лицензий, чем узлы меньшего размера. Мы используем объем оперативной памяти на отслеживаемом сервере в качестве меры для определения размера хоста (то есть того, сколько лицензий ЕА он потребляет). Преимущество этого подхода заключается в его простоте - мы не принимаем во внимание факторы, зависящие от технологии (например, количество JVM или количество микросервисов, размещенных на сервере). Не имеет значения, является ли хост на основе .NET, Java или чего-то еще. У вас может быть 10 JVM или 1000 JVM; такие факторы не влияют на объем мониторинга, потребляемого средой.

ЕдиныйАгент может работать в двух разных режимах. По умолчанию ЕдиныйАгент работает в режиме полного мониторинга . В качестве альтернативы вы можете использовать режим мониторинга инфраструктуры для мониторинга хостов, которым не требуется полная видимость стека. Режим инфраструктуры потребляет меньше узлов, чем режим Full-Stack.

== Единый Агент (ЕА) ==
Обратитесь к таблице весовых коэффициентов хост-модулей ниже, чтобы узнать, сколько хост-модулей потребляется в зависимости от объема ОЗУ отслеживаемого сервера. Общее потребление хост-модулей рассчитывается на основе суммы всех хост-модулей всех режимов и отслеживаемых систем.
{| class="wikitable"
!Max. RAM
!ЕА (Full-Stack *)
!ЕА (Инфраструктура **)
|-
|1,6 ГБ
|0,10
|0,03
|-
|4ГБ
|0,25
|0,075
|-
|8 ГБ
|0,50
|0,15
|-
|16 ГБ
|1.0
|0,3
|-
|32 ГБ
|2.0
|0,6
|-
|48 ГБ
|3.0
|0,9
|-
|64 ГБ
|4.0
|1.0
|-
|80 ГБ
|5.0
|1.0
|-
|96 ГБ
|6.0
|1.0
|-
|112 ГБ
|7.0
|1.0
|-
|nx16 ГБ
|п
|1.0
|}
<nowiki>*</nowiki> Когда объем ОЗУ на хосте оказывается между значениями, указанными в таблице выше, число округляется в большую сторону. Например, хост с 12 ГБ ОЗУ потребляет 1 лицензию ЕА, потому что 12 ГБ находятся между 8 ГБ и 16 ГБ.

<nowiki>**</nowiki> Для режима мониторинга инфраструктуры применяется тот же принцип округления, но количество единиц хоста, потребляемых хостом, ограничено 1,0.

Лучшие команды для владения

2024-09-13T14:33:44Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.92.D0.BB.D0.B0.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5|Владение]] / Лучшие команды для владения'''''

Эти передовые методы и советы по владению призваны помочь вам:

* Установите владения на краткосрочные объекты, такие как экземпляры групп процессов и модули Kubernetes.
* Минимизируйте время, необходимое для выполнения маркировки.
* Эффективно масштабируйте распределение владений для больших и сложных сред.
* Обеспечьте покрытие владений для организаций путем назначения команд во время развертывания.
* Поддерживайте актуальную информацию о команде для маршрутизации и отображения.

== Передача владения ==
Мы рекомендуем назначить владельцев для критически важных объектов. Это подразделения, которые часто выходят из строя или имеют проблемы с безопасностью, обладают высокой пропускной способностью, являются критически важными для компании или взаимодействуют с пользователями.

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

* [[Назначение владельцев объектов|'''''Метки Kubernetes для объектов Kubernetes''''']]
* [[Назначение владельцев объектов|'''''Метаданные для хостов''''']]
* [[Назначение владельцев объектов|'''''Переменные среды для процессов''''']]
* [[Назначение владельцев объектов|'''''Теги (ручные, автоматические и через API) для всех остальных сущностей''''']]

=== Kubernetes ===
Для '''''[[Назначение владельцев объектов|объектов Kubernetes]]''''' определите владельца одновременно для всех желаемых объектов Kubernetes. Это гарантирует, что все ваши объекты Kubernetes будут иметь адекватное покрытие владельца во время развертывания.

* Всегда применяйте метки для развертывания .
* Мы рекомендуем указать владельца как минимум для объектов <code>CLOUD_APPLICATION</code> (например, Deployment, Job, CronJob или DaemonSet) и <code>CLOUD_APPLICATION_INSTANCE</code> (Pods).
* Уникальные ключи являются обязательными в парах ключ-значение в метках Kubernetes. Ключи должны начинаться с имен пользовательских ключей, которые вы определяете для информации о владельце. Например, вы можете использовать <code>owner</code> и <code>dt.owner</code> в качестве префиксов для создания уникальных ключей.

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

<code>apiVersion: apps/v1</code>

<code>kind: Deployment</code>

<code>metadata:</code>

<code> name: demo</code>

<code> labels:</code>

<code> dt.owner-1: my-team-1 # Dual team ownership defined for the Deployment</code>

<code> dt.owner-2: my-team-2</code>

<code>spec:</code>

<code> replicas: 1</code>

<code> selector:</code>

<code> matchLabels:</code>

<code> app: demo</code>

<code> template:</code>

<code> metadata:</code>

<code> labels:</code>

<code> app: demo</code>

<code> dt.owner-1: my-team-1 # Ownership defined for the Pod</code>

<code> spec:</code>

<code> containers:</code>

<code> - name: demo</code>

<code> image: demo:1.0.0</code>

<code> ports:</code>

<code> - containerPort: 8888</code>

<code> env:</code>

<code> - name: DT_CUSTOM_PROP # Environment variable</code>

<code> value: 'dt.owner-1=my-team-1' # Ownership defined for the process</code>

=== Теги ===
Используйте '''''[[Назначение владельцев объектов|теги, чтобы применять владения]]''''' только к тем сущностям, которые не охвачены другими методами.

==== Преимущества и использование тегов ====

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

==== Важные замечания при использовании тегов для определения владения ====

* Ручное тегирование не масштабируется адекватно для назначения владения в больших динамических средах мониторинга. Ручные теги также можно удалить вручную.
* Хотя (на основе веб-интерфейса) правила автоматических тегов разработаны для сложности, выполнение автоматических тегов может занять много времени в зависимости от сложности ваших правил и размера вашей среды. Между тем, критически важный объект, испытывающий проблему, может не быть помечен с владением.
* Хотя вызов API пользовательских тегов выполняется немедленно, недостаток заключается в том, что это одноразовая операция. В зависимости от частоты запусков тегирования новые или недолговечные объекты могут полностью не быть помечены информацией о владельце, что затрудняет поиск владельцев в случае уязвимостей или сбоев.
* Мы не рекомендуем использовать теги для применения владения к процессам или группам процессов.

== Информация о командах ==
Хотя для создания команды владельцев требуются только поля '''Название команды''' и '''Идентификатор команды''', вот несколько предложений и рекомендаций по использованию других полей.

* При определении пользовательских ключей для идентификаторов собственности используйте конкретные, легко понятные имена, которые вряд ли будут использоваться для других целей тегирования.
* Всегда добавляйте описание команды — оно отображается вместе с названием команды на странице настроек '''Команды владения''' и помогает различать команды с первого взгляда. Команды без описания или с неудачным названием (команда 1) не дают никаких подсказок относительно их роли в вашей организации. Команды с описаниями (2 и 3) более идентифицируемы. [[Файл:227.png|граница]]
* Дополнительные идентификаторы (вы можете определить до трех для каждой команды) особенно полезны, когда:
** Название вашей команды изменится — вы можете добавить дополнительный идентификатор, чтобы отразить изменение названия, оставив основной идентификатор команды без изменений. (После создания основной идентификатор команды нельзя будет редактировать или изменять.)
** Вы хотите определить подкоманды. Создайте дополнительный идентификатор для каждой подкоманды — вы можете использовать основной идентификатор команды в качестве префикса. Например, для основного идентификатора команды <code>team1</code> создайте дополнительные идентификаторы <code>team1-taskforce</code> и <code>team1-planning</code>. Дополнительные идентификаторы обеспечивают большую гибкость.
** Независимо от того, применяете ли вы к объекту основной или дополнительный идентификатор команды, он помечается как принадлежащий к той же названной команде.
** Дополнительные идентификаторы могут быть изменены и удалены.
** Дополнительный идентификатор может совпадать с основным или дополнительным идентификатором другой команды. В таком случае обе команды отмечаются как владельцы, когда дополнительный идентификатор применяется к объекту.
* Всегда выбирайте '''Обязанности команды''', даже если они не требуются. Обязанности отображаются на видном месте вместе с описаниями команды на карточке владельца объекта. Эти фрагменты информации о команде являются ключевыми индикаторами для добавления контактной информации для маршрутизации сообщений и эскалаций. [[Файл:228.png|граница]]
* Определите как минимум один адрес электронной почты или канал Slack для каждой команды в разделе '''Контактная информация''', чтобы вы могли создать автоматизированный рабочий процесс с целевым уведомлением или просто извлечь контактную информацию любого отслеживаемого объекта, когда это необходимо.
* Для дополнительной информации , хотя вы можете определять пользовательские пары ключ-значение '''ad hoc''', мы рекомендуем рационализировать ключи между командами, чтобы их можно было повторно использовать для тех же видов информации. Например, используйте те же или связанные ключи для определения информации о центрах затрат и другой набор ключей по всей организации для определения иерархий и отношений команд.

Приложение для владения

2024-09-13T14:33:21Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.92.D0.BB.D0.B0.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5|Владение]] / Приложение для владения'''''

'''''Последняя версия Ключ-АСТРОМ'''''

Приложение '''Ownership''' предоставляет действия для построения рабочего процесса, запрашивающего команду владения объекта и связанную контактную информацию. С помощью этих действий вы можете извлекать данные о владении объекта и интегрировать их с другими приложениями, например, для отправки уведомлений Slack или обновлений Jira владением объектов на основе различных триггеров.

Кроме того, приложение '''Ownership''' позволяет импортировать команды из следующих источников с помощью автоматизированных рабочих процессов :

* Группы из [[Полное руководство по мониторингу служб Azure|'''''Microsoft Entra ID''''']]
* Группы из '''''ServiceNow'''''
* Любой источник данных, использующий структуру '''''JSON'''''

Подробности см . в разделе '''''Возможности''''' (ниже).

== Разрешения ==

* Для владения требуются следующие разрешения.
** <code>environment-api:entities:read</code>—Читать объекты.
** <code>settings:objects:read</code>—Читать объекты настроек 2.0.
** <code>settings:schemas:read</code>—Читать схемы настроек 2.0.
* Кроме того, вам потребуются следующие основные разрешения в '''Workflows''' (перейдите в раздел '''Workflows > Настройки > Настройки авторизации''').
** <code>app-engine:apps:run</code>— Позволяет просматривать и запускать приложения; обеспечивает базовый доступ к '''Launcher'''.
** <code>app-engine:functions:run</code>— Позволяет использовать функцию-исполнитель. В качестве альтернативы вы можете настроить пользователей с помощью пользовательской политики '''AppEngine'''.

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

=== <code>import_teams</code> ===
Это действие позволяет импортировать команды '''Ownership''' в Ключ-АСТРОМ из разных источников данных. Для всех поддерживаемых источников мы предоставляем [https://github.com/Dynatrace/Dynatrace-workflow-samples/tree/main/samples/Team-Import '''''шаблоны рабочих процессов'''''] которые можно использовать в качестве справочного материала.

* Группы '''Entra ID''' Действие <code>import_teams</code> берет результаты предопределенного действия <code>get_groups</code>, которое получает данные о группах из [[Полное руководство по мониторингу служб Azure|'''''Microsoft Entra ID''''']], и сохраняет данные как [[Создание и управление владениями|'''''команды владения''''']] в Ключ-АСТРОМ. Таким образом, вы можете использовать информацию о своем Entra ID для назначения команд владения объектами, отслеживаемым Ключ-АСТРОМ, без создания команд с нуля.
*# Убедитесь, что действие <code>get_groups</code> предшествует действию <code>import_teams</code> в том же рабочем процессе. Мы рекомендуем, чтобы действие <code>import_teams</code> следовало сразу за действием <code>get_groups</code>. Важно для импорта групп '''Entra ID''' в качестве команд владения :
*#* Вам всегда необходимо включать <code>id</code> и <code>displayName</code> в <code>$select</code>; эти поля сопоставляются с ID команды и названием команды импортированной команды владения соответственно.
*#* Мы рекомендуем всегда включать параметр <code>mailNickname</code> в <code>get_groups</code>. Это поле имеет уникальные значения в '''Entra ID''' и задается как уникальный, понятный человеку дополнительный ID для вашей импортированной команды владения в Ключ-АСТРОМ.
*#* ID объекта из '''Entra ID''', импортированный через параметр <code>id</code>, устанавливается как уникальный ID команды , а также как внешний ID импортированной команды владения.
*#* Параметр <code>mail</code> задается как адрес электронной почты импортированной команды владения.
*# Выберите группы Entra ID в качестве источника данных на вкладке '''Вход''' в действии <code>import_teams</code>.
*# Установите данные, содержащие команды для импорта — в этом случае в качестве входных данных для <code><nowiki>{{ result("get_groups") }}</nowiki></code> используется результат <code>get_groupsimport_teams</code>
*# Выберите настройки импорта . Импорт команды из '''Entra ID''' не может быть отменен. Однако вы можете выборочно импортировать и защищать изменения в ранее импортированной информации, выбрав один из следующих вариантов.
*#* Если вы уже импортировали команды из '''Entra ID''', вы можете выбрать '''Import new teams and skip existing teams''' . Эта опция гарантирует, что импортированные ID команд не перезапишут никакую информацию о командах, уже сохраненную в Ключ-АСТРОМ. Эта опция позволяет обслуживать команды и планировать запуски импорта команд. Эта опция полезна, когда вы ранее импортировали команды, а затем изменили импортированную информацию в Ключ-АСТРОМ. В таких случаях Ключ-АСТРОМ, а не '''Entra ID''', является источником правды о ваших существующих командах владения, и вы не хотите, чтобы последующие запуски <code>import_teams</code> перезаписывали вашу текущую информацию.
*#* Если вы хотите импортировать команды из '''Entra ID''' с нуля, выберите '''Import new teams and owerwrite existing teams''' . Для импортируемых ID команд эта опция перезаписывает любую информацию о команде, которая уже существует в Ключ-АСТРОМ.

[[Файл:267.png|граница]]

* Группы '''''ServiceNow''''' Действие <code>import_teams</code>берет результаты предопределенного действия <code>get_groups</code>, которое получает данные о группах из '''ServiceNow''' и сохраняет данные как [[Создание и управление владениями|'''''команды владения''''']] в Ключ-АСТРОМ. Таким образом, вы можете использовать информацию '''ServiceNow''' для назначения команд владения объектам, отслеживаемым Ключ-АСТРОМ, без создания команд с нуля.
*# Убедитесь, что действие <code>get_groups</code> предшествует действию <code>import_teams</code> в том же рабочем процессе. Мы рекомендуем, чтобы действие <code>import_teams</code> следовало сразу за действием <code>get_groups</code>.
*# Выберите группы '''ServiceNow''' в качестве источника данных на вкладке '''Вход''' в действии <code>import_teams</code>.
*# Установить данные, содержащие команды для импорта — в этом случае в качестве входных данных для <code><nowiki>{{ result("get_groups") }}</nowiki></code> используется результат <code>get_groupsimport_teams</code>.
*# Выберите настройки импорта . Импорт команды из '''ServiceNow''' не может быть отменен. Однако вы можете выборочно импортировать и защищать изменения в ранее импортированной информации, выбрав один из следующих вариантов.
*#* Если вы уже импортировали команды из '''ServiceNow''', вы можете выбрать '''Import new teams and skip existing teams'''. Эта опция гарантирует, что импортированные идентификаторы команд не перезапишут никакую информацию о командах, уже сохраненную в Ключ-АСТРОМ. Эта опция позволяет выполнять обслуживание команд и запланированные запуски импорта команд. Эта опция полезна, когда вы ранее импортировали команды и изменили импортированную информацию в Ключ-АСТРОМ. В таких случаях Ключ-АСТРОМ, а не '''ServiceNow''', является источником правды о ваших существующих командах владельцев, и вы не хотите, чтобы последующие запуски <code>import_teams</code> перезаписывали вашу текущую информацию.
*#* Если вы хотите импортировать команды из '''ServiceNow''' с нуля, выберите '''Import new teams and owerwrite existing teams'''. Для импортируемых идентификаторов команд эта опция перезаписывает любую информацию о команде, которая уже существует в Ключ-АСТРОМ.
* '''JSON''' <code>import_teams</code> позволяет импортировать информацию о команде владения, которая ранее была сгенерирована как массив '''JSON''' действием <code>run_javascript</code> в том же рабочем процессе. Этот подход позволяет извлекать информацию о команде из любой сторонней базы данных в структурированном формате, указанном в схеме '''JSON''' конфигурации владельцев (<code>builtin:ownership.config</code>), которую предоставляет Ключ-АСТРОМ.
*# Убедитесь, что действие <code>run_javascript</code> предшествует <code>import_teams</code> в том же рабочем процессе. Мы рекомендуем, чтобы действие <code>import_teams</code> следовало сразу за действием <code>run_javascript</code>. Результатом <code>run_javascript</code> должен быть массив '''JSON''', который можно потреблять <code>import_teams</code>.
*# В разделе '''Схема владения''' <code>import_teams</code> выберите '''JSON''' в качестве источника данных на вкладке '''Вход'''.
*# Установите данные, содержащие команды для импорта <code><nowiki>{{ result("run_javascript_1") }}</nowiki></code>— это результат <code>run_javascript</code>.
*# Выберите настройки импорта . Импорт команды из '''JSON''' не может быть отменен. Однако вы можете выборочно импортировать и защищать изменения в ранее импортированной информации, выбрав один из следующих вариантов.
*#* '''Import new teams and skip existing teams''' гарантирует, что для импортируемых идентификаторов команд любая информация о командах, уже сохраненная в Ключ-АСТРОМ, не будет перезаписана. Эта опция позволяет обслуживать команды и планировать запуски импорта команд. Эта опция полезна, когда вы ранее импортировали команды, а затем изменили импортированную информацию в Ключ-АСТРОМ. В таких случаях вы не хотите, чтобы последующие запуски <code>import_teams</code> перезаписывали вашу текущую информацию.
*#* Чтобы импортировать команды с нуля, выберите '''Import new teams and owerwrite existing'''. Для импортируемых идентификаторов команд эта опция перезаписывает любую информацию о команде, которая уже существует в Ключ-АСТРОМ.

=== <code>get_owners</code> ===
Предварительные условия: вы создали команды владения в Ключ-АСТРОМ и назначили их отслеживаемым объектам.

Действие <code>get_owners</code> позволяет вам извлекать связанные команды владения, включенные в метаданные указанных объектов. Вы можете определить источник, из которого вы хотите запросить владельцев. И ID объекта, и ID команды могут использоваться по отдельности или в комбинации.

# Выберите ID объектов, либо введя ссылку на выражение '''Jinja''' , либо добавив несколько ID объектов, разделив их запятой <code>,</code> или точкой с запятой <code>;</code>. Это действие принимает ID объектов в качестве входных данных, но также может вывести ID объекта на основе предыдущего действия рабочего процесса.
# Выберите команду из списка ID команды или введите ссылку на выражение '''Jinja''' . Это действие принимает команду в качестве входных данных, но также может вывести команду на основе предыдущего действия рабочего процесса.
# В '''Фильтр владения''' выберите владение на основе обязанностей, содержащихся в определениях команды в Фильтр владельцев по ответственности . По умолчанию фильтр не применяется.

[[Файл:268.png|граница]]

== Пример создания автоматизированного рабочего процесса ==
Использование владения в рабочих процессах лучше всего иллюстрируется в '''Send logs to the owner of an entity''' в '''Automation Workflow Creator Sample'''. Вы можете сохранять иллюстрации в '''Automation Workflow Creator Sample''' как '''Notebooks''', что позволяет просматривать подробные инструкции и запускать фрагменты кода для образцов рабочих процессов.

Вы можете использовать '''Automation Workflow Creator Sample''', чтобы ознакомиться с использованием готовых действий владения в '''Workflows'''.

# Перейти к примеру '''Automation Workflow Creator'''. [[Файл:269.png|граница]]
# Прокрутите страницу до пункта '''Send logs to the owner of an entity''' и выберите '''Choose warkflow''' .
# Сохраните иллюстрацию в новом или существующем '''Notebook''' и выберите '''Add''' . [[Файл:270.png|граница]] Теперь ваше подробное руководство доступно в '''Notebooks''' с подробными инструкциями, примерами кода, которые вы можете запустить, и ссылками на пример рабочего процесса. [[Файл:272.png|граница]]
# Прокрутите страницу и выберите ссылку на пример рабочего процесса '''Примеры автоматизации: целевые уведомления''', который вы можете изменить в соответствии со своими целями. [[Файл:273.png]] [[Файл:274.png|граница]]

== Шаги обучения и пример рабочего процесса ==
В этом разделе представлен контекст и проводится руководство по руководству '''Владения''' и пример рабочего процесса, установленные выше . Руководство сохранено в '''Notebooks''' , а пример рабочего процесса сохранен в '''Workflows''' .

* Шаг 1: Назначьте владение хосту. В качестве предварительного условия вам необходимо настроить владение и назначить команду хосту в вашей среде. Подробнее о доступных методах читайте в разделе '''''[[Назначение владельцев объектов]]'''''. Обратите внимание, что вы можете применить тег для владения непосредственно на странице обзора хоста — выберите '''Владельцы''' в верхней части страницы, а затем выберите '''Добавить тег владения'''. [[Файл:275.png|граница]]
* Шаг 2: Смоделируйте мероприятие-организатора. В качестве вспомогательного средства для руководства этот шаг имитирует событие хоста типа '''Пользовательская информация''' ; в реальном сценарии хост столкнется с событием или проблемой, которая запускает рабочий процесс. В предоставленном примере кода вставьте идентификатор хоста, как показано ниже, и выберите '''Запустить''' '''код''' . ID хоста можно найти в URL-адресе страницы обзора хоста. [[Файл:276.png|граница]] Событие можно увидеть на карточке '''События'''. [[Файл:277.png|граница]]
* Шаг 3: Извлечение событий; настройка триггера событий рабочего процесса. На третьем этапе руководства ID хоста принимается в качестве входных данных для выполнения DQL-запроса, который извлекает события хоста указанного типа <code>CUSTOM_INFO</code>. Это соответствует первой задаче в '''Automation Samples: Targeted Notifications sample workflow''' , которая устанавливает триггер на основе событий для рабочего процесса. Вставьте ID хоста, как показано, и выберите '''Query events''' . На изображении ниже показаны выходные данные задачи и сведения о самом последнем событии. [[Файл:278.png|граница]]
* Шаг 4: Извлеките логи хоста. Этот шаг руководства соответствует второй задаче примера рабочего процесса, в котором действие <code>get_logs</code> извлекает последние 10 логов для хоста. Вам необходимо указать ID хоста для запуска примера кода в руководстве. Однако рабочий процесс использует код <code><nowiki>{{ event()["dt.entity.host"] }}</nowiki></code> для извлечения логов для хоста, уже определенного в триггере рабочего процесса.
* Шаг 5: Получите информацию о владельце хоста (действие <code>get_owners</code>). В этом шаге описываются действия <code>get_owners</code> в примере рабочего процесса '''Примеры автоматизации: целевые уведомления'''. <code>get_owners</code> требует ID объекта в качестве входных данных для извлечения информации о связанной команде владения. Однако в образце рабочего процесса <code>get_owners</code> использует код <code><nowiki>{{ event()["dt.entity.host"] }}</nowiki></code> для извлечения команд для хоста, уже определенного в триггере рабочего процесса. [[Файл:279.png|граница]]
* Шаг 6: Запустите пример рабочего процесса. Прежде чем выбрать '''Run''' для сохраненного примера рабочего процесса, выполните шаг 2 руководства несколько раз, чтобы смоделировать события хоста. Когда вы выполнили свой рабочий процесс, успешные задачи подсвечиваются зеленым цветом. Выберите каждое действие владения в представлении выполнения, чтобы проверить его вывод. <code>get_owners</code> возвращает информацию о команде вместе с контактными данными, сгруппированными по типу контакта в формате '''JSON''' на вкладке '''Executions'''. [[Файл:280.png|граница]]
* Шаг 7: Настройте действие '''Slack''' для целевых уведомлений. Вы можете расширить пример рабочего процесса, интегрировав его со '''Slack for Workflows''' для отправки целевых уведомлений. Аналогично, если вы извлекаете контактную информацию '''Jira''' для команды владения, вы можете интегрировать его с '''Jira for Workflows''' для создания задач.

Анализ распределенных трассировок

2024-09-13T14:32:11Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.A0.D0.B0.D1.81.D0.BF.D1.80.D0.B5.D0.B4.D0.B5.D0.BB.D0.B5.D0.BD.D0.BD.D1.8B.D0.B5%20.D1.82.D1.80.D0.B0.D1.81.D1.81.D0.B8.D1.80.D0.BE.D0.B2.D0.BA.D0.B8|Распределенные трассировки]] / Анализ распределенных трассировок'''''

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

=== Быстрый старт ===
Чтобы начать работу с анализом распределенных трассировок

# Перейдите в раздел '''Распределенные трейсы.'''
# '''''необязательный''''' Используйте обзорную диаграмму, чтобы оценить количество запросов и время ответа за выбранный период времени. '''''Хранение данных''''' Диаграмма использует данные трассировки и запроса , которые имеют разные периоды хранения данных. Для временных рамок, содержащих данные старше 10 дней, вы можете включить переключатель Показать хранение данных, чтобы лучше понять, какие данные доступны для какого периода непосредственно из диаграммы.
# '''''необязательный''''' В таблице разверните сведения о трассировке, которую вы хотите проанализировать, чтобы получить обзор ее топологии, атрибутов, HTTP-информации и времени.
# Выберите имя распределенной трассировки для углубленного анализа трассировки.
# Выберите временной отрезок, чтобы развернуть вкладки с подробностями.

=== Просмотр обзора трейсов ===
Чтобы настроить просмотр распределенных трассировок в вашей среде

# Перейдите в раздел '''Распределенные трейсы.''' [[Файл:197.png|граница]] [[Файл:198.png|граница]]
# Настройте вид, установив фильтры. Чтобы отфильтровать распределенные трассировки по
#* Методам
#** Выберите '''PurePaths''' , чтобы просмотреть распределенные трассировки PurePath®, полученные ЕдинымАгентом.
#** Выберите '''Принятые трейсы''' , чтобы просмотреть распределенные трассировки , инструментированные с помощью других библиотек .
#* Базы данных Перейдите в '''Фильтр запросов > Имя базы данных''' и введите имя службы. Обратите внимание, что вы также можете получить доступ к этому представлению, перейдя в '''Службы > Дополнительно ( … ) > Распределенные трассировки для службы'''.

=== Экспорт базы данных ===
Вы можете экспортировать данные таблицы обзора распределенных трассировок в файл со значениями, разделенными запятыми (CSV).

# Перейдите в раздел '''Распределенные трейсы.'''
# '''''необязательный''''' Сузьте результаты поиска по таблице, изменив настройки представления или воспользовавшись полем ввода поиска над таблицей. В таблице перечислены до 3000 последних трассировок, которые были захвачены в течение выбранного периода времени и в пределах выбранной зоны управления. В зависимости от периода времени и настроенного представления список выделяет наиболее важный узел для трассировки. '''Найти узел''' Чтобы найти определенный узел трассировки
## Перейдите в раздел '''Распределенные трейсы'''.
## Отфильтруйте таблицу по идентификатору трассировки.
## Выберите имя трассировки.
## В окне трассировки найдите нужный узел.
# В правом нижнем углу страницы выберите меню '''Показать экспорт''' [[Файл:199.png|граница]] .
# Выберите один из следующих вариантов.

{| class="wikitable"
!Вариант
!Экспортированные данные
!Поля
!Количество входов
|-
|Экспорт видимых данных
|Текущая отображаемая область таблицы с учетом примененных фильтров
|Только видимые поля
|До 50 трассировок
|-
|Экспорт данных таблицы
|Все данные таблицы, включая трассировки, которые не отображаются на текущей странице таблицы
|Все доступные поля, относящиеся к распределенным трассировкам
|Все 3000 последних трассировок
|}

=== Анализ выполнения трассировки ===
Представление распределенного анализа трассировки обеспечивает сквозную визуализацию каскадной последовательности запросов в трассировке.

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

# Перейдите в раздел '''Распределенные трейсы.'''
# Из таблицы выберите имя распределенной трассировки.
# '''''необязательный''''' Перейдите к разделу '''Уточнить анализ''' , чтобы узнать распределение времени трассировки.
# Перейдите к каскадной диаграмме, чтобы узнать, какие службы проходят по трассировке и в каком порядке.
# Выберите запрос, чтобы визуализировать последующие взаимодействия. Используйте цвета и положения горизонтальных полос на диаграмме, чтобы увидеть, какие запросы были выполнены синхронно (параллельно). Они указывают как последовательность, так и время ответа каждого из запросов. [[Файл:200.png|граница]]
# Выберите временной сегмент, чтобы получить доступ к подробной аналитике трассировки на подробных вкладках, вплоть до информации на уровне кода.
# Закройте вкладку с деталями, чтобы продолжить анализ.

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

* В случае, если удаётся определить нужную службу, распределённые трассировки с диагностическими сообщениями отображаются на странице распределённых трассировок службы вместе со всеми другими распределёнными трассировками, связанными со службой. [[Файл:201.png|граница]]
* В случае, если связанную службу невозможно определить, например, из-за отсутствия имени или типа службы, распределенные трассировки указываются как '''Неожиданные службы''' в списке служб процесса, для которого были получены распределенные трассировки. Неожиданные службы могут быть вызваны проблемами сети (потеря данных при передаче) или внезапным завершением процесса (перезапуск или масштабирование).

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

Для поддержания хорошего качества данных мы рекомендуем вам

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

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

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

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

* Сократите количество узлов, отправляемых за одну трассировку, например, изменив пользовательские службы и функции ЕдиногоАгента, активные в вашей среде. ЕдиныйАгент может отправлять ограниченное количество узлов на трассировку. Как только он сталкивается с ограничениями ресурсов, новые узлы больше не создаются. Трассировка ограничивается при приеме, и новые входящие данные не добавляются в трассировку. Это может повлиять на корреляцию сущностей и подорвать качество ваших данных.
* Исследуйте следы, которые действуют в течение длительного времени. Для защиты ресурсов вашей среды предпринимаются действия, когда трассировки выполняются в течение длительного времени. Например, трассировки, которые больше не активны после выполнения в течение 90 минут, отсчитываются по тайм-ауту, а трассировки, для которых время начала вызова слишком далеко в прошлом, ограничиваются. В обоих случаях новые данные не добавляются в трассировку. Это может повлиять на корреляцию сущностей и качество данных.
* Исследуйте следы с ограниченным или чрезмерным объемом данных.
** Если данные трассировки не содержат достаточных метаданных о сетях или не все узлы были получены, коррелирование сущностей может оказаться неудачным, что приведет к усеченным трассировкам.
** Если у вызова слишком много зависимостей в процессе выполнения или у трассировки слишком много узлов, такая трассировка усекается. Мы рекомендуем изучить соответствующую службу и, в случае пользовательских служб, связаться с экспертом по продукту Ключ-АСТРОМ через чат в вашей среде.
* Адаптируйте полноэкранный режим просмотра для визуализации необходимых вам данных. Полное представление трассировки в Ключ-АСТРОМ обычно достаточно велико, чтобы отобразить самую важную информацию для всей трассировки. Однако форматирование можно изменить, чтобы помочь вам визуализировать все необходимые данные.

{| class="wikitable"
!Формат элемента
!Начальная настройка
!Приспособление
|-
|Временной диапазон
|Для текущего временного диапазона выберите '''Дополнительно ( … )''' в правом верхнем углу окна просмотра полной трассировки и наведите курсор на '''Уточнить анализ''' .
|Чтобы увеличить временной диапазон, выберите '''Уточнить анализ''' .
|-
|Видимые запросы
|На вкладке '''Уровень кода''' вы можете увидеть вызовы служб до 100 000 узлов.
|Чтобы изменить это ограничение, свяжитесь со специалистом по продуктам Ключ-АСТРОМ через чат в вашей среде Ключ-АСТРОМ.
|}

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

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

'''''Ограничения'''''

* Трассировка между средами ограничивается трассировкой запросов, которые могут передавать информацию о заголовках ответов и отслеживать контекст из принимающей среды, например HTTP или синхронные запросы.
* IBM z/OS (CICS, IMS и Java) и AWS Lambda не поддерживают трассировку между средами.

=== Конфигурация ===
'''''Необходимые условия'''''

* Убедитесь, что между кластерами можно установить прямое сетевое соединение по протоколу HTTP/HTTP.

'''''API-эквиваленты'''''

Процедуры, которые следуют, используют веб-интерфейс Ключ-АСТРОМ. Чтобы выполнить эквивалентные задачи через API, см.:

* API токенов доступа — для создания токена в удаленной среде
* API удаленных сред — для создания ссылки на удаленную среду из локальной среды

==== 1. Создать токен доступа ====
С помощью этой процедуры вы получаете токен доступа из удаленной среды, который вам понадобится на других этапах.

Чтобы создать токен доступа в удаленной среде Ключ-АСТРОМ

# Войдите в удаленную среду.
#* Это среда, из которой вы извлекаете данные.
#* Если вы не можете войти в удаленную среду, кто-то, имеющий доступ к удаленной среде, может выполнить эту процедуру за вас.
# Перейти к токенам доступа .
# Нажмите на кнопку '''Сгенерировать новый токен'''.
# Введите название токена.
# Найдите и выберите следующие области:
#* Найдите область (<code>traces.lookup</code>)
#* Извлечение данных из удаленной среды (<code>RestRequestForwarding</code>)
# Нажмите на кнопку '''Да, создать токен'''. Это сгенерирует токен, который дает вашей локальной среде разрешение проверять наличие трассировки в удаленной среде и извлекать данные из удаленной среды.
# Выберите '''Копировать''', а затем вставьте токен в безопасное место. Это длинная строка, которую вам нужно будет скопировать и вставить обратно в Ключ-АСТРОМ позже.

==== 2. Добавить удаленное окружение ====
Чтобы добавить удаленную среду Ключ-АСТРОМ в список доступных удаленных окружений

# Войдите в локальную среду Ключ-АСТРОМ.
# Перейдите в настройки .
# Выберите '''Интеграция > Удалённые окружения'''.
# Выберите '''Подключить окружение'''.
# Определите удаленное окружение, из которого ваше локальное окружение извлекает данные, а затем выберите '''Сохранить изменения'''.
#* '''Название''' — это имя, под которым удаленное окружение будет указано в текущей среде Ключ-АСТРОМ. Это текст свободной формы. Он не влияет на удаленное окружение.
#* '''URI удаленного окружения'''
#** Для Ключ-АСТРОМ SaaS он должен быть в следующем формате: <code>https://<ENVIRONMENTID>.live.dynatrace.com/</code> Замените <code><ENVIRONMENTID></code>на фактический идентификатор вашего окружения.
#** Для Ключ-АСТРОМ Managed разрешен любой URI.
#* '''Область действия сети'''
#** <code>External</code>: Удаленное окружение расположенное в другой сети. Глобально настроенные параметры прокси используются, если они есть. Это область действия по умолчанию.
#** <code>Internal</code>: Удаленное окружение находится в той же сети. Глобально настроенные параметры прокси-сервера не используются.
#** <code>Cluster</code>: Удаленное окружение находится в том же кластере. Запрос сделан в <code>localhost</code>. Ключ-АСТРОМ SaaS может использовать только <code>External</code>сетевую область действия.
#* '''Токен''' — это токен, который вы сгенерировали в предыдущей процедуре. Он должен включать область поиска одного следа ( <code>traces.lookup</code>).
#* '''Протестировать подключение''' — проверяет соединение вашего текущего окружения с удаленным окружением. Прежде чем продолжить, обязательно получите сообщение <code>connection successfully established</code>.

==== 3. Включить функции ====
Включите следующие функции в каждом окружении группы, которое вы хотите подключить:

* Скоординированный отбор проб Вы можете повысить согласованность трассировки между окружениями с помощью скоординированной выборки. Когда вы включаете переключатель, выборка координируется между окружениями с помощью идентификатора трассировки W3C.
*# Перейдите в '''Настройки > Предпочтения> Функции ЕдиногоАгента'''.
*# Установите распространение контекста трассировки W3C в соответствии с вашими предпочтениями. Вы можете отправлять заголовки HTTP контекста трассировки W3C или заголовки gRPC.
*# Найдите и включите функцию '''Cross-environment tracing - Coordinated sampling''' .
* Заголовки ответа Вы можете включить идентификацию и отслеживание вызовов между окружениями, включая идентификатор окружения и идентификатор трассировки в заголовках HTTP-ответа. Если вызывающее окружение, получающее ответ, имеет окружение, настроенное как доверенное удаленное окружение, пункт назначения вызова связан.
*# Перейдите в '''Настройки > Предпочтения> Функции ЕдиногоАгента''' .
*# Найдите и включите '''Cross-environment tracing - Environment and transaction IDs in HTTP response headers'''.

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

=== Анализ удаленных окружений с перекрестным подключением ===
После настройки соединения между окружениями становятся доступны следующие конкретные параметры анализа.

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

[[Файл:203.png|граница]]

* Исходящие вызовы в подключенные окружения отображаются в '''Smartscape''' и потоке обслуживания. [[Файл:204.png|граница]]
* Все службы, отслеживаемые удаленном окружением и участвующие в запросе, перечислены на странице Удаленные окружения. Чтобы открыть ее, выберите Открыть окружение на странице службы удаленного окружения .

==== Поток обслуживания ====
Поток обслуживания распознает вызовы удаленного окружения. Поскольку запросы отслеживаются другим окружением Ключ-АСТРОМ, при выборе вызова удаленного окружения доступна определенная опция детализации. На боковой панели выберите '''Открыть окружение''', чтобы получить доступ к странице '''Удаленные окружения'''.

[[Файл:205.png|граница]]

==== Распределенные трассировки ====

* Когда запрос поступает в подключенное удаленное окружение, Ключ-АСТРОМ отображает имя удаленного окружения в дереве вызовов. Для отслеживания трассировки в удаленном окружении
*# Выберите запрос удаленного окружения.
*# На вкладке '''Обзор''' выберите пункт '''Открыть окружение'''.
* Если соединение трассировок настроено правильно, Ключ-АСТРОМ автоматически отображает вызов '''Агрегированные запросы''' . Он объединяет все данные обнаруженных запросов в каждой соответствующей подключенном удаленном окружении Если вы настроили подключение к удаленному окружению, но не видите запросов на нем, вы можете запустить ручной поиск трассировки в настроенных окружениях. В правом верхнем углу страницы трассировки выберите Найти в удаленных окружениях.

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

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

[[Файл:206.png|граница]]

Адаптивное управление распределенными трассировками

2024-09-13T14:31:33Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.A0.D0.B0.D1.81.D0.BF.D1.80.D0.B5.D0.B4.D0.B5.D0.BB.D0.B5.D0.BD.D0.BD.D1.8B.D0.B5%20.D1.82.D1.80.D0.B0.D1.81.D1.81.D0.B8.D1.80.D0.BE.D0.B2.D0.BA.D0.B8|Распределенные трассировки]] / Адаптивное управление распределенными трассировками'''''

== Концепции распределенных трассировок ==
Распределенные трассировки PurePath — это сквозные транзакции, захваченные ЕдинымАгентом. Каждую минуту статистически значимое количество сквозных распределенных трассировок записывается в каждом отслеживаемом процессе. Каждая трассировка содержит информацию на уровне кода и бизнес-информацию, полученную из вызовов уровня обслуживания на нескольких уровнях. Поскольку каждая трассировка записывается полностью, уровни второго и третьего уровня часто захватывают больше общих вызовов обслуживания, чем процессы точки входа.

[[Файл:195.png|граница]]

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

=== Чем адаптивное управление отличается от других механизмов выборки? ===
В типичных приложениях распределение запросов неравномерно. Скорее, это комбинация: большого количества уникальных URL, среднего количества важных запросов и, наконец, нескольких видов запросов, которые составляют большую часть трафика (например, запросы изображений или проверки статуса).

Благодаря адаптивному управлению трафиком ЕдиныйАгент сначала рассчитывает список самых популярных запросов, начиная с каждой минуты, а затем извлекает из него:

* Большинство следов уникальных и редких запросов.
* Значительный, но меньший объем очень частых запросов.

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

'''''Пример'''''

В следующей таблице представлен пример расчета основных запросов, а также соответствующие показатели захвата.
{| class="wikitable"
!Запрос
!Количество обработанных приложением запросов
!Фактор захвата
!Захваченные распределенные следы
|-
|URI А
|900
|1/2
|450
|-
|URI-код B
|440
|1/2
|220
|-
|URI-код C
|250
|1
|250
|-
|URI D
|60
|1
|60
|-
|…50 других URI
|100
|1
|100
|-
|Общий:
|1500
|
|1080
|}
В этом примере ЕдиныйАгент захватывает чуть больше 1000 запросов/мин, в соответствии с настроенным целевым числом запросов. В зависимости от фактора захвата URI захватываются каждый раз (URI C, D и 50 других URI) или только 50% времени (URI A и B). В этом последнем случае запросы отслеживаются ЕдинымАгентом сквозным образом более 600 раз/мин.

Эффект адаптивного управления трафиком можно увидеть в распределенном списке трассировки. Если ЕдиныйАгент выполняет выборку и не все запросы захвачены, то захваченные трассировки укажут, что похожие запросы не были захвачены с сообщением <code>[amount] more like this</code> в распределенном списке трассировки.

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

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

=== Затраты на процесс ===
В Ключ-АСТРОМ Managed затраты новых распределенных трассировок/мин, которые каждый процесс может отправить в Ключ-АСТРОМ, составляет 1000. Поскольку управление трафиком зависит от архитектуры вашего приложения, сетевой трафик ограничен для точек входа с большим объемом данных (таких как балансировщик нагрузки или NGINX), и могут возникать пики.

==== Адаптивное управление захватом ====
Вы можете управлять затратами новых распределенных трассировок точек входа, захватываемых в минуту, с помощью адаптивного управления захватом , как на уровне среды, так и для каждого процесса или группы процессов.

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

Для управления квотой новых распределенных трасс/мин,

# Перейдите в '''Консоль управления кластером > Окружение''' и выберите свое окружение.
# '''''необязательный''''' В настройках предотвращения перегрузки кластера можно задать квоту среды Количество новых отслеживаемых трассировок точек входа, захваченных на процесс/минуту . Значение по умолчанию — 1000, однако квоту среды можно увеличить до 100 000.
# Нажмите на кнопку '''Перейти к окружению''' .
# Перейдите в '''Настройки > Мониторинг серверных сервисов > Глубокий мониторинг > Адаптивное управление захватом''' .
# Выберите '''Глобальное или Переопределение группы процессов''' . Вы можете уменьшить или увеличить квоту, чтобы соответственно уменьшить процент контролируемого входящего трафика или обеспечить более высокую точность. Если квота вашей среды установлена на уровне 100 000 и вы устанавливаете адаптивное управление захватом на максимальное значение, OneAgent фактически получает указание захватывать все запросы, даже редкие, в средах с большим объемом данных.

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

=== Мониторинг ===
Вы можете использовать предустановленную панель мониторинга ЕдиныйАгент Traces - Адаптивное управление трафиком для отслеживания использования и пороговых значений адаптивного управления трафиком.

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

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

# Новые входящие распределенные трассировки пропускаются случайным образом, постепенно уменьшая количество обработанных распределенных трассировок. Обратите внимание, что вызовы обслуживания полных распределенных трассировок, которые уже находятся в процессе, не являются целевыми.
# Количество пропущенных распределенных трассировок учитывается для обеспечения стабильной статистической достоверности всех показателей, диаграмм, базовых уровней и событий.
# Вы проинформированы о сокращении обрабатываемых данных
#* Предупреждающее сообщение в веб-интерфейсе Ключ-АСТРОМ:<code>Server [amount] activated adaptive load reduction</code>
#* Сообщение в распределенном списке трассировки:<code>[amount] more like this</code>

'''Качество данных'''

Адаптивное снижение нагрузки защищает вашу среду Ключ-АСТРОМ от случайных скачков трафика.

Хотя периодическая активация (например, для покрытия пиков) не повлияет на точность данных мониторинга, постоянное использование в течение интервалов в 15 минут или дольше может повлиять на точность данных и показателей мониторинга, поскольку не все данные обрабатываются.

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

Варианты включают в себя:

* Добавление оборудования и нового узла кластера Ключ-АСТРОМ Managed для обеспечения вашего кластера Ключ-АСТРОМ Managed необходимыми ресурсами для обработки дополнительных данных.
* Изменение настроек ЕдиногоАгента для уменьшения входящего трафика.

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

=== Часто задаваемые вопросы ===
'''''Почему я не вижу определенный запрос?'''''

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

* Вы можете увеличить объем, доступный для важных запросов, уменьшив объем трафика, связанного с неважными запросами. Чтобы исключить неважные запросы из захвата, используйте атрибуты веб-запросов и правила исключения URL.
* Вы также можете увеличить квоту собираемых распределенных трассировок.

'''''Адаптивное управление влияет на диаграммы, базовые показатели и оповещения?'''''

Короткий ответ — нет.

Формирование трафика учитывается прозрачно и выполняется таким образом, чтобы гарантировать статистическую достоверность при захвате редких запросов с высокой вероятностью. Все диаграммы показывают общее реальное количество запросов, которые обрабатывает ваше приложение, как и все специальные анализы, которые вы можете выполнять. Вы не увидите разницы в диаграммах или данных анализа вызовов служб, если только вы не смотрите на одну распределенную трассировку. Действительно, единственное место, где видно это формирование трафика, — это список распределенных трассировок, который отображает сообщение типа <code>[number of traces] more like this</code>.

'''''Влияет ли адаптивное управление на настройки сервиса или (глобальные) настройки мониторинга запросов?'''''

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

'''''Влияет ли адаптивное управление на показатели обслуживания?'''''

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

* Для низкочастотных запросов в средах с большим объемом выборка и низкая скорость захвата могут повлиять на точность метрик. Из-за низкой частоты запросов трассировки могут быть захвачены в меньшем объеме или не захвачены вообще. Следовательно, некоторые значения метрик не могут быть собраны. Обратите внимание, что это отражается в расчетах метрик услуг, чтобы избежать искажений в диаграммах.
* Поскольку каждый отдельный запрос учитывается в диаграммах с высоким разрешением и короткими временными рамками, для услуг с большим объемом выборка и низкая скорость захвата могут повлиять на точность таких метрик, как количество запросов или количество ошибок. И наоборот, точность будет статистически выше в диаграммах с низким разрешением и длинными временными рамками.

== Выборка на основе URL-адресов ==
Чтобы изменить определенный вклад трассировки в объем трассировки среды, вы можете настроить частоту захвата определенных URL-адресов в соответствии со своими потребностями.

[[Файл:196.png|граница]]

# Перейдите в '''Настройки > Мониторинг сервисов > Выборка на основе URL''' .
# Нажмите на кнопку '''Добавить Элемент'''.
# Создайте новое правило.
## Чтобы изменить частоту захвата URL, выберите параметр масштабного коэффициента из параметра '''Важность конкретного URL''' . Чтобы захватывать URL чаще, увеличьте значение захвата и наоборот. Если вы никогда не хотите захватывать трассировку для определенного URL, включите параметр '''Игнорировать конкретный URL'''.
## Введите URL-путь или укажите параметры запроса. Используйте подстановочные знаки (<code>**</code>) для URL-адресов с похожими путями сегментов, например URL-адресов одного и того же домена. Например, в <code>/api/product/**/detail</code>все значения между косыми чертами игнорируются; путь применяется как к , так <code>/api/product/1/detail</code>и к <code>/api/product/2/detail</code>. Чтобы указать параметры запроса, перейдите в раздел '''Параметры запроса''' и выберите '''Добавить элемент'''.
### Введите имя параметра запроса.
### Введите значение параметра запроса или включите опцию Значение параметра запроса не определено .
## '''''необязательный''''' Чтобы применить коэффициент масштабирования к одному или нескольким методам HTTP, отключите параметр '''Любой HTTP-метод''' и выберите целевой метод(ы) HTTP.
# Нажмите на кнопку '''Сохранить изменения'''.

=== Переопределение процессов и групп процессов ===
Чтобы переопределить параметры среды выборки на основе URL для определенной группы процессов или процесса

* На уровне группы процессов выберите '''Дополнительно ( … ) > Настройки группы процессов''' и выберите '''Выборка на основе URL''' .
* На уровне процесса выберите '''Дополнительно ( … ) > Настройки функции ЕдиныйАгент''' и выберите '''Выборка на основе URL''' .

=== Примеры вариантов использования ===
'''''Пример 1: Уменьшить захват часто выполняемого запроса проверки работоспособности, который предоставляет значения менее 60 раз в минуту'''''

# Перейдите в '''Настройки > Мониторинг сервисов > Выборка на основе URL''' .
# Нажмите на кнопку '''Добавить Элемент'''.
# В разделе '''Важность конкретного URL''' выберите '''Уменьшить захват по фактору 4''' .
# Введите URL-путь <code>/_healthz</code>.
# В поле '''Условие сравнения пути''' выберите '''Начинается с''' .
# Включите '''Любой HTTP-метод'''.
# Нажмите на кнопку '''Сохранить изменения'''.

'''''Пример 2: Никогда не перехватывайте запрос HTTP-параметров на веб-серверах для группы процессов'''''

# Перейдите в группу процессов и выберите '''Дополнительно ( … ) > Настройки группы процессов > Выборка на основе URL''' .
# Нажмите на кнопку '''Добавить Элемент''' .
# Включите опцию '''Игнорировать конкретный URL'''.
# Введите URL-путь <code>/</code>.
# В поле '''Условие сравнения пути''' выберите '''Начинается с'''.
# Отключите '''Любой HTTP-метод''' .
# В списке методов HTTP включите '''OPTIONS''' .
# Нажмите на кнопку '''Сохранить изменения'''.
# '''''необязательный''''' Создайте новое правило для каждой группы процессов, на которую вы хотите нацелиться.

Понятие распределенных трассировок

2024-09-13T14:30:05Z

ENetrebin:

Распределенные трассировки

2024-09-13T14:28:58Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [https://doc.ruscomtech.ru/index.php/Применение_Ключ-АСТРОМ#.D0.A0.D0.B0.D1.81.D0.BF.D1.80.D0.B5.D0.B4.D0.B5.D0.BB.D0.B5.D0.BD.D0.BD.D1.8B.D0.B5_.D1.82.D1.80.D0.B0.D1.81.D1.81.D0.B8.D1.80.D0.BE.D0.B2.D0.BA.D0.B8 Распределенные трассировки]'''''

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

*

Распределенные трассировки

2024-09-13T14:28:38Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / Распределенные трассировки'''''

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

*

Непрерывный анализ потоков

2024-09-13T14:27:00Z

ENetrebin:

Профилирование памяти

2024-09-13T14:26:14Z

ENetrebin:

Непрерывное профилирование ЦП

2024-09-13T14:25:23Z

ENetrebin:

Аварийные завершения процессов

2024-09-13T14:24:41Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.9F.D1.80.D0.BE.D1.84.D0.B8.D0.BB.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5%20.D0.B8%20.D0.BE.D0.BF.D1.82.D0.B8.D0.BC.D0.B8.D0.B7.D0.B0.D1.86.D0.B8.D1.8F|Профилирование и оптимизация]] / Аварийные завершения процессов'''''

Процессы аварийно завершаются по множеству причин, и часто бывает сложно понять основные причины, которые способствуют таким аварийным завершениям. Когда отслеживаемый процесс аварийно завершается, вы увидите запись о сбое процесса в разделе '''События''' каждого затронутого процесса и страницы '''Хосты'''. В примере процесса ниже есть некоторые проблемы с доступностью (показаны красным на временной шкале). При выборе затронутого временного интервала на временной шкале раздел '''События''' показывает количество аварийных завершений процесса, произошедших в течение этого временного интервала (в этом примере 3 сбоя).

[[Файл:178.png]]

Нажмите '''Детали сбоя процесса''' , чтобы просмотреть подробный список сбоев, произошедших в течение выбранного таймфрейма. Здесь вы найдете все подробности, связанные с причиной сбоя каждого процесса.

[[Файл:179.png|граница]]

Предоставленные сведения о сбое включают сигнал, который завершил процесс (например, <code>Segmentation fault</code>или <code>Abort</code>), кадр стека выполнения, который дал сбой, и многое другое. Тип сбоя — например, собственный дамп ядра, дамп ядра Java или ненормальный выход программы из-за исключения — определяет, какие сведения о сбое доступны.

== Анализ дополнительных артефактов сбоя ==
Сведения о сбоях часто включают в себя кнопку '''Загрузить''' , которая обеспечивает доступ к дополнительным артефактам сбоев, таким как <code>hs_err_pid</code>файлы для сбоев Java, текстовые файлы, которые предоставляют анализ основных дампов Linux и Windows, или файлы, содержащие исключения .NET, Java или Node.js, которые потенциально были ответственны за сбои. Например, отчет о сбое '''Segmentation fault''' выше привел к созданию основного дампа. ЕдиныйАгент автоматически проанализировал основной дамп, а затем создал следующий отчет в качестве артефакта журнала:

<code>dumpproc version 1.108.0.20161025-115919, installer version 1.108.0.20161025-121046</code>

<code>2016-11-09 18:00:44: Application 'CreditCardAutho', inner pid '15891', outer pid '0', signal: 'Segmentation fault' (11)</code>

<code>process group ID: 0x441b2cb89962033d</code>

<code>process group instance ID: 0xfe58bab23100f42c</code>

<code>process group Name: easytravel-*-x*</code>

<code>threadCount: 1</code>

<code>thread: 0 - stack range: 0x7ffeda572000-0x7ffeda594000, size: 136 kB</code>

<code>0x00007ffeda592be0 0x00007f4de477604d libpthread-2.15.so!<imagebase>+0xf04d</code>

<code>0x00007ffeda592bf0 0x00000000004038d8 CreditCardAuthorizationS64!main+0x1b8</code>

<code>0x00007ffeda592c60 0x00007f4de41c676d libc-2.15.so!__libc_start_main+0xed</code>

<code>0x00007ffeda592d20 0x000000000040329a CreditCardAuthorizationS64!<imagebase>+0x329a</code>

<code>mapped files:</code>

<code>0000000000400000-000000000041e000 0 /home/labuser/easytravel-2.0.0-x64/CreditCardAuthorizationS64 (MD5: da5992daf5ba3b76c633c853c7da5e87)</code>

<code>000000000051d000-000000000051e000 1d /home/labuser/easytravel-2.0.0-x64/CreditCardAuthorizationS64 (MD5: da5992daf5ba3b76c633c853c7da5e87)</code>

<code>00007f4de41a5000-00007f4de4359000 0 /lib/x86_64-linux-gnu/libc-2.15.so (GNU Build-Id: aa64a66ac46bff200848c0a0694011bd0140ab4e)</code>

<code>00007f4de4359000-00007f4de4558000 1b4 /lib/x86_64-linux-gnu/libc-2.15.so (GNU Build-Id: aa64a66ac46bff200848c0a0694011bd0140ab4e)</code>

<code>00007f4de4558000-00007f4de455c000 1b3 /lib/x86_64-linux-gnu/libc-2.15.so (GNU Build-Id: aa64a66ac46bff200848c0a0694011bd0140ab4e)</code>

<code>00007f4de455c000-00007f4de455e000 1b7 /lib/x86_64-linux-gnu/libc-2.15.so (GNU Build-Id: aa64a66ac46bff200848c0a0694011bd0140ab4e)</code>

<code>00007f4de4563000-00007f4de4565000 0 /lib/x86_64-linux-gnu/libdl-2.15.so (GNU Build-Id: d181af551dbbc43e9d55913d532635fde18e7c4e)</code>

<code>00007f4de4565000-00007f4de4765000 2 /lib/x86_64-linux-gnu/libdl-2.15.so (GNU Build-Id: d181af551dbbc43e9d55913d532635fde18e7c4e)</code>

<code>00007f4de4765000-00007f4de4766000 2 /lib/x86_64-linux-gnu/libdl-2.15.so (GNU Build-Id: d181af551dbbc43e9d55913d532635fde18e7c4e)</code>

<code>00007f4de4766000-00007f4de4767000 3 /lib/x86_64-linux-gnu/libdl-2.15.so (GNU Build-Id: d181af551dbbc43e9d55913d532635fde18e7c4e)</code>

<code>00007f4de4767000-00007f4de477f000 0 /lib/x86_64-linux-gnu/libpthread-2.15.so (GNU Build-Id: c340af9dee97c17c730f7d03693286c5194a46b8)</code>

<code>00007f4de477f000-00007f4de497e000 18 /lib/x86_64-linux-gnu/libpthread-2.15.so (GNU Build-Id: c340af9dee97c17c730f7d03693286c5194a46b8)</code>

<code>00007f4de497e000-00007f4de497f000 17 /lib/x86_64-linux-gnu/libpthread-2.15.so (GNU Build-Id: c340af9dee97c17c730f7d03693286c5194a46b8)</code>

<code>00007f4de497f000-00007f4de4980000 18 /lib/x86_64-linux-gnu/libpthread-2.15.so (GNU Build-Id: c340af9dee97c17c730f7d03693286c5194a46b8)</code>

<code>00007f4de4984000-00007f4de4a02000 0 /lib/x86_64-linux-gnu/liboneagentproc.so (1.108.0.20161025-115919)</code>

<code>00007f4de4a02000-00007f4de4c01000 7e /lib/x86_64-linux-gnu/liboneagentproc.so (1.108.0.20161025-115919)</code>

<code>00007f4de4c01000-00007f4de4c03000 7d /lib/x86_64-linux-gnu/liboneagentproc.so (1.108.0.20161025-115919)</code>

<code>00007f4de4c03000-00007f4de4c05000 7f /lib/x86_64-linux-gnu/liboneagentproc.so (1.108.0.20161025-115919)</code>

<code>00007f4de4cc0000-00007f4de4ce2000 0 /lib/x86_64-linux-gnu/ld-2.15.so (GNU Build-Id: e25ad1a11ccf57e734116b8ec9c69f643dca9f18)</code>

<code>00007f4de4ee2000-00007f4de4ee3000 22 /lib/x86_64-linux-gnu/ld-2.15.so (GNU Build-Id: e25ad1a11ccf57e734116b8ec9c69f643dca9f18)</code>

<code>00007f4de4ee3000-00007f4de4ee5000 23 /lib/x86_64-linux-gnu/ld-2.15.so (GNU Build-Id: e25ad1a11ccf57e734116b8ec9c69f643dca9f18)</code>

== Защитите конфиденциальные данные пользователя ==
Отчеты о сбоях могут содержать конфиденциальную личную информацию, которую не следует просматривать всем пользователям. По этой причине ваш администратор Ключ-АСТРОМ должен включить опцию безопасности учетной записи '''View logs''' и разрешения '''View sensitive request data''' в вашем профиле пользователя, прежде чем вы сможете просматривать персональные данные. Эта опция отключена по умолчанию для всех пользователей, не являющихся администраторами, и должна быть явно включена, прежде чем вы сможете получить доступ к содержимому журнала.

== Обработка сбоев в Windows ==
Для того чтобы общий сбой процесса Windows (дамп ядра) был виден в Ключ-АСТРОМ, сбой должен быть обнаружен '''Windows Error Reporting'''. По этой причине служба '''Windows Error Reporting''' должна быть включена.

[[Файл:180.png|граница]]

Когда в Windows происходит сбой, появляется диалоговое окно с вопросом, хотите ли вы отладить или закрыть аварийное приложение. Это нежелательно для систем headless. Вы можете отключить это диалоговое окно, добавив значение в реестр, как показано ниже:

<code>[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting] "DontShowUI"=dword:00000001</code>

[[Файл:181.png|граница]]

== Обработка дампа ядра Linux ==
В Linux способ обработки ядром дампа ядра задается в <code>/proc/sys/kernel/core_pattern</code>. Начиная с ядра 2.6.19 (1), существует два метода обработки сбоев приложений. Дамп ядра может быть записан в файл, на который указывает запись <code>/proc/sys/kernel/core_pattern</code>, или отправлен в приложение — запись должна иметь префикс в виде вертикальной косой черты (<code>|</code>).

Поскольку '''Suse Linux''' использует первый метод, запись похожа на <code>/proc/sys/kernel/core_pattern:core</code>. Это означает, что файл с именем <code>core</code>записывается в текущий рабочий каталог аварийно завершившегося процесса.

'''Ubuntu''' и '''Red Hat''' обычно полагаются на свои собственные инструменты для создания отчетов об ошибках, поэтому строки выглядят следующим образом:

<code>|/usr/share/apport/apport %p %s %c %P</code>

или

<code>|/usr/libexec/abrt-hook-ccpp %s %c %p %u %g %t e</code>

В последнем примере, когда программа аварийно завершает работу, <code>coredump</code>вывод передается в приложение <code>stdin</code>, указанное в первом параметре. Более того, ядро заполняет значения любых параметров, отформатированных как <code>%[a-zA-Z]</code>. <code>apport</code>Служба отчетов перезаписывает файл <code>/proc/sys/kernel/core_pattern</code>. Если <code>apport</code>включено (в <code>/etc/default/apport</code>), то <code>/proc/sys/kernel/core_pattern</code>настройка конфигурации устанавливается при <code>apport</code>запуске службы отчетов о сбоях при загрузке системы.

=== Изменения операционной системы ===
Установщик ЕдиногоАгента вносит в вашу систему следующие изменения для обработки дампов ядра.

==== Отключение ABRT и Apport ====
'''''[https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/6/html/deployment_guide/ch-abrt ABRT]''''' (Red Hat) и '''''[https://launchpad.net/ubuntu/+source/apport Apport]''''' (Debian) службы остановлены и отключены.

Обе службы повторно включаются во время удаления ЕдиногоАгента .

==== Обработка основного шаблона ====
Установщик ЕдиногоАгента перезаписывает основной шаблон своей собственной командой, но сохраняет исходный шаблон.

* Содержимое исходного файла <code>/proc/sys/kernel/core_pattern</code> копируется в <code>/opt/astromkey/oneagent/agent/conf/original_core_pattern</code>. При удалении ЕдиныйАгент деинсталлятор восстанавливает исходный шаблон ядра, присутствующий в этом файле, в <code>/proc/sys/kernel/core_pattern</code>.
* Содержимое <code>kernel.core_pattern</code>исходного параметра <code>/etc/sysctl.conf</code>копируется в <code>/opt/astromkey/oneagent/agent/conf/original.sysctl.corepattern</code>. При удалении ЕдиныйАгент деинсталлятор восстанавливает исходный шаблон ядра, присутствующий в этом файле, <code>kernel.core_pattern</code>в <code>/etc/sysctl.conf</code>. Если <code>kernel.core_pattern</code>отсутствует в <code>/etc/sysctl.conf</code>до установки ЕдиногоАгента, <code>/opt/astromkey/oneagent/agent/conf/original.sysctl.corepattern</code>файл не создается.

В зависимости от исходной записи в <code>core_pattern</code>Ключ-АСТРОМ запишет различные шаблоны в <code>core_pattern</code>. Возможные конфигурации и ожидаемые записи после установки перечислены ниже:
{| class="wikitable"
!Исходная запись core_pattern
!core_pattern после установки ruxitdumpproc
!Комментарий
|-
|core
|/opt/astromkey/oneagent/agent/rdp -p %p -e %e -s %s
|Простой дамп ядра без параметров.
|-
|core_%s_%e
|/opt/astromkey/oneagent/agent/rdp -p %p -e %e -s %s -kp %s,%e
|Простой дамп ядра с параметрами в имени файла. Параметр <code>-kp</code>добавляется вместе со всеми параметрами ядра, необходимыми для замены Ключ-АСТРОМ в исходном имени файла.
|-
|/usr/share/apport/apport
|/opt/astromkey/oneagent/agent/rdp -p %p -e %e -s %s
|Дамп ядра следующее приложение без параметров. Аргумент <code>-a</code>не добавляется к выходной записи <code>core_pattern</code>, если нет параметров.
|-
|/usr/share/apport/apport %p %s %c %P
|/opt/astromkey/oneagent/agent/rdp -p %p -e %e -s %s -a %p %s %c %P
|Дамп ядра следующее приложение с параметрами. Аргумент <code>-a</code>добавляется вместе со всеми параметрами после двоичного пути к <code>apport</code>.
|}

=== Основная обработка ЕдиныйАгент dumpproc ===
Когда происходит сбой:

# <code>rdp</code>вызывается для сброса ядра в папки ЕдиногоАгента. Это ядро используется функциональностью '''Crash Reporting'''.
# '''ЕдиныйАгент''' считывает <code>/opt/astromkey/oneagent/agent/conf/original_core_pattern</code>и генерирует ядро в соответствии с настройками. Это означает, что если исходная настройка записывала файл ядра в определенное место, это все равно произойдет после установки ЕдиногоАгента.
# Анализируется дамп ядра, чтобы проверить, мог ли Ключ-АСТРОМ стать основной причиной сбоя.
#* Если ЕдиныйАгент определит, что Ключ-АСТРОМ мог быть причиной:
#** Создается оповещение службы поддержки. Об этом сообщается нашей команде DevOps.
#** Основной дамп архивируется и сохраняется в дополнение ко всем задействованным библиотекам. Это необходимо для последующего офлайн-анализа.
#* Если ЕдиныйАгент определит, что Ключ-АСТРОМ не является причиной:
#** Сообщения о сбое отправляются пользователю через веб-интерфейс Ключ-АСТРОМ.
#** Если это оказывает какое-либо влияние на приложение клиента, открывается проблема и генерируется соответствующее событие для задействованных процессов, как описано выше.

== Очистка ==
Каталоги журналов и оповещений службы поддержки очищаются автоматически.

* Для оповещений службы поддержки мы обрабатываем файл <code>core dump</code>, затем архивируем его и сохраняем для отправки в кластер.
* В случае сбоев (неинструментированных процессов или инструментированных процессов, когда мы решаем, что Ключ-АСТРОМ не виноват) мы обрабатываем, а затем удаляем копию файла <code>core dump</code>.

Настройка АктивногоШлюза (для хранения дампов памяти)

2024-09-13T14:22:31Z

ENetrebin:

Дампы памяти

2024-09-13T14:19:56Z

ENetrebin:

Профилирование и оптимизация

2024-09-13T14:15:15Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [https://doc.ruscomtech.ru/index.php/Применение_Ключ-АСТРОМ#.D0.9F.D1.80.D0.BE.D1.84.D0.B8.D0.BB.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8_.D0.BE.D0.BF.D1.82.D0.B8.D0.BC.D0.B8.D0.B7.D0.B0.D1.86.D0.B8.D1.8F Профилирование и оптимизация]'''''

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

* '''Непрерывное профилирование ЦП''' выявляет процессы наиболее затратные по ресурсам ЦП в вашей среде и позволяет детализировать проблему ЦП до уровня метода.
* '''Анализ дампов памяти и аварийных завершений процессов''' позволяет обнаруживать сбои приложений в Windows и Linux и анализировать основные дампы этих сбоев.

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

# Перейдите в раздел '''Профилирование'''.
# Выберите вариант анализа, который вы хотите исследовать: '''[[Непрерывное профилирование ЦП|''Непрерывное профилирование ЦП'']]''', '''[[Дампы памяти|''Дампы памяти'']]''' или '''''[[Аварийные завершения процессов]]'''''.

Обновление пользовательских диаграмм

2024-09-13T14:10:35Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.9D.D0.B0.D0.B1.D0.BB.D1.8E.D0.B4.D0.B0.D0.B9.D1.82.D0.B5%20.D0.B8%20.D0.B8.D1.81.D1.81.D0.BB.D0.B5.D0.B4.D1.83.D0.B9.D1.82.D0.B5|Наблюдайте и исследуйте]] / Обновление пользовательских диаграмм'''''
*Обсуждаемые здесь '''дашборды''' представляют собой '''классические дашборды''', созданные с использованием функциональности дашборда, интегрированной с предыдущей версией Ключ-АСТРОМ.

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

== Требуются немедленные действия ==

* Что: Если вы используете '''пользовательские диаграммы''', вам необходимо обновить их сейчас .
** '''Пользовательские диаграммы''' больше не получают исправлений и улучшений.
** '''Пользовательские диаграммы''' больше не подлежат редактированию. При обновлении '''пользовательских диаграмм''' до диаграмм '''''[[Визуализация метрик|Визуализации метрик]]''''' вы сможете редактировать свои диаграммы, использовать исправления и улучшения функций визуализации метрик и быть готовыми к обновлению до новой платформы.
* Когда:
** Версия '''Ключ-АСТРОМ 1.265''' была последней версией Ключ-АСТРОМ, поддерживающей пользовательские диаграммы.
** '''Ключ-АСТРОМ SaaS''' версии '''1.271+''' и '''Ключ-АСТРОМ Managed''' версии '''1.272+''' полностью отключают редактирование пользовательских диаграмм и прекращают поддержку кода пользовательских диаграмм
* Как: Вы можете обновлять плитку за плиткой, дашборд за дашбордом или, используя API, все сразу.

Подробности смотрите ниже.

== Относится ли это ко мне? ==
Это не относится к визуализациям и дашбордам, созданным с помощью '''Визуализации метрик'''. Это относится только к нашей старой функциональности '''Custom charts''' , которая существовала до '''Визуализации метрик''' и теперь полностью устарела.

=== Проверьте таблицу дашбордов ===
Чтобы узнать, есть ли у вас какие-либо пользовательские диаграммы старого образца, которые нужно обновить, отфильтруйте таблицу '''Дашборды''' по <code>Пользовательские графики: Yes</code> и посмотрите, есть ли в списке какие-либо дашборды.

# Перейдите в раздел '''Дашборды''' (последняя версия Ключ-АСТРОМ).
# '''''необязательный''''' Чтобы вывести список только тех дашбордов, которыми вы владеете, добавьте фильтр для <code>Владение: Мой</code>. [[Файл:213.png|граница]] Если вы хотите проверить все дашборды, к которым у вас есть доступ, независимо от владельца, пропустите этот шаг.
# Добавьте фильтр для <code>Пользовательские графики: Yes</code>. [[Файл:214.png|граница]]
# Проверьте таблицу.
#* Если после фильтрации по <code>Пользовательские графики: Yes</code>, не отображается ни одной панели, вам нечего обновлять. Вы можете остановиться здесь.
#* Если вы не фильтруете по владельцу дашборда, вы можете увидеть некоторые предустановленные дашборды <code>Ключ-АСТРОМ</code> с указанием владельца. Вы можете игнорировать их.
#* Если в списке указаны какие-либо другие дашборды, на каждой из них должна отображаться метка, <code>Пользовательские графики</code> поскольку вы установили <code>Пользовательские графики: Yes</code> фильтр на предыдущем шаге. В приведенном ниже примере вам придется обновить две панели мониторинга. [[Файл:215.png|граница]]

=== Проверьте плитки на дашборде ===
Если вы нашли дашборд с пользовательскими диаграммами, откройте ее и найдите следующие индикаторы того, что на ней есть пользовательские диаграммы старого образца, которые следует обновить:

* Если плитку необходимо обновить, на ней отображается предупреждающий значок и подсказка. [[Файл:216.png|граница]]
* Если на отображаемом в данный момент дашборде все еще есть хотя бы одна плитка, которую необходимо обновить, в меню дашборда в правом верхнем углу есть опция '''Обновить'''. [[Файл:217.png|граница]]

== Как обновиться? ==
Прежде чем что-либо делать, мы рекомендуем вам сделать резервные копии самых важных дашбордов. Затем попробуйте обновить резервные копии, чтобы освоиться с процессом обновления, прежде чем обновлять все оставшиеся дашборды.

Например, выберите любой популярный дашборд в вашей среде, от которого вы зависите, возможно, тот, который имеет несколько расширенных и сложных пользовательских плиток диаграмм (используется несколько показателей, и есть конфигурации для единицы, ставок и т. д.), и клонируйте его. Затем вы можете спокойно работать с клоном и проверять, все ли обновляется правильно.

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

== Обновление через веб-интерфейс ==
В веб-интерфейсе вы можете обновлять по одной плитке или по одному дашборду за раз.

=== Улучшить одну плитку ===
Чтобы обновить одну плитку

# Перейдите в раздел '''Дашборды''' (последняя версия Ключ-АСТРОМ).
# Отобразить дашборды с плиткой, которую необходимо обновить. [[Файл:216.png|граница]]
# В меню плитки выберите '''Предварительный просмотр обновленной диаграммы'''. Преобразованная диаграмма откроется в визуализации метрик в новой вкладке браузера, так что вы сможете сравнить старые диаграммы с новыми визуализациями. [[Файл:218.png|граница]]
# Проверьте визуализацию, чтобы убедиться, что она преобразована правильно. Внесите изменения по мере необходимости.
# Когда вы будете удовлетворены результатом преобразования, выберите «Закрепить на дашборде» и закрепите обновленную визуализацию на другой панели мониторинга или на той же панели мониторинга.
#* Если вы закрепите его на той же панели, то теперь у вас будут старые и новые плитки на той же панели. Это даст вам еще одну возможность сравнить плитки. Если вы удовлетворены результатами, удалите старую плитку (ту, что со значком предупреждения) и перетащите новую плитку на ее место.

=== Обновить всю панель управления ===
Вы можете выполнить следующие процедуры с созданием клонов (резервных копий) или без них.

==== Быстро, но без резервных копий ====
Для обновления всего дашборда (всех плиток на дашборде одновременно) без создания клона (резервной копии).

# Перейдите в раздел '''Дашборды''' (последняя версия Ключ-АСТРОМ).
# Найдите дашборд в таблице дашбордов.
# В строке этой панели выберите '''Дополнительно (...) > Обновить''' . Если не обнаружено ошибок обновления, вся панель будет обновлена. [[Файл:219.png|граница]]

==== Медленнее, но с резервным копированием ====
Чтобы создать клон (резервную копию) дашборда, а затем обновить весь клонированный дашборд (все плитки на дашборда одновременно)

# Перейдите в раздел '''Дашборды''' (последняя версия Ключ-АСТРОМ).
# Найдите дашборд в таблице дашбордов.
# В строке этой панели выберите '''Дополнительно (...) > Клонировать''' . Это создаст клон (копию) дашборда и откроет ее в режиме редактирования. Исходный дашборд останется неизменным.
# Нажмите на кнопку '''Готово''' , чтобы выйти из режима редактирования и отобразить клон.
# В правом верхнем углу панели управления выберите '''Дополнительно (...) > Обновить''' . [[Файл:219.png|граница]]
# Просмотрите обновленный дашборд Чтобы сравнить два дашборда рядом
## Перейдите в раздел '''Дашборды''' (последняя версия Ключ-АСТРОМ).
## Щелкните правой кнопкой мыши на название первого дашборда в таблице '''Дашборды''' и откройте ссылку в новом окне.
## Щелкните правой кнопкой мыши на название второго дашборда в таблице '''Дашборды''' и откройте ссылку в новом окне.
## Расположите окна браузера рядом, а затем визуально сравните дашборды
# После того, как вы будете удовлетворены обновленном дашбордом, вы можете удалить оригинал.

==== Альтернативная процедура из меню дашборда ====
Эту процедуру можно выполнить как с созданием резервной копии, так и без нее (см. шаг 3).

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

После завершения обновления дашборда:

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

=== Проверьте наличие дополнительных дашбордов для обновления ===
Чтобы проверить наличие дополнительных дашбордов для обновления

# Перейдите в раздел '''Дашборды''' (последняя версия Ключ-АСТРОМ).
# Фильтровать страницу '''Дашборды''' по <code>Пользовательские графики: Yes</code>.

* Дашборды, которые вы уже обновили, не должны отображаться.
* Все панели, на которых сохранилась метка <code>Пользовательские графики</code>, необходимо обновить.

Подробную информацию об определении дашбордов и диаграмм, которые все еще нуждаются в обновлении, см. в разделе '''''Относится ли это ко мне?''''' выше.

== Обновление через API ==
Ключ-АСТРОМ версии 1.251+

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

=== Обновить один дашборд ===
Чтобы обновить один дашборд через API, используйте конечную точку перехода.

<code><nowiki>https://{your-environment-id}/rest-api-doc/index.jsp?urls.primaryName=Configuration%20API#/Dashboards/migrateDashboard</nowiki></code>

Обязательно замените <code>{your-environment-id}</code> на фактический идентификатор вашей среды.

=== Обновитm все дашборды ===
Для обновления всех дашбордов через API

# Используйте конечную точку GET для получения всех идентификаторов дашборда. <code><nowiki>https://{your-environment-id}/rest-api-doc/index.jsp?urls.primaryName=Configuration%20API#/Dashboards/getDashboardStubsList</nowiki></code> Обязательно замените <code>{your-environment-id}</code> на фактический идентификатор вашей среды .
# Выполните цикл по всем идентификаторам, как описано в разделе '''''Обновить один дашборд''''' выше.

==== Пример скрипта Node.js ====
Чтобы быстро начать работу, не стесняйтесь адаптировать и использовать следующий пример скрипта Node.js. Мы использовали его для массового обновления всех дашбордов нашей собственной среды разработки.

Перед использованием скрипта обязательно обновите обе отмеченные строки <code>// TODO</code> своей собственной информацией:

* Замените <code>{your-environment-id}</code> на фактический идентификатор вашей среды.
* Замените <code>{your-api-token}</code> действительным токеном API с соответствующей областью действия.

<code>import fs from "fs";</code>

<code>import fetch from "node-fetch";</code>

<code>async function migrateAllDashboards() {</code>

<code> // create a backup directory</code>

<code> if (!fs.existsSync("./BACKUPS")) {</code>

<code> fs.mkdirSync("./BACKUPS");</code>

<code> }</code>

<code> export const ENV_URL = "{your-environment-id}"; // TODO replace this</code>

<code> export const AUTH_HEADERS = {</code>

<code> Authorization: `Api-token {your-api-token}`, // TODO replace this</code>

<code> };</code>

<code> const dirName = `./BACKUPS/${new URL(ENV_URL).hostname.replace(</code>

<code> ".",</code>

<code> "_"</code>

<code> )}-${Date.now()}`;</code>

<code> fs.mkdirSync(dirName);</code>

<code> console.log("Fetching all the dashboards");</code>

<code> const fetchAllUrl = `${ENV_URL}/api/config/v1/dashboards`;</code>

<code> const response = await fetch(fetchAllUrl, { headers: AUTH_HEADERS });</code>

<code> const dashboardsMetadata = await response.json();</code>

<code> fs.writeFileSync(</code>

<code> `${dirName}/_ALL_DASHBOARDS_METADATA.json`,</code>

<code> JSON.stringify(dashboardsMetadata)</code>

<code> );</code>

<code> const allDashboards = dashboardsMetadata.dashboards;</code>

<code> console.log(`Saved the metadata of ${allDashboards.length} dashboards`);</code>

<code> for (let index = 0; index < allDashboards.length; index++) {</code>

<code> const db = allDashboards[index];</code>

<code> const dbId = db.id;</code>

<code> const fetchDB = `${ENV_URL}/api/config/v1/dashboards/${dbId}`;</code>

<code> const response = await fetch(fetchDB, { headers: AUTH_HEADERS });</code>

<code> const dbContent = await response.json();</code>

<code> // save dashboard content to backup directory</code>

<code> fs.writeFileSync(`${dirName}/${dbId}.json`, JSON.stringify(dbContent));</code>

<code> try {</code>

<code> // attempt migration</code>

<code> const migrateResponse = await fetch(</code>

<code> `${ENV_URL}/api/config/v1/dashboards/${dbId}/migrate`,</code>

<code> {</code>

<code> method: "PUT",</code>

<code> headers: {</code>

<code> "Content-Type": "application/json",</code>

<code> ...AUTH_HEADERS,</code>

<code> },</code>

<code> body: dbId,</code>

<code> }</code>

<code> );</code>

<code> if (migrateResponse.status === 200) {</code>

<code> if (migrateResponse.errors) {</code>

<code> console.log(`X ${dbId} updated failed!);</code>

<code> console.error(migrateResponse.errors);</code>

<code> }</code>

<code> } else {</code>

<code> console.error(`X ${dbId} update failed!`);</code>

<code> console.error(migrateResponse);</code>

<code> }</code>

<code> } catch (error) {</code>

<code> console.error(`X ${dbId} update failed!`);</code>

<code> console.error(updateResponse);</code>

<code> }</code>

<code> }</code>

<code>}</code>

<code>console.log("### Backup and Migrate\n");</code>

<code>await migrateAllDashboards();</code>

<code>console.log(`### Migration completed\n\n`);</code>

=== Проверьте наличие дополнительных дашбордов для обновления ===
Чтобы проверить наличие дополнительных дашбордов для обновления

# Перейдите в раздел '''Дашборды''' (последняя версия Ключ-АСТРОМ).
# Фильтровать страницу '''Дашборды''' по <code>Пользовательские диаграммы: Yes</code>.

* Дашборды, которые вы уже обновили, не должны отображаться.
* Все дашборды, на которых сохранилась метка <code>Пользовательские диаграммы</code>, по-прежнему необходимо обновить.

Подробную информацию об определении дашбордов и диаграмм, которые все еще нуждаются в обновлении, см. в разделе '''''Относится ли это ко мне?''''' выше.

== Что делать, если обновление не удалось? ==
В зависимости от сложности задействованных плиток обновление дашборда может завершиться частичной неудачей (некоторые плитки на дашборде обновятся успешно, а некоторые — нет) или полностью (ни одна плитка на дашборде не обновится успешно).

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

Часто задаваемые вопросы по Визуализации метрик

2024-09-13T14:06:34Z

ENetrebin:

Расширенный режим Визуализации метрик

2024-09-13T14:04:29Z

ENetrebin:

Быстрый старт Визуализации метрик

2024-09-13T14:01:28Z

ENetrebin:

Визуализация метрик

2024-09-13T13:58:49Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.9D.D0.B0.D0.B1.D0.BB.D1.8E.D0.B4.D0.B0.D0.B9.D1.82.D0.B5%20.D0.B8%20.D0.B8.D1.81.D1.81.D0.BB.D0.B5.D0.B4.D1.83.D0.B9.D1.82.D0.B5|Наблюдайте и исследуйте]] / Визуализация метрик'''''

Визуализация метрик значительно расширяет ваши возможности по запросу и визуализации показателей.

* Анализируйте многомерные показатели, встроенные в Ключ-АСТРОМ или полученные из StatsD, Prometheus, Telegraf и других каналов.
* Выберите тип визуализации.
* Добавьте визуализацию прямо на дашборде для легкого доступа и совместного использования.
* Обеспечивает основу для расчета показателей в визуализациях на дашбордах.

'''''[[Быстрый старт Визуализации метрик|Быстрый старт]]'''''

Если вы предпочитаете пока пропустить технические подробности и учиться на практике, попробуйте '''''[[Быстрый старт Визуализации метрик]].''''' Вы узнаете, как:

* Используйте шаблон
* Создайте простую визуализацию с нуля
* Используйте визуализацию непосредственно в Визуализации метрик
* Закрепите визуализацию на дашборд для дальнейшего использования и обмена.

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

== Компоненты и концепции запроса ==
Каждый запрос метрики состоит из нескольких необязательных компонентов. Например, этот запрос:

[[Файл:141.png|граница]]

имеет следующие компоненты:

* Название метрики: <code>CPU usage %</code> (<code>builtin:host.cpu.usage</code>)
* Агрегация: <code>Average (Среднее)</code> (<code>avg</code>)
* Разделить по: <code>Host</code> (<code>dt.entity.host</code>)
* Фильтровать: <code>Host</code> : <code>OS type</code>:<code>Linux</code>

Ниже приведены описания этих и других возможных компонентов запроса.

* Редактор запросов поможет вам выбрать параметры запроса, совместимые с настраиваемым вами запросом. В приведенном ниже примере, если навести курсор на значок i (информация) в списке выбора для '''Оценка''' , редактор объяснит, почему настройка недоступна для текущего запроса. [[Файл:142.png|граница]]

=== Название метрики ===
В редакторе запросов выберите имя метрики из списка, отображаемого в поле '''Выберите метрику…''' Это может быть встроенная метрика или метрика, полученная из канала, например StatsD, Prometheus или Telegraf через наш API метрик.

Чтобы выбрать метрику

* Вы можете ввести или вставить имя метрики непосредственно в поле, чтобы найти все соответствующие метрики. В этом примере есть несколько совпадений. Мы выбираем метрику в категории '''Host''', чтобы добавить ее в наш запрос. [[Файл:Imageссмчм.png|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:Image%D1%81%D1%81%D0%BC%D1%87%D0%BC.png|граница]]

* Если вы добавили в избранное какие-либо метрики в [[Обзор метрик|'''''Обзоре метрик''''']], эти метрики будут отображаться в верхней части списка в выборе метрик. [[Файл:125.png|граница]]
* Вы можете выбрать категорию метрик, чтобы сузить список метрик. [[Файл:126.png|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:126.png|граница]]

* При наведении курсора на любую метрику в списке на боковой панели отображаются сведения об этой метрике. [[Файл:127.png|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:127.png|граница]] Чтобы увидеть больше информации об этой метрике, выберите '''Просмотреть всю информацию о метриках''' . Это откроет [[Обзор метрик|'''''Обзор метрик''''']] в новой вкладке (чтобы вы не потеряли свою работу в '''Визуализации метрик''') с большим количеством полезных сведений о выбранной метрике.

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

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

Чтобы изменить эту агрегацию, выберите ее из списка, расположенного сразу после имени метрики в редакторе запросов:

[[Файл:143.png|граница]]

Каждая метрика обеспечивает одни и те же возможные пространственные агрегации: <code>Auto</code>, <code>Average</code>, <code>Count</code>, <code>Maximum</code>, <code>Minimum</code>, <code>Sum</code>, <code>Median</code>, <code>Percentile 10th</code>, <code>Percentile 75th</code>и <code>Percentile 90th</code>.

=== Разделить по ===
По умолчанию запрос не разделяется ни по одному измерению с использованием агрегации метрики. При разделении по измерению, такому как хост, агрегация используется для каждого хоста.

Разделить по размеру

# Если параметр '''Разделить по''' еще не отображается в редакторе запросов, выберите [[Файл:105.png|граница|31x31пкс]] и затем выберите <code>Разделить по</code> из списка.
# Установите параметр '''Разделить по''' на измерение, по которому вы хотите разделить запрос.

==== Пример ====
Если метрика строки — <code>CPU usage %</code>, <code>Host</code>— единственное доступное измерение. В разделе '''Разделить по''' выберите <code>Host</code>.

=== Сортировать по ===
По умолчанию результаты сортируются в порядке убывания на основе выбранного агрегирования.

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

# Если параметр '''Сортировать по''' еще не отображается в редакторе запросов, выберите [[Файл:105.png|граница|31x31пкс]] и затем выберите <code>Сортировать по</code> из списка.
# Установите параметр '''Сортировать по''' тому измерению, по которому вы хотите выполнить сортировку.
# Выберите порядок сортировки: <code>ASC</code>(по возрастанию) или <code>DESC</code>(по убыванию).

=== Оценка ===
Чтобы установить оценку

# Если '''Оценка''' еще не отображается в редакторе запросов, выберите [[Файл:105.png|граница|31x31пкс]] и затем выберите <code>Оценка</code> из списка.
# Установите оценку на <code>Нет</code>, <code>За секунду</code>, <code>За минуту</code>, или <code>За час</code>.

=== Фильтровать ===
Область действия определяется любым установленным вами фильтром. По умолчанию область действия равна <code>(include all)</code>.

Чтобы отфильтровать ваш запрос (изменить область действия)

# Если '''Фильтровать''' еще не отображается в редакторе запросов, выберите [[Файл:105.png|граница|31x31пкс]] и затем выберите <code>Фильтровать</code> из списка.
# В '''Фильтровать''' :
#* Выберите доступное измерение
#* Укажите атрибут
#* Укажите значение атрибута

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

==== Пример ====
Если метрика — это количество действий (по категории Apdex) [веб] (<code>builtin:apps.web.actionCount.category</code>) и вы хотите выполнить фильтрацию по определенному веб-приложению с именем<code>My web application</code>

# Если параметр '''Фильтровать''' по еще не отображается, отобразите его.
# В Фильтр по выберите <code>Web application</code>, затем выберите <code>Name</code>, а затем выберите <code>My web application</code>

См. также '''''Автоматическая расширенная фильтрация''''' ниже

=== Ограничение ===
По умолчанию количество показателей, которые вы видите, если они разделены по измерению, равно 20.

Чтобы установить ограничение

# Если '''Ограничение''' еще не отображается в редакторе запросов, выберите [[Файл:105.png|граница|31x31пкс]] и затем выберите <code>Ограничение</code> из списка.
# Установите ограничение на <code>1</code>, <code>10</code>, <code>20</code>, или <code>100</code>.

Чтобы снять ограничение, включите Расширенный режим и удалите компонент запроса <code>:limit(n)</code>.

=== По умолчанию ===
Чтобы установить значение по умолчанию

# Если '''По умолчанию''' еще не отображается в редакторе запросов, выберите [[Файл:105.png|граница|31x31пкс]] и затем выберите <code>По умолчанию</code> из списка.
# Установите для параметра '''По умолчанию''' желаемое значение по умолчанию.

=== Сдвиг во времени ===
Чтобы установить значение сдвига по времени

# Если '''Сдвиг во времени''' еще не отображается в редакторе запросов, выберите [[Файл:105.png|граница|31x31пкс]] и затем выберите <code>Сдвиг во времени</code> из списка.
# Установите для параметра '''Сдвиг во времени''' число (положительное или отрицательное).
# Выберите единицу измерения (секунда, минута, час, день, неделя) из соседнего списка.

==== Пример ====
Чтобы вернуться на две минуты назад:

# Установить '''сдвиг времени''' на <code>-2</code>
# Установите единицу измерения <code>minute</code>

== Запросы команд ==
Используйте эти команды в редакторе запросов для выбора компонентов запроса и установки значений.

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

[[Файл:144.png|граница]]

Ключ-АСТРОМ предлагает следующие типы визуализации:
*[[Файл:График.png|граница|30x30пкс|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%93%D1%80%D0%B0%D1%84%D0%B8%D0%BA.png]] [[Графическая визуализация|График]]
*[[Файл:Столбец с накоплением.png|32x32px|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%A1%D1%82%D0%BE%D0%BB%D0%B1%D0%B5%D1%86_%D1%81_%D0%BD%D0%B0%D0%BA%D0%BE%D0%BF%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%D0%BC.png]][[Визуализация многоуровневых столбцов|Столбец с накоплением]]
*[[Файл:Область с накоплением.png|граница|30x30пкс|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%9E%D0%B1%D0%BB%D0%B0%D1%81%D1%82%D1%8C_%D1%81_%D0%BD%D0%B0%D0%BA%D0%BE%D0%BF%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5%D0%BC.png]] [[Визуализация многоуровневых областей|Область с накоплением]]
*[[Файл:Круг.png|граница|30x30пкс|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%9A%D1%80%D1%83%D0%B3.png]] [[Круговая визуализация|Круг]]
*[[Файл:Одно значение.png|граница|30x30пкс|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%9E%D0%B4%D0%BD%D0%BE_%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5.png]] [[Визуализация значений|Одно значение]]
*[[Файл:Таблица.png|граница|30x30пкс|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%A2%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0.png]] [[Визуализация таблиц|Таблица]]
*[[Файл:Топ-лист.png|граница|30x30пкс|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%A2%D0%BE%D0%BF-%D0%BB%D0%B8%D1%81%D1%82.png]] [[Визуализация топ-листа|Топ-лист]]
*[[Файл:Тепловая карта.png|граница|30x30пкс|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%A2%D0%B5%D0%BF%D0%BB%D0%BE%D0%B2%D0%B0%D1%8F_%D0%BA%D0%B0%D1%80%D1%82%D0%B0.png]] [[Визуализация тепловой карты|Тепловая карта]]
*[[Файл:Соты.png|граница|30x30пкс|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:%D0%A1%D0%BE%D1%82%D1%8B.png]] [[Визуализация в виде сот|Соты]]

=== Плюс ===
Чтобы добавить или удалить метрические преобразования для строки в редакторе запросов, выберите [[Файл:105.png|граница|32x32пкс]] а затем установите или снимите флажки по мере необходимости.

* Все — отобразить все доступные поля (см. ниже)
* Разделить по
* Сортировать по
* Фильтровать
* Оценка
* По умолчанию
* Сдвиг во времени
* Ограничение

=== Добавить метрику ===
Чтобы добавить новую пустую строку, нажмите на кнопку '''Добавить метрику''' , а затем определите запрос этой строки.

=== Дублирующая метрика ===
Чтобы сделать копию метрики, которую вы уже добавили в запрос, выберите '''Дополнительно (...) > Дублировать''' и затем отредактируйте копию по мере необходимости [[Файл:145.png|граница|52x52пкс]].

=== Добавить метрическое событие ===
Если вы видите на диаграмме '''Визуализации метрик''' что-то, за чем хотите продолжить наблюдение, можно легко создать метрическое событие.

Чтобы создать метрическое событие из '''Визуализации метрик'''

# Выбирать '''Дополнительно (...) > Добавить событие метрики''' в редакторе запросов. [[Файл:145.png|граница|52x52пкс]] Вкладка '''Настройки > Обнаружение аномалий > События метрик''' отображается в новом окне браузера (чтобы вы не потеряли результаты своей работы в Визуализации метрик) с выбранным параметром '''Добавить событие метрики''' и уже заполненными полями метрик из вашего запроса, где это возможно.
# Завершите определение события метрики и сохраните изменения.
# Закройте это окно браузера и вернитесь в первое окно браузера, чтобы продолжить работу в '''Визуализации метрик'''.

Подробную информацию о метрических событиях см. в разделе [[События метрик|'''''События метрик''''']].

=== Изменить порядок метрик ===
Порядок, в котором показатели перечислены в вашем запросе, влияет на следующее:

* Порядок, в котором отображаются элементы рисунка: метрики запроса отображаются сверху вниз, поэтому последняя отображается поверх остальных.
* Порядок столбцов в визуализации таблицы
* Порядок отображения настроек на панели настроек

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

[[Файл:Image8з.png|граница]]

Повторите запрос, чтобы увидеть изменения.

=== Переключить метрику ===
Чтобы включить или выключить метрики, вы можете выбрать букву рядом с метрикой, которую вы хотите включить в свой запрос, или выбрать значок глаза [[Файл:40.png|граница]].

[[Файл:32.png|граница]]

=== Удалить метрику ===
Чтобы удалить метрику, выберите '''Дополнительно (...) > Удалить''' .

[[Файл:145.png|граница|52x52пкс]]

=== Запуск запроса ===
Нажмите на кнопку '''Запуск запроса''' , чтобы запустить текущий настроенный запрос и отобразить визуализацию результатов. Текст рядом с кнопкой '''Запуск запроса''' отображает статус последнего запуска.

[[Файл:147.png|граница]]

=== Расширенный режим ===
Чтобы в полной мере использовать возможности запросов '''Metrics API v2''' из веб-интерфейса, включите '''расширенный режим''' для запроса.

'''Расширенный режим''' позволяет вам создавать выражения метрик , сдвиги временных рамок и многое другое непосредственно в веб-интерфейсе и, конечно, использовать это для создания визуализаций для ваших дашбордов. Начните с проверки примеров выражений метрик .

[[Файл:148.png|граница]]

Подробную информацию о расширенном режиме см. в разделе '''''[[Расширенный режим Визуализации метрик]].'''''

==Базовая линия==
Чтобы помочь вам определить аномалии, вы можете использовать базовую линию, чтобы добавить доверительный диапазон к линии метрики на графике. Затем вы можете увидеть, когда значение выходит за пределы доверительного диапазона. Расчет базовой линии основан на [[Сезонные базовые линии|'''''Сезонной базовой линии''''']], которая используется для создания [[События метрик|'''''Событий метрики''''']] для обнаружения аномалий.
*Базовые показатели применяются только к визуализации <code>График</code>.
*При закреплении диаграммы на дашборде базовые линии не добавляются на плитку дашборда.
*Таймфреймы, используемые для определения базовой линии, определяются текущим выбранным разрешением:
{| class="wikitable"
!Диапазон разрешения
!Примеры разрешений
!Таймфрейм базовой линии
|-
|разрешение < 5 минут
|1 минута
|предыдущие 14 дней
|-
|5 минут ≥ разрешение < 1 час
|5 минут
10 минут

30 минут
|предыдущие 28 дней
|-
|1 час ≥ разрешение < 1 день
|1 час
6 часов

12 часов
|400 дней
|-
|разрешение ≥ 1 день
|1 день
1 неделя

1 месяц
|5 лет
|}
===Добавить базовую линию===
#На графике выберите линию метрики, которую вы хотите использовать в качестве базовой.
#Во всплывающем окне нажмите '''Добавить baseline'''.
#Подождите немного, пока вычисляется базовая линия. Затем график перерисовывается с базовой линией, отображаемой для выбранной вами метрики.
===Скрыть или показать базовую линию===
Базовые линии указаны отдельно в легенде диаграммы. Например, если вы добавляете базовую линию к метрике <code>CPU usage %</code> в визуализации <code>График</code>, список легенд будет содержать <code>CPU usage %</code> и <code>CPU usage % - baseline</code>. Выберите '''Показать легенду''', чтобы включить или выключить их отображение.
===Удалить базовую линию===
#На графике выберите линию метрики, из которой вы хотите удалить базовую линию.
#В всплывающем окне выберите '''Удалить''' '''baseline'''. График будет перерисован с удаленной базовой линией.
===Сравнение с базовыми показателями метрических событий===
Вы можете заметить различия между базовыми значениями в '''Визуализации метрик''' и метрическими событиями. Эти функции предлагают разные подходы для соответствия разным контекстам. В целом, конфигурация '''Визуализации метрик''' фиксирована, а конфигурация метрических событий настраивается.

Подробную информацию о сезонной базовой линии см. в разделе '''''[[Сезонные базовые линии]]'''''.

=== Часто задаваемые вопросы по базовым линиям ===

# Как рассчитывается базовая линия? Расчет базовой линии основан на сезонной базовой линии, используемой для создания метрических событий для обнаружения аномалий. Подробности о внутренней работе модели см. в разделе '''''[[Сезонные базовые линии]]'''''.
# Хотя базовая линия основана на сезонной базовой линии, существует несколько причин, по которым полученные базовые линии могут отличаться:

* '''Разрешение''': Базовая линия в '''Визуализации метрик''' выводится из данных в зависимости от текущего выбранного разрешения, как описано выше. Сезонная базовая линия конфигурации событий метрики всегда изучает поведение на основе данных разрешения в 1 минуту. Если разрешения различаются, результирующая базовая линия различается, поскольку значения метрики также различаются.
* '''Базовый таймфрейм''': таймфрейм, используемый для вывода базовой линии, определяется текущим выбранным разрешением, как описано выше. Поскольку конфигурации метрических событий всегда используют данные с разрешением в 1 минуту, таймфрейм обучения может отличаться, что также может привести к разным базовым линиям.
* '''Параметры линии''': Базовая линия в '''Визуализации метрик''' использует фиксированные параметры по умолчанию для обучения базовой линии:
** '''Допуск''' = 4
** '''Условие оповещения''' = «Оповещение, если метрика выходит за пределы»
** '''Нет оповещения об отсутствующих данных =''' Если параметры в конфигурации событий метрики отличаются, результирующий базовый уровень может быть другим.

==Коррелированные показатели==
Ключ-АСТРОМ ИИ учитывает знание и топологию предметной области при вычислении сигналов связанной наблюдаемости. ИИ ранжирует наиболее релевантные сигналы наверху, а оценка ИИ для каждого обнаруженного сигнала указывает, насколько близко сигнал соответствует поведению эталонного сигнала в течение выбранного периода времени.
===Добавить коррелированные показатели===
Обратите внимание, что эта опция доступна только в том случае, если вы разделяете данные по измерению в запросе.
#Перейдите в раздел '''Визуализация метрик''' (стандартный или расширенный режим), создайте запрос ряда показателей, разделенных по связанному измерению, и отобразите его в визуализации <code>График</code>. Коррелированные показатели доступны '''''только''''' в том случае, если вы:
#*Выбрали визуализацию <code>График</code>
#*Указали запрос, который разделен по измерению, связанному с выбранным рядом данных. Попробуйте этот пример: [[Файл:33.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:33.png]] Вот это в '''расширенном режиме''': [[Файл:34.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:34.png]] <code>builtin:host.cpu.usage:splitBy("dt.entity.host"):sort(value(auto,descending)):limit(20)</code>
#Нажмите на кнопку '''Запуск запроса''' , чтобы построить график запроса.
#Выберите (нажмите) линию на графике, чтобы отобразить всплывающее окно с соответствующими параметрами.
#Во всплывающем окне выберите '''Просмотреть коррелирующие показатели''' . Боковая панель анализа '''AI''' содержит метрики, которые на основе анализа корреляции '''ИИ''' коррелируют с выбранным рядом. Эта корреляция определяется формой ряда, а не значениями. Что отображает анализатор?
#*'''Опорный сигнал''' представляет собой ряд данных, который вы выбрали на графике. Другие формы других метрических рядов сравниваются с формой этого ряда.
#*'''Связанные сигналы''' — это другие метрические ряды, имеющие схожую форму, отсортированные по принципу «наиболее схожие — наименее схожие». Чем более схожа форма, тем ближе корреляция. Для каждой коррелированной метрики анализатор отображает:
#**Название метрики
#**Измерение
#**Идентификатор объекта Корреляции иногда группируются.
#На боковой панели выберите любую из перечисленных метрик, чтобы автоматически добавить ее в текущий запрос.
#*Вы можете добавить несколько коррелированных показателей в свой запрос.
#*Вы можете добавить одну и ту же метрику несколько раз, а затем отредактировать запрос.
#После добавления коррелированных показателей выберите '''Запуск запроса''', чтобы обновить график.
===Часто задаваемые вопросы о коррелированных метриках===
#Что означает «корреляция» в данном контексте? Для определения корреляции анализатор проверяет форму ряда данных, а не значения. Коррелируются два ряда с очень похожими формами.
#Почему опция '''Просмотреть коррелирующие показатели''' недоступна? Возможные причины, по которым вы не видите опцию '''Просмотреть коррелирующие показатели''', включают:
#*Вы не выбрали визуализацию <code>График</code>
#*Вы не разделили по измерению в своем запросе
#*Вы не выполнили запрос на построение графика
#*Вы не выбрали (не щелкнули) линию на графике
#Что означает '''Сигналы на найдены'''? Если появляется надпись <code>Сигналы на найдены</code>, возможны следующие варианты:
#*Слишком малая дисперсия в выборке (например, метрика представляет собой прямую линию)
#*Слишком мало точек данных в выборке (например, за очень короткий период времени)
==Фокус==
Чтобы временно убрать потенциальный беспорядок с графика и сосредоточиться на одной метрике, вы можете скрыть все, кроме выбранной серии метрик.
*Фокус применяется только к визуализации <code>График</code>.
*Фокус не изменяет ваш запрос и не влияет на плитку дашборда при закреплении диаграммы на этот дашборд.
===Сосредоточьтесь на метрической серии===
#На линейном графике выберите линию метрики, на которой вы хотите сосредоточиться.
#Во всплывающем окне выберите '''Фокус''' . График перерисовывается, отображая только выбранную метрику.
===Удалить фокус===
#На графике выберите линию метрики, на которой вы сосредоточились.
#Во всплывающем окне выберите '''Удалить фокус''' . График перерисовывается для отображения всех показателей.

== Результат ==
В разделе '''Результат''' отображается выбранная визуализация результатов вашего запроса.

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

В этом примере — визуализация <code>График</code>, показывающая линейную диаграмму метрики <code>CPU usage %</code> для хостов — визуализация показывала хост, ведущий себя нестабильно, поэтому мы выбрали его, чтобы просмотреть сведения о хосте во всплывающем окне.

[[Файл:149.png|граница]]

В этом примере у вас есть следующие варианты:

* Выберите '''Фокус''' , чтобы сфокусировать график на одной метрике. Подробности см. в разделе '''Фокус''' (выше).
* Выберите '''Добавить baseline''' , чтобы добавить базовую линию для выбранной метрики. Подробности см. в разделе '''Базовая линия''' (выше).
* Выберите '''Просмотреть коррелирующие показатели''' , чтобы вывести список коррелированных метрик и при желании добавить их выборку в свой запрос. Подробности см. в разделе '''Коррелированные показатели''' (выше) .
* Выберите '''Показать host''' , чтобы перейти непосредственно на страницу сведений о данном хосте.
* Выберите '''Показать host list''' , чтобы перейти на страницу '''Хосты'''.

Параметры, доступные во всплывающем окне, зависят от настроенного вами запроса и визуализации.

=== Закрепить на дашборде ===
Когда вы будете удовлетворены своим запросом, вы можете добавить его на дашборд.

# Нажмите на кнопку '''Закрепить на дашборде'''.
# Выберите дашборд, для которого у вас есть разрешение на редактирование.
# Нажмите на кнопку '''Прикрепить'''.

Подробную информацию см. в разделе '''''[[Закрепление плиток на панели инструментов|Закрепление плиток на дашборде]]'''''.

=== Поделитесь своими результатами ===
Если вы проводите анализ в '''Визуализации метрик''' и находите интересные результаты, которыми хотите поделиться с другими аутентифицированными пользователями, или если вы хотите иметь возможность повторно просмотреть те же результаты самостоятельно, используя более поздний период времени

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

=== Экспорт в CSV-файл ===
Для экспорта в файл со значениями, разделенными запятыми (CSV)

# Перейдите на страницу '''Визуализация метрик''' и в разделе '''Результат''' выберите '''Дополнительно (...) >''' '''Экспорт CSV''' .
#* '''Экспорт CSV''' доступен для всех визуализаций, кроме сотовой и одиночной.
#* Значения, экспортированные в CSV-файл, отражают форматирование, указанное в настройках '''Единица измерения''' и '''Формат''' в разделе '''Настройки'''.
# CSV-файл с результатами сохраняется на вашем локальном компьютере.

Имя файла указывает метрики, дату и временные рамки.

Например:

* <code>CPU usage % (May 24, 2022, 11_41 - 13_41).csv</code>— содержит результаты metric <code>CPU usage %</code>, запущенного 24 мая 2022 года в течение двухчасового периода с 11:41 до 13:41.
* <code>CPU usage % +1 (May 24, 2022, 13_19 - 13_49).csv</code>— содержит результаты метрики <code>CPU usage %</code>и еще одной метрики, запущенные 24 мая 2022 года в течение получасового периода с 13:19 до 13:49.

=== Использовать в API ===
После выполнения запроса у вас есть возможность скопировать запрос для использования в запросе API.

# Перейдите на страницу '''Визуализация метрик''' и в разделе '''Результат''' выберите '''Дополнительно (...) >''' '''Копировать запрос'''.
# Выберите, следует ли '''Использовать таймфрейм результата'''.
# Выберите формат ответа: '''JSON''' или '''CSV'''.
# Нажмите на кнопку '''Скопировать''', чтобы скопировать запрос в буфер обмена, или просто выберите и скопируйте те части запроса, которые вы хотите использовать.
# '''''необязательный''''' Нажмите '''Получите токен с областью чтения метрик и замените XXX-XXX в запросе''' , чтобы перейти на страницу '''Создание токена''' доступа и получить токен для запроса.

== Примеры ==

=== Таблица с двумя метриками (разделенная) ===
В этом примере мы выбираем метрики <code>CPU usage %</code> и <code>Memory used %</code>, разбиваем их по хостам для обоих и отображаем в виде таблицы так, чтобы строки представляли собой хосты, а столбцы — значения метрик для каждого хоста.

* '''A:''' <code>CPU usage %</code> (<code>builtin:host.cpu.usage</code>), <code>Среднее</code>, Разделить по <code>Host</code>
* '''B:''' <code>Memory used %</code> (<code>builtin:host.mem.usage</code>), <code>Среднее</code>, Разделить по <code>Host</code>
* '''Визуализация:''' <code>Таблица</code>

Полный запрос должен выглядеть так:

[[Файл:150.png|граница]]

Пример плитки:

[[Файл:151.png|граница]]

=== График с двумя метриками ===
В этом примере мы выбираем те же показатели и отображаем их в виде графика.

При установке '''Визуализации''' на <code>График</code> отображаются '''Настройки''' , где можно выбрать, как отображать каждую метрику. В этом случае — <code>CPU usage %</code> это диаграмма с областями (область между 0 и значением метрики заполнена), а <code>Memory used %</code>— это линейная диаграмма (одна линия, представляющая значение метрики с течением времени).

* A: <code>CPU usage %</code> (<code>builtin:host.cpu.usage</code>), <code>Среднее</code>, Разделить по <code>Host</code>
* B: <code>Memory used %</code> (<code>builtin:host.mem.usage</code>), <code>Среднее</code>, Разделить по <code>Host</code>
* Визуализация: <code>График</code>
* Визуальные настройки:
** А =<code>Область</code>
** Б =<code>Линейный</code>

Полный запрос должен выглядеть так:

[[Файл:152.png|граница]]

Пример плитки:

[[Файл:153.png|граница]]

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

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

=== Пример 1: Синтетическая метрика шага, расширенная синтетическим монитором ===
Некоторые показатели производительности для синтетических событий не имеют возможности фильтровать их по монитору. Однако одно и то же событие может произойти на нескольких мониторах, и чтобы посмотреть на производительность одного монитора, вам нужна возможность фильтровать их.

Благодаря автоматически расширенным фильтрам теперь можно фильтровать данные на этапе синтетического теста.

# Выберите метрику (например, <code>Action duration - load action (by event) [browser monitor]</code>). Она имеет '''тип объекта''' <code>SYNTHETIC_TEST_STEP</code>. [[Файл:157.png|граница]]
# Добавьте фильтр. [[Файл:158.png|граница]]
# Выберите автоматически расширенное измерение. [[Файл:159.png|граница]]
# Полученный фильтр. [[Файл:160.png|граница]] Более того, теперь вы можете использовать автоматически расширенные фильтры на панели мониторинга, поэтому вам не придется настраивать несколько плиток, чтобы видеть одну и ту же метрику для разных мониторов или разных хостов.
# На вкладке '''Динамические фильтры''' на странице настроек дашборда добавьте фильтр для <code>Пользовательские фильтры</code>. [[Файл:161.png|граница]]
# Выберите <code>Synthetic monitor</code>. [[Файл:162.png|граница]]
# Сохраните изменения и отобразите дашборд. Теперь вы можете фильтровать все плитки на дашборде по Synthetic monitor. Дашборд автоматически проверит для каждой плитки, существует ли такая связь. Таким образом, каждая плитка (без фильтров, установленных на уровне плитки), которая имеет метрику событий Synthetic, будет отфильтрована в тот момент, когда существует связь между шагом в плитке и выбранным вами монитором. [[Файл:163.png|граница]]

=== Пример 2: расширенная метрика хоста ===
Здесь мы расширяем метрику хоста экземпляром EC2.

# Создайте плитку, связанную с хостом, с метрикой хоста (например, <code>CPU usage %</code>- <code>builtin:host.cpu.usage</code>).
# Примените соответствующий фильтр, например <code>EC2 instance (runsOn)</code>. Теперь плитка со всеми хостами отфильтрована только по хостам, работающим на этом экземпляре '''EC2'''. Это возможно, даже если измерение <code>EC2 instance</code> не существует в исходной метрике хоста. Используя топологию (тип объекта), Ключ-АСТРОМ может фильтровать хосты на основе этой связи. [[Файл:164.png|граница]]

В этом варианте метрика хоста расширяется за счет группы хостов.

# Установите фильтр <code>Host.Host Group (isInstanceOf)</code>и закрепите плитку на нашем дашборде. [[Файл:165.png|граница]]
# Теперь мы можем фильтровать плитки дашборда по группе хостов. [[Файл:166.png|граница]]

Глобальная настройка дашбордов

2024-09-13T13:52:41Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / Дашборды / Дашборды / Глобальная настройка дашбордов'''''

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

== Общие настройки ==

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

# Перейдите в раздел '''Настройки''' и выберите '''Дашборды > Общие настройки.'''
# Включите или отключите параметр '''Разрешить анонимный доступ''', чтобы на глобальном уровне (учетной записи) определить, можно ли предоставлять общий доступ к дашбордам.
# Нажмите на кнопку '''Сохранить изменения'''.

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

# Перейдите в раздел '''Настройки''' и выберите '''Дашборды > Общие настройки.'''
# Нажмите на кнопку '''Настроить домашний дашборд.'''
# Выберите группу пользователей из списка '''Группа пользователей'''.
# Выберите предустановленный дашборд из списка '''Домашний дашборд'''. Если вашего дашборда нет в списке, убедитесь, что это '''''[[Дашборды-шаблоны|предустановленный дашборд]].'''''
# Нажмите на кнопку '''Сохранить изменения'''.

== Настройки пресетов ==
Используйте эту страницу для настройки предустановленных дашбордов на глобальном уровне.

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

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

=== Ограничить просмотр пресетов ===
Используйте настройки пресетов, чтобы гарантировать, что определенные предустановленные дашборды будут видны только определенным группам пользователей, а не всем пользователям в среде.

# Перейдите на вкладку '''Настройки''' и выберите '''Дашборды > Настройки пресетов.'''
# В разделе '''Ограничьте видимость пресетов''' нажмите на кнопку '''Добавить правило пресета'''.
#* Выберите в списке '''Пресет дашборда''' пресет дашборда, для которого вы хотите изменить групповой доступ.
#* Выберите в списке '''Группа пользователей''' группу, которая должна иметь доступ к выбранному пресету дашборда.
# Нажмите на кнопку '''Сохранить изменения'''.

Дополнительную информацию о предустановленных дашбордах см. в разделе '''''[[Дашборды-шаблоны|Предустановленные дашборды]]'''''.

== Правила разрешённых шаблонов URL ==
Чтобы добавить изображение на дашборд через URL-адрес, сначала необходимо добавить правило для URL-адреса список.

# Перейдите на вкладку '''Настройки''' и выберите '''Дашборды >Маски разрешённых URL'''
# Нажмите на кнопку '''Добавить элемент'''.
# В списке '''Правило''' выберите правило, которое определяет, как обрабатывать эту запись в списке.
#* '''Начинается на''' — разрешить любое изображение, URL-адрес которого начинается с содержимого Pattern.
#* '''Точное''' — разрешить конкретное изображение, URL-адрес которого точно соответствует содержимому шаблона.
# Установите шаблон:
#* Чтобы указать начало URL-адреса, введите достаточно URL-адреса, чтобы все соответствующие URL-адреса изображений подходили для ваших дашбордов. Пример: введите, <code><nowiki>https://example.com/images/</nowiki></code>чтобы разрешить любое изображение, URL-адрес которого начинается с <code><nowiki>https://example.com/images/</nowiki></code>, например <code><nowiki>https://example.com/images/image-x.jpg</nowiki></code>и <code><nowiki>https://example.com/images/my-picture.svg</nowiki></code>
#* Чтобы указать точный URL-адрес, введите полный URL-адрес изображения, которое вы хотите разрешить. Пример: введите <code><nowiki>https://example.com/images/my-image-file-name.jpg</nowiki></code>, чтобы разрешить только это изображение
# Нажмите на кнопку '''Сохранить изменения''', чтобы добавить указанное правило в список разрешенных.

Затем вы можете добавить изображение дашборда через URL-адрес.

# Перейдите в раздел '''Дашборды'''.
# Выберите необходимый дашборд, чтобы отобразить его.
# Нажмите на кнопку '''Редактировать''' в правом верхнем углу дашборда. Дашборд откроется в режиме редактирования.
#* Если вы не видите кнопку '''Редактировать''', значит, у вас нет разрешения на редактирование этого дашборда.
# Перетащите плитку изображения на желаемое место.
# На панели '''Изображение''' перейдите на вкладку '''Добавьте URL-адрес изображения'''.
# Введите URL-адрес файла изображения, который вы хотите отобразить на плитке. Он должен соответствовать одному из правил в списке.
# При необходимости измените размер и положение плитки.

JSON-конфигурация дашбордов

2024-09-13T13:51:46Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / Дашборды / Дашборды / JSON-конфигурация дашбордов'''''

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

* Альтернатива API Для расширенного управления JSON дашборда вам понадобится '''''API Дашборд'''''.

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

* Когда вы загружаете дашборд с помощью этой процедуры, вы перезаписываете этот дашборд, образ которого вы изначально скачали. Если вы хотите загрузить образ дашброда, как новый дашборд, см. раздел '''''Импорт дашборда''''' ниже.

# Отобразите необходимый дашборд.
# Нажмите на кнопку '''Редактировать'''.
# Перейдите на вкладку '''Настройки''' и нажмите на кнопку '''Настроить больше.'''
# Перейдите на вкладку '''JSON дашборда'''.
# На странице '''JSON дашборд''' Нажмите на кнопку '''Загрузить.''' Файл JSON с названием дашборда будет загружен на ваш локальный компьютер.
# Отредактируйте JSON в удобной для вас среде разработки. Подробные сведения о синтаксисе JSON см. в документации '''''API Дашборд'''''.
# На странице '''JSON дашборда''' нажмите на кнопку '''Загрузить''', найдите отредактированный файл JSON и загрузите его в систему Ключ-АСТРОМ. Загруженный JSON отображается на странице '''JSON дашборда'''.
# Нажмите на кнопку '''Сохранить изменения''', чтобы заменить старый JSON на отредактированный JSON.
# Откройте дашборд, чтобы проверить изменения.

== Редактирование в системе Ключ-АСТРОМ ==

# Отобразите необходимый дашборд.
# Нажмите на кнопку '''Редактировать'''.
# Перейдите на вкладку '''Настройки''' и нажмите на кнопку '''Настроить больше.'''
# Перейдите на вкладку '''JSON дашборда'''.
# На странице '''JSON дашборда''' JSON дашборда отображается в окне редактирования.
# Нажмите на отображаемый JSON и начните редактирование.
#* Вы можете работать непосредственно в окне редактирования или копировать и вставлять туда и обратно из другого редактора.
#* Сообщения в левом нижнем углу страницы напомнит вам, что работа продолжается. Обязательно сохранитесь, прежде чем покинуть страницу.
#* Синтаксис проверяется каждый раз при сохранении. Вы можете работать постепенно и использовать кнопку '''Сохранить изменения''', чтобы убедиться, что он все еще анализируется.
#* Подробные сведения о синтаксисе JSON см. в документации '''''API Дашборд'''''.
# Когда вы закончите, откройте дашборд, чтобы проверить изменения.

== Импорт дашборда ==

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

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

# Экспорт дашборда (если вы хотите начать с существующего дашброда)
#* Откройте вкладку '''Дашборды.'''
#* В таблице дашбордов выберите '''Дополнительно (…) > Экспорт''' для дашборда, который вы хотите экспортировать. Определение дашборда экспортируется в виде файла JSON на ваш компьютер.
# Редактирование JSON-файла дашборда
#* Отредактируйте JSON дашборда в удобной для вас системе разработки. Подробные сведения о синтаксисе JSON см. в документации '''''API Дашборд.'''''
#Импорт дашборда
#* Откройте вкладку '''Дашборды'''
#*Нажмите на кнопку '''Импортировать дашборд.'''
#*Выберите файл JSON дашборда, который вы хотите импортировать. Импортированный дашборд откроется в режиме редактирования.

Таймфреймы и менеджмент-зоны дашбордов

2024-09-13T13:50:49Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / Дашборды / Дашборды / Таймфреймы и менеджмент-зоны дашбордов'''''

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

[[Файл:Таймфрейм_new.png|граница]]
* Нажмите на кнопку фильтра, чтобы выбрать новую менеджмент-зону.
* Нажмите на кнопку тамфрейма, чтобы выбрать новый диапазон.

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

[[Файл:Подробный_Таймфрейм.png|граница|350x350пкс]]
* На вкладке '''Пресеты''' перечислены все доступные стандартные таймфреймы. Выберите один из них, чтобы изменить временной интервал.
* На вкладке '''Custom''' отображается календарь. Выберите день начала и день окончания, а затем нажмите на кнопку '''Применить''', чтобы выбрать этот диапазон дней в качестве таймфрейма.
** Выбранные календарные интервалы заканчиваются в начале следующего дня (время установлено на <code>00:00</code>). Например, если вы выберете в календаре период с 3 по 4 сентября, временной интервал начнется 3 сентября в <code>00:00</code>и закончится 5 сентября в <code>00:00.</code>
* На вкладке '''Недавний''' отображаются недавно использованные таймфреймы. Выберите один из них, чтобы вернуться к этому таймфрейму.
* Элементы управления '''<''' и '''>''' сдвигают таймфрейм вперед или назад во времени. Сдвиг — это длина исходного временного диапазона. Например, если текущий таймфрейм равен <code>-2h</code>(период за 2 часа, которые заканчиваются сейчас), нажмите '''<''' , чтобы сдвинуть временной диапазон на два часа назад к <code>-4h to -2h</code>(период за 2 часа, которые закончились 2 часа назад).
* Наведите курсор мыши на таймфрейм, чтобы увидеть время начала, продолжительность и время окончания.
[[Файл:Курсор_с_таймфреймом.png|граница]]

=== Выражения выбора таймфрейма ===
Если вы выберете текущий таймфрейм в строке меню, отобразится редактируемое выражение таймфрейма.

* При чтении слева направо выражение временного интервала имеет время начала, и время окончания <code>to</code>.
* Если время окончания не задано, то подразумеваются <code>to now</code>Например, <code>-2h</code>то же самое <code>-2h to now</code>.
* Поддерживаемые единицы: <code>s</code>, <code>m</code>, <code>h</code>, <code>d</code>, <code>w</code>, <code>M</code>, <code>q</code>, <code>y</code>(вы также можете использовать целые слова, например <code>minutes</code>и <code>quarter</code>)

{| class="wikitable"
|+Обозначения выражений таймфрейма
!Примеры выражений таймфрейма
!Значение
|-
|<code>today</code>
|С начала сегодняшнего дня до начала завтрашнего дня.
|-
|<code>yesterday</code>
|С начала вчерашнего дня до начала сегодняшнего. Пример <code>-1d/d to today</code>.
|-
|<code>yesterday to now</code>
|С начала вчерашнего дня до текущего времени сегодня.
|-
|<code>previous week</code>
|Целых семь предыдущих дней. Если сегодня понедельник, вы получаете данные с предыдущего понедельника по предыдущее воскресенье (вчера).
|-
|<code>this year</code>
|Текущий календарный год, с 1 января этого года <code>00:00</code>по 1 января следующего года <code>00:00</code>.
|-
|<code>last 6 weeks</code>
|Последние 42 дня (6 недель * 7 дней), заканчивающихся сейчас. Аналогично <code>-6w to now</code>.
|-
|<code>-2h</code>
|От 2 часов (120 минут) назад до текущего времени ( <code>now</code>подразумевается). Аналогично <code>Last 2 hours</code>и <code>-2h to now</code>.
|-
|<code>-4d to -1h30m</code>
|От 4 дней (96 часов) назад до 1,5 часов назад.
|-
|<code>-1w</code>
|Последние 7 дней (168 часов), с этого времени 7 дней назад до текущего времени (<code>now</code>). Аналогично <code>-7d</code>и <code>-168h</code>.
|-
|<code>-1w/w</code>
|От начала предыдущей календарной недели до текущего времени (сейчас).

* Если вы использовали <code>-1w/w</code> в пятницу днем в 3:00, вы получите диапазон 11 дней 15 часов, начиная с начала понедельника предыдущей недели, поскольку <code>/w</code> подразумевает округление до начала недели.
* Если вы использовали <code>-1w</code>«без» <code>/w</code>в пятницу днем в 3:00, время начала будет ровно на 7 дней (168 часов) раньше: в предыдущую пятницу в 3:00 дня.

Обычно <code>/</code>используют в сочетании с единицей измерения (например <code>/d</code>, <code>/w</code>, <code>/M</code>, и <code>/y</code>) это означает округление даты или времени до начала указанной единицы времени. Например, <code>-3d</code>означает ровно 72 часа назад, тогда как <code>-3d/d</code>означает три дня назад, округленное до ближайшего дня (начиная с момента времени <code>00:00</code>, начала дня). Используется <code>now/d</code>для обозначения начала сегодняшнего дня.
|-
|<code>-1w/w + 8h</code>
|С начала прошлой недели плюс 8 часов (8:00 понедельника).

* Обратите внимание, что вы можете использовать функции <code>+</code>и <code>-</code>с единицами измерения, метками времени и <code>now</code>.
|-
|<code>-1d/d+9h00m to -1d/d+17h00m</code>
|Часы работы вчера с 09:00 до 17:00 (с 9:00 до 17:00).
|-
|<code>2020-08-16 21:28 to 2020-08-19 10:02</code>
|Абсолютный диапазон, состоящий из абсолютных дат и времени начала и окончания в <code>YYYY-MM-DD hh:mm</code>формате.

* Если вы указали дату, но не указали время (например <code>2020-08-16</code>), предполагается, что это время начала дня (<code>00:00</code>).
* Если вы укажете время, но опустите дату (например, просто <code>21:28</code>), предполагается, что это сегодняшняя дата.
|-
|<code>1598545932346 to 1598837052346</code>
|Миллисекундные временные метки формата Unix.
|}

== Сохранение таймфреймов и менеджмент-зон ==
Выбор таймфреймов и менеджмент-зон является фиксированным — они распространяются на все посещаемые вами страницы. Например, после изменения таймфрейма и менеджмент-зоны на дашборде выбранные параметры сохраняются при переходе от плитки '''Приложения''' к отдельным страницам приложений.

Исключением является открытие нового дашборда или возврат к текущим дашбордам, выбрав вкладку '''Дашборды''' в верхнем левом углу страницы. В этом случае таймфрейм и менеджмент-зона сбрасываются '''''до значений по умолчанию''' (см. ниже)'''.'''''

Значения таймфреймов запоминаются в количестве до 10 недавно использованных таймфреймов.

== Настройки по умолчанию таймфрейма и менеджмент-зоны ==
Вы можете установить таймфрейм и менеджмент-зону по умолчанию для каждого дашборда; они будут выбираться каждый раз, когда вы открываете дашборд. Эти настройки также будут применены, когда вы предоставите '''''[[Доступ к дашбордам|общий доступ]]''''' к дашборду.

Вы также можете указать таймфрейм и менеджмент-зону по умолчанию для каждой плитки.

=== Таймфрейм для конкретного дашборда ===
Чтобы установить таймфрейм дашборда, который будет отображаться глобально:

# Перейдите на вкладку '''Настройки'''.
# Включите '''Таймфрейм по умолчанию'''.
# Выберите таймфрейм, который вы хотите использовать по умолчанию для этого дашборда.

=== Менеджмент-зона для конкретного дашборда ===
Чтобы установить менеджмент-зоны дашборда, которая будет отображаться глобально:

# Перейдите на вкладку '''Настройки'''.
# Включите '''Менеджмент-зона по умолчанию'''.
# Выберите менеджмент-зону, которую вы хотите использовать по умолчанию для этого дашборда.

=== Таймфрейм для конкретной плитки ===
Чтобы установить таймфрейм для плитки:

# Перейдите в раздел '''Дашборды.'''
# Выберите название дашборда, чтобы отобразить его.
# Нажмите на кнопку '''Редактировать''' в правом верхнем углу дашборда. Дашборд откроется в режиме редактирования.
#* Если вы не видите опцию '''Редактировать''' , значит, у вас нет разрешения на редактирование этого дашборда.
# Выберите плитку, которую хотите настроить.
# Включите параметр '''Custom''' таймфрейм.
# Выберите таймфрейм, который будет использоваться по умолчанию для этой плитки.
# Нажмите на кнопку '''Готово'''. Когда вы устанавливаете таймфрейм для конкретной плитки, в правом верхнем углу плитки отображается ее фильтр. Наведите курсор на фильтр, чтобы увидеть настройку.

=== Менеджмент-зона для конкретной плитки ===
Чтобы установить менеджмент-зону для плитки:

# Перейдите в раздел '''Дашборды.'''
# Выберите название дашборда, чтобы отобразить его.
# Нажмите на кнопку '''Редактировать''' в правом верхнем углу дашборда. Дашборд откроется в режиме редактирования.
#* Если вы не видите опцию Редактировать , значит, у вас нет разрешения на редактирование этого дашборда.
# Выберите плитку, которую хотите настроить.
# Включите параметр '''Custom''' менеджмент-зона.
# Выберите менеджмент-зону, которую вы хотите использовать по умолчанию для этой плитки.
# Нажмите на кнопку '''Готово'''. Когда вы устанавливаете менеджмент-зону для конкретной плитки, в правом верхнем углу плитки отображается ее фильтр. Наведите курсор на фильтр, чтобы увидеть настройку.

Создание дашбордов для нескольких окружений Ключ-АСТРОМ

2024-09-13T13:50:25Z

ENetrebin:

'''''[[Применение Ключ-АСТРОМ]] / Дашборды / Дашборды / Создание дашбордов для нескольких окружений Ключ-АСТРОМ'''''

== Добавление удаленной среды ==
Чтобы добавить удаленную среду Ключ-АСТРОМ в список доступных удаленных сред

# Войдите в локальную среду Ключ-АСТРОМ.
# В меню Ключ-АСТРОМ перейдите в '''«Настройки»''' .
# Выберите '''Интеграция''' > '''Удаленные среды''' .
# Выберите '''Подключить среду''' .
# Определите удаленную среду, из которой ваша локальная среда извлекает данные, а затем выберите '''Сохранить изменения''' .
#* '''Имя''' — это имя, под которым эта среда будет указана в вашей локальной среде Ключ-АСТРОМ, когда вы настроите плитку для запроса этой удаленной среды. Это текст произвольной формы. Это не влияет на удаленную среду.
#* '''URI удаленной среды''' — это URI, который вы скопировали из адресной строки браузера в предыдущей процедуре.
#* '''Область действия сети'''
#** <code>External</code>: удаленная среда находится в другой сети. При наличии используются глобально настроенные параметры прокси. Это область действия по умолчанию.
#** <code>Internal</code>: удаленная среда находится в той же сети. Глобально настроенные параметры прокси не используются.
#** <code>Cluster</code>: удаленная среда находится в том же кластере. Запрос сделан на <code>localhost</code>. ''Примечание:'' Ключ-АСТРОМ SaaS может использовать только <code>External</code>область сети.
#* '''Токен''' — это токен, который вы создали в предыдущей процедуре. Он должен включать в'''ыборку данных из области удаленной среды''' ( <code>RestRequestForwarding</code>).
#* '''Тестовое соединение''' проверяет подключение из вашей локальной среды к удаленной среде.

Теперь, когда вы установили связь с удаленной средой, вы можете создавать плитки панели мониторинга, которые запрашивают эту среду.

== Создание плитки, отображающей удаленные данные ==
Чтобы создать плитку, которая извлекает данные из удаленной среды

# Отобразите панель мониторинга, на которой будет отображаться плитка.
# Выберите '''Изменить''' .
# Выберите или добавьте плитку, на которой вы хотите отображать данные из удаленной среды. В разделе '''«Среда»''' панели настроек плитки отображается имя среды, из которой эта плитка извлекает данные мониторинга.
#* '''Значение по умолчанию (локальное)''' настраивает плитку на извлечение данных из локальной среды Ключ-АСТРОМ.
#* Все остальные перечисленные среды являются удаленными средами, для которых установлено соединение.
# Выберите удаленную среду, которую вы хотите, чтобы выбранная плитка запрашивала. Если вы назвали удаленную среду <code>ABC</code>при добавлении удаленной среды в предыдущей процедуре, она <code>ABC</code>должна быть в этом списке.
# Выберите '''Готово''' , чтобы отобразить готовую панель мониторинга.
# Наведите указатель мыши на значок фильтра плитки, чтобы увидеть выбор среды.

== Примеры ==

=== Те же плитки, разные среды ===
В этом примере мы создаем информационную панель, которая параллельно показывает состояние хоста и сети для локальной и удаленной среды. Мы предполагаем, что вы уже добавили удаленную среду в локальную среду.

# В меню Ключ-АСТРОМ перейдите к '''Дашборды''' , выберите '''Создать дашборд''' , дайте ему имя и выберите '''Создать''' .
# Перетащите две плитки '''заголовков''' на панель мониторинга (или перетащите одну, а затем клонируйте ее).
# Отредактируйте один заголовок так, чтобы он был '''Локально''' , а другой — '''Удалённо''' .
# Перетащите две плитки '''работоспособности узла''' на панель управления (или перетащите одну, а затем клонируйте ее). Поместите один под заголовком '''Локально''' , а другой под заголовком '''Удалённо'''
#.
# Перетащите две плитки '''состояния сети''' на панель управления (или перетащите одну, а затем клонируйте ее). Поместите одну под заголовком '''Локально''' , а другой под заголовком '''Удалённо''' . На этом этапе все плитки запрашивают локальную среду, поэтому у вас есть две идентичные плитки '''работоспособности хоста''' и две идентичные плитки '''состояния сети''' .
# Под заголовком '''«Удаленно»''' отредактируйте плитки '''«Состояние хоста »''' и '''«Состояние сети»''' , чтобы они оба запрашивали удаленную среду ( <code>ABC</code>в этом примере).
# Выберите '''Готово''' , чтобы отобразить панель мониторинга.
#* Плитки в разделе '''«Локально»''' по-прежнему отображают информацию о локальном хосте и сети.
#* Плитки в разделе '''Удалённо''' теперь запрашивают удаленную среду:
#** Удаленные плитки отображают работоспособность хоста и состояние сети для удаленной среды, а не для локальной среды по умолчанию.
#** На каждой удаленной плитке отображается значок фильтра. Наведите указатель мыши на значок, чтобы увидеть название среды.

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

== Поиск неисправностей ==
'''''При настройке плитки я не вижу удаленную среду в списке Среда'''''

Если вы не видите удаленную среду в списке «Среда» для своей плитки, убедитесь, что среда указана в таблице '''«Удаленные среды»''' .

# В меню Ключ-АСТРОМ перейдите в '''«Настройки»''' .
# Выберите '''Интеграция''' > '''Удаленные среды''' .
# Найдите среду в таблице '''удаленных сред''' .
#* Убедитесь, что вы ищете правильное имя.
#* Убедитесь, что среда не была удалена.

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

Сообщение <code>Verification failed, please check your settings: Constraints violated.</code>указывает на ошибку конфигурации.

Что проверить:

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