--- title: Service Page description: >- Comprehensive service overview with health metrics, dependencies, deployments, error tracking, and security insights. breadcrumbs: Docs > APM > Service Observability > Service Page --- # Service Page {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/overview_service_page_1.23b8a898329ddc80ce4811b8ed0ec103.png?auto=format" alt="Detailed service page" /%} ## Overview{% #overview %} Selecting a service on the Software Catalog leads you to the detailed service page. A service is a set of processes that do the same job - for example a web framework or database (read more about how services are defined in [Getting Started with APM](https://docs.datadoghq.com/tracing/glossary/)). Consult on this page: - Service health - Service monitor states - Watchdog Insights - Summary cardsImportant note for users on the following Datadog sites: ap1.datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, app.datadoghq.eu, app.datadoghq.com, ap2.datadoghq.com: - Dependencies - Out-of-the-box graphs - [Resources associated to this service](https://docs.datadoghq.com/tracing/services/resource_page/) - Additional sections - Deployments, Error Tracking, Traces, Security, and more ## Service health{% #service-health %} **Service health** provides a real-time summary of service status to help you identify services that need immediate attention. Service health integrates multiple signals (monitors, incidents, and Watchdog Insights) into a single alert. See which services are in a critical state to detect and troubleshoot issues faster. {% image source="https://datadog-docs.imgix.net/images/tracing/services/service_page/service-health3.61ebdf76da264cdd34629512bb669def.png?auto=format" alt="Service health on the service page and service dependency map." /%} Service health is available in several places in Datadog: 1. [Software Catalog](https://app.datadoghq.com/services) 1. Service pages 1. Service dependendency maps, if Watchdog detects that an issue spans multiple service dependencies. 1. Service pills Service health displays the status of your service as *Critical* or *Warning* if at least one of the following conditions is met: | Status | Condition | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Critical** | **Monitors**:- A non-muted monitor with a paging integration setup (PagerDuty or Opsgenie) is in an `ALERT` state and triggered within the `past 2 days`.**Incidents**:- An incident of any severity is active.**Watchdog Insights**:- A faulty deployment is ongoing.- An APM latency/error rate alert is ongoing. | | **Warning** | **Monitors**:- A non-muted warning monitor with a paging integration setup (PagerDuty or Opsgenie) is in a `WARN` state and triggered within the `past 2 days`.**Incidents**:- An incident of any severity is stable .**Watchdog Insights**:- A log anomaly alert is ongoing. | | **Ok** | No alerts from the critical or warning state are active. | ## Service monitor{% #service-monitor %} The Service monitor panel surfaces active Monitors and Synthetics tests linked to your service. Datadog also proposes a list of monitors depending on your service type: {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/service_monitors.8ed4c892e57e7ee9cfc88687010ce26c.png?auto=format" alt="Service Monitors" /%} Enable them directly or create your own [APM monitors](https://docs.datadoghq.com/monitors/types/apm/). **Note**: Monitors are attached to an APM service if `service:` is tagged in the metadata, included in the monitor query, or if the query is grouped-by service. You can also tag any Synthetic Test with `service:` to attach it to an APM service. ## Watchdog Insights{% #watchdog-insights %} The [Watchdog Insights](https://docs.datadoghq.com/watchdog/) carousel surfaces anomalies and outliers detected on specific tags, enabling you to investigate the root cause of an issue. Insights are discovered from APM, Continuous Profiler, Log Management, and Infrastructure data that include the service tag. These insights are the same insights that appear in each of the product pages. For example, the same Log outliers on the service page can be found in the [Log Explorer](https://www.datadoghq.com/blog/datadog-watchdog-insights-log-management/). {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/cross_product_insight_1.1e5dff9e8709c19739d2d010fd5201b5.jpg?auto=format" alt="Watchdog Insights" /%} Click on an insight to see more details, such as the time frame of the insight, related logs or traces, and suggested next steps. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/watchdog_details_1.1fe2a79fcece945cb546ef6b18852224.jpg?auto=format" alt="Watchdog Insights details" /%} ## Summary cards{% #summary-cards %} The service page features summary cards with highlights on your service health. Easily spot potential faulty deployments, click into the card to view details or traces of the latest deployment, or view all deployments on this service. See new issues flagged on your service through our integration with [Error Tracking](https://docs.datadoghq.com/tracing/error_tracking/), where errors are automatically aggregated into issues. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/summary_cards.86a312ae37a67cee1d2cfd994f4912bb.png?auto=format" alt="Summary cards" /%} Our [Service Level Objectives (SLOs)](https://docs.datadoghq.com/service_level_objectives/) and [Incidents](https://docs.datadoghq.com/incident_response/incident_management/) summaries allow you to monitor the status of SLOs and ongoing incidents, so that you can keep performance goals top of mind. Click the cards to create a new SLO on the service or declare an incident. The [security signals](https://docs.datadoghq.com/security/application_security/how-it-works/) summary highlights how your services react to application threats. ## Out-of-the-box graphs{% #out-of-the-box-graphs %} Datadog provides out-of-the-box graphs for any given service. Use the dropdown above each graph to change the displayed information. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/out_of_the_box_graphs.94bbbfb35fc2bea8d5b81203b5ba53c2.jpg?auto=format" alt="Out of the box service graphs" /%} ### Requests and Errors{% #requests-and-errors %} The **Requests and Errors** graph displays the total number of requests (hits) and errors over time. Using the dropdown menu, you can also view: - **Requests by Version**: Breakdown of requests across different service versions. - **Requests per Second by Version**: The rate of requests for each version. - **Requests and Errors Per Second**: The rate of requests (hits) and errors per second. ### Errors{% #errors %} The **Errors** graph displays the total count of errors over time. Using the dropdown menu, you can also view: - **Errors by Version**: The error counts for each service version side by side. - **Errors per Second by Version**: The error rate (errors per second) for each service version over time. - **Errors per Second**: The overall error rate for the service, per second. - **% Error Rate by Version**: The percentage of requests resulting in errors for each service version. - **% Error Rate**: The overall error rate for the service, as a percentage. ### Latency{% #latency %} The **Latency** graph displays the latency percentiles as a timeseries. Using the dropdown menu, you can also view: - **Latency by Version**: Latency broken down by service version. - **Historical Latency**: Comparison of the current latency distribution with the previous day and week. - **Latency Distribution**: The distribution of latencies over the selected time frame. - **Latency by Error**: The latency of requests over time, segmented by whether the requests resulted in errors. - **Apdex** (Application Performance Index): The [Apdex](https://docs.datadoghq.com/tracing/guide/configure_an_apdex_for_your_traces_with_datadog_apm/) score over time. ### Avg Time per Request{% #avg-time-per-request %} For services involving multiple downstream services, a fourth graph breaks down the average [execution time](https://docs.datadoghq.com/glossary/#execution-time) spent per request. This graph is built on sampled trace data, unlike the other top graphs which use unsampled data sources. Using the dropdown menu, you can also view: - **Total Time Spent**: The cumulative time spent in each downstream service over time. - **% of Time Spent**: The percentage of time spent in each downstream service relative to the total time. For services like Postgres or Redis, which are final operations that do not call other services, there is no sub-services graph. [Watchdog](https://docs.datadoghq.com/watchdog/) performs automatic anomaly detection on the Requests, Latency, and Error graphs. If an anomaly is detected, an overlay appears on the graph. Clicking the Watchdog icon provides more details in a side panel. ### Export{% #export %} On the upper-right corner of each graph click on the arrow in order to export your graph into a pre-existing [dashboard](https://docs.datadoghq.com/dashboards/): {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/save_to_dashboard.e6a66c86bef6b838b613ab0ebfde9da2.png?auto=format" alt="Save to dashboard" /%} ## Resources{% #resources %} See Requests, Latency, and Error graphs broken down by resource to identify problematic resources. Resources are particular actions for your services (typically individual endpoints or queries). Below, there's a list of [resources](https://docs.datadoghq.com/tracing/glossary/#resources) associated with your service. Note: If the resource represents an external interface of an HTTP service, the list displays endpoints instead. Sort the service's resources by requests, latency, errors, or time to identify high-traffic areas or potential issues. You can configure these metric columns, as shown in the following example: {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/resources_tab_1.0f6d7d30e6b0db93ff3de476b8c3f838.jpg?auto=format" alt="Resources" /%} Click on a resource to open a side panel that displays the resource's out-of-the-box graphs (about requests, errors, and latency), a resource dependency map, and a span summary table. Use keyboard navigation keys to toggle between resources on the **Resources** list and compare resources in a service. To view the full resource page, click **Open Full Page**. [Refer to the dedicated resource documentation to learn more](https://docs.datadoghq.com/tracing/services/resource_page/). ### Columns{% #columns %} Choose what to display in your resources list: - **Requests**: Absolute amount of requests traced (per seconds) - **Requests per second**: Absolute amount of requests traced per second - **Total time**: Sum of all time spend in this resource - **Avg/p75/p90/p95/p99/Max Latency**: The Avg/p75/p90/p95/p99/Max latency of your traced requests - **Errors**: Absolute amount of error for a given resource - **Error Rate**: Percent of error for a given resource {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/resource_columns.c52b608871fce164967f7fca11d8a6ff.png?auto=format" alt="Resource columns" /%} {% callout %} # Important note for users on the following Datadog sites: ap1.datadoghq.com, ap2.datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, app.datadoghq.eu, app.datadoghq.com ## Dependencies{% #dependencies %} Visualize upstream and downstream dependencies that the service interacts with from the dependency map. The map is powered by [APM metrics](https://docs.datadoghq.com/tracing/metrics/metrics_namespace/) to surface accurate request counts, error rates, and latency numbers. The map automatically groups dependencies by operation name. For instance, if a service calls two downstream services using gRPC, these services are grouped together. The table on the left-hand side of the map shows requests and error rates over time, useful to identify failing dependencies. [Inferred service dependencies](https://docs.datadoghq.com/tracing/services/inferred_services/) like databases, queues, or third-party services are represented with a purple background node. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/dependencies_section.00796711c89198a72b9f4dfd5c756170.png?auto=format" alt="Service page dependency map" /%} **Note**: [Service overrides](https://docs.datadoghq.com/tracing/guide/service_overrides/) display along the edges (connecting lines) between nodes in the dependency map to keep visibility over the actual remote service, database, or queue the service is interacting with. ### Investigating a specific service dependency{% #investigating-a-specific-service-dependency %} Click on a dependency service node to investigate one of the service's dependencies. In the side panel, request count, errors, and latency metrics are scoped to requests going from the service to the downstream dependency. Use the following table to see which resources are invoked in client calls from the service to the downstream dependency. For instance, if the service is calling a database, see the breakdown of queries that are made to the database, and use the table to identify slow or failing queries. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/dependencies_side_panel.1280db2a3db13fe94dfdfeda7ae86057.png?auto=format" alt="Service page service dependency map" /%} {% /callout %} ## Additional sections{% #additional-sections %} ### Deployments{% #deployments %} A service configured with version tags will show versions in the Deployment tab. The version section shows all versions of the service that were active during the selected time interval, with active versions at the top. By default, you can see: - The version names deployed for this service over the timeframe. - The times at which traces that correspond to this version were first and last seen. - An Error Types indicator, which shows how many types of errors appear in each version that did not appear in the immediately previous version. **Note**: This indicator shows errors that were not seen in traces from the previous version. It doesn't mean that this version necessarily introduced these errors. Looking into new error types can be a great way to begin investigating errors. - Requests per second. - Error rate as a percentage of total requests. You can add columns to or remove columns from this overview table and your selections will be saved. The additional available columns are: - Endpoints that are active in a version that were not in the previous version. - Time active, showing the length of time from the first trace to the last trace sent to Datadog for that version. - Total number of Requests. - Total number of Errors. - Latency measured by p50, p75, p90, p95, p99, or max. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/deployments_1.b6dba6dd88eb594fe215f96025ef6fe1.png?auto=format" alt="Deployments" /%} Read more about Deployments [on the service page](https://docs.datadoghq.com/tracing/services/deployment_tracking/#versions-deployed). ### Error Tracking{% #error-tracking %} View issues on your service, which are similar errors aggregated together to turn a noisy stream of errors into manageable issues and help you assess the impact of your service's errors. Read more about issues in [Error Tracking](https://docs.datadoghq.com/tracing/error_tracking/). This tab has overview graphs that show which resources have the most issues and a list of the most common issues occurring in your service. Click on an issue in the list to see details in a side panel, including its stack trace, related code versions, and total error occurrences since inception. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/error_tracking_side_panel_1.3323855ce71b82b89a54087562651337.jpg?auto=format" alt="Error Tracking tab" /%} ### Security{% #security %} Understand the security posture of the service, including known vulnerabilities exposed in the service's libraries and security signals on your service, which are automatically created when Datadog detects application attacks impacting your services. The signals identify meaningful threats for you to review instead of assessing each individual attack attempt. Read more about [App and API Protection](https://docs.datadoghq.com/security/application_security/how-it-works/). The top section of the security tab has overview graphs that show the number and severity of vulnerabilities, a timeline of attacks, the types of attacks, and attacker information (client IP or authenticated user). The next section of the panel lists all the vulnerabilities and signals concerning the service. Click on a security vulnerability to open a side panel with relevant details to investigate further and remediate the vulnerability. Click on a security signal to get information about what the detected threat is and what actions you can take to remediate it. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/security_tab_1.100f0b8ab1e7cb207e93cd302a8b516b.jpg?auto=format" alt="Security" /%} ### Databases{% #databases %} View host details, queries, recommendations, and downstream database dependencies, and identify latency and load outliers. #### Queries{% #queries %} The Queries tab includes a visualization of sampled span durations and a full list of queries from the selected time interval. Select a query from the table to open the query panel and view diagnostics, error details, and traces. #### Databases{% #databases-1 %} The Databases tab includes active connection and average query duration visualizations to help identify outliers, and a full list of database hosts for the selected service. Select a database host from the list to view it in Database Monitoring. [Learn more about connecting DBM and APM](https://docs.datadoghq.com/database_monitoring/connect_dbm_and_apm/). ### Infrastructure{% #infrastructure %} If your service is running on Kubernetes, you can see an Infrastructure tab on the Service Page. The live Kubernetes Pods table displays detailed information on your pods, such as if memory usage is close to its limit, and allows you to improve resource allocation by seeing if provisioned compute resources exceed what is required for optimal application performance. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/infra_pods.360d540afa13753aee1a111db0f54aaf.png?auto=format" alt="Kubernetes Pods" /%} The Kubernetes Metrics section contains a high level summary of your infrastructure health for the selected time period, and includes CPU, Memory, Network, and Disk metrics. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/infra_metrics_1.1a19345f331a15a4e895e63d16f471ef.png?auto=format" alt="Kubernetes Metrics" /%} For non-Kubernetes environments (such as host-based installation), see the [Unified Service Tagging documentation](https://docs.datadoghq.com/getting_started/tagging/unified_service_tagging/?tab=systemmetrics#non-containerized-environment). ### Runtime Metrics{% #runtime-metrics %} If runtime metrics are enabled in the tracing client, you'll see a Runtime metrics tab corresponding to the runtime language of your service. Read more in [Runtime Metrics](https://docs.datadoghq.com/tracing/metrics/runtime_metrics/). {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/runtime_metrics_1.4f5aa158fb856126ebf5117160f1b606.png?auto=format" alt="Runtime Metrics" /%} ### Profiling{% #profiling %} You'll see a Profiling tab if the [Continuous Profiler](https://docs.datadoghq.com/profiler/) is set up for your service. Use the information in the **Profiling** tab to correlate a latency and throughput change to a code performance change. In this example, you can see how latency is linked to a lock contention increase on `/GET train` that is caused by the following line of code: ```java Thread.sleep(DELAY_BY.minus(elapsed).toMillis()); ``` {% video url="https://datadog-docs.imgix.net/images/profiler/apm_service_page_pivot_to_contention_comparison_1.mp4" /%} ### Memory Leaks{% #memory-leaks %} If you set up the [Continuous Profiler](https://docs.datadoghq.com/profiler/) and the service is running in a containerized environment, the [Memory Leaks](https://docs.datadoghq.com/profiler/guide/solve-memory-leaks/) tab becomes available. It guides you through a workflow for identifying potential memory leaks and shows the most actionable data. {% image source="https://datadog-docs.imgix.net/images/profiler/apm_service_page_memory_leaks.63f7a6883da7e877d5e94072ca45e0d4.png?auto=format" alt="Memory Leaks" /%} ### Traces{% #traces %} View the list of traces associated with the service in the traces tab, which is already filtered on your service, environment, and operation name. Drill down to problematic spans using core [facets](https://docs.datadoghq.com/tracing/trace_explorer/query_syntax/#facets) such as status, resource, and error type. For more information, click a span to view a flame graph of its trace and more details. {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/traces_1.28ce9d933e4143d75904090b41c6381b.png?auto=format" alt="Traces" /%} ### Log patterns{% #log-patterns %} View common patterns in your service's logs, and use facets like status in the search bar to filter the list of patterns. Click on a pattern to open the side panel to view more details, such as what events triggered the cascade. Read more in [Log patterns](https://www.datadoghq.com/blog/log-patterns/). {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/log_patterns_1.ceddd6b00277bd71b899153d0855b32d.png?auto=format" alt="Log patterns" /%} ### Costs{% #costs %} Visualize the cost associate with your service's infrastructure used in the Costs tab. [Learn More about Cloud Cost Management](https://docs.datadoghq.com/cloud_cost_management/). {% image source="https://datadog-docs.imgix.net/images/tracing/visualization/service/costs_tab_1.eec486f381f6fa27d2f22daa186a9c9e.png?auto=format" alt="Costs" /%} ## Further Reading{% #further-reading %} - [Learn how to setup APM tracing with your application](https://docs.datadoghq.com/tracing/trace_collection/) - [Discover and catalog the services reporting to Datadog](https://docs.datadoghq.com/tracing/software_catalog/) - [Dive into your resource performance and traces](https://docs.datadoghq.com/tracing/services/resource_page/) - [Understand how to read a Datadog Trace](https://docs.datadoghq.com/tracing/trace_explorer/trace_view/) - [Add an APM service page URL to your clipboard](https://www.datadoghq.com/blog/datadog-clipboard/) - [Gain visibility into risks, vulnerabilities, and attacks with APM Security View](https://www.datadoghq.com/blog/apm-security-view/)