Problems API - GET feed
This API is deprecated. Use the Problems API v2 instead.
Lists the problems (and their details) observed by Dynatrace during a relative period of time.
A problem is included in the response if either the start or end timestamp of the problem is within the defined timeframe.
The output is limited to 5,000 problems. You can narrow it down by specifying filtering criteria—see the Parameters section.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v1/problem/feed |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/problem/feed | |
Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v1/problem/feed |
Authentication
To execute this request, you need an access token with DataExport
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
relativeTime | string | The relative timeframe of the inquiry, back from the current time.
| query | optional |
startTimestamp | integer | The start timestamp of the requested timeframe, in UTC milliseconds. | query | optional |
endTimestamp | integer | The end timestamp of the requested timeframe, in UTC milliseconds. If The timeframe must not exceed 31 days. | query | optional |
status | string | Filters the result problems by the status.
| query | optional |
impactLevel | string | Filters the result problems by the impact level.
| query | optional |
severityLevel | string | Filters the result problems by the severity level.
| query | optional |
tag | string[] | Filters the result problems by the tags of affected entities.You can specify several tags in the following format: In case of key-value tags, such as imported AWS or CloudFoundry tags use following format: | query | optional |
expandDetails | boolean | Includes( Defaults to | query | optional |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | ProblemFeedResultWrapper | Success |
Response body objects
The ProblemFeedResultWrapper
object
Element | Type | Description |
---|---|---|
result | ProblemFeedQueryResult | Details on open problems in your environment. |
The ProblemFeedQueryResult
object
Details on open problems in your environment.
Element | Type | Description |
---|---|---|
monitored | object | The number of monitored entities per impact level. |
problems | Problem[] | The list of problems and their details. Contains all problems within specified timeframe, open and closed. |
The Problem
object
The properties of a problem.
Element | Type | Description |
---|---|---|
affectedCounts | object | The number of affected entities per impact level. |
commentCount | integer | The number of comments to the problem. |
displayName | string | The name of the problem, displayed in the UI. |
endTime | integer | The end timestamp of the problem, in UTC milliseconds. Has the value |
hasRootCause | boolean | Indicates whether Dynatrace has found at least one possible root cause for the problem. |
id | string | The ID of the problem. |
impactLevel | string | The impact level of the problem. It shows what is affected by the problem: infrastructure, service, or application.
|
rankedEvents | Event[] | The list of events related to the problem. |
rankedImpacts | EventRestImpact[] | Provides impact information of the events in an aggregated form. For a more detailed impact analysis, see |
recoveredCounts | object | The number of entities that were affected, but recovered, per impact level. |
severityLevel | string | The severity of the problem.
|
startTime | integer | The start timestamp of the problem, in UTC milliseconds. |
status | string | The status of the problem.
|
tagsOfAffectedEntities | TagInfo[] | Tags of entities affected by the problem. |
The Event
object
The properties of an event.
Element | Type | Description |
---|---|---|
activeMaintenanceWindows | EntityShortRepresentation[] | - |
affectedPrivateSyntheticLocations | string[] | - |
affectedRequestsPerMinute | number | - |
affectedSyntheticActions | string[] | If the event type is one of the synthetic event types then we may have information on which synthetic actions are affected by the event. The names of those are returned in this field. |
affectedSyntheticLocations | string[] | - |
affectedUserActionsPerMinute | number | - |
annotationDescription | string | - |
annotationType | string | - |
artifact | string | - |
browser | string | -
|
changed | string | - |
ciBackLink | string | - |
correlationId | string | - |
cpuLimitInMHz | integer | - |
cpuLoad | number | - |
customProperties | object | - |
deploymentName | string | - |
deploymentParamAdded | string | - |
deploymentParamRemoved | string | - |
deploymentProject | string | - |
deploymentVersion | string | - |
effectiveEntity | string | - |
endTime | integer | The timestamp of the event closure, in UTC milliseconds. Has the |
entityId | string | The ID of the affected Dynatrace entity. |
entityName | string | The name of the affected Dynatrace entity. |
eventType | string | The type of the event.
|
geolocation | string | - |
impactLevel | string | The impact level of the event. It shows what is affected by the problem: infrastructure, service, or application.
|
isClusterWide | boolean | For events with event type |
isRootCause | boolean | Indicates if the event is the root cause of a problem. |
minimumProcessGroupInstanceCountThreshold | integer | - |
mobileAppVersion | string | - |
operatingSystem | string | - |
original | string | - |
percentile | string | -
|
referenceResponseTime50thPercentile | number | - |
referenceResponseTime90thPercentile | number | - |
remediationAction | string | - |
resourceId | string | The id of the resource the event occurred on. |
resourceName | string | The name of the resource the event occurred on. |
service | string | - |
serviceMethod | string | - |
serviceMethodGroup | string | - |
severities | EventSeverity[] | Additional data on the event severity. |
severityLevel | string | The severity of the event.
|
source | string | - |
startTime | integer | The timestamp of the event detection, in UTC milliseconds. |
status | string | The status of the event.
|
syntheticErrorType | string[] | If the event type is one of the synthetic event types then we may have information about the error type. The names of those are returned in this field. |
userAction | string | - |
userDefined50thPercentileThreshold | number | - |
userDefined90thPercentileThreshold | number | - |
userDefinedFailureRateThreshold | number | - |
The EntityShortRepresentation
object
The short representation of a Dynatrace entity.
Element | Type | Description |
---|---|---|
description | string | A short description of the Dynatrace entity. |
id | string | The ID of the Dynatrace entity. |
name | string | The name of the Dynatrace entity. |
The EventSeverity
object
Additional data on the event severity.
Element | Type | Description |
---|---|---|
context | string | The metric used in the event severity calculation.
|
unit | string | The unit of the severity value.
|
value | number | The value of the severity. |
The EventRestImpact
object
The information about the event's impact.
Element | Type | Description |
---|---|---|
entityId | string | The ID of the affected Dynatrace entity. |
entityName | string | The name of the affected Dynatrace entity. |
eventType | string | The type of the event.
|
impactLevel | string | The impact level of the event. It shows what is affected by the problem: infrastructure, service, or application.
|
resourceId | string | The id of the resource the event occurred on. |
resourceName | string | The name of the resource the event occurred on. |
severityLevel | string | The severity of the event.
|
The TagInfo
object
Tag of a Dynatrace entity.
Element | Type | Description |
---|---|---|
context | string | The origin of the tag, such as AWS or Cloud Foundry. Custom tags use the
|
key | string | The key of the tag. Custom tags have the tag value here. |
value | string | The value of the tag. Not applicable to custom tags. |
Response body JSON model
1{2 "result": {3 "monitored": {4 "APPLICATION": 1,5 "ENVIRONMENT": 1,6 "INFRASTRUCTURE": 1,7 "SERVICE": 18 },9 "problems": [10 {11 "affectedCounts": {12 "APPLICATION": 1,13 "ENVIRONMENT": 1,14 "INFRASTRUCTURE": 1,15 "SERVICE": 116 },17 "commentCount": 1,18 "displayName": "string",19 "endTime": 1,20 "hasRootCause": true,21 "id": "string",22 "impactLevel": "APPLICATION",23 "rankedEvents": [24 {25 "activeMaintenanceWindows": [26 {27 "description": "Dynatrace entity for the REST API example",28 "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",29 "name": "Dynatrace entity"30 }31 ],32 "affectedPrivateSyntheticLocations": [33 "string"34 ],35 "affectedRequestsPerMinute": 1,36 "affectedSyntheticActions": [37 "string"38 ],39 "affectedSyntheticLocations": [40 "string"41 ],42 "affectedUserActionsPerMinute": 1,43 "annotationDescription": "string",44 "annotationType": "string",45 "artifact": "string",46 "browser": "APPLICATION",47 "changed": "string",48 "ciBackLink": "string",49 "correlationId": "string",50 "cpuLimitInMHz": 1,51 "cpuLoad": 1,52 "customProperties": {},53 "deploymentName": "string",54 "deploymentParamAdded": "string",55 "deploymentParamRemoved": "string",56 "deploymentProject": "string",57 "deploymentVersion": "string",58 "effectiveEntity": "string",59 "endTime": 1,60 "entityId": "string",61 "entityName": "string",62 "eventType": "APPLICATION_JS_FRAMEWORK_DETECTED",63 "geolocation": "string",64 "impactLevel": "APPLICATION",65 "isClusterWide": true,66 "isRootCause": true,67 "minimumProcessGroupInstanceCountThreshold": 1,68 "mobileAppVersion": "string",69 "operatingSystem": "string",70 "original": "string",71 "percentile": "50th",72 "referenceResponseTime50thPercentile": 1,73 "referenceResponseTime90thPercentile": 1,74 "remediationAction": "string",75 "resourceId": "string",76 "resourceName": "string",77 "service": "string",78 "serviceMethod": "string",79 "serviceMethodGroup": "string",80 "severities": [81 {82 "context": "COMMAND_ABORT",83 "unit": "Ampere (A)",84 "value": 185 }86 ],87 "severityLevel": "AVAILABILITY",88 "source": "string",89 "startTime": 1,90 "status": "CLOSED",91 "syntheticErrorType": [92 "string"93 ],94 "userAction": "string",95 "userDefined50thPercentileThreshold": 1,96 "userDefined90thPercentileThreshold": 1,97 "userDefinedFailureRateThreshold": 198 }99 ],100 "rankedImpacts": [101 {102 "entityId": "string",103 "entityName": "string",104 "eventType": "APPLICATION_JS_FRAMEWORK_DETECTED",105 "impactLevel": "APPLICATION",106 "resourceId": "string",107 "resourceName": "string",108 "severityLevel": "AVAILABILITY"109 }110 ],111 "recoveredCounts": {112 "APPLICATION": 1,113 "ENVIRONMENT": 1,114 "INFRASTRUCTURE": 1,115 "SERVICE": 1116 },117 "severityLevel": "AVAILABILITY",118 "startTime": 1,119 "status": "CLOSED",120 "tagsOfAffectedEntities": [121 {122 "context": "AWS",123 "key": "string",124 "value": "string"125 }126 ]127 }128 ]129 }130}
Example
In this example, the request gets the problems that have occurred during the last hour and which are affecting infrastructure.
The API token is passed in the Authorization header.
The result is truncated to the first two entries.
Curl
1curl -X GET \2 'https://mySampleEnv.live.dynatrace.com/api/v1/problem/feed?impactLevel=INFRASTRUCTURE&relativeTime=hour' \3 -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
1https://mySampleEnv.live.dynatrace.com/api/v1/problem/feed?impactLevel=INFRASTRUCTURE&relativeTime=hour
Response body
1{2 "result": {3 "problems": [4 {5 "id": "-1024851378335816085_1538553240000V2",6 "startTime": 1538553240000,7 "endTime": 7258118400000,8 "displayName": "85",9 "impactLevel": "INFRASTRUCTURE",10 "status": "OPEN",11 "severityLevel": "ERROR",12 "commentCount": 0,13 "tagsOfAffectedEntities": [14 {15 "context": "CONTEXTLESS",16 "key": "loadtest"17 }18 ],19 "rankedImpacts": [20 {21 "entityId": "PROCESS_GROUP_INSTANCE-DE765F657721AF59",22 "entityName": "IIS app pool dotNetBackend_easyTravel_x64",23 "severityLevel": "ERROR",24 "impactLevel": "INFRASTRUCTURE",25 "eventType": "PROCESS_LOG_ERROR"26 }27 ],28 "affectedCounts": {29 "INFRASTRUCTURE": 1,30 "SERVICE": 0,31 "APPLICATION": 0,32 "ENVIRONMENT": 033 },34 "recoveredCounts": {35 "INFRASTRUCTURE": 0,36 "SERVICE": 0,37 "APPLICATION": 0,38 "ENVIRONMENT": 039 },40 "hasRootCause": true41 },42 {43 "id": "2307087411653364173_1538400720000V2",44 "startTime": 1538400720000,45 "endTime": 7258118400000,46 "displayName": "173",47 "impactLevel": "INFRASTRUCTURE",48 "status": "OPEN",49 "severityLevel": "AVAILABILITY",50 "commentCount": 0,51 "tagsOfAffectedEntities": [52 {53 "context": "CONTEXTLESS",54 "key": "loadtest"55 },56 {57 "context": "CONTEXTLESS",58 "key": "ServiceNow"59 },60 {61 "context": "CONTEXTLESS",62 "key": "host tag"63 }64 ],65 "rankedImpacts": [66 {67 "entityId": "PROCESS_GROUP-09875E82E2FB98FD",68 "entityName": "Windows System",69 "severityLevel": "AVAILABILITY",70 "impactLevel": "INFRASTRUCTURE",71 "eventType": "PROCESS_GROUP_LOW_INSTANCE_COUNT"72 },73 {74 "entityId": "HOST-ED6BC51DEBA8093A",75 "entityName": "ZID",76 "severityLevel": "AVAILABILITY",77 "impactLevel": "INFRASTRUCTURE",78 "eventType": "CONNECTION_LOST"79 }80 ],81 "affectedCounts": {82 "INFRASTRUCTURE": 1,83 "SERVICE": 0,84 "APPLICATION": 0,85 "ENVIRONMENT": 086 },87 "recoveredCounts": {88 "INFRASTRUCTURE": 1,89 "SERVICE": 0,90 "APPLICATION": 0,91 "ENVIRONMENT": 092 },93 "hasRootCause": true94 }95 ],96 "monitored": {97 "INFRASTRUCTURE": 2474,98 "SERVICE": 85,99 "APPLICATION": 503,100 "ENVIRONMENT": 1101 }102 }103}
Response code
200