GET ленты событий - История изменений

IKuznetsov в 14:15, 24 декабря 2024

2024-12-24T14:15:57Z

← Предыдущая версия		Версия от 14:15, 24 декабря 2024
Строка 1:		Строка 1:
	'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты среды]] / [~~[API АппОптима~~#:~:text=DELETE ~~тегов~~-,~~Развёртывание~~,-~~править\|~~Развёртывание]] / [~~[API АппОптима~~#:~:text=~~Тарболлы оркестровки~~-,~~События v1~~,-GET ~~ленты событий\|~~События v1]] / GET ленты событий'''''		'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты среды]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=DELETE%20%D1%82%D0%B5%D0%B3%D0%BE%D0%B2-,%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,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Развёртывание] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%A2%D0%B0%D1%80%D0%B1%D0%BE%D0%BB%D0%BB%D1%8B%20%D0%BE%D1%80%D0%BA%D0%B5%D1%81%D1%82%D1%80%D0%BE%D0%B2%D0%BA%D0%B8-,%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F%20v1,-GET%20%D0%BB%D0%B5%D0%BD%D1%82%D1%8B%20%D1%81%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B9 События v1] / GET ленты событий'''''

	Функция предоставляет список всех событий вашей среды и их параметров. Поскольку возможное количество событий может быть большим, ответ ограничен 150 событиями. Вы можете сузить вывод, указав параметры фильтрации в своем запросе .		Функция предоставляет список всех событий вашей среды и их параметров. Поскольку возможное количество событий может быть большим, ответ ограничен 150 событиями. Вы можете сузить вывод, указав параметры фильтрации в своем запросе .
Строка 539:		Строка 539:
	}		}
	]		]
	}~~</code>~~		}
	==Пример==		==Пример==
	В этом примере запрос запрашивает все события ERROR_EVENT , произошедшие за последние 24 часа . Результат усекается до двух событий.		В этом примере запрос запрашивает все события ERROR_EVENT , произошедшие за последние 24 часа . Результат усекается до двух событий.
Строка 547:		Строка 547:
	<curl -X GET \		<curl -X GET \
	'<nowiki>https://mySampleEnv.live.AppOptima.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day'</nowiki> \		'<nowiki>https://mySampleEnv.live.AppOptima.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day'</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'~~</code>~~		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
	====URL-адрес запроса====		====URL-адрес запроса====
	<code><nowiki>https://mySampleEnv.live.AppOptima.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day</nowiki></code>		<code><nowiki>https://mySampleEnv.live.AppOptima.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day</nowiki></code>
Строка 611:		Строка 611:
	}		}
	]		]
	}~~</code>~~		}
	====Код ответа====		====Код ответа====
	200		200

IKuznetsov в 12:30, 24 декабря 2024

2024-12-24T12:30:37Z

