Просмотр кода страницы Получение события

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

Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="3" |GET
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/events/{eventId}</nowiki></code>
|-
|SaaS
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v1/events/{eventId}</nowiki></code>
|-
|Evironment АктивыйШлюз
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v1/events/{eventId}</nowiki></code>
|}

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

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Необходимость
|-
|eventId
|string
|ID требуемого события.
|path
|требуется
|}

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|EventRestEntry
|Успех
|}

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

==== Объект _ <code>EventRestEntry</code> ====
Набор параметров события.

Помимо общих свойств, упомянутых здесь, которые есть у каждого события, фактическое событие имеет набор метаданных, которые различаются в зависимости от типа события.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|startTime
|integer
|Отметка времени обнаружения события в миллисекундах UTC.

Может быть <code>null</code>.
|-
|endTime
|integer
|Отметка времени закрытия события в миллисекундах UTC.

Может быть <code>null</code>.
|-
|entityId
|string
|Идентификатор затронутого объекта Dynatrace.

Может быть <code>null</code>.
|-
|entityName
|string
|Имя затронутого объекта Dynatrace.

Может быть <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>DYNATRACE_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[]
|Теги объекта Dynatrace, вызвавшего событие.

Может быть <code>null</code>.
|-
|id
|string
|Закодированный идентификатор события. Формат — ''eventID_startTime'' .

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

Может быть <code>null</code>.
|}

==== Объект _ <code>TagInfo</code> ====
Тег сущности Dynatrace.
{| 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>{
   "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>

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

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

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

==== Curl ====
 <code>curl -X GET \
   <nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/events/4166694657638834567_1533134704285</nowiki> \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>

==== URL-адрес запроса ====
 <code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/events/4166694657638834567_1533134704285</nowiki></code>

==== Содержание ответа ====
 <code>{
   "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": "<nowiki>http://tower.local/job/RemediateJob/38/</nowiki>",
   "deploymentVersion": "1.23.321",
   "deploymentName": "easyTravel service deployment",
   "source": "ServiceNow",
   "ciBackLink": "<nowiki>http://tower.local/job/DeployJob/38/artifact/build/Deployment-v1.23.321.zip</nowiki>"
 }</code>

==== Код ответа ====
200