Events API v2 - GET an event
Gets all properties of the specified event.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v2/events/{eventId} |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/events/{eventId} | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/events/{eventId} |
Authentication
To execute this request, you need an access token with events.read
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
eventId | string | The ID of the required event. | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | Event | Success. The response contains the configuration of the event. |
Response body objects
The Event
object
Configuration of an event.
Element | Type | Description |
---|---|---|
frequentEvent | boolean | If A frequent event doesn't raise a problem. |
suppressProblem | boolean | The problem detection status during a maintenance:
|
suppressAlert | boolean | The alerting status during a maintenance:
|
underMaintenance | boolean | If |
managementZones | Management | A list of all management zones that the event belongs to. |
entityId | Entity | A short representation of a monitored entity. |
entityTags | M | A list of tags of the related entity. |
eventType | string | The type of the event. |
eventId | string | The ID of the event. |
properties | Event | A list of event properties. |
status | string | The status of the event. |
startTime | integer | The timestamp when the event was raised, in UTC milliseconds. |
endTime | integer | The timestamp when the event was closed, in UTC milliseconds. Has the value of |
title | string | The title of the event. |
correlationId | string | The correlation ID of the event. |
The ManagementZone
object
A short representation of a management zone.
Element | Type | Description |
---|---|---|
name | string | The name of the management zone. |
id | string | The ID of the management zone. |
The EntityStub
object
A short representation of a monitored entity.
Element | Type | Description |
---|---|---|
entityId | Entity | A short representation of a monitored entity. |
name | string | The name of the entity. Not included in the response in case no entity with the relevant ID was found. |
The EntityId
object
A short representation of a monitored entity.
Element | Type | Description |
---|---|---|
id | string | The ID of the entity. |
type | string | The type of the entity. |
The METag
object
The tag of a monitored entity.
Element | Type | Description |
---|---|---|
stringRepresentation | string | The string representation of the tag. |
value | string | The value of the tag. |
key | string | The key of the tag. |
context | string | The origin of the tag, such as AWS or Cloud Foundry. Custom tags use the |
The EventProperty
object
A property of an event.
Element | Type | Description |
---|---|---|
value | string | The value of the event property. |
key | string | The key of the event property. |
Response body JSON model
{
"frequentEvent": true,
"suppressProblem": true,
"suppressAlert": true,
"underMaintenance": true,
"managementZones": [
{
"name": "string",
"id": "string"
}
],
"entityId": {
"entityId": {
"id": "string",
"type": "string"
},
"name": "string"
},
"entityTags": [
{
"stringRepresentation": "string",
"value": "string",
"key": "string",
"context": "string"
}
],
"eventType": "LOW_DISK_SPACE",
"eventId": "4293884258445543163_1564039524182",
"properties": [
{
"value": "string",
"key": "string"
}
],
"status": "OPEN",
"startTime": 1564039524182,
"endTime": 1564039524182,
"title": "High CPU load on host X",
"correlationId": "933613657e1c8fcf"
}
Example
In this example, the request queries the parameters of the event with the ID of 6375436663535938547_1628496488654.
This is the SYNTHETIC_GLOBAL_OUTAGE event, indicating global outage of browser monitors.
The API token is passed in the Authorization header.
Curl
curl --request GET \
--url https://mySampleEnv.live.dynatrace.com/api/v2/events/6375436663535938547_1628496488654 \
--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com/api/v2/events/6375436663535938547_1628496488654
Response body
{
"eventId": "6375436663535938547_1628496488654",
"startTime": 1628496488654,
"endTime": 1628503679796,
"eventType": "SYNTHETIC_GLOBAL_OUTAGE",
"title": "Browser monitor global outage",
"entityId": {
"entityId": {
"id": "SYNTHETIC_TEST-03ABB7F6446D1727",
"type": "SYNTHETIC_TEST"
},
"name": "Maintenance window test"
},
"properties": [
{
"key": "dt.event.group_label",
"value": "Browser monitor global outage"
},
{
"key": "dt.event.is_rootcause_relevant",
"value": "true"
}
],
"status": "CLOSED",
"correlationId": "aecd1653df38ef50",
"entityTags": [
{
"context": "CONTEXTLESS",
"key": "Synthetic",
"value": "Browser",
"stringRepresentation": "Synthetic:Browser"
}
],
"managementZones": [
{
"id": "-7832237287622819191",
"name": "Synthetic tests"
}
],
"underMaintenance": true,
"suppressAlert": false,
"suppressProblem": false,
"frequentEvent": false
}
Response code
200