← Предыдущая версия		Версия от 12:30, 24 декабря 2024
Строка 1:		Строка 1:
	'''''[[API ~~Ключ-АСТРОМ~~]] / [[API ~~Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B~~\|Эндпойнты среды]] / [~~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~~ Развёртывание] / События v1 / GET ленты событий'''''		'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты среды]] / [[API АппОптима#:~:text=DELETE тегов-,Развёртывание,-править\|Развёртывание]] / [[API АппОптима#:~:text=Тарболлы оркестровки-,События v1,-GET ленты событий\|События v1]] / GET ленты событий'''''

	Функция предоставляет список всех событий вашей среды и их параметров. Поскольку возможное количество событий может быть большим, ответ ограничен 150 событиями. Вы можете сузить вывод, указав параметры фильтрации в своем запросе .		Функция предоставляет список всех событий вашей среды и их параметров. Поскольку возможное количество событий может быть большим, ответ ограничен 150 событиями. Вы можете сузить вывод, указав параметры фильтрации в своем запросе .
Строка 6:		Строка 6:
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="2" \|GET		\| rowspan="2" \|GET
	\|~~Managed~~		\|АппОптима
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/events</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/events</nowiki></code>
	\|-		\|-
Строка 77:		Строка 77:
	*<code>DEPLOYMENT_CHANGED_NEW</code>		*<code>DEPLOYMENT_CHANGED_NEW</code>
	*<code>DEPLOYMENT_CHANGED_REMOVED</code>		*<code>DEPLOYMENT_CHANGED_REMOVED</code>
	*<code>~~ASTROMKEY_INTERNAL~~</code>		*<code>AppOptima_INTERNAL</code>
	*<code>EBS_VOLUME_HIGH_LATENCY</code>		*<code>EBS_VOLUME_HIGH_LATENCY</code>
	*<code>ELASTIC_LOAD_BALANCER_HIGH_BACKEND_FAILURE_RATE</code>		*<code>ELASTIC_LOAD_BALANCER_HIGH_BACKEND_FAILURE_RATE</code>
Строка 189:		Строка 189:
	\|entityId		\|entityId
	\|string		\|string
	\|Фильтрует результирующий набор событий до событий, связанных с указанным объектом ~~Ключ-АСТРОМ~~.		\|Фильтрует результирующий набор событий до событий, связанных с указанным объектом АппОптима.
	\|запрос		\|запрос
	\|необязательный		\|необязательный
Строка 272:		Строка 272:
	\|entityId		\|entityId
	\|string		\|string
	\|Идентификатор затронутого объекта ~~Ключ-Астром~~.		\|Идентификатор затронутого объекта АппОптима.
	Может быть <code>null</code>.		Может быть <code>null</code>.
	\|-		\|-
	\|entityName		\|entityName
	\|string		\|string
	\|Имя затронутого объекта ~~Ключ-Астром~~.		\|Имя затронутого объекта АппОптима.
	Может быть <code>null</code>.		Может быть <code>null</code>.
	\|-		\|-
Строка 322:		Строка 322:
	*<code>DEPLOYMENT_CHANGED_NEW</code>		*<code>DEPLOYMENT_CHANGED_NEW</code>
	*<code>DEPLOYMENT_CHANGED_REMOVED</code>		*<code>DEPLOYMENT_CHANGED_REMOVED</code>
	*<code>~~ASTROMKEY_INTERNAL~~</code>		*<code>AppOptima_INTERNAL</code>
	*<code>EBS_VOLUME_HIGH_LATENCY</code>		*<code>EBS_VOLUME_HIGH_LATENCY</code>
	*<code>ELASTIC_LOAD_BALANCER_HIGH_BACKEND_FAILURE_RATE</code>		*<code>ELASTIC_LOAD_BALANCER_HIGH_BACKEND_FAILURE_RATE</code>
Строка 451:		Строка 451:
	\|tags		\|tags
	\|TagInfo[]		\|TagInfo[]
	\|Теги объекта ~~Ключ-АСТРОМ~~, вызвавшего событие.		\|Теги объекта АппОптима, вызвавшего событие.
	Может быть <code>null</code>.		Может быть <code>null</code>.
	\|-		\|-
Строка 462:		Строка 462:
	\|}		\|}
	====Объект <code>TagInfo</code>====		====Объект <code>TagInfo</code>====
	Тег объекта ~~Ключ-АСТРОМ~~.		Тег объекта АппОптима.
	{\| class="wikitable"		{\| class="wikitable"
	!Элемент		!Элемент
Строка 496:		Строка 496:
	\|}		\|}
	===JSON-модель тела ответа===		===JSON-модель тела ответа===
	<~~code>~~{		<{
	"nextCursor": "AgEBAAFn5IIFrgEAAAFofwDTrgAAAQAcMTY4N2RhYzViZTAtZmUxODEwOWQ5YTA1MTIyNQ%3D%3D",		"nextCursor": "AgEBAAFn5IIFrgEAAAFofwDTrgAAAQAcMTY4N2RhYzViZTAtZmUxODEwOWQ5YTA1MTIyNQ%3D%3D",
	"from": 1521042929000,		"from": 1521042929000,
Строка 545:		Строка 545:
	Маркер API передается в заголовке авторизации .		Маркер API передается в заголовке авторизации .
	====Curl====		====Curl====
	<~~code>~~curl -X GET \		<curl -X GET \
	'<nowiki>https://mySampleEnv.live.~~astromkey~~.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day'</nowiki> \		'<nowiki>https://mySampleEnv.live.AppOptima.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day'</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>
	====URL-адрес запроса====		====URL-адрес запроса====
	<code><nowiki>https://mySampleEnv.live.~~astromkey~~.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day</nowiki></code>		<code><nowiki>https://mySampleEnv.live.AppOptima.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day</nowiki></code>
	====Содержание ответа====		====Содержание ответа====
	<~~code>~~{		<{
	"nextEventStartTms": null,		"nextEventStartTms": null,
	"nextEventId": null,		"nextEventId": null,

ENetrebin в 16:03, 6 июня 2024

2024-06-06T16:03:52Z

← Предыдущая версия		Версия от 16:03, 6 июня 2024
Строка 1:		Строка 1:
	'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B\|Эндпойнты среды]] / [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 Развёртывание] / GET ленты событий'''''		'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B\|Эндпойнты среды]] / [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 Развёртывание] / События v1 / GET ленты событий'''''

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

ENetrebin: Новая страница: «'''''API Ключ-АСТРОМ / API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B|Эндп...»

