Professional Documents
Culture Documents
OnDevice HTTP - User Manual
OnDevice HTTP - User Manual
OnDevice HTTP - User Manual
Contents
1 Overview 3
1.1 Operational and Functional Differences .......................................................... 3
1.1.1 HTTP GET - UE Download .............................................................. 3
1.1.2 HTTP GET - UE Webkit ................................................................... 3
1.1.3 HTTP POST - HTTP UE .................................................................. 5
2 Prerequisites 6
2.1 Phone Setup .................................................................................................... 6
2.1.1 App Permission ................................................................................ 6
3 Activity Configuration 7
3.1 Sample Scripts ................................................................................................ 7
3.1.1 HTTP GET - UE Download .............................................................. 7
3.1.2 HTTP GET - UE Webkit ................................................................... 7
3.1.3 HTTP POST - HTTP UE .................................................................. 7
3.2 Settings............................................................................................................ 8
3.2.1 HTTP GET - UE Download .............................................................. 8
3.2.2 HTTP GET - UE Webkit .................................................................10
3.2.3 HTTP POST – HTTP UE ...............................................................13
5 Highlights 30
5.1 Limitations .....................................................................................................30
http_get_ue_download.tsc
http_get_ue_webkit.tsc
http_post_ue_http.tsc
Property Description
Expected MD5 After downloaded the file, an MD5 hash will be calculated. If this is provided,
it will be used to verify with the calculated MD5.
The MD5 format is 32 hexadecimal characters. For multiple files, separate
each MD5 with a comma like the URL above.
End Session After Set to True to end session successfully after the download exceeds the
Payload Size payload size.
Payload Size The payload size limit in bytes. If the download exceeds this value, the
download is considered done and the session will end.
Consider Any
Download Thread Indicating whether the test is considered as failure if any of the download or
Failure As Failed thread failed with data transfer cutoff.
Measurement
If set to True, the test will proceed regardless IPCapture service can be
started. If IPCapture service not exists or failed to start, only limited KPIs will
be reported. Refer to 3.3.5 section for the limited KPIs.
If set to False, the test will return with error message Failed to start
IPCapture Service if IPCapture service not exists or failed to start.
Maximum wait time for DNS lookup.
Dns Timeout
Set to 00:00.00 to disable the timeout.
Set to True to use the last 200 OK or 206 response as First Packet With
Use Last Connection Content.
As Marker for Time
Based Measurement This option is ONLY applicable for time based measurement.
Network Access Maximum wait time for the device data connection up.
Timeout
Maximum wait time from First DNS request to First Packet With Content
Time To First Byte
Timeout Set to 00:00.00 to disable the timeout.
Optional
If an internal setting (see below) is enabled, the computation of Time to
FirstByte is from FirstDnsRequest to first HTTP response from server
(response can be 404, 3xx (redirection), etc) . Previously, this is the time
from FirstDnsRequest to FirstPktWithContent.
NOTE: If the response code is 200 then there is no change since 200 is
treated as FirstPktWithContent
Property Description
End Session After Set to True to end session successfully after the download exceeds the
Payload Size payload size.
Payload Size The payload size limit in bytes. If the download exceeds this value, the
download is considered done and the session will end.
This setting is obsolete starting from ODM 1.190 onwards, user should set
Proceed Without IP this to False always.
Sniffer
For ODM versions prior to ODM 1.190, this value indicates whether the test
should proceed if the IPCapture service failed to start.
If set to True, the test will proceed regardless IPCapture service can be
started. If IPCapture service does not exists or failed to start, only limited
KPIs will be reported. Refer to 3.3.5 section for the limited KPIs.
If set to False, the test will return with error message Failed to start
IPCapture Service if IPCapture service does not exists or failed to start.
Minimum Payload Minimum payload as one of the criterias to determine the live page browsing
completion.
Refer to 1.1.2.2 for details.
Silence Time Silence time as one of the criterias to determine the live page browsing
completion.
Refer to 1.1.2.2 for details.
Maximum Wait Time Maximum wait time from the page completion event notification until getting
the minimum payload and exceeds silence time.
Set ‘0’ to disable the timeout.
Maximum wait time from First Syn to First Packet With Content.
IP Service Access
Timeout Method A Set to 00:00.00 to disable the timeout.
Maximum wait time from First DNS request to First Packet With Content
Time To First Byte
Timeout Set to 00:00.00 to disable the timeout.
Optional
If an internal setting (see below) is enabled, the computation of Time to
FirstByte is from FirstDnsRequest to first HTTP response from server
(response can be 404, 3xx (redirection), etc) . Previously, this is the time
from FirstDnsRequest to FirstPktWithContent.
NOTE: If the response code is 200 then there is no change since 200 is
treated as FirstPktWithContent
Property Description
This setting is obsolete starting from ODM 1.190 onwards, user should
Proceed Without IP set this to False always.
Sniffer
For ODM versions prior to ODM 1.190, this value indicates whether the test
should proceed if the IPCapture service failed to start.
If set to True, the test will proceed regardless IPCapture service can be
started. If IPCapture service does not exists or failed to start, only limited
KPIs will be reported. Refer to 3.3.5 section for the limited KPIs.
End Session After Set to True to end session successfully after the upload exceeds the
Payload Size payload size.
The payload size limit in bytes. If the upload exceeds this value, the upload
Payload Size is considered done and the session will end.
Maximum wait time for DNS lookup.
Dns Timeout
Set to 00:00.00 to disable the timeout.
Set to True to use the first upload packet of the last connection as First
Use Last Connection Packet With Content.
As Marker for Time
Based Measurement This option is ONLY applicable for time based measurement.
Network Access Maximum wait time for the device data connection up.
Timeout
Maximum wait time from First DNS request to First Packet With Content
Time To First Byte
Timeout Set to 00:00.00 to disable the timeout.
Optional
If an internal setting (see below) is enabled, the computation of Time to
FirstByte is from FirstDnsRequest to first HTTP response from server
(response can be 404, 3xx (redirection), etc) . Previously, this is the time
from FirstDnsRequest to FirstPktWithContent.
NOTE: If the response code is 200 then there is no change since 200 is
treated as FirstPktWithContent
Tr-1 Script activity start TEMS script activity been trigger to start
First HTTP GET Operation first HTTP GET request Tr-3 Tr-4
HTTP Get Session Failure Ratio The failure rate of the HTTP GET session.
HTTP Transfer Time Elapsed time for current HTTP download session.
For throughput measurement, it start measures upon getting the GET Response with
200 OK. From there onwards, throughput will be updated in every second of interval.
DNS Query
DNS Response
HTTP payload
P1: Payload Update (every sec)
𝑃𝑎𝑦𝑙𝑜𝑎𝑑𝑃2 − 𝑃𝑎𝑦𝑙𝑜𝑎𝑑𝑃1
𝐴𝑝𝑝𝑙𝑖𝑐𝑎𝑡𝑖𝑜𝑛𝐿𝑎𝑦𝑒𝑟𝑇ℎ𝑟𝑜𝑢𝑔ℎ𝑝𝑢𝑡𝐷𝑜𝑤𝑛𝑙𝑖𝑛𝑘𝑃2 =
𝑇𝑖𝑚𝑒𝑃2 − 𝑇𝑖𝑚𝑒𝑃1
𝑃𝑎𝑦𝑙𝑜𝑎𝑑𝑃2
𝐻𝑡𝑡𝑝𝐴𝑣𝑒𝑟𝑎𝑔𝑒𝑇ℎ𝑟𝑜𝑢𝑔ℎ𝑝𝑢𝑡𝑃2 =
𝑇𝑖𝑚𝑒𝑃2 − 𝑇𝑖𝑚𝑒𝑃0
Tr-1 Script activity start TEMS script activity been trigger to start
First HTTP POST Operation first HTTP POST request Tr-3 Tr-4
HTTP Post File Size Sent Size of file uploaded over HTTP.
HTTP Post File Transfer Time Time taken by the browser to complete the HTTP upload.
For throughput measurement, it starts measures upon getting the First Uploaded Byte
after the POST Request. From there onwards, throughput will be updated in every
second of interval.
𝑃𝑎𝑦𝑙𝑜𝑎𝑑𝑃2 − 𝑃𝑎𝑦𝑙𝑜𝑎𝑑𝑃1
𝐴𝑝𝑝𝑙𝑖𝑐𝑎𝑡𝑖𝑜𝑛𝐿𝑎𝑦𝑒𝑟𝑇ℎ𝑟𝑜𝑢𝑔ℎ𝑝𝑢𝑡𝑈𝑝𝑙𝑖𝑛𝑘𝑃2 =
𝑇𝑖𝑚𝑒𝑃2 − 𝑇𝑖𝑚𝑒𝑃1
𝑃𝑎𝑦𝑙𝑜𝑎𝑑𝑃2
𝐻𝑡𝑡𝑝𝑃𝑜𝑠𝑡𝐴𝑣𝑒𝑟𝑎𝑔𝑒𝑇ℎ𝑟𝑜𝑢𝑔ℎ𝑝𝑢𝑡𝑃2 =
𝑇𝑖𝑚𝑒𝑃2 − 𝑇𝑖𝑚𝑒𝑃0
✓ - SUPPORT
- SUPPORT ONLY IF IP Capture Service is available.
19 HTTP Throughput ✓
KPIs HTTP UE
✓ - SUPPORT
- SUPPORT ONLY IF IP Capture Service is available.
1 Service Status ✓ ✓
2 Session Identity ✓ ✓
4 Service Bearer ✓ ✓
7 Multi Sockets ✓
9 Limited KPIs ✓ ✓
10 Is Https
11 Local IP Address
12 Destination IP Address
✓ - SUPPORT
- SUPPORT ONLY IF IP Capture Service is available.
1 Service Status ✓
2 Session Identity ✓
4 Service Bearer ✓
7 Multi Sockets ✓
8 Limited KPIs ✓
9 Is Https
10 Local IP Address
11 Destination IP Address
1 Result produced from the testing without IP Capture Service are all derived from application
level. The accuracy will be degraded compare to the result measured with IP Capture Service.
2 Residual packets can propagate to the following activity causing mixed traffic, particularly during
bad network conditions but has also been observed to happen on good network conditions as
well.
Solution to this issue remains out of reach and ODM is entirely reliant on the Android OS to
close the connection when instructed to by ODM.