Получение события

Перечисляет параметры указанного события.

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

GET	АппОптима	https://{your-domain}/e/{your-environment-id}/api/v1/events/{eventId}
	Среда АктивногоШлюза	https://{your-activegate-domain}/e/{your-environment-id}/api/v1/events/{eventId}

Аутентификация

Чтобы выполнить этот запрос , вам необходимо разрешение на проблему с доступом и канал событий, метрики и топологию ( DataExport) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр	Тип	Описание	В	Необходимость
eventId	string	ID требуемого события.	path	требуется

Ответ

Коды ответов

Код	Тип	Описание
200	EventRestEntry	Успех

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

Объект _ EventRestEntry

Набор параметров события.

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

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

Объект _ TagInfo

Тег сущности АппОптима.

Элемент	Тип	Описание
context	string	Происхождение тега, например AWS или Cloud Foundry. Пользовательские теги используют это CONTEXTLESSзначение. Элемент может содержать эти значения AWS AWS_GENERIC AZURE CLOUD_FOUNDRY CONTEXTLESS ENVIRONMENT GOOGLE_CLOUD KUBERNETES
key	string	Ключ тега. Пользовательские теги имеют значение тега здесь.
value	string	Значение тега. Не применимо к пользовательским тегам. Может быть null.

JSON-модель тела ответа

<{
  "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"
}

Пример

В этом примере запрос запрашивает параметры события с идентификатором 4166694657638834567_1533134704285 .

Это служба, на которую влияет событие CUSTOM_DEPLOYMENT , и она помечена пользовательским тегом развертывания .

Маркер API передается в заголовке авторизации .

Curl

<curl -X GET \
  https://mySampleEnv.live.ruscomtech.ru/api/v1/events/4166694657638834567_1533134704285 \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

URL-адрес запроса

https://mySampleEnv.live.ruscomtech.ru/api/v1/events/4166694657638834567_1533134704285

Содержание ответа

<{
  "eventId": 4166694657638834567,
  "startTime": 1533134704285,
  "endTime": 1533134704285,
  "entityId": "SERVICE-0F579DCA105F190C",
  "entityName": "wmqiTestingWeb",
  "severityLevel": null,
  "impactLevel": "SERVICE",
  "eventType": "CUSTOM_DEPLOYMENT",
  "eventStatus": "CLOSED",
  "tags": [
    {
      "context": "CONTEXTLESS",
      "key": "deploy"
    }
  ],
  "id": "4166694657638834567_1533134704285",
  "customProperties": {
    "Build Number": "1.223.23432",
    "Owner": "Jason Miller (jason.miller@easytravel.com)",
    "Approver": "Alice McBright (alice.mcbright@easytravel.com)",
    "Git commit": "e5afbftc7eb"
  },
  "deploymentProject": "easyTravel service",
  "remediationAction": "http://tower.local/job/RemediateJob/38/",
  "deploymentVersion": "1.23.321",
  "deploymentName": "easyTravel service deployment",
  "source": "ServiceNow",
  "ciBackLink": "http://tower.local/job/DeployJob/38/artifact/build/Deployment-v1.23.321.zip"
}

Код ответа

200