Skip to main content
Version: 24.05

Performance Monitoring - Issues

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint​

/o/apm/issues

Overview​

Lists the network and device traces that have samples slower than their threshold in the period.

Authentication​

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions​

  • Requires Read permission for the Performance Monitoring feature (performance_monitoring) in the target app.

Request Parameters​

ParameterTypeRequiredDescription
api_keyStringYes (or auth_token)API key authentication
auth_tokenStringYes (or api_key)Auth token authentication
app_idStringYesID of the app.
periodStringNoPeriod of the data, for example 30days or a date range. Defaults to 30days.

Examples​

Example: List issues​

curl "https://your-server.com/o/apm/issues?api_key=YOUR_API_KEY&app_id=YOUR_APP_ID&period=30days"

Response​

Success Response​

[
{
"name": "example.com/demo/",
"id": "96637f489b1786a3a575ee18096ea1f5:381caa66c42c2218db8e8f1b241f426f0d14e64ba957b536afd8f5b152ee57bd",
"type": "network",
"c": 1,
"th": 2,
"t": 16,
"status": "open"
}
]

Response Fields​

FieldTypeDescription
(root array)ArrayOne entry per trace with slow samples. Empty when there are none.
nameStringTrace name.
idStringTrace ID, for use with the other Performance Monitoring endpoints.
typeStringnetwork or device.
cNumberNumber of samples slower than the threshold.
thNumberThreshold of the trace, in seconds.
tNumberTotal number of samples of the trace in the period.
statusStringopen or mute. Traces without a stored status are reported as open.

Behavior​

  • Network traces are judged on response_time and device traces on duration.
  • The device traces app_in_background and app_in_foreground are not listed.
  • A trace is listed only when at least one sample is slower than its threshold.
Implementation details

Database Collections

CollectionUsed forData touched by this endpoint
countly.apmTrace data and propertiesReads aggregated trace data and trace thresholds and statuses.