Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
View your application topology and monitor operational health with
the CloudWatch service map
The CloudWatch service map replaces the ServiceLens map. To see a map of your application based
on Amazon X-Ray traces, open the X-Ray Trace Map. Choose
Trace Map under the X-Ray section in the left
navigation pane of the CloudWatch console.
Use the service map to view the topology of your application clients, synthetics canaries,
services and dependencies, and monitor operational health. To view the service map, open the
CloudWatch console and choose Service
Map under the Application Signals section in the left
navigation pane.
After you enable your application for
Application Signals, use the service map to make it easier to monitor your
application's operational health:
-
View connections between client, canary, service, and dependency nodes to help you
understand your application topology and execution flow. This is especially helpful if your
service operators are not your development team.
-
See which services are meeting or not meeting your service level objectives (SLOs). When a
service is not meeting your SLOs, you can quickly identify whether a downstream service or
dependency might be contributing to the issue or impacting multiple upstream services.
-
Select an individual client, synthetics canary, service, or dependency node to see
related metrics. The Service details page shows more
detailed information about operations, dependencies, synthetics canaries, and client pages.
-
Filter and zoom the service map to make it easier to focus on a part of your application
topology, or see the entire map. Create a filter by choosing one or more properties from the
filter text box. As you choose each property, you are guided through filter criteria. You
will see the complete filter below the filter text box. Choose Clear
filters at any time to remove the filter.
The following example service map shows services with edges connecting them to components
that they interact with. If an SLO is defined, the service map also shows health status.
Explore the service map
After you have enabled your application for Application Signals, the service map displays
nodes representing your services and their dependencies.
Turn on active tracing for your CloudWatch RUM clients and synthetics canaries to see client and
canary nodes on the map.
By default, canaries, RUM clients, and Amazon
service dependencies of the same kind are grouped together into a single expandable icon in
the service map. Service dependencies outside of Amazon are not grouped together by default.
For example, in the following image, all Amazon S3 buckets are
grouped together under one expandable icon:
In the previous image, the label between the Amazon S3 grouping and originating
service displays the number of edges to the group in parenthesis under the dependency's icon.
Select the (+) icon to expand the group and see its individual elements, as shown in the
following image:
Choose a tab for information about exploring each kind of node and the edges (connections)
between them.
- View your application services
-
You can view your application services and the status of their SLOs and service
level indicators (SLIs) in the Service Map. If you didn't create
SLOs for a service, choose the Create SLO button below the service
node.
The Service Map displays all of your services. It also shows
the customers and canaries that consume the service and the dependencies that your
services calls, as shown in the following image:
The following icons represent examples of application services in the service
map:
When you select a service node, a pane opens displaying detailed service
information:
-
Metrics for call volume, latency, error, and fault rate.
-
The number of SLIs and SLOs that are healthy or
unhealthy.
-
The option to view more information about an SLO.
-
The number of service operations, dependencies, synthetics canaries, and client
pages.
-
The option to select each number to open the Service details page for it.
-
The application name, if you have associated the underlying compute resource
with an application using AppRegistry or the Applications card on the Amazon Web Services Management Console home
page.
-
The Cluster, Namespace, and Workload for
services hosted in Amazon EKS, or Environment for services hosted in Amazon ECS
or Amazon EC2. For Amazon EKS-hosted services, choose any link to open CloudWatch Container
Insights.
Select an edge or connection between a service node and a downstream service or
dependency node. This opens a pane containing top paths by fault rate, latency, and
error rate, as shown in the following example image. Choose any link in the pane to open
the Service details page and see detailed
information for the chosen service or dependency.
- View dependencies
-
Your application dependencies are displayed on the service map, connected to the
services that call them.
Choose a dependency node to open a pane containing top paths by fault rate, latency,
and error rate. Choose any service or target link to open the Service Details page and see detailed information about
the chosen service or dependency target, as shown in the example image below:
Service dependencies are grouped together by default into a single expandable icon.
Select the (+) icon, as shown in the previous image, to expand the group and see its
individual elements.
The following icons represent examples of dependency nodes in the service
map:
- View clients
-
After you turn on
X-Ray tracing for your CloudWatch RUM web clients, they display on the service map
connected to services they call.
Choose a client node to open a pane displaying detailed client information:
-
Metrics for page loads, average load time, errors, and average web vitals.
-
A graph displaying a breakdown of errors.
-
A link to display the client details in CloudWatch RUM.
RUM clients are grouped together by default into a single expandable icon. Select
the (+) icon, as shown in the following image, to expand the group and see its individual
elements.
The following icon represents an example of a RUM client in the service map:
- View synthetics canaries
-
After you turn on Amazon X-Ray
tracing for your CloudWatch Synthetics canaries, they display on the service map
connected to services they call, as shown in the following example image:
Choose a canary node to open a pane displaying detailed canary information, as shown
in the following image:
Canaries are grouped together by default into a single expandable icon. Select the
(+) icon, as shown in the previous image, to expand the group and see its individual
elements.
The following icons represent examples of clients in the service
map:
In the pane for canary nodes, you can see the following:
-
Metrics for success percentage, average duration, and errors.
-
The status of the last canary run.
-
A graph displaying canary run duration. Hover over a graph series to see a
pop-up containing more information.
-
A link to display canary details in CloudWatch Synthetics.
