Получение сводного лога - История изменений

ENetrebin в 15:13, 27 января 2023

2023-01-27T15:13:02Z

← Предыдущая		Версия 15:13, 27 января 2023
Строка 11:		Строка 11:
	\|GET		\|GET
	\|		\|
	* SaaS <nowiki>https://{идентификатор_вашей_среды}.~~live.ruscomtech.ru~~.com/api/v2/logs/aggregate</nowiki>		* SaaS <nowiki>https://{идентификатор_вашей_среды}.dynatrace.com/api/v2/logs/aggregate</nowiki>
	* Окружающая среда АктивногоШлюза <nowiki>https://{ваш-активный-домен}/e/{идентификатор-вашей-среды}/api/v2/logs/aggregate</nowiki>		* Окружающая среда АктивногоШлюза <nowiki>https://{ваш-активный-домен}/e/{идентификатор-вашей-среды}/api/v2/logs/aggregate</nowiki>
	\|}		\|}

ENetrebin в 15:12, 27 января 2023

2023-01-27T15:12:18Z

← Предыдущая		Версия 15:12, 27 января 2023
Строка 70:		Строка 70:
	\|Поисковый запрос лога.		\|Поисковый запрос лога.

	Запрос должен использовать язык поисковых запросов ~~Ключ-АСТРОМ~~ .		Запрос должен использовать язык поисковых запросов Dynatrace .

	Запрос имеет ограничение в 20 отношений (логические операторы между простыми выражениями ( <code>AND</code>, <code>OR</code>) или операторы сравнения ( <code>=</code>, <code>!=</code>, <code><</code>, <code><=</code>, <code>></code>, <code>>=</code>) в простых выражениях).		Запрос имеет ограничение в 20 отношений (логические операторы между простыми выражениями ( <code>AND</code>, <code>OR</code>) или операторы сравнения ( <code>=</code>, <code>!=</code>, <code><</code>, <code><=</code>, <code>></code>, <code>>=</code>) в простых выражениях).

ENetrebin в 11:52, 7 октября 2022

2022-10-07T11:52:45Z

← Предыдущая		Версия 11:52, 7 октября 2022
Строка 11:		Строка 11:
	\|GET		\|GET
	\|		\|
	* SaaS <nowiki>https://{идентификатор_вашей_среды}.live.~~dynatrace~~.com/api/v2/logs/aggregate</nowiki>		* SaaS <nowiki>https://{идентификатор_вашей_среды}.live.ruscomtech.ru.com/api/v2/logs/aggregate</nowiki>
	* Окружающая среда АктивногоШлюза <nowiki>https://{ваш-активный-домен}/e/{идентификатор-вашей-среды}/api/v2/logs/aggregate</nowiki>		* Окружающая среда АктивногоШлюза <nowiki>https://{ваш-активный-домен}/e/{идентификатор-вашей-среды}/api/v2/logs/aggregate</nowiki>
	\|}		\|}
Строка 130:		Строка 130:
	=== Объекты тела ответа ===		=== Объекты тела ответа ===

	==== Объект _ <code>AggregatedLog</code> ====		==== Объект <code>AggregatedLog</code> ====
	Совокупные записи лога.		Совокупные записи лога.
	{\| class="wikitable"		{\| class="wikitable"

ENetrebin в 14:34, 5 октября 2022

2022-10-05T14:34:05Z

← Предыдущая		Версия 14:34, 5 октября 2022
Строка 1:		Строка 1:
	Получает агрегированные записи ~~журнала~~, соответствующие заданным критериям.		Получает агрегированные записи лога, соответствующие заданным критериям.

	Возвращает агрегированное количество вхождений значений ~~журнала~~, разделенных на временные интервалы.		Возвращает агрегированное количество вхождений значений лога, разделенных на временные интервалы.

	Возможно, что временные рамки, охватываемые результатами, превышают указанные временные рамки. В таких случаях запрос возвращает меньше временных интервалов, чем указано в параметре запроса timeBuckets .		Возможно, что временные рамки, охватываемые результатами, превышают указанные временные рамки. В таких случаях запрос возвращает меньше временных интервалов, чем указано в параметре запроса timeBuckets .
Строка 9:		Строка 9:
	Этот запрос является выпуском Early Adopter и может быть изменен несовместимым образом.		Этот запрос является выпуском Early Adopter и может быть изменен несовместимым образом.
	{\| class="wikitable"		{\| class="wikitable"
	\|~~ПОЛУЧИТЬ~~		\|GET
	\|		\|
	* ~~SaaShttps~~://{идентификатор_вашей_среды}.live.dynatrace.com/api/v2/logs/aggregate		* SaaS <nowiki>https://{идентификатор_вашей_среды}.live.dynatrace.com/api/v2/logs/aggregate</nowiki>
	* Окружающая среда ~~ActiveGatehttps~~://{ваш-активный-домен}/e/{идентификатор-вашей-среды}/api/v2/logs/aggregate		* Окружающая среда АктивногоШлюза <nowiki>https://{ваш-активный-домен}/e/{идентификатор-вашей-среды}/api/v2/logs/aggregate</nowiki>
	\|}		\|}

	== Аутентификация ==		== Аутентификация ==
	Чтобы выполнить этот запрос, вам необходимо разрешение на чтение ~~журналов~~ ( <code>logs.read</code>), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .		Чтобы выполнить этот запрос, вам необходимо разрешение на '''чтение логов''' ( <code>logs.read</code>), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)\|Токены и аутентификация]] .

	== Параметры ==		== Параметры ==
