Events API v2 - GET an event
Gets all properties of the specified event.
The request produces an application/json payload.
| GET | Managed | 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 Read events (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 |
|---|---|---|
| managementZones | Management | A list of all management zones that the event belongs to. Can be |
| underMaintenance | boolean | If Can be |
| suppressAlert | boolean | The alerting status during a maintenance:
Can be |
| suppressProblem | boolean | The problem detection status during a maintenance:
Can be |
| frequentEvent | boolean | If A frequent event doesn't raise a problem. Can be |
| entityId | Entity | A short representation of a monitored entity. Can be |
| eventId | string | The ID of the event. Can be |
| entityTags | M | A list of tags of the related entity. Can be |
| eventType | string | The type of the event. Can be |
| properties | Event | A list of event properties. Can be |
| status | string | The status of the event. Can be |
| startTime | integer | The timestamp when the event was raised, in UTC milliseconds. Can be |
| endTime | integer | The timestamp when the event was closed, in UTC milliseconds. Has the value of Can be |
| title | string | The title of the event. Can be |
| correlationId | string | The correlation ID of the event. Can be |
The ManagementZone object
A short representation of a management zone.
| Element | Type | Description |
|---|---|---|
| name | string | The name of the management zone. Can be |
| id | string | The ID of the management zone. Can be |
The EntityStub object
A short representation of a monitored entity.
| Element | Type | Description |
|---|---|---|
| entityId | Entity | A short representation of a monitored entity. Can be |
| name | string | The name of the entity. Not included in the response in case no entity with the relevant ID was found. Can be |
The EntityId object
A short representation of a monitored entity.
| Element | Type | Description |
|---|---|---|
| id | string | The ID of the entity. Can be |
| type | string | The type of the entity. Can be |
The METag object
The tag of a monitored entity.
| Element | Type | Description |
|---|---|---|
| stringRepresentation | string | The string representation of the tag. Can be |
| value | string | The value of the tag. Can be |
| key | string | The key of the tag. Can be |
| context | string | The origin of the tag, such as AWS or Cloud Foundry. Custom tags use the Can be |
The EventProperty object
A property of an event.
| Element | Type | Description |
|---|---|---|
| value | string | The value of the event property. Can be |
| key | string | The key of the event property. Can be |
Response body JSON model
{
"managementZones": [
{
"name": "string",
"id": "string"
}
],
"underMaintenance": true,
"suppressAlert": true,
"suppressProblem": true,
"frequentEvent": true,
"entityId": {
"entityId": {
"id": "string",
"type": "string"
},
"name": "string"
},
"eventId": "4293884258445543163_1564039524182",
"entityTags": [
{
"stringRepresentation": "string",
"value": "string",
"key": "string",
"context": "string"
}
],
"eventType": "LOW_DISK_SPACE",
"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_1628496488654Response 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