2024-06-06T15:57:25Z

Новая страница: «'''''API Ключ-АСТРОМ / API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B|Эндп...»

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

'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B|Эндпойнты среды]] / [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 Развёртывание] / GET ленты событий'''''

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

Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="2" |GET
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/events</nowiki></code>
|-
|Среда АктивногоШлюза
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v1/events</nowiki></code>
|}
==Аутентификация==
Чтобы выполнить этот запрос, вам необходимо разрешение на '''Доступ к ленте проблем, событий, метрик и топологий''' ( <code>DataExport</code>) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .
==Параметры==
{| class="wikitable"
!Параметр
!Тип
!Описание
!In
!Необходимость
|-
|from
|integer
|Отметка времени начала запроса в миллисекундах UTC.
Используется значение "30 дней назад", если не задано значение relativeTime .
|запрос
|необязательный
|-
|to
|integer
|Конечная метка времени запроса в миллисекундах UTC.
Используется текущая временная метка, если не задано значение relativeTime .

Срок не должен превышать 2 лет.
|запрос
|необязательный
|-
|relativeTime
|string
|Относительный таймфрейм, назад от текущего времени.
Элемент может содержать эти значения
*<code>10mins</code>
*<code>15mins</code>
*<code>2hours</code>
*<code>30mins</code>
*<code>3days</code>
*<code>5mins</code>
*<code>6hours</code>
*<code>day</code>
*<code>hour</code>
*<code>min</code>
*<code>month</code>
*<code>week</code>
|запрос
|необязательный
|-
|eventType
|string
|Фильтрует результирующий набор событий по типу события.
Элемент может содержать эти значения
*<code>APPLICATION_JS_FRAMEWORK_DETECTED</code>
*<code>APPLICATION_OVERLOAD_PREVENTION</code>
*<code>AVAILABILITY_EVENT</code>
*<code>CONNECTION_LOST</code>
*<code>CPU_SATURATED</code>
*<code>CUSTOM_ALERT</code>
*<code>CUSTOM_ANNOTATION</code>
*<code>CUSTOM_APPLICATION_OVERLOAD_PREVENTION</code>
*<code>CUSTOM_APP_CRASH_RATE_INCREASED</code>
*<code>CUSTOM_CONFIGURATION</code>
*<code>CUSTOM_DEPLOYMENT</code>
*<code>CUSTOM_INFO</code>
*<code>DATABASE_CONNECTION_FAILURE</code>
*<code>DEPLOYMENT_CHANGED_CHANGE</code>
*<code>DEPLOYMENT_CHANGED_NEW</code>
*<code>DEPLOYMENT_CHANGED_REMOVED</code>
*<code>ASTROMKEY_INTERNAL</code>
*<code>EBS_VOLUME_HIGH_LATENCY</code>
*<code>ELASTIC_LOAD_BALANCER_HIGH_BACKEND_FAILURE_RATE</code>
*<code>ELASTIC_LOAD_BALANCER_HIGH_FAILURE_RATE</code>
*<code>ELASTIC_LOAD_BALANCER_HIGH_UNHEALTHY_HOST_RATE</code>
*<code>ERROR_EVENT</code>
*<code>ESXI_HOST_VM_MOTION_ARRIVED</code>
*<code>ESXI_HOST_VM_MOTION_LEFT</code>
*<code>ESXI_HOST_VM_STARTED</code>
*<code>ESXI_START</code>
*<code>ESXI_VM_DISCONNECTED</code>
*<code>ESXI_VM_MOTION</code>
*<code>ESXI_VM_POWER_OFF</code>
*<code>ESXI_VM_START</code>
*<code>FAILURE_RATE_INCREASED</code>
*<code>HIGH_CONNECTIVITY_FAILURES</code>
*<code>HIGH_DROPPED_PACKETS_RATE</code>
*<code>HIGH_GC_ACTIVITY</code>
*<code>HIGH_LATENCY</code>
*<code>HIGH_NETWORK_ERROR_RATE</code>
*<code>HIGH_NETWORK_LOSS_RATE</code>
*<code>HIGH_NETWORK_UTILIZATION</code>
*<code>HOST_CONNECTION_FAILED</code>
*<code>HOST_CONNECTION_LOST</code>
*<code>HOST_DATASTORE_LOW_DISK_SPACE</code>
*<code>HOST_DISK_LOW_INODES</code>
*<code>HOST_GRACEFULLY_SHUTDOWN</code>
*<code>HOST_LOG_AVAILABILITY</code>
*<code>HOST_LOG_ERROR</code>
*<code>HOST_LOG_MATCHED</code>
*<code>HOST_LOG_PERFORMANCE</code>
*<code>HOST_MAINTENANCE</code>
*<code>HOST_NO_CONNECTION</code>
*<code>HOST_OF_SERVICE_UNAVAILABLE</code>
*<code>HOST_SHUTDOWN</code>
*<code>HOST_TIMEOUT</code>
*<code>HTTP_CHECK_GLOBAL_OUTAGE</code>
*<code>HTTP_CHECK_LOCAL_OUTAGE</code>
*<code>HTTP_CHECK_TEST_LOCATION_SLOWDOWN</code>
*<code>INSUFFICIENT_DISK_QUEUE_DEPTH</code>
*<code>JAVASCRIPT_ERROR_RATE_INCREASED</code>
*<code>LAMBDA_FUNCTION_HIGH_ERROR_RATE</code>
*<code>LOG_AVAILABILITY</code>
*<code>LOG_ERROR</code>
*<code>LOG_MATCHED</code>
*<code>LOG_PERFORMANCE</code>
*<code>LOW_DISK_SPACE</code>
*<code>LOW_STORAGE_SPACE</code>
*<code>MARKED_FOR_TERMINATION</code>
*<code>MEMORY_RESOURCES_EXHAUSTED</code>
*<code>MEMORY_SATURATED</code>
*<code>MOBILE_APPLICATION_OVERLOAD_PREVENTION</code>
*<code>MOBILE_APP_CRASH_RATE_INCREASED</code>
*<code>MONITORING_UNAVAILABLE</code>
*<code>OPENSTACK_HOST_VM_SHUTDOWN</code>
*<code>OPENSTACK_HOST_VM_STARTED</code>
*<code>OPENSTACK_KEYSTONE_SLOW</code>
*<code>OPENSTACK_KEYSTONE_UNHEALTHY</code>
*<code>OPENSTACK_VM_LAUNCH_FAILED</code>
*<code>OPENSTACK_VM_MOTION</code>
*<code>OSI_DOCKER_DEVICEMAPPER_LOW_DATA_SPACE</code>
*<code>OSI_DOCKER_DEVICEMAPPER_LOW_METADATA_SPACE</code>
*<code>OVERLOADED_STORAGE</code>
*<code>PERFORMANCE_EVENT</code>
*<code>PGI_CRASHED_INFO</code>
*<code>PGI_HAPROXY_QUEUED_REQUESTS_HIGH</code>
*<code>PGI_HAPROXY_SESSION_USAGE_HIGH</code>
*<code>PGI_LOG_MATCHED</code>
*<code>PGI_MEMDUMP</code>
*<code>PGI_MYSQL_SLOW_QUERIES_RATE_HIGH</code>
*<code>PGI_OF_SERVICE_UNAVAILABLE</code>
*<code>PGI_RMQ_HIGH_FILE_DESC_USAGE</code>
*<code>PGI_RMQ_HIGH_MEM_USAGE</code>
*<code>PGI_RMQ_HIGH_PROCESS_USAGE</code>
*<code>PGI_RMQ_HIGH_SOCKETS_USAGE</code>
*<code>PGI_RMQ_LOW_DISK_SPACE</code>
*<code>PROCESS_CRASHED</code>
*<code>PROCESS_CUSTOM_AVAILABILITY</code>
*<code>PROCESS_CUSTOM_ERROR</code>
*<code>PROCESS_CUSTOM_PERFORMANCE</code>
*<code>PROCESS_GROUP_LOW_INSTANCE_COUNT</code>
*<code>PROCESS_LOG_AVAILABILITY</code>
*<code>PROCESS_LOG_ERROR</code>
*<code>PROCESS_LOG_PERFORMANCE</code>
*<code>PROCESS_RESTART</code>
*<code>PROCESS_UNAVAILABLE</code>
*<code>RDS_AZ_FAILOVER_COMPLETED</code>
*<code>RDS_AZ_FAILOVER_STARTED</code>
*<code>RDS_BACKUP_COMPLETED</code>
*<code>RDS_BACKUP_STARTED</code>
*<code>RDS_OF_SERVICE_UNAVAILABLE</code>
*<code>RDS_RESTART</code>
*<code>RDS_RESTART_SEQUENCE</code>
*<code>RESOURCE_CONTENTION</code>
*<code>SERVICE_RESPONSE_TIME_DEGRADED</code>
*<code>SLOW_DISK</code>
*<code>SYNTHETIC_AVAILABILITY</code>
*<code>SYNTHETIC_NODE_OUTAGE</code>
*<code>SYNTHETIC_PRIVATE_LOCATION_OUTAGE</code>
*<code>SYNTHETIC_SLOWDOWN</code>
*<code>THREADS_RESOURCES_EXHAUSTED</code>
*<code>UNEXPECTED_HIGH_LOAD</code>
*<code>UNEXPECTED_LOW_LOAD</code>
*<code>USER_ACTION_DURATION_DEGRADATION</code>
*<code>VIRTUAL_MACHINE_SHUTDOWN</code>
*<code>WEB_CHECK_GLOBAL_OUTAGE</code>
*<code>WEB_CHECK_LOCAL_OUTAGE</code>
|запрос
|необязательный
|-
|entityId
|string
|Фильтрует результирующий набор событий до событий, связанных с указанным объектом Ключ-АСТРОМ.
|запрос
|необязательный
|-
|cursor
|string
|Ответ ограничен 150 событиями, поэтому, если вы хотите получить больше, вы можете использовать курсор, чтобы получить следующие 150. Этот параметр должен быть пустым при первом запросе.
Клавиша курсора затем может быть найдена в поле nextCursor предыдущего ответа.

При использовании строки курсора нет необходимости указывать дополнительные параметры, так как эта информация уже закодирована внутри курсора.
|запрос
|необязательный
|}
==Ответ==
Каждое событие содержит как минимум следующие элементы метаинформации и свойства, относящиеся к событию.
===Коды ответов===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|Результат запроса события
|Успех
|}
===Объекты тела ответа===
====Объект<code>EventQueryResult</code>====
События среды.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|nextCursor
|string
|Курсор для следующих 150 событий, соответствующих указанным критериям.
Установите это значение для параметра запроса курсора . Без него вы снова получите первые 150 событий.

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