Строка 23:		Строка 23:
	!Тип		!Тип
	!Описание		!Описание
	!В		!In
	!~~Необходимый~~		!Необходимость
	\|-		\|-
	\|из		\|from
	\|~~нить~~		\|string
	\|Начало запрошенного таймфрейма.		\|Начало запрошенного таймфрейма.

Строка 35:		Строка 35:
	* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.		* Человекочитаемый формат <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>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>m</code>: минуты
	** <code>h</code>: часы		** <code>h</code>: часы
	** <code>d</code>: ~~дней~~		** <code>d</code>: дни
	** <code>w</code>: недели		** <code>w</code>: недели
	** <code>M</code>: месяцы		** <code>M</code>: месяцы
Строка 46:		Строка 46:
	\|по желанию		\|по желанию
	\|-		\|-
	\|к		\|to
	\|~~нить~~		\|string
	\|Конец запрошенного периода времени.		\|Конец запрошенного периода времени.

Строка 55:		Строка 55:
	* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.		* Человекочитаемый формат <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>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>m</code>: минуты
	** <code>h</code>: часы		** <code>h</code>: часы
	** <code>d</code>: ~~дней~~		** <code>d</code>: дни
	** <code>w</code>: недели		** <code>w</code>: недели
	** <code>M</code>: месяцы		** <code>M</code>: месяцы
Строка 66:		Строка 66:
	\|по желанию		\|по желанию
	\|-		\|-
	\|~~запрос~~		\|query
	\|~~нить~~		\|string
	\|Поисковый запрос ~~журнала~~.		\|Поисковый запрос лога.

	Запрос должен использовать язык поисковых запросов ~~Dynatrace~~ .		Запрос должен использовать язык поисковых запросов Ключ-АСТРОМ .

	Запрос имеет ограничение в 20 отношений (логические операторы между простыми выражениями ( <code>AND</code>, <code>OR</code>) или операторы сравнения ( <code>=</code>, <code>!=</code>, <code><</code>, <code><=</code>, <code>></code>, <code>>=</code>) в простых выражениях).		Запрос имеет ограничение в 20 отношений (логические операторы между простыми выражениями ( <code>AND</code>, <code>OR</code>) или операторы сравнения ( <code>=</code>, <code>!=</code>, <code><</code>, <code><=</code>, <code>></code>, <code>>=</code>) в простых выражениях).
Строка 76:		Строка 76:
	\|по желанию		\|по желанию
	\|-		\|-
	\|~~таймковши~~		\|timeBuckets
	\|~~целое число~~		\|integer
	\|Количество временных интервалов в результате.		\|Количество временных интервалов в результате.

Строка 89:		Строка 89:
	\|-		\|-
	\|maxGroupValues		\|maxGroupValues
	\|~~целое число~~		\|integer
	\|Максимальное количество значений в каждой группе.		\|Максимальное количество значений в каждой группе.

Строка 98:		Строка 98:
	\|по желанию		\|по желанию
	\|-		\|-
	\|~~группа по~~		\|groupBy
	\|~~строка~~ []		\|string []
	\|Группы, которые должны быть включены в ответ.		\|Группы, которые должны быть включены в ответ.

