Monitoring applications that access data services
The Network Monitor is a useful tool for monitoring and
debugging applications that access data services. The Network Monitor
allows you to examine the data that flows between an application
and a data service. It also examines XML, AMF, and JSON data, which
are sent using SOAP, AMF, HTTP, and HTTPS protocols.
The Network Monitor is active in the Flash Development and Flash
Debug perspectives.
Enabling network monitoringYou enable the Network Monitor for individual Flex projects.
The monitor state (enabled or disabled) applies to all applications
within that project. You cannot enable or disable the Network Monitor
on an individual application basis.
By default the Network Monitor is not enabled. You enable the
Network Monitor by selecting the Enable Monitor icon in the Network
Monitor toolbar.
Enabling the Network MonitorThis procedure
assumes you are in the Flex Development or Flex Debug perspective.
If the Network Monitor view is not open, from the Flash Builder
menu select Windows > Other Views > Flash Builder > Network
Monitor.
If the Network Monitor is not enabled, in the Network Monitor
toolbar click the Enable Network Monitor button.
This button
is a toggle for enabling or disabling the Network Monitor.
Monitoring remote servicesTo monitor your application, run either the development
or debug version of the application with the Network Monitor enabled.
In general, the Network Monitor captures and stores all event
data until you either quit the application or explicitly clear the
data. The events are displayed in chronological order.
Starting a monitoring sessionRun either a development or debug version of the
application that accesses remote services.
For each access to a remote service, the Network Monitor
lists the following:
Select a column header to sort the returned data according
to the values in that column.
Click the column again to invert
the order of the data.
Select the request and parameter tabs at the bottom of the
monitor to view the details about the request operation.
The
actual data sent in the request, as well as other information about
the request, can be viewed from these tabs.
Select the response and result tabs at the bottom of the
monitor to view the details about the response.
The actual
data sent in the response, as well as other information about the response,
can be viewed from these tabs.
Double-click an entry to go to the source code for that operation.
The
Flash Builder source editor opens with the relevant line of source
code highlighted.
Note: For most events, the Network Monitor
can correlate an event with the Flex source code. For some events
that are triggered outside the scope of the Network Monitor, the
monitor cannot find the Flex source code.
Click the Save button on the Network Monitor toolbar to write
all captured information to an XML file.
Note: Use the generated
XML file to study the data offline. You cannot import the data from
this file back into the Network Monitor.
Click the Clear icon in the Network Monitor toolbar to remove
all captured information from the monitor.
Suspending a monitoring sessionYou can suspend and resume network monitoring. Suspending
and resuming a session applies to all applications in the Flex project.
For example, you cannot suspend one application in the project and
continue monitoring another.
Click the Suspend button in the Network Monitor toolbar
to suspend the monitoring of a session.
Click the Resume button in the toolbar to continue monitoring
the session.
Stopping a monitoring sessionTo stop monitoring a session, you disable the Network Monitor.
(Optional) Close the Network Monitor.
Note: Simply
closing the Network Monitor does not stop the monitoring session. Monitoring
is still active, even if the Network Monitor is closed.
Click the Enable Network Monitor button.
This button
is a toggle for enabling or disabling the Network Monitor.
Note: Disabling
the Network Monitor applies to all applications in the Flex project.
Support for HTTPS protocolThe Network Monitor supports monitoring HTTPS calls to
a server certified by a certificate authority (CA) or that has a
self-signed certificate.
To monitor calls over the HTTPS protocol, modify the default
preference for the Network Monitor to ignore SSL security checks.
Open the Preferences dialog and navigate to Flash Builder > Network
Monitor.
Viewing Network Monitor dataThe leftmost panel of the Network Monitor provides information
about the source of the data. It displays the following information:
Source URL for the data service
The type of service displayed
For example RemoteService,
HTTPService, or WebService.
The request time, response time, and elapsed time for the
data request
The name of the operation called from the data service.
The Network Monitor has two tabs for viewing data, allowing you
to view the request data and response data.
For each request and response, you can view the data in Tree
View, Raw View, or Hex view. Select the corresponding icon for each
view to change how the Network Monitor displays the data.
Tree View
Shows the XML, JSON, and AMF data in
a tree structure format. This is the default view for data.
Raw View
Shows the actual data that is transferred.
Hex View
Shows the data in hexadecimal format. Hex
view is useful when debugging binary data sent over a network.
By default, the Network Monitor clears all recorded data with
every launch of an application. However, you can change the default
behavior and retain all monitor data. Retained monitor data includes
the data from all applications in all projects. Open the Preference
dialog and navigate to Flash Builder > Network Monitor. Deselect
Clear Entries on Start.
Saving Network Monitor dataYou can save Network Monitor data to an XML. Click the
Save button in the Network Monitor view to save Network Monitor
data.
Monitoring multiple applicationsYou can monitor multiple applications simultaneously. There
are two scenarios for monitoring multiple applications:
Monitoring multiple applications in the same project
You
can only have one Network Monitor per Flex project. When monitoring multiple
applications in the same project, events from all applications appear in
the monitor according to the time the event occurred.
You
cannot filter events in the monitor according to specific applications.
Monitoring multiple applications in different projects
You
can open a Network Monitor for each active Flex project. Each Network Monitor
is independent of the other monitor, displaying only the events
for its specific project.
Suspending or disabling a Network
Monitor in one project does not apply to monitors in other projects.
Limitations of the Network MonitorBe aware of the following limitations when monitoring network
data:
The Network Monitor does not support applications
that were created using pure ActionScript and Library projects.
The Network Monitor does not support the Real Time Messaging
Protocol (RTMP). For example, you cannot monitor streaming video.
|
|