Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fcustom-dashboards%2Fintroduction.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%2Fcustom-dashboards%2Fintroduction.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[API reference](https://coralogix.com/docs/api-reference/v5/dashboard-service)[Terraform](https://registry.terraform.io/providers/coralogix/coralogix/latest/docs/resources/dashboard)

# Custom Dashboards

Coralogix Custom Dashboards give you a flexible, high-performance workspace to visualize logs, metrics, and traces—together, in real time.

Whether you're monitoring a critical release, investigating latency, or trying to understand system behavior, Custom Dashboards give you the power to ask complex questions and see immediate, visual answers.

Ready to get started?

Explore our [tutorials](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/configure-time-interval.md) to start building your first dashboard.

## Data sources[​](#data-sources "Direct link to Data sources")

Coralogix brings logs, metrics, and traces together in a single dashboard interface. While each widget focuses on a specific data type, dashboards can seamlessly combine visualizations from all three—making it easier to correlate and act on your data.

## Queries: turn raw data into answers[​](#queries-turn-raw-data-into-answers "Direct link to Queries: turn raw data into answers")

Behind every widget is a powerful query. Coralogix supports:

* [DataPrime](https://coralogix.com/docs/dataprime/introduction/welcome-to-the-dataprime-reference.md) for complex, cross-source, data-transformative queries.

[![alt text](/docs/assets/images/dataprime-widget-75d8a2811abb01cb6a820348c855627d.webp)](https://coralogix.com/docs/assets/images/dataprime-widget-75d8a2811abb01cb6a820348c855627d.webp)

* PromQL for metric queries.

[![alt text](/docs/assets/images/metric-widget-80c2ec05685bc440a2a0e9d2e3a2d780.webp)](https://coralogix.com/docs/assets/images/metric-widget-80c2ec05685bc440a2a0e9d2e3a2d780.webp)

* Lucene for log and span queries.

[![alt text](/docs/assets/images/logs-widget-1afbdfbfe380e52e1636ec9a1a98f461.webp)](https://coralogix.com/docs/assets/images/logs-widget-1afbdfbfe380e52e1636ec9a1a98f461.webp)

* [Relational queries](https://coralogix.com/docs/user-guides/data-query/relational-queries.md) in the Query Builder to query spans by their relationships in a trace.

[![Relational query](/docs/assets/images/rq-root-cart-services-65b0cfcd9df9759b1a4b5e255662a7a0.webp)](https://coralogix.com/docs/assets/images/rq-root-cart-services-65b0cfcd9df9759b1a4b5e255662a7a0.webp)

Queries allow you to define what data you’re visualizing. Use the out-of-the-box [Query Builder](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/query-builder.md) to effortlessly construct the most complex queries, whether you're counting errors, tracking throughput, or correlating latency spikes.

[Variables](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/create-and-manage-variables.md) and filters let you reuse and refine these queries dynamically—so dashboards become interactive tools, not static reports.

## Custom widgets[​](#custom-widgets "Direct link to Custom widgets")

Each query feeds into a widget—a visual representation of your data. Coralogix offers a rich variety of widget types to help you explore patterns, spot anomalies, and track key metrics.

* **Time series**: Visualize trends over time with [line charts](https://coralogix.com/docs/user-guides/custom-dashboards/widgets/line-charts.md). Ideal for performance metrics and alerts.
* **Metrics**: [Gauges](https://coralogix.com/docs/user-guides/custom-dashboards/widgets/gauges/basic-gauges.md) and [polystats](https://coralogix.com/docs/user-guides/custom-dashboards/widgets/polystat-widget.md) highlight current values, thresholds, and statuses at a glance.
* **Tables**: Display structured data for detailed side-by-side metric inspection.
* **Charts**: Use [bar](https://coralogix.com/docs/user-guides/custom-dashboards/widgets/vertical-bar-charts.md) and [pie charts](https://coralogix.com/docs/user-guides/custom-dashboards/widgets/pie-charts.md) for proportional breakdowns of value.
* **Text widgets**: Add [markdown-based](https://coralogix.com/docs/user-guides/custom-dashboards/widgets/markdown-widget.md) explanations, headers, or contextual notes directly. within the dashboard.

By combining these widget types, you can build focused, interactive dashboards, tailored to your observability and monitoring needs.

## Widget layout[​](#widget-layout "Direct link to Widget layout")

Custom Dashboards arrange widgets on a grid of rows. Each row holds a maximum number of widgets, which varies by widget type because some widgets stay readable at smaller sizes than others:

| Widget type                                                                                                              | Maximum per row |
| ------------------------------------------------------------------------------------------------------------------------ | --------------- |
| Gauge                                                                                                                    | 6               |
| Stat                                                                                                                     | 10              |
| All other widget types (line chart, bar chart, pie chart, data table, Polystat, heatmap, markdown, DataPrime, and so on) | 5               |

When you mix widget types in the same row, the maximum depends on the combined widget sizes. A gauge that shares a row with other widget types renders at single-gauge width.

When a row is full, the dashboard prevents you from adding another widget to it—add the widget to a new row instead. By default, widgets in a row share the available width evenly, but you can resize them horizontally.

### Resize widgets[​](#resize-widgets "Direct link to Resize widgets")

Widgets don't have to keep their default width. To give one widget more room than the others, drag the handle on its right edge. The widget snaps to the grid as you drag, and the widget immediately to its right grows or shrinks by the same amount, so the row stays full—for example, you can widen a line chart while keeping a neighboring stat or gauge compact. Only widgets that have a neighbor to their right show the resize handle.

A widget can't be resized below the minimum width for its type, and it can't grow so far that the adjacent widget would drop below its own minimum.

## Feature overview[​](#feature-overview "Direct link to Feature overview")

Custom Dashboards help you to go from high-level monitoring to granular investigation in just a few clicks.

* Add [custom actions](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/create-and-manage-custom-actions.md) to jump from a chart in one custom dashboard to another with the same filters.
* Use [custom annotations](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/create-annotations.md) to mark deployments or incidents.
* Create [variables](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/create-and-manage-variables.md) once and reuse them across your widgets.
* [Auto-refresh](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/auto-refresh.md) dashboards at a fixed interval for live, streaming updates.
* Share, [export](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/import-and-export-custom-dashboards.md), or duplicate dashboards to scale your workflows across teams.

## Ask Olly about a widget[​](#ask-olly-about-a-widget "Direct link to Ask Olly about a widget")

Hover over a widget to reveal its toolbar, then select the **Add to Olly context** icon at the top right — to the left of the more actions menu — to pin the widget to an [Olly](https://coralogix.com/docs/user-guides/olly.md) chat and open the Olly drawer.

[![Custom dashboard widget toolbar with the Add to Olly context icon highlighted, to the left of the more-actions menu](/docs/assets/images/add-olly-context-widget-97d482cfb3d5c52dff7dea0aebf79c83.webp)](https://coralogix.com/docs/assets/images/add-olly-context-widget-97d482cfb3d5c52dff7dea0aebf79c83.webp)

Olly receives the widget's query and data, so you can ask what's driving a spike, summarize what the widget shows, or compare it against another time range. The widget is added as a removable chip in the prompt; see [Page and data context](https://coralogix.com/docs/user-guides/olly/olly-chat.md#page-and-data-context) for chip behavior and removal.

## Additional resources[​](#additional-resources "Direct link to Additional resources")

![Introduction to Coralogix Custom Dashboards](https://img.youtube.com/vi/KSsf1yvUqTc/mqdefault.jpg)

Introduction to Coralogix Custom Dashboards

![General Overview of Custom Dashboards](https://img.youtube.com/vi/8TftCAejGCA/mqdefault.jpg)

General Overview of Custom Dashboards

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

Learn how to [configure time intervals for time-axis widgets](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/configure-time-interval.md).