Instana Mobile App Analyze API
The Mobile App Analyze API from Instana — 2 operation(s) for mobile app analyze.
The Mobile App Analyze API from Instana — 2 operation(s) for mobile app analyze.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/instana-mobile-app-analyze-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
contact:
email: support@instana.com
name: © Instana
url: http://instana.com
termsOfService: https://www.instana.com/terms-of-use/
title: Instana REST API documentation Mobile App Analyze API
version: 1.307.1417
x-ibm-ahub-try: true
x-logo:
altText: instana logo
backgroundColor: '#FAFBFC'
url: header-logo.svg
description: Searching for answers and best pratices?
servers:
- description: Instana Backend
url: https://{unit}-{tenant}.instana.io
variables:
tenant:
default: tenant
description: Customer tenant unit
unit:
default: unit
description: Customer tenant name
- description: Instana Self-Hosted Backend
url: https://{domain}
variables:
domain:
default: example.com
description: Customer Self-Hosted domain
tags:
- name: Mobile App Analyze
paths:
/api/mobile-app-monitoring/analyze/beacon-groups:
post:
description: API request to get grouped mobile app beacon metrics.
operationId: getMobileAppBeaconGroups
parameters:
- in: query
name: fillTimeSeries
schema:
type: boolean
requestBody:
content:
application/json:
example:
metrics:
- metric: beaconCount
aggregation: SUM
granularity: 60
group:
groupbyTag: mobileBeacon.view.name
tagFilterExpression:
type: EXPRESSION
logicalOperator: AND
elements:
- type: TAG_FILTER
name: mobileBeacon.mobileApp.name
operator: EQUALS
entity: NOT_APPLICABLE
value: robot-warehouse
- type: TAG_FILTER
name: mobileBeacon.platform
operator: EQUALS
entity: NOT_APPLICABLE
value: iOS
timeFrame:
to: null
windowSize: 3600000
type: SESSION_START
schema:
$ref: '#/components/schemas/GetMobileAppBeaconGroups'
responses:
'200':
content:
application/json:
example:
items:
- name: Products
earliestTimestamp: 1707023340857
cursor:
'@class': .IngestionOffsetCursor
ingestionTime: 1707026879283
offset: 1
metrics:
beaconCount.sum.60:
- - 1707023340000
- 47
- - 1707023400000
- 43
canLoadMore: false
totalHits: 1
totalRepresentedItemCount: 1
totalRetainedItemCount: 1
adjustedTimeframe:
windowSize: 3540000
to: 1707026880000
schema:
$ref: '#/components/schemas/MobileAppBeaconGroupsResult'
description: OK
'401':
description: Unauthorized access - requires user authentication.
'500':
description: Internal server error.
security:
- ApiKeyAuth:
- Default
summary: Get grouped beacon metrics
tags:
- Mobile App Analyze
x-ibm-ahub-byok: true
/api/mobile-app-monitoring/analyze/beacons:
post:
description: API request to get all mobile app beacons with matching type.
operationId: getMobileAppBeacons
requestBody:
content:
application/json:
example:
tagFilterExpression:
entity: NOT_APPLICABLE
name: mobileBeacon.mobileApp.name
operator: EQUALS
value: robot-warehouse
timeFrame:
to: null
windowSize: 60000
type: SESSION_START
schema:
$ref: '#/components/schemas/GetMobileAppBeacons'
responses:
'200':
content:
application/json:
example:
items:
- beacon:
agentVersion: 6.0.22
mobileAppId: K3bP-bmCRkyimNai9vvq8o
mobileAppLabel: robot-warehouse
timestamp: 1707025556799
clockSkew: 450
ingestionTime: 1707025557248
duration: 0
batchSize: 1
sessionId: B5CB9B35-C822-4101-B192-DC2488924C7F
beaconId: c43d78282ee5b5cf
parentBeaconId: ''
backendTraceId: ''
type: sessionStart
view: Products
customEventName: ''
meta:
feature.testGroup: beta
userIp: 94.134.0.0
userId: Example User Id
userSessionId: ''
userName: Example User Name
userEmail: example@example.com
userLanguages:
- de-DE
useFeatures: []
bundleIdentifier: com.example.shop
appBuild: aba9031kl
appVersion: 1.41.4
platform: Android
osName: Android
osVersion: '10'
deviceManufacturer: Google
deviceModel: Google Pixel 4XL
deviceHardware: Google Pixel 4XL
viewportWidth: 320
viewportHeight: 680
carrier: Deutsche Telekom
connectionType: wifi
effectiveConnectionType: 3g
latitude: 50.9865
longitude: 6.9304
accuracyRadius: 20
city: Cologne
subdivision: North Rhine-Westphalia
subdivisionCode: NW
country: Germany
countryCode: DE
continent: Europe
continentCode: EU
httpCallUrl: ''
httpCallOrigin: ''
httpCallPath: ''
httpCallMethod: ''
httpCallHeaders: {}
errorCount: 0
errorMessage: ''
errorId: ''
errorType: ''
stackTrace: ''
stackTraceLine: []
parsedStackTrace: ''
cursor:
'@class': .IngestionOffsetCursor
ingestionTime: 1707025557248
offset: 1
canLoadMore: false
totalHits: 70
totalRepresentedItemCount: 70
totalRetainedItemCount: 70
adjustedTimeframe:
windowSize: 60000
to: 1707025560000
schema:
$ref: '#/components/schemas/MobileAppBeaconResult'
description: OK
security:
- ApiKeyAuth:
- Default
summary: Get all beacons
tags:
- Mobile App Analyze
x-ibm-ahub-byok: true
components:
schemas:
GetMobileAppBeacons:
type: object
properties:
pagination:
$ref: '#/components/schemas/CursorPagination'
tagFilters:
type: array
items:
$ref: '#/components/schemas/DeprecatedTagFilter'
maxItems: 32
minItems: 0
timeFrame:
$ref: '#/components/schemas/TimeFrame'
type:
type: string
enum:
- SESSION_START
- HTTP_REQUEST
- CRASH
- CUSTOM
- VIEW_CHANGE
- DROP_BEACON
- PERF
required:
- type
MobileAppBeaconGroupsItem:
type: object
description: 'Represents an array of call group item containing several attributes that describe its properties.
The item includes fields such as cursor, metrics, name, and timestamp, which provide detailed information about the item.
'
properties:
cursor:
$ref: '#/components/schemas/IngestionOffsetCursor'
earliestTimestamp:
type: integer
format: int64
minimum: 0
metrics:
type: object
additionalProperties:
type: array
items:
type: array
items:
type: number
name:
type: string
required:
- cursor
- metrics
- name
TagFilterExpressionElement:
type: object
description: Boolean expression of tag filters to define the scope of relevant calls.
discriminator:
mapping:
EXPRESSION: '#/components/schemas/TagFilterExpression'
TAG_FILTER: '#/components/schemas/TagFilter'
propertyName: type
properties:
type:
type: string
required:
- type
Order:
type: object
description: 'Specifies the ordering of the results.
It contains fields that define the sorting criteria, the collation for sorting, and the direction in which the results should be ordered.
'
properties:
by:
type: string
description: If the granularity is set to `1` you can use the metric name eg. `latency.p95` to order by that value.
collation:
type: string
description: Language code used for sorting. Ignored for infrastructure queries.
direction:
type: string
description: The order in which results will be sorted, either `ASC` for ascending or `DESC` for descending.
enum:
- ASC
- DESC
required:
- by
- direction
TimeFrame:
type: object
description: Time range for which the data should be retrieved.
properties:
to:
type: integer
format: int64
description: 'end of timeframe expressed as the Unix epoch time in milliseconds. Eg: `ISO 8601` standard time `2024-06-27T05:05:55.615Z` can be represented as `1719464755615` in Unix epoch time in milliseconds.'
windowSize:
type: integer
format: int64
description: windowSize in milliseconds
maximum: 2678400000
minimum: 0
MobileAppMonitoringBeacon:
type: object
properties:
accuracyRadius:
type: integer
format: int64
minimum: -1
agentVersion:
type: string
maxLength: 128
minLength: 0
appBuild:
type: string
maxLength: 128
minLength: 0
appVersion:
type: string
maxLength: 128
minLength: 0
appVersionNumber:
type: integer
format: int64
minimum: -1
availableMb:
type: integer
format: int64
minimum: -1
backendTraceId:
type: string
maxLength: 128
minLength: 0
batchSize:
type: integer
format: int64
minimum: 1
beaconId:
type: string
maxLength: 128
minLength: 0
bundleIdentifier:
type: string
maxLength: 128
minLength: 0
bytesIngested:
type: integer
format: int64
carrier:
type: string
maxLength: 256
minLength: 0
city:
type: string
maxLength: 256
minLength: 0
clockSkew:
type: integer
format: int64
minimum: 0
coldStartTimeMs:
type: integer
format: int64
minimum: -1
connectionType:
type: string
maxLength: 16
minLength: 0
continent:
type: string
maxLength: 256
minLength: 0
continentCode:
type: string
maxLength: 64
minLength: 0
country:
type: string
maxLength: 256
minLength: 0
countryCode:
type: string
maxLength: 64
minLength: 0
currentAppState:
type: string
maxLength: 24
minLength: 0
customEventName:
type: string
maxLength: 256
minLength: 0
customMetric:
type: number
format: double
decodedBodySize:
type: integer
format: int64
minimum: -1
deviceHardware:
type: string
maxLength: 128
minLength: 0
deviceManufacturer:
type: string
maxLength: 128
minLength: 0
deviceModel:
type: string
maxLength: 128
minLength: 0
dropView:
type: string
maxLength: 256
minLength: 0
duration:
type: integer
format: int64
minimum: 0
effectiveConnectionType:
type: string
maxLength: 16
minLength: 0
encodedBodySize:
type: integer
format: int64
minimum: -1
environment:
type: string
maxLength: 256
minLength: 0
errorCount:
type: integer
format: int64
minimum: 0
errorId:
type: string
maxLength: 128
minLength: 0
errorMessage:
type: string
maxLength: 16384
minLength: 0
errorType:
type: string
maxLength: 1024
minLength: 0
googlePlayServicesMissing:
type: boolean
hotStartTimeMs:
type: integer
format: int64
minimum: -1
httpCallHeaders:
type: object
additionalProperties:
type: string
httpCallMethod:
type: string
maxLength: 16
minLength: 0
httpCallOrigin:
type: string
maxLength: 1024
minLength: 0
httpCallPath:
type: string
maxLength: 4096
minLength: 0
httpCallStatus:
type: integer
format: int32
maximum: 599
minimum: -1
httpCallUrl:
type: string
maxLength: 4096
minLength: 0
ingestionTime:
type: integer
format: int64
minimum: 1
internalMeta:
type: object
additionalProperties:
type: string
label:
type: string
latitude:
type: number
format: double
longitude:
type: number
format: double
maxMb:
type: integer
format: int64
minimum: -1
meta:
type: object
additionalProperties:
type: string
mobileAppId:
type: string
maxLength: 64
minLength: 0
mobileAppLabel:
type: string
maxLength: 128
minLength: 0
osName:
type: string
maxLength: 128
minLength: 0
osVersion:
type: string
maxLength: 128
minLength: 0
parentBeaconId:
type: string
parsedStackTrace:
type: string
maxLength: 16384
minLength: 0
performanceSubtype:
type: string
maxLength: 24
minLength: 0
platform:
type: string
maxLength: 32
minLength: 0
rateLimitBeaconType:
type: string
maxLength: 128
minLength: 0
rateLimitCount:
type: integer
format: int64
minimum: 0
rateLimitCustomMetricVal:
type: array
items:
type: number
format: float
rateLimitTimeMax:
type: integer
format: int64
minimum: 0
rateLimitTimeMin:
type: integer
format: int64
minimum: 0
region:
type: string
maxLength: 256
minLength: 0
rooted:
type: boolean
sessionId:
type: string
maxLength: 128
minLength: 0
stackTrace:
type: string
maxLength: 16384
minLength: 0
stackTraceKeyChecksum:
type: string
maxLength: 128
minLength: 0
stackTraceKeyInformation:
type: string
maxLength: 1024
minLength: 0
stackTraceLine:
type: array
items:
$ref: '#/components/schemas/StackTraceLine'
maxItems: 128
minItems: 0
stackTraceParsingStatus:
type: integer
format: int32
minimum: -1
subdivision:
type: string
maxLength: 256
minLength: 0
subdivisionCode:
type: string
maxLength: 64
minLength: 0
tenant:
type: string
maxLength: 256
minLength: 0
timestamp:
type: integer
format: int64
minimum: 1
transferSize:
type: integer
format: int64
minimum: -1
type:
type: string
maxLength: 24
minLength: 0
unit:
type: string
maxLength: 256
minLength: 0
useFeatures:
type: array
items:
type: string
maxItems: 15
minItems: 0
usedMb:
type: integer
format: int64
minimum: -1
userEmail:
type: string
maxLength: 128
minLength: 0
userId:
type: string
maxLength: 128
minLength: 0
userIp:
type: string
maxLength: 45
minLength: 0
userLanguages:
type: array
items:
type: string
maxItems: 5
minItems: 0
userName:
type: string
maxLength: 128
minLength: 0
userSessionId:
type: string
maxLength: 128
minLength: 0
view:
type: string
maxLength: 256
minLength: 0
viewportHeight:
type: integer
format: int32
minimum: -1
viewportWidth:
type: integer
format: int32
minimum: -1
warmStartTimeMs:
type: integer
format: int64
minimum: -1
required:
- beaconId
- mobileAppId
- performanceSubtype
- rateLimitBeaconType
- type
StackTraceLine:
type: object
properties:
column:
type: integer
format: int32
minimum: -1
file:
type: string
line:
type: integer
format: int32
minimum: -1
name:
type: string
translationExplanation:
type: string
translationStatus:
type: integer
format: int32
minimum: -1
required:
- file
AdjustedTimeframe:
type: object
description: 'Time frame provided in API request is slightly adjusted in response for faster API response.
For example, In request payload, if timeframe is 08:03 - 14:03, which is a 6 hour window size. It is adjusted to 08:05 - 14:00
Another example, In request payload, if timeframe is 08:20 - 08:20 (next day) which is a 24h window size. It is adjusted to 08:30 - 08:00 (next day)
'
properties:
to:
type: integer
format: int64
description: 'end of timeframe expressed as the Unix epoch time in milliseconds. Eg: `ISO 8601` standard time `2024-06-27T05:05:55.615Z` can be represented as `1719464755615` in Unix epoch time in milliseconds.'
windowSize:
type: integer
format: int64
description: windowSize in milliseconds
minimum: 0
required:
- to
ImpactedBeaconInfo:
type: object
properties:
country:
type: string
label:
type: string
subdivision:
type: string
userEmail:
type: string
userName:
type: string
MobileAppMonitoringMetricsConfiguration:
type: object
properties:
aggregation:
type: string
description: 'Set aggregation that can be applied to a series of values. Eg: `MEAN`.'
enum:
- SUM
- MEAN
- MAX
- MIN
- P25
- P50
- P75
- P90
- P95
- P98
- P99
- P99_9
- P99_99
- DISTINCT_COUNT
- SUM_POSITIVE
- PER_SECOND
- INCREASE
granularity:
type: integer
format: int32
description: 'If the granularity is set you will get data points with the specified granularity in seconds. Default: `1000` milliseconds'
metric:
type: string
description: 'Set a particular metric, eg: `latency`.'
numeratorTagFilterExpression:
$ref: '#/components/schemas/TagFilterExpressionElement'
required:
- aggregation
- metric
IngestionOffsetCursor:
type: object
description: Cursor to use between successive queries
GetMobileAppBeaconGroups:
type: object
properties:
group:
$ref: '#/components/schemas/MobileAppBeaconTagGroup'
metrics:
type: array
items:
$ref: '#/components/schemas/MobileAppMonitoringMetricsConfiguration'
maxItems: 5
minItems: 1
order:
$ref: '#/components/schemas/Order'
pagination:
$ref: '#/components/schemas/CursorPagination'
tagFilterExpression:
$ref: '#/components/schemas/TagFilterExpressionElement'
tagFilters:
type: array
items:
$ref: '#/components/schemas/DeprecatedTagFilter'
maxItems: 32
minItems: 0
timeFrame:
$ref: '#/components/schemas/TimeFrame'
type:
type: string
enum:
- SESSION_START
- HTTP_REQUEST
- CRASH
- CUSTOM
- VIEW_CHANGE
- DROP_BEACON
- PERF
required:
- group
- metrics
- type
MobileAppBeaconTagGroup:
type: object
properties:
groupbyTag:
type: string
description: The name of the group tag (e.g. `agent.tag` or `docker.label`).
maxLength: 256
minLength: 0
groupbyTagEntity:
type: string
description: 'The entity by which the data should be grouped.
This field supports three possible values: `NOT_APPLICABLE`, `DESTINATION`, and `SOURCE`.
`SOURCE`: the tag filter should apply to the source entity.
`DESTINATION`: the tag filter should apply to the destination entity.
`NOT_APPLICABLE`: some tags are independent of source or destination, such as tags on the call itself, log tags or trace tags (only destination makes sense because the source is unknown for the root call).
'
enum:
- NOT_APPLICABLE
- DESTINATION
- SOURCE
groupbyTagSecondLevelKey:
type: string
description: If present, it's the 2nd level key part (e.g. `customKey` on `docker.label.customKey`)
maxLength: 256
minLength: 0
required:
- groupbyTag
- groupbyTagEntity
MobileAppBeaconsItem:
type: object
description: 'Represents an array of call group item containing several attributes that describe its properties.
The item includes fields such as cursor, metrics, name, and timestamp, which provide detailed information about the item.
'
properties:
beacon:
$ref: '#/components/schemas/MobileAppMonitoringBeacon'
cursor:
$ref: '#/components/schemas/IngestionOffsetCursor'
impactedBeaconInfo:
$ref: '#/components/schemas/ImpactedBeaconInfo'
required:
- beacon
- cursor
DeprecatedTagFilter:
type: object
properties:
entity:
type: string
enum:
- NOT_APPLICABLE
- DESTINATION
- SOURCE
name:
type: string
operator:
type: string
enum:
- EQUALS
- CONTAINS
- LESS_THAN
- LESS_OR_EQUAL_THAN
- GREATER_THAN
- GREATER_OR_EQUAL_THAN
- NOT_EMPTY
- NOT_EQUAL
- NOT_CONTAIN
- IS_EMPTY
- NOT_BLANK
- IS_BLANK
- STARTS_WITH
- ENDS_WITH
- NOT_STARTS_WITH
- NOT_ENDS_WITH
- REGEX_MATCH
value:
type: string
required:
- name
- operator
- value
MobileAppBeaconGroupsResult:
type: object
properties:
adjustedTimeframe:
$ref: '#/components/schemas/AdjustedTimeframe'
canLoadMore:
type: boolean
description: Determine if additional data is available when a new query is made using the cursor from the last item in the `items` list.
items:
type: array
description: 'Represents an array of call group item containing several attributes that describe its properties.
The item includes fields such as cursor, metrics, name, and timestamp, which provide detailed information about the item.
'
items:
$ref: '#/components/schemas/MobileAppBeaconGroupsItem'
totalHits:
type: integer
format: int64
description: The total number of items that match a given filter
minimum: 0
totalRepresentedItemCount:
type: integer
format: int64
description: For calls and EUM beacons, one row can represent multiple real items (batched call, sample multiplicity)
minimum: 0
totalRetainedItemCount:
type: integer
format: int64
description: For calls and EUM beacons, only a subset is retained for historic data. Each retained row can represent multiple real items due to batching.
minimum: 0
required:
- items
CursorPagination:
type: object
description: 'Details for controlling the pagination of the API response.
This object allows you to define the starting point for retrieving records, how many records to skip, and the size of the result set.
'
properties:
ingestionTime:
type: integer
format: int64
description: 'The timestamp indicating the starting point from which data was ingested.
The format of the timestamp is in Unix epoch Time.
For example, `Thursday, 5 September 2024 07:03:13 GMT` can be represented as `1725519793`.
'
offset:
type: integer
format: int32
description: 'The number of records to be skipped from the `ingestionTime`.
For example: when `offset` is 20 and `ingestionTime` is 1725519793, the API response should have records starting from the 21st record after the specified `ingestionTime`.
Note that if `offset` value is not empty, `ingestionTime` can''t be empty.
'
retrievalSize:
type: integer
format: int32
description: 'The number of records to retrieve in a single request.
For example, when retrievalSize is set to 30, offset is 20, and ingestionTime is 1725519793, the API request will fetch 30 records starting from the 21st record after the specified `ingestionTime`.
Minimum value is 1 and maximum value is 200.
'
maximum: 200
minimum: 1
MobileAppBeaconResult:
type: object
properties:
adjustedTimeframe:
$ref: '#/components/schemas/AdjustedTimeframe'
canLoadMore:
type: boolean
description: Determine if additional data is available when a new query is made using the cursor from the last item in the `items` list.
items:
type: array
description: 'Represents an array of call group item containing several attributes that describe its properties.
The item includes fields such as cursor, metrics, name, and timestamp, which provide detailed information about the item.
'
items:
$ref: '#/components/schemas/MobileAppBeaconsItem'
totalHits:
type: integer
format: int64
description: The total number of items that match a given filter
minimum: 0
totalRepresentedItemCount:
type: integer
format: int64
description: For calls and EUM beacons, one row can represent multiple real items (batched call, sample multiplicity)
minimum: 0
totalRetainedItemCount:
type: integer
format: int64
description: For calls and EUM beacons, only a subset is retained for historic data. Each retained row can represent multiple real items due to batching.
minimum: 0
required:
- items
securitySchemes:
ApiKeyAuth:
in: header
name: authorization
type: apiKey
description: "## Example\n\n```bash\ncurl --request GET \\\n --url https://test-instana.instana.io/api/application-monitoring/catalog/metrics \\\n --header 'authorization: apiToken xxxxxxxxxxxxxxxx'\n```\n"
x-tagGroups:
- name: Websites & Mobile Apps
tags:
- Website Metrics
- Website Catalog
- Website Analyze
- Website Configuration
- Mobile App Metrics
- Mobile App Catalog
- Mobile App Analyze
- Mobile App Configuration
- End User Monitoring
- name: Applications
tags:
- Application Metrics
- Application Resources
- Application Catalog
- Application Analyze
- Application Settings
- Application Topology
- Application Alert Configuration
- Global Application Alert Configuration
- name: Infrastructure
tags:
- Infrastructure Analyze
- Infrastructure Metrics
- Infrastructure Resources
- Infrastructure Catalog
- Infrastructure Topology
- name: Logging
tags:
- Logging Analyze
- name: Synthetic Monitoring
tags:
- Synthetic Catalog
- Synthetic Metrics
- Synthetic Settings
- Synthetic Test Playback Results
- Synthetic Alert Configuration
- name: Logs
tags:
- Log Alert Configuration
- name: Events
tags:
- Events
- Event Settings
- name: Automation
tags:
- Action Catalog
- Action History
- Policies
- name: Service Levels
tags:
- SLI Settings
- SLI Report
- Apdex Settings
- Apdex Report
- Service Levels Objective(SLO) Configurations
- Service Levels Objective(SLO) Report
- Service Levels Alert Configuration
- SLO Correction Configurations
- SLO Correction Windows
- name: AI Management
tags:
- AI Management
- name: Settings
tags:
- Custom Dashboards
- User
- Groups
- Teams
- Roles
- Audit Log
- API Token
- Maintenance Configuration
- Synthetic Calls
- Session Settings
- Automation Settings
- Authentication
- name: Open Beta Features
tags:
- Infrastructure Analyze
- name: Closed Beta Features
tags:
- Infrastructure Alert Configuration
- name: Instana
tags:
- Releases
- Host Agent
- Health
- Usage