Может быть <code>null</code>.
|-
|from
|integer
|Начало периода запроса.
Может быть <code>null</code>.
|-
|to
|integer
|Конец периода запроса.
Может быть <code>null</code>.
|-
|totalEventCount
|integer
|Общее количество событий, соответствующих заданным критериям.
Может быть <code>null</code>.
|-
|events
|EventRestEntry[]
|Список событий.
Может быть <code>null</code>.
|}
====Объект <code>EventRestEntry</code>====
Набор параметров события.

Помимо общих свойств, упомянутых здесь, которые есть у каждого события, фактическое событие имеет набор метаданных, которые различаются в зависимости от типа события.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|startTime
|integer
|Отметка времени обнаружения события в миллисекундах UTC.
Может быть <code>null</code>.
|-
|startTime
|integer
|Отметка времени закрытия события в миллисекундах UTC.
Может быть <code>null</code>.
|-
|entityId
|string
|Идентификатор затронутого объекта Ключ-Астром.
Может быть <code>null</code>.
|-
|entityName
|string
|Имя затронутого объекта Ключ-Астром.
Может быть <code>null</code>.
|-
|severityLevel
|string
|Тяжесть события.
Элемент может содержать эти значения
*<code>AVAILABILITY</code>
*<code>CUSTOM_ALERT</code>
*<code>ERROR</code>
*<code>MONITORING_UNAVAILABLE</code>
*<code>PERFORMANCE</code>
*<code>RESOURCE_CONTENTION</code>
Может быть <code>null</code>.
|-
|impactLevel
|string
|Уровень воздействия события. Он показывает, на что влияет проблема: на инфраструктуру, службу или приложение.
Элемент может содержать эти значения
*<code>APPLICATION</code>
*<code>ENVIRONMENT</code>
*<code>INFRASTRUCTURE</code>
*<code>SERVICE</code>
Может быть <code>null</code>.
|-
|eventType
|string
|Тип события.
Элемент может содержать эти значения
*<code>APPLICATION_JS_FRAMEWORK_DETECTED</code>
*<code>APPLICATION_OVERLOAD_PREVENTION</code>
*<code>AVAILABILITY_EVENT</code>
*<code>CONNECTION_LOST</code>
*<code>CPU_SATURATED</code>
*<code>CUSTOM_ALERT</code>
*<code>CUSTOM_ANNOTATION</code>
*<code>CUSTOM_APPLICATION_OVERLOAD_PREVENTION</code>
*<code>CUSTOM_APP_CRASH_RATE_INCREASED</code>
*<code>CUSTOM_CONFIGURATION</code>
*<code>CUSTOM_DEPLOYMENT</code>
*<code>CUSTOM_INFO</code>
*<code>DATABASE_CONNECTION_FAILURE</code>
*<code>DEPLOYMENT_CHANGED_CHANGE</code>
*<code>DEPLOYMENT_CHANGED_NEW</code>
*<code>DEPLOYMENT_CHANGED_REMOVED</code>
*<code>ASTROMKEY_INTERNAL</code>
*<code>EBS_VOLUME_HIGH_LATENCY</code>
*<code>ELASTIC_LOAD_BALANCER_HIGH_BACKEND_FAILURE_RATE</code>
*<code>ELASTIC_LOAD_BALANCER_HIGH_FAILURE_RATE</code>
*<code>ELASTIC_LOAD_BALANCER_HIGH_UNHEALTHY_HOST_RATE</code>
*<code>ERROR_EVENT</code>
*<code>ESXI_HOST_VM_MOTION_ARRIVED</code>
*<code>ESXI_HOST_VM_MOTION_LEFT</code>
*<code>ESXI_HOST_VM_STARTED</code>
*<code>ESXI_START</code>
*<code>ESXI_VM_DISCONNECTED</code>
*<code>ESXI_VM_MOTION</code>
*<code>ESXI_VM_POWER_OFF</code>
*<code>ESXI_VM_START</code>
*<code>FAILURE_RATE_INCREASED</code>
*<code>HIGH_CONNECTIVITY_FAILURES</code>
*<code>HIGH_DROPPED_PACKETS_RATE</code>
*<code>HIGH_GC_ACTIVITY</code>
*<code>HIGH_LATENCY</code>
*<code>HIGH_NETWORK_ERROR_RATE</code>
*<code>HIGH_NETWORK_LOSS_RATE</code>
*<code>HIGH_NETWORK_UTILIZATION</code>
*<code>HOST_CONNECTION_FAILED</code>
*<code>HOST_CONNECTION_LOST</code>
*<code>HOST_DATASTORE_LOW_DISK_SPACE</code>
*<code>HOST_DISK_LOW_INODES</code>
*<code>HOST_GRACEFULLY_SHUTDOWN</code>
*<code>HOST_LOG_AVAILABILITY</code>
*<code>HOST_LOG_ERROR</code>
*<code>HOST_LOG_MATCHED</code>
*<code>HOST_LOG_PERFORMANCE</code>
*<code>HOST_MAINTENANCE</code>
*<code>HOST_NO_CONNECTION</code>
*<code>HOST_OF_SERVICE_UNAVAILABLE</code>
*<code>HOST_SHUTDOWN</code>
*<code>HOST_TIMEOUT</code>
*<code>HTTP_CHECK_GLOBAL_OUTAGE</code>
*<code>HTTP_CHECK_LOCAL_OUTAGE</code>
*<code>HTTP_CHECK_TEST_LOCATION_SLOWDOWN</code>
*<code>INSUFFICIENT_DISK_QUEUE_DEPTH</code>
*<code>JAVASCRIPT_ERROR_RATE_INCREASED</code>
*<code>LAMBDA_FUNCTION_HIGH_ERROR_RATE</code>
*<code>LOG_AVAILABILITY</code>
*<code>LOG_ERROR</code>
*<code>LOG_MATCHED</code>
*<code>LOG_PERFORMANCE</code>
*<code>LOW_DISK_SPACE</code>
*<code>LOW_STORAGE_SPACE</code>
*<code>MARKED_FOR_TERMINATION</code>
*<code>MEMORY_RESOURCES_EXHAUSTED</code>
*<code>MEMORY_SATURATED</code>
*<code>MOBILE_APPLICATION_OVERLOAD_PREVENTION</code>
*<code>MOBILE_APP_CRASH_RATE_INCREASED</code>
*<code>MONITORING_UNAVAILABLE</code>
*<code>OPENSTACK_HOST_VM_SHUTDOWN</code>
*<code>OPENSTACK_HOST_VM_STARTED</code>
*<code>OPENSTACK_KEYSTONE_SLOW</code>
*<code>OPENSTACK_KEYSTONE_UNHEALTHY</code>
*<code>OPENSTACK_VM_LAUNCH_FAILED</code>
*<code>OPENSTACK_VM_MOTION</code>
*<code>OSI_DOCKER_DEVICEMAPPER_LOW_DATA_SPACE</code>
*<code>OSI_DOCKER_DEVICEMAPPER_LOW_METADATA_SPACE</code>
*<code>OVERLOADED_STORAGE</code>
*<code>PERFORMANCE_EVENT</code>
*<code>PGI_CRASHED_INFO</code>
*<code>PGI_HAPROXY_QUEUED_REQUESTS_HIGH</code>
*<code>PGI_HAPROXY_SESSION_USAGE_HIGH</code>
*<code>PGI_LOG_MATCHED</code>
*<code>PGI_MEMDUMP</code>
*<code>PGI_MYSQL_SLOW_QUERIES_RATE_HIGH</code>
*<code>PGI_OF_SERVICE_UNAVAILABLE</code>
*<code>PGI_RMQ_HIGH_FILE_DESC_USAGE</code>
*<code>PGI_RMQ_HIGH_MEM_USAGE</code>
*<code>PGI_RMQ_HIGH_PROCESS_USAGE</code>
*<code>PGI_RMQ_HIGH_SOCKETS_USAGE</code>
*<code>PGI_RMQ_LOW_DISK_SPACE</code>
*<code>PROCESS_CRASHED</code>
*<code>PROCESS_CUSTOM_AVAILABILITY</code>
*<code>PROCESS_CUSTOM_ERROR</code>
*<code>PROCESS_CUSTOM_PERFORMANCE</code>
*<code>PROCESS_GROUP_LOW_INSTANCE_COUNT</code>
*<code>PROCESS_LOG_AVAILABILITY</code>
*<code>PROCESS_LOG_ERROR</code>
*<code>PROCESS_LOG_PERFORMANCE</code>
*<code>PROCESS_RESTART</code>
*<code>PROCESS_UNAVAILABLE</code>
*<code>RDS_AZ_FAILOVER_COMPLETED</code>
*<code>RDS_AZ_FAILOVER_STARTED</code>
*<code>RDS_BACKUP_COMPLETED</code>
*<code>RDS_BACKUP_STARTED</code>
*<code>RDS_OF_SERVICE_UNAVAILABLE</code>
*<code>RDS_RESTART</code>
*<code>RDS_RESTART_SEQUENCE</code>
*<code>RESOURCE_CONTENTION</code>
*<code>SERVICE_RESPONSE_TIME_DEGRADED</code>
*<code>SLOW_DISK</code>
*<code>SYNTHETIC_AVAILABILITY</code>
*<code>SYNTHETIC_NODE_OUTAGE</code>
*<code>SYNTHETIC_PRIVATE_LOCATION_OUTAGE</code>
*<code>SYNTHETIC_SLOWDOWN</code>
*<code>THREADS_RESOURCES_EXHAUSTED</code>
*<code>UNEXPECTED_HIGH_LOAD</code>
*<code>UNEXPECTED_LOW_LOAD</code>
*<code>USER_ACTION_DURATION_DEGRADATION</code>
*<code>VIRTUAL_MACHINE_SHUTDOWN</code>
*<code>WEB_CHECK_GLOBAL_OUTAGE</code>
*<code>WEB_CHECK_LOCAL_OUTAGE</code>
Может быть <code>null</code>.
|-
|resourceId
|string
|Идентификатор ресурса, на котором произошло событие.
Может быть <code>null</code>.
|-
|resourceName
|string
|Имя ресурса, на котором произошло событие.
Может быть <code>null</code>.
|-
|eventStatus
|string
|Состояние мероприятия: открытое или закрытое.
Элемент может содержать эти значения
*<code>CLOSED</code>
*<code>OPEN</code>
Может быть <code>null</code>.
|-
|tags
|TagInfo[]
|Теги объекта Ключ-АСТРОМ, вызвавшего событие.
Может быть <code>null</code>.
|-
|id
|string
|Закодированный идентификатор события. Формат — ''eventID_startTime'' .
Вы должны использовать значение из этого поля, когда вам нужен идентификатор события.

