Merge pull request #2687 from splunk/johannahp-O11YDOCS-6428-service-view-updates

APM error based troubleshooting doc updates and service map redesign doc updates

Author: johannahp-splunk

_images/apm/spans-traces/service-map-updated-view.png

@@ -15,7 +15,7 @@ See :ref:`apm-inferred-services` to learn more about inferred services in APM.
 
 The following screenshot shows an example service map: 
 
-..  image:: /_images/apm/spans-traces/service-map-global-search-rename.png
+..  image:: /_images/apm/spans-traces/service-map-updated-view.png
     :width: 95%
     :alt: An example of the service map in Splunk APM Service Map.
 
@@ -28,6 +28,8 @@ Use these steps to access the service map in Splunk APM:
 #. Log into Splunk Observability Cloud. 
 #. Select :guilabel:`APM` in the navigation bar. 
 #. Select :guilabel:`Service Map` on the APM landing page. The service map view opens, with the service map in the center. 
+#. (Optional) Select :guilabel:`Switch to Classic Service Map` to switch to the lateral service map layout. The default constellation view displays a larger view of your environment and helps you quickly assess service performance. 
+
 
 Using the service map, you can do the following: 
 
@@ -86,15 +88,6 @@ When configured, you can select tiles in the Related Content bar to seamlessly n
 ..  image:: /_images/apm/spans-traces/service-map-related-content-global-search-rename.gif
     :alt: Using Related Content in Splunk Observability Cloud.
 
-Configure and view global data links for your service map
-==========================================================
-
-You can configure global data links to link Splunk APM properties, such as services, traces, spans, and span tags, to relevant resources. For example, you can link APM properties to Infrastructure Monitoring navigators and dashboards, Splunk instances, Kibana logs, Splunk AppDynamics tiers, or custom URLs.
-
-For information on how to configure data links to display in your service map, see :ref:`apm-create-data-links`. You can also create a global data link directly from the APM :guilabel:`Service Map` by selecting an inferred service, selecting the :guilabel:`(⋯)` menu next to the inferred service name, and selecting :guilabel:`Configure data links`.
-
-For information on how to view data links in your service map, see :ref:`apm-use-data-links`.
-
 Share your view of the service map
 ======================================
 To share your view of the service map with a colleague, copy and share the URL. Your current filter selections are preserved in the URL.

_images/apm/spans-traces/service-view-errors.png

@@ -29,7 +29,7 @@ You can also access the service view for a specific service within the service m
 
 Finally, you can also access the service view for a specific service by selecting the service from the APM landing page.
 
-Use the service overview to monitor the health of your service
+Use the service view to monitor the health of your service
 =====================================================================
 
 When you open the service view an environment is selected based on your recently viewed environments. Adjust the environment and time range filters if necessary. Use the following sections to monitor the health of your service.
@@ -54,6 +54,18 @@ Use the following metrics in the :guilabel:`Service metrics` section to monitor
    *  Inferred services - un-instrumented third-party services
    *  Pub/sub queues - Publisher/subscriber queues
 
+Error breakdown
+-----------------
+
+Use the following section to troubleshoot service errors and view relevant traces for specific error types. Select a point on the graph to view example traces for a particular data point, or select any value to hide the time series for that value.
+
+..  image:: /_images/apm/spans-traces/service-view-errors.png
+    :width: 95%
+    :alt: Screenshot of charts on the service view page that display service errors. 
+
+* Errors by exception type - Displays errors with the span attribute ``exception.type``. Select a data point on the chart to view related traces and alert details for that time period. 
+* Errors by status code - Displays errors based on the HTTP or gRPC error status code. Select a data point on the chart to view related traces and alert details for that selected time period and error. For more information about error status codes, see :new-page:`Semantic Conventions for HTTP Spans <https://opentelemetry.io/docs/specs/semconv/http/http-spans/>`.
+
 Runtime metrics
 -----------------
 
@@ -82,6 +94,13 @@ View Tag Spotlight view for your service
 
 Select :guilabel:`Tag Spotlight` to view Tag Spotlight view filtered for your service. See :ref:`apm-tag-spotlight` to learn more about Tag Spotlight.
 
+View errors for your service
+====================================================
+
+Select the :guilabel:`Errors` tab to visualize errors for your service. Select a specific error type to view available traces for that error, and troubleshoot by viewing details such as the ``exception.message`` or ``exception.stacktrace``. 
+
+Administrators can pause these metrics by going to the :guilabel:`Sources of Errors MetricSets` section on the :guilabel:`APM MetricSets` page and selecting :guilabel:`Pause Indexing`. These metrics are turned on by default.
+
 View endpoints for your service
 =================================
 

apm/apm-spans-traces/service-map.rst

@@ -25,7 +25,7 @@ To view service performance broken down by your indexed span tags, follow these
      * Select the :guilabel:`Tag Spotlight` panel on the APM landing page or in the service map. 
      * Select the :guilabel:`Tag Spotlight` tab in the service view for your service.
      * Use the search in the top toolbar to search for Tag Spotlight and select the navigation result to go to Tag Spotlight.
-#. Add time range, environment, workflow, service, operation, and tag filters as need to refine the data in your Tag Spotlight view. The default time range is for the last 15 minutes, and the data resolution is 10 seconds.
+#. Add time range, environment, workflow, service, endpoint, operation, and tag filters as need to refine the data in your Tag Spotlight view. The default time range is for the last 15 minutes, and the data resolution is 10 seconds.
 #. Use the request and errors and latency time-series charts at the top to see a distribution of your RED metrics.
 #. Use the bar charts under the request and errors and latency time-series charts to view RED metrics for each indexed span tag.
 #. View the distribution of all indexed span tags. The tag bar charts display either request and error distributions or latency distribution. Use the :guilabel:`Cards display` menu to select the data you want to display in the bars.