# Alibaba Cloud AppMonitor API

> Alibaba Cloud AppMonitor API on Apizie: 15 endpoints (Creates a remote log retrieval task for a specified device, Retrieves the details of an error event, Retrieves the list of all error events under a specific aggregated error, Retrieves the details of an aggregated error, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-emas-appmonitor`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/emas-appmonitor
- Page: https://apizie.tech/api/cloud/aliyun-emas-appmonitor
- OpenAPI: https://apizie.tech/api/cloud/aliyun-emas-appmonitor/openapi.json

Alibaba Cloud OpenAPI for AppMonitor (emas-appmonitor, version 2019-06-11). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates a remote log retrieval task for a specified device
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/create-tlog-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppKey | integer | yes | The AppKey of the application |
| Os | string | yes | The operating system type. Valid values: iphoneos: iOS. android: Android |
| AliYunName | string | yes | The name of the creator. This value is written to the task as the author |
| AliYunCurrentPk | string | no | The account or employee ID of the creator. This value is written to the authorEmpId field |
| AliYunMainPk | string | no | The ID of the Alibaba Cloud account. This value is written to the authorParentEmpId field |
| Days | string | no | The number of recent days of logs to retrieve. Default value: 1 |
| TaskName | string | no | The name of the task |
| City | string | no | The region for conditional retrieval. This parameter is used in non-USER mode |
| Brand | string | no | The device brand for conditional retrieval. This parameter is used in non-USER mode |
| Model | string | no | The device model for conditional retrieval. This parameter is used in non-USER mode |
| OsVersion | string | no | The operating system version for conditional retrieval. This parameter is used in non-USER mode |
| AppVersion | string | no | The application version for conditional retrieval. This parameter is used in non-USER mode |
| CollectionNums | integer | no | The number of target devices for conditional retrieval. This parameter is used in non-USER mode |
| ClusterId | string | no | Deprecated |
| ErrorType | string | no | Deprecated |
| DeviceJson | string | no | The device information used to create a log retrieval task in USER mode. The field type is String, and the content format is a JSON array… |
| NotifySettingJson | string | no | The notification configuration in JSON format. If specified, this value is saved to the task |
| SourceType | string | no | The task type. Valid values: USER: device retrieval by device ID. AUTO: device retrieval in batch. AUTO_RT: conditional retrieval |
| BeginDate | integer | no | The start time for conditional retrieval filtering, in UNIX milliseconds. This parameter is used in non-USER mode |
| EndDate | integer | no | The end time for conditional retrieval filtering, in UNIX milliseconds. This parameter is used in non-USER mode |

### Retrieves the details of an error event
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-error` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| ClientTime | integer | yes | The client time |
| Did | string | no | The device ID |
| Force | string | no | Specifies whether to forcibly skip the cache query. Do not pass this parameter unless necessary |
| AppKey | integer | yes | The AppKey |
| Os | string | no | The OS type. Valid values: android iphoneos harmony h5 |
| Uuid | string | no | The unique event ID |
| BizModule | string | no | The business module. Valid values: exception: exception analysis lag: lag analysis custom: custom exception crash: crash analysis… |
| DigestHash | string | no | The DigestHash |

### Retrieves the list of all error events under a specific aggregated error
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-errors` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| BizModule | string | yes | The business module. Valid values: exception: exception analysis lag: lag analysis custom: custom exception crash: crash analysis… |
| Utdid | string | no | The utdid |
| DigestHash | string | no | The error digest hash |
| Filter | string | no | The filter condition (JSON-encoded) |
| TimeRange | string | yes | The time range for filtering (JSON-encoded) |
| PageIndex | integer | yes | The page number |
| PageSize | integer | yes | The page size |
| AppKey | integer | yes | The appKey |
| Os | string | no | The OS type. Valid values: iphoneos: iOS android: Android harmony: HarmonyOS h5: H5 |

### Retrieves the details of an aggregated error
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-issue` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| BizModule | string | yes | The business module. Valid values: exception: exception analysis lag: lag analysis custom: custom exception crash: crash analysis… |
| TimeRange | string | yes | The time range (JSON-encoded) |
| Filter | string | no | The filter condition (JSON-encoded) |
| DigestHash | string | no | The hash of the error digest |
| AppKey | integer | yes | The AppKey |
| Os | string | yes | The OS type. Valid values: iphoneos android harmony h5 |

### Get the aggregated error list
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-issues` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| BizModule | string | yes | Business module exception (exception analysis) lag (lag analysis) custom (custom exception) crash (crash analysis) h5JsError (H5 JS error)… |
| TimeRange | string | yes | Time range (JSON-encoded) |
| Filter | string | no | Filter conditions (JSON-encoded) |
| Name | string | no | Error name (for fuzzy search) |
| Status | integer | no | Error status 1 (NEW) 2 (OPEN) 3 (CLOSE) 4 (FIXED) |
| PageIndex | integer | no | Page number |
| PageSize | integer | no | Page size |
| OrderBy | string | no | Sort key ErrorDeviceRate (error device rate) ErrorDeviceCount (error device count) ErrorCount (error count) ErrorRate (error rate) |
| OrderType | string | no | Sort order asc (ascending) desc (descending) |
| AppKey | integer | yes | Project AppKey |
| Os | string | no | OS type iphoneos (iOS) android (Android) harmony (HarmonyOS) h5 (H5) |

### Get Symbolication File List
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-symbolic-files` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| StartTime | integer | no | Start time |
| EndTime | integer | no | End time |
| AppVersion | string | no | App version |
| FileType | string | yes | The type of the symbolication file |
| FileName | string | no | The file name |
| Uuid | string | no | The UUID |
| ExportStatus | string | no | The parsing status of the symbolication file |
| PageIndex | integer | yes | The page number |
| PageSize | integer | yes | The page size |
| AppKey | integer | yes | The AppKey |
| Os | string | yes | The OS type. iphoneos (iOS) android (Android) harmony (HarmonyOS) |
| BuildId | string | no | The BuildId |

### Retrieves a list of device log tasks
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-tlog-collect-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppKey | integer | yes | The AppKey of the application |
| Os | string | yes | The operating system type. Valid values: iphoneos: iOS. android: Android |
| PageIndex | integer | yes | The page number |
| PageSize | integer | yes | The number of entries per page |
| Utdid | string | no | The UTDID. This parameter is deprecated |
| Author | string | no | The user who last modified the task |
| Status | string | no | The collection status. If this parameter is left empty, tasks in all states are queried. Valid values: START: The task has been created… |
| BeginDate | integer | no | This parameter is deprecated |
| EndDate | integer | no | This parameter is deprecated |
| Keyword | string | no | The keyword for exact match. The value is used to query by both deviceId and userNick |
| Model | string | no | This parameter is deprecated |
| City | string | no | This parameter is deprecated |
| AppVersion | string | no | This parameter is deprecated |
| OsVersion | string | no | This parameter is deprecated |
| SourceType | string | no | The device task type. Valid values: USER: ID-based retrieval. AUTO: batch retrieval. AUTO_RT: conditional retrieval. POSITIVE: proactive… |
| CreateBeginDate | integer | no | The start time of the device log task creation period. This parameter is used to query log retrieval device tasks |
| CreateEndDate | integer | no | The end time of the device log task creation period. This parameter is used to query log retrieval device tasks |
| UpdateBeginDate | integer | no | The start time of the device log task update period. This parameter is used to query proactive reporting device tasks |
| UpdateEndDate | integer | no | The end time of the device log task update period. This parameter is used to query proactive reporting device tasks |
| PositiveComment | string | no | The comment for proactive reporting. This parameter is used to query proactive reporting device tasks |
| UserNick | string | no | The device nickname |
| DeviceId | string | no | The device ID |

### Retrieves the details of a device
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-tlog-device-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppKey | integer | yes | The AppKey of the application |
| Os | string | yes | The operating system type. Valid values: iphoneos: iOS. android: Android |
| DeviceId | string | no | The device ID |

### Queries retrievable devices by device ID, user nickname, user ID, or device attributes
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-tlog-device-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppKey | integer | yes | Application AppKey |
| Os | string | yes | The OS type. Valid values: iphoneos (iOS) android (Android) |
| PageIndex | integer | yes | The page number |
| PageSize | integer | yes | The number of entries per page |
| Utdid | string | no | The device ID. This parameter is deprecated |
| BeginDate | integer | no | The start of the device active time range. Unit: milliseconds (Unix timestamp) |
| EndDate | integer | no | The end of the device active time range. Unit: milliseconds (Unix timestamp) |
| Keyword | string | no | The general exact query keyword. The value is used to query deviceId, userNick, and userId simultaneously, and is mutually exclusive with… |
| Model | string | no | The device model filter. This parameter is mapped to deviceModel |
| City | string | no | The region filter. This parameter is mapped to geo |
| AppVersion | string | no | The app version filter |
| OsVersion | string | no | The OS version filter |
| CreateBeginDate | integer | no | This parameter is deprecated |
| CreateEndDate | integer | no | This parameter is deprecated |
| UpdateBeginDate | integer | no | This parameter is deprecated |
| UpdateEndDate | integer | no | This parameter is deprecated |
| UserNick | string | no | The user nickname |
| Brand | string | no | The device brand filter |

### Queries the collection status of each device under a task
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-tlog-task-collections` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppKey | integer | yes | The AppKey |
| Os | string | yes | The OS type. Valid values: iphoneos: iOS android: Android |
| TaskId | string | yes | The task ID |

### Retrieves the details of a task
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/get-tlog-task-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppKey | integer | yes | The AppKey of the application |
| Os | string | yes | The OS type. Valid values: iphoneos android |
| TaskId | string | yes | The task ID |

### Obtains temporary credentials for uploading symbol tables to OSS
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/request-upload-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppKey | integer | yes | The AppKey |
| Os | string | yes | The OS type. Valid values: iphoneos: iOS android: Android harmony: HarmonyOS |

### Queries device log data
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/search-tlog` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppKey | integer | yes | Application AppKey |
| Os | string | yes | OS type. iphoneos android |
| DeviceId | string | yes | Device ID |
| LevelJson | string | no | JSON array string of log levels |
| Keyword | string | no | Log content keyword |
| BeginDate | integer | yes | The start time of the query, in Unix milliseconds. EndDate must be greater than or equal to BeginDate |
| EndDate | integer | yes | The end time for conditional pull filtering, in Unix milliseconds. Used in non-USER mode |
| PageIndex | integer | yes | Page number for pagination |
| PageSize | integer | yes | Page size |

### Submits the upload result after a symbol table is successfully uploaded to OSS
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/submit-symbolic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |
| AppVersion | string | no | The application version |
| FileType | string | yes | The type of the symbol table file |
| FilePath | string | yes | The file path |
| FileName | string | yes | The storage name |
| Uuid | string | no | The UUID |
| BuildId | string | no | The build ID of the APP SO file |
| AppKey | integer | yes | The AppKey |
| Os | string | yes | The operating system type. Valid values: iphoneos android harmony |

### version
`POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emas-appmonitor.cn-shanghai.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/create-tlog-task" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud AppMonitor API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-emas-appmonitor/create-tlog-task with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud AppMonitor API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud AppMonitor itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud AppMonitor API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-emas-appmonitor.

### What is the status of the Alibaba Cloud AppMonitor API?
Needs your own provider key (bring your own key)