Может быть <code>null</code>.
|}
====Объект <code>TagInfo</code>====
Тег объекта Ключ-АСТРОМ.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|context
|string
|Происхождение тега, например AWS или Cloud Foundry.
Пользовательские теги используют это <code>CONTEXTLESS</code>значение.

Элемент может содержать эти значения
*<code>AWS</code>
*<code>AWS_GENERIC</code>
*<code>AZURE</code>
*<code>CLOUD_FOUNDRY</code>
*<code>CONTEXTLESS</code>
*<code>ENVIRONMENT</code>
*<code>GOOGLE_CLOUD</code>
*<code>KUBERNETES</code>
|-
|key
|string
|Ключ тега.
Пользовательские теги имеют значение тега здесь.
|-
|value
|string
|Значение тега.
Не применимо к пользовательским тегам.

Может быть <code>null</code>.
|}
===JSON-модель тела ответа===
<code>{
"nextCursor": "AgEBAAFn5IIFrgEAAAFofwDTrgAAAQAcMTY4N2RhYzViZTAtZmUxODEwOWQ5YTA1MTIyNQ%3D%3D",
"from": 1521042929000,
"to": 1521542929000,
"totalEventCount": 2,
"events": [
{
"startTime": 1521042929000,
"endTime": 1521542929000,
"entityId": "HOST-0000000000000007",
"entityName": "Example Host",
"severityLevel": "PERFORMANCE",
"impactLevel": "INFRASTRUCTURE",
"eventType": "SLOW_DISK",
"eventStatus": "OPEN",
"tags": [
{
"context": "CONTEXTLESS",
"key": "exampleTag"
}
],
"id": "5915682011263205071_1521042929000",
"source": "builtin"
},
{
"startTime": 1521042929000,
"endTime": 1521542929000,
"entityId": "HOST-0000000000000007",
"entityName": "Example Host",
"severityLevel": "PERFORMANCE",
"impactLevel": "INFRASTRUCTURE",
"eventType": "SLOW_DISK",
"eventStatus": "OPEN",
"tags": [
{
"context": "CONTEXTLESS",
"key": "exampleTag"
}
],
"id": "5915682011263205071_1521042929000",
"source": "builtin"
}
]
}</code>
==Пример==
В этом примере запрос запрашивает все события ERROR_EVENT , произошедшие за последние 24 часа . Результат усекается до двух событий.

