Events - Get
Get an event
Gets the data for a single event
GET https://api.applicationinsights.io/v1/apps/{appId}/events/{eventType}/{eventId}
GET https://api.applicationinsights.io/v1/apps/{appId}/events/{eventType}/{eventId}?timespan={timespan}
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
app
|
path | True |
string |
ID of the application. This is Application ID from the API Access settings blade in the Azure portal. |
event
|
path | True |
string |
ID of event. |
event
|
path | True |
The type of events to query; either a standard event type ( |
|
timespan
|
query |
string |
Optional. The timespan over which to retrieve events. This is an ISO8601 time period value. This timespan is applied in addition to any that are specified in the Odata expression. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Successful response |
|
Other Status Codes |
An error response object. |
Security
oauth2
Connect to Azure Application Insights API
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
eventById
Sample request
GET https://api.applicationinsights.io/v1/apps/DEMO_APP/events/traces/dc76df01-0141-11e8-9894-e3e7c1eeabad
Sample response
{
"@odata.context": "https://api.applicationinsights.io/v1/apps/DEMO_APP/events/traces/$metadata#traces",
"value": [
{
"id": "dc76df01-0141-11e8-9894-e3e7c1eeabad",
"type": "trace",
"count": 1,
"timestamp": "2018-01-24T20:04:32.243Z",
"customDimensions": null,
"customMeasurements": null,
"operation": {
"name": "GET /FabrikamProd/Employees/Create",
"id": "HPFy1bNlyQ0=",
"parentId": "|HPFy1bNlyQ0=.c642e1f1_",
"syntheticSource": "Application Insights Availability Monitoring"
},
"session": {
"id": "97915c9e-2ba3-4258-82f5-84233de21127"
},
"user": {
"id": "emea-ru-msa-edge_97915c9e-2ba3-4258-82f5-84233de21127",
"accountId": null,
"authenticatedId": null
},
"cloud": {
"roleName": null,
"roleInstance": "AIConnect2"
},
"ai": {
"iKey": "5a2e4e0c-e136-4a15-9824-90ba859b0a89",
"appName": "fabrikamprod",
"appId": "cf58dcfd-0683-487c-bc84-048789bca8e5",
"sdkVersion": "sd:2.4.1-442"
},
"trace": {
"message": "New Request Received",
"severityLevel": 0
},
"application": {
"version": null
},
"client": {
"model": null,
"os": null,
"type": "PC",
"browser": null,
"ip": "51.140.105.0",
"city": "London",
"stateOrProvince": "England",
"countryOrRegion": "United Kingdom"
}
}
]
}
Definitions
Name | Description |
---|---|
Custom |
Custom dimensions of the event |
Custom |
Custom measurements of the event |
error |
Error details. |
error |
The code and message for an error. |
error |
Error details. |
events |
AI related application info for an event result |
events |
Application info for an event result |
events |
The availability result info |
events |
An availability result result |
events |
The browser timing information |
events |
A browser timing result |
events |
Client info for an event result |
events |
Client performance information |
events |
Cloud info for an event result |
events |
The custom event information |
events |
A custom event result |
events |
The custom metric info |
events |
A custom metric result |
events |
The dependency info |
events |
A dependency result |
events |
Exception details |
events |
A parsed stack entry |
events |
The exception info |
events |
An exception result |
events |
Operation info for an event result |
events |
The page view information |
events |
A page view result |
events |
The performance counter info |
events |
A performance counter result |
events |
The request info |
events |
A request result |
events |
An events query result. |
events |
Session info for an event result |
events |
The trace information |
events |
A trace result |
events |
User info for an event result |
Event |
The type of events to query; either a standard event type ( |
CustomDimensions
Custom dimensions of the event
Name | Type | Description |
---|---|---|
additionalProperties |
object |
CustomMeasurements
Custom measurements of the event
Name | Type | Description |
---|---|---|
additionalProperties |
object |
errorDetail
Error details.
Name | Type | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
The error's code. |
message |
string |
A human readable error message. |
resources |
string[] |
Indicates resources which were responsible for the error. |
target |
string |
Indicates which property in the request is responsible for the error. |
value |
string |
Indicates which value in 'target' is responsible for the error. |
errorInfo
The code and message for an error.
Name | Type | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
A machine readable error code. |
details |
error details. |
|
innererror |
The code and message for an error. |
|
message |
string |
A human readable error message. |
errorResponse
Error details.
Name | Type | Description |
---|---|---|
error |
The code and message for an error. |
eventsAiInfo
AI related application info for an event result
Name | Type | Description |
---|---|---|
appId |
string |
ID of the application |
appName |
string |
Name of the application |
iKey |
string |
iKey of the app |
sdkVersion |
string |
SDK version of the application |
eventsApplicationInfo
Application info for an event result
Name | Type | Description |
---|---|---|
version |
string |
Version of the application |
eventsAvailabilityResultInfo
The availability result info
Name | Type | Description |
---|---|---|
duration |
integer |
The duration of the availability result |
id |
string |
The ID of the availability result |
location |
string |
The location of the availability result |
message |
string |
The message of the availability result |
name |
string |
The name of the availability result |
performanceBucket |
string |
The performance bucket of the availability result |
size |
string |
The size of the availability result |
success |
string |
Indicates if the availability result was successful |
eventsAvailabilityResultResult
An availability result result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
availabilityResult |
The availability result info |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
availability |
The type of event. |
user |
User info of the event |
eventsBrowserTimingInfo
The browser timing information
Name | Type | Description |
---|---|---|
name |
string |
The name of the page |
networkDuration |
integer |
The network duration of the load |
performanceBucket |
string |
The performance bucket of the load |
processingDuration |
integer |
The processing duration of the load |
receiveDuration |
integer |
The receive duration of the load |
sendDuration |
integer |
The send duration of the load |
totalDuration |
integer |
The total duration of the load |
url |
string |
The url of the page |
urlHost |
string |
The host of the URL |
urlPath |
string |
The path of the URL |
eventsBrowserTimingResult
A browser timing result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
browserTiming |
The browser timing information |
|
client |
Client info of the event |
|
clientPerformance |
Client performance information |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
browser |
The type of event. |
user |
User info of the event |
eventsClientInfo
Client info for an event result
Name | Type | Description |
---|---|---|
browser |
string |
Browser of the client |
city |
string |
City of the client |
countryOrRegion |
string |
Country or region of the client |
ip |
string |
IP address of the client |
model |
string |
Model of the client |
os |
string |
Operating system of the client |
stateOrProvince |
string |
State or province of the client |
type |
string |
Type of the client |
eventsClientPerformanceInfo
Client performance information
Name | Type | Description |
---|---|---|
name |
string |
The name of the client performance |
eventsCloudInfo
Cloud info for an event result
Name | Type | Description |
---|---|---|
roleInstance |
string |
Role instance of the cloud |
roleName |
string |
Role name of the cloud |
eventsCustomEventInfo
The custom event information
Name | Type | Description |
---|---|---|
name |
string |
The name of the custom event |
eventsCustomEventResult
A custom event result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customEvent |
The custom event information |
|
customMeasurements |
Custom measurements of the event |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
custom |
The type of event. |
user |
User info of the event |
eventsCustomMetricInfo
The custom metric info
Name | Type | Description |
---|---|---|
name |
string |
The name of the custom metric |
value |
number |
The value of the custom metric |
valueCount |
integer |
The count of the custom metric |
valueMax |
number |
The maximum value of the custom metric |
valueMin |
number |
The minimum value of the custom metric |
valueStdDev |
number |
The standard deviation of the custom metric |
valueSum |
number |
The sum of the custom metric |
eventsCustomMetricResult
A custom metric result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
customMetric |
The custom metric info |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
custom |
The type of event. |
user |
User info of the event |
eventsDependencyInfo
The dependency info
Name | Type | Description |
---|---|---|
data |
string |
The data of the dependency |
duration |
integer |
The duration of the dependency |
id |
string |
The ID of the dependency |
name |
string |
The name of the dependency |
performanceBucket |
string |
The performance bucket of the dependency |
resultCode |
string |
The result code of the dependency |
success |
string |
Indicates if the dependency was successful |
target |
string |
The target of the dependency |
type |
string |
The type of the dependency |
eventsDependencyResult
A dependency result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
dependency |
The dependency info |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
dependency |
The type of event. |
user |
User info of the event |
eventsExceptionDetail
Exception details
Name | Type | Description |
---|---|---|
id |
string |
The ID of the exception detail |
message |
string |
The message of the exception detail |
outerId |
string |
The outer ID of the exception detail |
parsedStack |
The parsed stack |
|
severityLevel |
string |
The severity level of the exception detail |
type |
string |
The type of the exception detail |
eventsExceptionDetailsParsedStack
A parsed stack entry
Name | Type | Description |
---|---|---|
assembly |
string |
The assembly of the stack entry |
level |
integer |
The level of the stack entry |
line |
integer |
The line of the stack entry |
method |
string |
The method of the stack entry |
eventsExceptionInfo
The exception info
Name | Type | Description |
---|---|---|
assembly |
string |
The assembly which threw the exception |
details |
The details of the exception |
|
handledAt |
string |
Indicates where the exception was handled at |
innermostAssembly |
string |
The inner most assembly of the exception |
innermostMessage |
string |
The inner most message of the exception |
innermostMethod |
string |
The inner most method of the exception |
innermostType |
string |
The inner most type of the exception |
message |
string |
The message of the exception |
method |
string |
The method that threw the exception |
outerAssembly |
string |
The outer assembly of the exception |
outerMessage |
string |
The outer message of the exception |
outerMethod |
string |
The outer method of the exception |
outerType |
string |
The outer type of the exception |
problemId |
string |
The problem ID of the exception |
severityLevel |
integer |
The severity level of the exception |
type |
string |
The type of the exception |
eventsExceptionResult
An exception result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
exception |
The exception info |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
exception |
The type of event. |
user |
User info of the event |
eventsOperationInfo
Operation info for an event result
Name | Type | Description |
---|---|---|
id |
string |
ID of the operation |
name |
string |
Name of the operation |
parentId |
string |
Parent ID of the operation |
syntheticSource |
string |
Synthetic source of the operation |
eventsPageViewInfo
The page view information
Name | Type | Description |
---|---|---|
duration |
string |
The duration of the page view |
name |
string |
The name of the page |
performanceBucket |
string |
The performance bucket of the page view |
url |
string |
The URL of the page |
eventsPageViewResult
A page view result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
pageView |
The page view information |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
page |
The type of event. |
user |
User info of the event |
eventsPerformanceCounterInfo
The performance counter info
Name | Type | Description |
---|---|---|
category |
string |
The category of the performance counter |
counter |
string |
The counter of the performance counter |
instance |
string |
The instance of the performance counter |
instanceName |
string |
The instance name of the performance counter |
name |
string |
The name of the performance counter |
value |
number |
The value of the performance counter |
eventsPerformanceCounterResult
A performance counter result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
performanceCounter |
The performance counter info |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
performance |
The type of event. |
user |
User info of the event |
eventsRequestInfo
The request info
Name | Type | Description |
---|---|---|
duration |
number |
The duration of the request |
id |
string |
The ID of the request |
name |
string |
The name of the request |
performanceBucket |
string |
The performance bucket of the request |
resultCode |
string |
The result code of the request |
source |
string |
The source of the request |
success |
string |
Indicates if the request was successful |
url |
string |
The URL of the request |
eventsRequestResult
A request result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
request |
The request info |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
type |
string:
request |
The type of event. |
user |
User info of the event |
eventsResults
An events query result.
Name | Type | Description |
---|---|---|
@ai.messages |
OData messages for this response. |
|
@odata.context |
string |
OData context metadata endpoint for this response |
value | eventsResultData[]: |
Contents of the events query result. |
eventsSessionInfo
Session info for an event result
Name | Type | Description |
---|---|---|
id |
string |
ID of the session |
eventsTraceInfo
The trace information
Name | Type | Description |
---|---|---|
message |
string |
The trace message |
severityLevel |
integer |
The trace severity level |
eventsTraceResult
A trace result
Name | Type | Description |
---|---|---|
ai |
AI info of the event |
|
application |
Application info of the event |
|
client |
Client info of the event |
|
cloud |
Cloud info of the event |
|
count |
integer |
Count of the event |
customDimensions |
Custom dimensions of the event |
|
customMeasurements |
Custom measurements of the event |
|
id |
string |
The unique ID for this event. |
operation |
Operation info of the event |
|
session |
Session info of the event |
|
timestamp |
string |
Timestamp of the event |
trace |
The trace information |
|
type |
string:
trace |
The type of event. |
user |
User info of the event |
eventsUserInfo
User info for an event result
Name | Type | Description |
---|---|---|
accountId |
string |
Account ID of the user |
authenticatedId |
string |
Authenticated ID of the user |
id |
string |
ID of the user |
EventType
The type of events to query; either a standard event type (traces
, customEvents
, pageViews
, requests
, dependencies
, exceptions
, availabilityResults
) or $all
to query across all event types.
Name | Type | Description |
---|---|---|
$all |
string |
|
availabilityResults |
string |
|
browserTimings |
string |
|
customEvents |
string |
|
customMetrics |
string |
|
dependencies |
string |
|
exceptions |
string |
|
pageViews |
string |
|
performanceCounters |
string |
|
requests |
string |
|
traces |
string |