Строка 120:		Строка 120:
	\|-		\|-
	\|200		\|200
	\|~~Сводный журнал~~		\|AggregatedLog
	\|Успех		\|Успех
	\|-		\|-
Строка 131:		Строка 131:

	==== Объект _ <code>AggregatedLog</code> ====		==== Объект _ <code>AggregatedLog</code> ====
	Совокупные записи ~~журнала~~.		Совокупные записи лога.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 137:		Строка 137:
	!Описание		!Описание
	\|-		\|-
	\|~~агрегацияРезультат~~		\|aggregationResult
	\|~~объект~~		\|object
	\|Совокупные записи ~~журнала~~.		\|Совокупные записи лога.
	\|}		\|}

ENetrebin: Новая страница: «Получает агрегированные записи журнала, соответствующие заданным критериям. Возвращае...»

2022-10-04T19:28:53Z

Новая страница: «Получает агрегированные записи журнала, соответствующие заданным критериям. Возвращае...»

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

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

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

Возможно, что временные рамки, охватываемые результатами, превышают указанные временные рамки. В таких случаях запрос возвращает меньше временных интервалов, чем указано в параметре запроса timeBuckets .

Запрос создает <code>application/json</code>полезную нагрузку.

Этот запрос является выпуском Early Adopter и может быть изменен несовместимым образом.
{| class="wikitable"
|ПОЛУЧИТЬ
|
* SaaShttps://{идентификатор_вашей_среды}.live.dynatrace.com/api/v2/logs/aggregate
* Окружающая среда ActiveGatehttps://{ваш-активный-домен}/e/{идентификатор-вашей-среды}/api/v2/logs/aggregate
|}

== Аутентификация ==
Чтобы выполнить этот запрос, вам необходимо разрешение на чтение журналов ( <code>logs.read</code>), назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Необходимый
|-
|из
|нить
|Начало запрошенного таймфрейма.

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

* Отметка времени в миллисекундах 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>).
|запрос
|по желанию
|-
|к
|нить
|Конец запрошенного периода времени.

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

* Отметка времени в миллисекундах 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>: годы

Если не установлено, используется текущая метка времени.
|запрос
|по желанию
|-
|запрос
|нить
|Поисковый запрос журнала.

Запрос должен использовать язык поисковых запросов Dynatrace .

Запрос имеет ограничение в 20 отношений (логические операторы между простыми выражениями ( <code>AND</code>, <code>OR</code>) или операторы сравнения ( <code>=</code>, <code>!=</code>, <code><</code>, <code><=</code>, <code>></code>, <code>>=</code>) в простых выражениях).
|запрос
|по желанию
|-
|таймковши
|целое число
|Количество временных интервалов в результате.

Временной интервал запроса делится поровну на указанное количество слотов.

Минимальная длина слота составляет 1 мс.

Если не установлено, используется 1.
|запрос
|по желанию
|-
|maxGroupValues
|целое число
|Максимальное количество значений в каждой группе.

Вы можете получить до 100 значений на группу.

Если не установлено, используется 10.
|запрос
|по желанию
|-
|группа по
|строка []
|Группы, которые должны быть включены в ответ.

Вы можете указать несколько групп в следующем формате: <code>groupBy=status&groupBy=log.source</code>.

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

Уникальные атрибуты данных журнала (атрибуты высокой мощности), например, <code>span_id</code>или <code>trace_id</code>не могут использоваться для группировки.
|запрос
|по желанию
|}

== Ответ ==

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

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

==== Объект _ <code>AggregatedLog</code> ====
Совокупные записи журнала.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|агрегацияРезультат
|объект
|Совокупные записи журнала.
|}

=== JSON-модель тела ответа ===
<code>{
"aggregationResult": {
"processId": {
"1597835271": {
"cassandra": "6"
},
"1597835331": {
"apache": "12",
"cassandra": "60"
}
},
"hostId": {
"1597835271": {
"localhost": "12"
},
"1597835331": {
"remotehost": "6"
}
},
"logLevel": {
"1597835271": {
"ERROR": "1",
"INFO": "2"
},
"1597835331": {
"INFO": "17"
}
},
"logPath": {
"1597835271": {
"/var/log/messages": "15",
"/var/log/syslog": "3"
},
"1597835331": {
"/var/log/messages": "15",
"/var/log/syslog": "3"
}
}
}
}</code>