Маркер API передается в заголовке авторизации .
====Curl====
<code>curl -X GET \
'<nowiki>https://mySampleEnv.live.astromkey.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day'</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>
====URL-адрес запроса====
<code><nowiki>https://mySampleEnv.live.astromkey.com/api/v1/events?eventType=ERROR_EVENT&relativeTime=day</nowiki></code>
====Содержание ответа====
<code>{
"nextEventStartTms": null,
"nextEventId": null,
"nextCursor": null,
"from": 1530703635653,
"to": 1533295635653,
"totalEventCount": 25,
"events": [
{
"eventId": -8338439733889003014,
"startTime": 1532328338475,
"endTime": 1532328638475,
"entityId": "HOST-E4D1E5F46E239F21",
"entityName": "l-8.dyna.trace",
"severityLevel": "ERROR",
"impactLevel": "INFRASTRUCTURE",
"eventType": "ERROR_EVENT",
"eventStatus": "CLOSED",
"tags": [
{
"context": "CONTEXTLESS",
"key": "deploy"
},
{
"context": "CONTEXTLESS",
"key": "room23"
}
],
"id": "-8338439733889003014_1532328338475",
"annotationDescription": "testTrigger",
"correlationId": "67da0a4293956e55",
"source": "restTest"
},
{
"eventId": 3092227520312561338,
"startTime": 1531832640600,
"endTime": 1531836240600,
"entityId": "HOST-CE6A2253598EA88D",
"entityName": "q2.docker.l5",
"severityLevel": "ERROR",
"impactLevel": "INFRASTRUCTURE",
"eventType": "ERROR_EVENT",
"eventStatus": "CLOSED",
"tags": [
{
"context": "CONTEXTLESS",
"key": "ServiceNow"
}
],
"id": "3092227520312561338_1531832640600",
"customProperties": {
"Property 2": "value 2",
"Property 1": "value 1",
"Property 3": "value 3"
},
"annotationDescription": "package is damaged",
"correlationId": "1b79973c6902b486",
"source": "myAPI"
}
]
}</code>
====Код ответа====
200