# Insights

Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fapm-v2%2Ffeatures%2Finsights.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fapm-v2%2Ffeatures%2Finsights.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

**Insights** surface data-quality and coverage gaps across your APM catalog - services that aren't profiled, services with no owner or SLO, or an account nearing a catalog limit - so you can fix what's holding your observability back before it costs you during an incident. The section sits at the top of the catalog, summarizing the gaps across the services and databases in view, with a drawer that lists every one.

Use it to:

* **Close coverage gaps**: find services that aren't profiled, have no detected language, or aren't sending spans, and fix them before you need the data.
* **Drive ownership and reliability**: surface services with no owner or no SLO, so every service has a team accountable for it and a reliability target to meet.
* **Stay ahead of catalog limits**: catch when your account is near or at an entity, identity, or cardinality limit before entities start to drop.
* **Scope the work to your team**: filter insights by environment and team to see only what you're responsible for.

[![The Insights section on the APM catalog: four insight cards, each with a title, description, category badge, and the teams and environments it affects, and a View all insights control.](/docs/assets/images/insights-section-4d7cce9132838af310284bca1150b74a.webp)](https://coralogix.com/docs/assets/images/insights-section-4d7cce9132838af310284bca1150b74a.webp)

## What you need[​](#what-you-need "Direct link to What you need")

* Coralogix [Application Performance Monitoring (APM)](https://coralogix.com/docs/user-guides/apm-v2/getting-started/apm-onboarding-tutorial.md) installed and configured.
* [Compact span metrics](https://coralogix.com/docs/user-guides/apm-v2/getting-started/using-compact-span-metric.md) for your services - the catalog, and the insights computed from it, read these.

## Where Insights appears[​](#where-insights-appears "Direct link to Where Insights appears")

The Insights section sits at the top of the catalog, between the search bar and the [Overview](https://coralogix.com/docs/user-guides/apm-v2/services.md) widgets. It opens expanded, showing up to four insight cards. Select the section header to collapse it: the cards fold into compact pills that still name every gap, so you can keep the summary without the full cards. The expanded or collapsed state travels with the URL, so it's preserved when you copy a link or [save a view](https://coralogix.com/docs/user-guides/apm-v2/features/saved-views.md).

When there are more than four insights, **View all insights (*n*)** appears on the right of the header, where *n* is the total count. Select it to open the [All insights drawer](#view-all-insights).

## Read an insight[​](#read-an-insight "Direct link to Read an insight")

Each insight card shows:

* An **icon** for the kind of gap.
* A **title** naming the gap and how many entities it affects, for example *21 services with no CPU profiling*.
* A short **description** of the impact.
* A **category** badge (see [Insight categories](#insight-categories)).
* Up to two count pills: ***n* teams**, the owners affected, and ***n* envs**, the environments affected.

Insight cards are read-only. They tell you what's missing, how many entities and teams it affects, and in which environments - so you know what to fix and where. Use the catalog's filters to narrow to the affected entities, and the feature docs linked under [Insight types](#insight-types) to resolve each gap.

## Insight categories[​](#insight-categories "Direct link to Insight categories")

Coralogix assigns every insight a category. Filter by category in the All insights drawer to focus on one kind of work:

* **Enablement**: a capability isn't turned on yet for the entity, such as CPU or memory profiling, runtime metrics, or server spans.
* **Configuration**: something needs setting up, such as an owner or an SLO.
* **Instrumentation**: the telemetry itself is incomplete, such as a service with no detected language or one sending full span metrics without their compact counterparts.
* **Limits**: your account is near or at a catalog limit - entities, identities, or cardinality.
* **Other**: anything that doesn't fall into the categories above.

## Insight types[​](#insight-types "Direct link to Insight types")

The drawer also filters by type. Each type flags one specific gap. Only the types present in your data appear in the filter.

| Type                    | What it flags                                                                                                | Resolve with                                                                                                                              |
| ----------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| No language detected    | APM can't determine the service's language, so language-specific views and runtime insights are unavailable. | [APM onboarding](https://coralogix.com/docs/user-guides/apm-v2/getting-started/apm-onboarding-tutorial.md)                                |
| No server spans         | The entity has recorded no server (incoming) spans, so there's nothing to trace.                             | [APM onboarding](https://coralogix.com/docs/user-guides/apm-v2/getting-started/apm-onboarding-tutorial.md)                                |
| No transactions         | The service isn't producing transaction data.                                                                | [Enable the transactions processor](https://coralogix.com/docs/user-guides/apm-v2/features/transactions/enable-transactions-processor.md) |
| No CPU profiling        | No CPU profile has been recorded for the service.                                                            | [Profiling](https://coralogix.com/docs/user-guides/apm-v2/features/profiling.md)                                                          |
| No memory profiling     | No memory profile has been recorded for the service.                                                         | [Profiling](https://coralogix.com/docs/user-guides/apm-v2/features/profiling.md)                                                          |
| Missing runtime metrics | The service's runtime metrics aren't being reported. One insight is raised per language.                     | [Runtime metrics](https://coralogix.com/docs/user-guides/apm-v2/features/runtime-metrics.md)                                              |
| No owner                | No owner is set in the entity's metadata, so no team is accountable for it.                                  | [Entity Metadata API](https://coralogix.com/docs/developer-portal/apis/data-management/service-catalog-entity-metadata-api.md)            |
| No SLO                  | No SLO is defined for the service, so its reliability isn't tracked against a target.                        | [Service SLOs](https://coralogix.com/docs/user-guides/apm-v2/features/service-slos.md)                                                    |
| Missing compact metrics | The entity isn't sending the compact span metrics the catalog relies on.                                     | [Using compact span metrics](https://coralogix.com/docs/user-guides/apm-v2/getting-started/using-compact-span-metric.md)                  |
| Entity limit            | Your account is near or at its limit for catalog entities.                                                   | [Cardinality limits](https://coralogix.com/docs/user-guides/apm-v2/getting-started/span-metrics-cardinality-limits.md)                    |
| Identity limit          | Your account is near or at its limit for entity identities.                                                  | [Cardinality limits](https://coralogix.com/docs/user-guides/apm-v2/getting-started/span-metrics-cardinality-limits.md)                    |
| Cardinality limit       | Your account is near or at a cardinality limit.                                                              | [Cardinality limits](https://coralogix.com/docs/user-guides/apm-v2/getting-started/span-metrics-cardinality-limits.md)                    |

## View all insights[​](#view-all-insights "Direct link to View all insights")

Select **View all insights (*n*)** in the section header to open the **All insights** drawer - the complete list, not just the four cards on the overview. The drawer reads the same insights as the section, so it opens without reloading.

Narrow the list with two filters:

* **Category**: a single-select dropdown that lists only the categories present in your data, plus **All categories**.
* **Type**: a single-select dropdown that lists only the types present in your data, plus **All types**.

Select **Copy link** to copy a link that reopens APM with the drawer open at the current scope. The in-drawer category and type selections reset to **All** when the drawer reopens.

[![The All insights drawer open beside the catalog, listing every insight with the category and type filters above it.](/docs/assets/images/all-insights-drawer-f6a02e274a01fd8006259064615be72b.webp)](https://coralogix.com/docs/assets/images/all-insights-drawer-f6a02e274a01fd8006259064615be72b.webp)

## How insights are scoped[​](#how-insights-are-scoped "Direct link to How insights are scoped")

* **Entity type**: the sidebar selection - **Services** or **Databases** - determines which entities' insights you see.
* **Filters**: the catalog's sidebar filters - environment, team, language, database system, and health - also narrow the insights. The service-name search box does not.
* **No time range**: insights describe the current state of your catalog, not a time window, so the time picker doesn't change them.
* **Account-wide insights**, such as catalog limits, appear regardless of the entity type in view.

When no gaps are found for the current scope, the section reads **Nothing needs attention**. If only some insights could be loaded, it shows the ones it has alongside a note that the rest couldn't be loaded.

## Next steps[​](#next-steps "Direct link to Next steps")

Give the services Insights flags a reliability target to meet with [Service SLOs](https://coralogix.com/docs/user-guides/apm-v2/features/service-slos.md).
