# Exoscale Documentation — Grafana > Managed Grafana: a fully managed observability platform to launch Grafana in minutes and combine data from several sources in one dashboard. --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/ --- # Grafana Grafana is an open-source observability platform for dashboards, metrics, logs, and traces, enabling real-time monitoring and analysis. - [Quick Start - Grafana](https://community.exoscale.com/product/dbaas/service-specific/grafana/quick-start/index.md) - Get started quickly with a guided setup to achieve your first successful use of the service, including the required steps and configuration. - [Overview - Grafana](https://community.exoscale.com/product/dbaas/service-specific/grafana/overview/index.md) - Terminology and key features at a glance, learn the core concepts, capabilities, and options of this service before you dive deeper. - [How-To - Grafana](https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/index.md) - Step-by-step guides to configure the service and use specific features, with clear instructions for common tasks and problem solving. - [Service Boundaries - Grafana](https://community.exoscale.com/product/dbaas/service-specific/grafana/service-boundaries/index.md) - Service boundaries: quotas, limits, and the guaranteed service levels (SLA) for this product, including key constraints to plan and operate reliably. - [Reference - Grafana](https://community.exoscale.com/product/dbaas/service-specific/grafana/reference/index.md) - Reference documentation for API, CLI, and tools, browse comprehensive details, parameters, commands, and integration notes. --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/quick-start/ --- # Quick Start - Grafana ## Specific Options for Grafana You can find all the specific options for Managed Grafana by using the CLI help: ```bash exo dbaas create --help-grafana --grafana-fork-from name of a Database Service to fork from --grafana-ip-filter allow incoming connections from CIDR address block --grafana-settings grafana configuration settings (JSON format) ``` ## Specific Options when Creating or Updating a Grafana service You can find all the specific options for Grafana by using the CLI help: ```bash exo dbaas type show grafana --settings grafana ``` Output: ```bash ┼──────────────────────────────────┼─────────┼───────────────────────────────────────────────────┼ │ KEY │ TYPE │ DESCRIPTION │ ┼──────────────────────────────────┼─────────┼───────────────────────────────────────────────────┼ │ dashboard_previews_enabled │ boolean │ This feature is new in Grafana 9 and is quite │ │ │ │ resource intensive. It may cause low-end plans to │ │ │ │ work more slowly while the dashboard previews are │ │ │ │ rendering. │ │ │ │ * Example: false │ │ alerting_enabled │ boolean │ │ │ smtp_server │ object │ │ │ allow_embedding │ boolean │ │ │ cookie_samesite │ string │ │ │ auth_gitlab │ object │ │ │ alerting_max_annotations_to_keep │ integer │ │ │ dataproxy_send_user_header │ boolean │ │ │ google_analytics_ua_id │ string │ │ │ alerting_nodata_or_nullvalues │ string │ │ │ metrics_enabled │ boolean │ │ │ auth_github │ object │ │ │ dataproxy_timeout │ integer │ │ │ viewers_can_edit │ boolean │ │ │ alerting_error_or_timeout │ string │ │ │ privatelink_access │ object │ │ │ auth_basic_enabled │ boolean │ │ │ date_formats │ object │ │ │ user_auto_assign_org_role │ string │ │ │ auth_generic_oauth │ object │ │ │ recovery_basebackup_name │ string │ │ │ auth_azuread │ object │ │ │ user_auto_assign_org │ boolean │ │ │ dashboards_versions_to_keep │ integer │ │ │ editors_can_admin │ boolean │ │ │ auth_google │ object │ │ │ disable_gravatar │ boolean │ │ │ dashboards_min_refresh_interval │ string │ Signed sequence of decimal numbers, followed by a │ │ │ │ unit suffix (ms, s, m, h, d), e.g. 30s, 1h │ │ │ │ * Example: 5s │ ┼──────────────────────────────────┼─────────┼───────────────────────────────────────────────────┼ ``` --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/overview/ --- # Overview - Grafana Exoscale's Managed Grafana provides a fully managed observability platform ideal for cloud-native environments. It allows you to launch a Grafana instance within minutes and set up a monitoring solution for your systems and applications, combining data from various sources into a single dashboard ## Terminology Grafana Service : a managed deployment of the Grafana OSS application on Exoscale Data Source : external system (Prometheus, OpenSearch, PostgreSQL, etc.) queried by Grafana Dashboard : collection of panels that visualise data from one or more data sources Alert Rule : condition evaluated on dashboard queries; triggers a notification channel when firing Plugin : community or official extension that adds panels, data sources, or apps ## Features Managed Lifecycle : one-click provisioning, seamless point-release upgrades and simple plan scaling Secure by Default : TLS on the public endpoint, SSO via Exoscale IAM or native Grafana users Dashboards & Alerting : full Grafana OSS feature set, including Alerting v2 and alert rules as code Plugin Catalogue : curated selection of official and community plugins pre-approved by Exoscale Exoscale Integrations : ready-made data sources for Metrics, DBaaS logs and OpenSearch indices Automated Backups : daily off-site snapshots of Grafana’s SQLite/PostgreSQL storage (plan-dependent) --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/ --- # How-To - Grafana Step-by-step guides to configure the service and use specific features, with clear instructions for common tasks and problem solving. - [Configure Grafana Notifications](https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/notifications/index.md) - Configure Grafana notifications with alert integrations like Slack, PagerDuty, and email to monitor metrics and respond quickly to issues. - [Manage Grafana Users](https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/user-mgmt/index.md) - Manage Grafana users by configuring SMTP for email invites or creating users manually and assigning them to the right organization. - [Restrict Grafana Connections](https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/restricting-connections/index.md) - Restrict Grafana connections with IP filters to allow only specific addresses or CIDR ranges while keeping traffic SSL encrypted. - [Use Grafana Plugins](https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/plugins/index.md) - Use bundled Grafana panel, data source, and app plugins in Managed Grafana without extra installation to build dashboards and integrations. --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/notifications/ --- # Configure Grafana Notifications In Exoscale Managed Grafana, notifications are an essential feature for monitoring and alerting users about critical system activities and metrics. This allows users to be proactive in maintaining system health and performance across their cloud applications. ## Configuring Notifications - **Supported Integrations** Exoscale Managed Grafana supports a wide range of alert notification integrations, allowing users to connect with services like Slack, PagerDuty, and email, among others. These integrations facilitate timely alerts to appropriate teams or individuals, ensuring rapid response to any issues. - **Customizable Alerts** Users can configure alerts based on specific conditions and thresholds using Intuitive Grafana dashboards. This customization allows for precise monitoring of metrics such as resource utilization, error rates, and application availability. ## Leveraging Exoscale Infrastructure - **Scalability and Reliability** Exoscale’s robust infrastructure ensures that notification mechanisms are scalable and reliable, catering to various workload demands. This feature is particularly useful for enterprises needing to monitor multiple applications or microservices simultaneously. - **Streamlined Management** By utilizing Exoscale's management capabilities, users can seamlessly set up, customize, and scale notifications as their needs evolve. The intuitive interface and integration capabilities simplify the management of alerts across diverse cloud environments. > [!NOTE] > For notifications, you can implement any of the > [alert notifications extensions](https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/#list-of-supported-integrations) from the Grafana portal. --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/user-mgmt/ --- # Manage Grafana Users SMTP configuration is not available by default at startup, so directly sending a user invitation from the Grafana UI will not work under the organization and user management screen. Two options are possible: 1. Set SMTP configuration details to be able to send user invites and other notifications via email 2. Manually create users ## Configure SMTP and Send User Invites To activate SMTP email sending, use the `exo` CLI with the following parameters: ```bash exo dbaas update --zone de-fra-1 grafana-smtp --grafana-settings '{"smtp_server":{"host":"a_valid_smtp_host","port":587,"username":"myusername","password":"mypassword","from_address":"dashboard@your.domain"}}' ``` The full list of parameters is as follow: ### Required * from_address: (String) Address used for sending emails. * host: (String) Server hostname or IP. * port: (Number) SMTP server port. ### Optional * from_name: (String) Name used in outgoing emails, defaults to Grafana. * password: (String, Sensitive) Password for SMTP authentication. * skip_verify: (Boolean) Skip verifying server certificate. Defaults to false. * starttls_policy: (String) Either OpportunisticStartTLS, MandatoryStartTLS or NoStartTLS. Default is OpportunisticStartTLS. * username: (String) Username for SMTP authentication. Then proceed to the `admin/users/` section of the Grafana portal and follow the instructions. > [!NOTE] > The SMTP settings can also be set at service creation using the CLI with the same `--grafana-settings` option flag. ## Manual User Creation If no SMTP configuration is set then proceed as described: * Navigate to the `admin/users/` section of the Grafana portal * Add the user. Deactivate the sent email option. * No email will be sent. You can retrieve the invitation link by click on the pending invites button. * Specifically add the user to the organization you would prefer. By default a new organization will be created for each new user, whereas you might want to have them under the same default organization. --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/restricting-connections/ --- # Restrict Grafana Connections By default, Exoscale DBaaS is not accessible from the whole internet. Data does not transmit in clear over the network as it is SSL encrypted by default and authenticated. To allow incoming connections to your database service, you can add a filter allowing: - just one IP address - a network range - or a combination of IP address and network range To do this, update your service or create it with the IP filter, which is a comma separated list of CIDRs: ```bash exo dbaas update -z de-muc-1 test-grafana --grafana-ip-filter=1.2.3.4/24,5.6.7.8/32 ``` --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/how-to/plugins/ --- # Use Grafana Plugins The following plugins are packaged with the Managed Grafana instances and do not require additional installation. These are updated on a regular basis. ## Panel Plugins * AJAX - [Grafana](https://grafana.com/grafana/plugins/ryantxu-ajax-panel/) | [GitHub](https://github.com/ryantxu/ajax-panel) - A general way to load external content into a Grafana dashboard. * Alert list - [Grafana](https://grafana.com/grafana/plugins/alertlist/) | [Grafana Docs](https://grafana.com/docs/grafana/v7.5/panels/visualizations/alert-list-panel/) * Allows you to display alerts on a dashboard. The list can be configured to show either the current state of your alerts or recent alert state changes. * Annotation list - [Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/annotations/) | [GitHub](https://github.com/grafana/grafana/tree/main/public/app/plugins/panel/annolist) * Shows user annotations in Grafana database. * Bar chart - [Grafana Docs](https://grafana.com/docs/grafana/latest/visualizations/bar-chart/) * Allows you to graph categorical data. * Bar gauge - [Grafana Docs](https://grafana.com/docs/grafana/latest/visualizations/bar-gauge-panel/) * Simplifies your data by reducing every field to a single value. You choose how Grafana calculates the reduction. This panel can show one or more bar gauges depending on how many series, rows, or columns your query returns. * Candlestick - [Grafana Docs](https://grafana.com/docs/grafana/latest/visualizations/candlestick/) * Shows a chart that is typically used to describe price movements of a security, derivative, or currency. * Canvas - [Grafana](https://grafana.com/grafana/plugins/canvas/) * Included with Grafana. Canvas visualizations are extensible form-built panels that allow you to explicitly place elements within static and dynamic layouts. Similar to UI and web design tools you may have used before. * Carpet plot - [Grafana](https://grafana.com/grafana/plugins/petrslavotinek-carpetplot-panel/) * Receives data series and divides all the data into individual buckets. * Clock - [Grafana](https://grafana.com/grafana/plugins/grafana-clock-panel/) | [GitHub](https://github.com/grafana/clock-panel) * Shows the current time or a countdown and updates every second. * D3 Gauge - [Grafana](https://grafana.com/grafana/plugins/briangann-gauge-panel/) | [GitHub](https://github.com/briangann/grafana-gauge-panel) * Provides a D3-based gauge panel for Grafana 6.x/7.x * Dashboard list - [Grafana](https://grafana.com/grafana/plugins/dashlist/) | [Grafana Docs](https://docs.grafana.org/reference/dashlist/) * Allows you to display dynamic links to other dashboards. The list can be configured to use starred dashboards, a search query and/or dashboard tags. * Diagram - [Grafana](https://grafana.com/grafana/plugins/jdbranham-diagram-panel/) | [GitHub](https://github.com/jdbranham/grafana-diagram) * Provides a way to create flow-charts, sequence diagrams, and Gantt charts by leveraging the mermaid.js library. * Discrete - [Grafana](https://grafana.com/grafana/plugins/natel-discrete-panel/) | [GitHub](https://github.com/NatelEnergy/grafana-discrete-panel) * Shows discrete values in a horizontal graph, plotting state transitions. * FlowCharting - [Grafana](https://grafana.com/grafana/plugins/agenty-flowcharting-panel/) | [Docs](https://algenty.github.io/flowcharting-repository/) * Displays complex diagrams using the online graphing library draw.io. * Gauge * Standard gauge visualization. * Geomap * Included with Grafana. * Getting Started * Included with Grafana. * Graph - [Grafana Docs](https://grafana.com/docs/grafana/next/panels-visualizations/visualizations//) * Included with Grafana, provides a very rich set of graphing options. * Heatmap - [Grafana](https://grafana.com/grafana/plugins/heatmap-new/) | [Grafana Docs](https://docs.grafana.org/features/panels/heatmap/) * Allows you to view histograms over time. The legacy Heatmap plugin is also still available. * Histogram - [Grafana](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/histogram/) * Provides a histogram for time series data. * Logs * Included with Grafana. * News - [Grafana Docs](https://grafana.com/docs/grafana/latest/visualizations/news-panel/) * This panel visualization displays an RSS feed. By default, it displays articles from the Grafana Labs blog. * Node Graph * Included with Grafana. * Panel / Plotly - [GitHub](https://github.com/NatelEnergy/grafana-plotly-panel) * Render metrics using the plot.ly JavaScript framework. * Pie Chart - [Grafana](https://grafana.com/grafana/plugins/grafana-piechart-panel/) | [GitHub](https://github.com/grafana/piechart-panel) * Adding pie charts to your dashboard. * Plugin list - [Grafana](https://grafana.com/grafana/plugins/pluginlist/) * Included with Grafana. * Singlestat Math - [Grafana](https://grafana.com/grafana/plugins/blackmirror1-singlestat-math-panel/) * A modification of the native single stat panel to support math functions across series. * Stat - [Grafana Docs](https://docs.grafana.org/reference/singlestat/) * Included with Grafana, allows you to show the one main summary stat of a SINGLE series. * State timeline * Included with Grafana. * Status history * Provides a periodic status history. * Status Panel - [Grafana](https://grafana.com/grafana/plugins/vonage-status-panel/) | [GitHub](https://github.com/Vonage/Grafana_Status_panel) * Use as a centralized view for the status of component in a glance. * Statusmap - [Grafana](https://grafana.com/grafana/plugins/flant-statusmap-panel/) | [GitHub](https://github.com/flant/grafana-statusmap) * Shows discrete statuses of multiple targets over time. * Table - [Grafana](https://grafana.com/grafana/plugins/table/) * Supports both multiple modes for time series as well as for table, annotation and raw JSON data. It also provides date formatting and value formatting and coloring options. * Text - [Grafana](https://grafana.com/grafana/plugins/text/) * A simple panel that displays text. The source text is written in markdown so that you can format it. * Time series * Allows for visualizing time series data. * Welcome * Included with Grafana. * Worldmap Panel - [GitHub](https://github.com/grafana/worldmap-panel) * Displays time series data or geohash data from Elasticsearch overlaid on a world map. * XY Chart - [Grafana](https://grafana.com/grafana/plugins/text/) * Native plugin that supports arbitrary X vs Y in graphs. ## Data Source Plugins * Altinity plugin for ClickHouse® - [GitHub](https://github.com/Altinity/clickhouse-grafana) * Provides support for ClickHouse® as a backend database. * Azure Monitor - [Grafana](https://grafana.com/grafana/plugins/grafana-azure-monitor-datasource/) | [GitHub](https://github.com/grafana/azure-monitor-datasource) * Provides a single source for monitoring Azure resources. * CloudWatch - [Grafana](https://grafana.com/grafana/plugins/cloudwatch/) | [Grafana Docs](https://docs.grafana.org/datasources/cloudwatch/) * Build dashboards for your CloudWatch metrics. * Elasticsearch - [Grafana](https://grafana.com/grafana/plugins/elasticsearch/) | [Grafana Docs](https://docs.grafana.org/datasources/elasticsearch/) * Performs Elasticsearch queries to visualize logs or metrics stored in Elasticsearch. Annotate your graphs with log events stored in Elasticsearch. * GitHub - [GitHub](https://github.com/grafana/github-datasource) * Allows GitHub API data to be visually represented in Grafana dashboards. * Google BigQuery - [GitHub](https://github.com/doitintl/bigquery-grafana) * Provides support for BigQuery as a backend database. * Google Sheets - [Grafana](https://grafana.com/grafana/plugins/grafana-googlesheets-datasource/) | [GitHub](https://github.com/grafana/google-sheets-datasource) * Visualize your Google Spreadsheets in Grafana. * Graphite - [Grafana](https://grafana.com/grafana/plugins/graphite/) | [Grafana Docs](https://docs.grafana.org/datasources/graphite/) * Quickly navigate the metric space, add functions, change function parameters and more. * InfluxDB® - [Grafana](https://grafana.com/grafana/plugins/influxdb/) | [Grafana Docs](https://docs.grafana.org/datasources/influxdb/) * Instana - [Grafana](https://grafana.com/grafana/plugins/instana-datasource/) | [GitHub](https://github.com/instana/instana-grafana-datasource) * Shows metrics from Instana AI-Powered APM for dynamic applications. * Jaeger * Open source, end-to-end distributed tracing. * Loki * A built in data source that allows you to connect to the Loki logging service. * Microsoft SQL Server * Grafana ships with a built-in Microsoft SQL Server (MSSQL) data source plugin that allows you to query and visualize data from any Microsoft SQL Server 2005 or newer. * MySQL - [Grafana](https://grafana.com/grafana/plugins/mysql/) | [Grafana Docs](https://docs.grafana.org/features/datasources/mysql/) * Allows you to query any visualize data from a MySQL compatible database. * OpenSearch® - [Grafana](https://grafana.com/grafana/plugins/grafana-opensearch-datasource/) * Runs many types of simple or complex OpenSearch® queries to visualize logs or metrics stored in OpenSearch. Annotate your graphs with log events stored in OpenSearch. * OpenTSDB - [Grafana](https://grafana.com/grafana/plugins/opentsdb/) | [Grafana Docs](https://docs.grafana.org/datasources/opentsdb/) * OpenTSDB is a scalable, distributed time series database. * Pagerduty - [Grafana](https://grafana.com/grafana/plugins/xginn8-pagerduty-datasource/) | [GitHub](https://github.com/xginn8/grafana-pagerduty) * Annotations-only datasource for Pagerduty events. * PostgreSQL® - [Grafana](https://grafana.com/grafana/plugins/postgres/) | [Grafana Docs](https://docs.grafana.org/features/datasources/postgres/) * Allows you to query and visualize data from a PostgreSQL compatible database. * Prometheus - [Grafana](https://grafana.com/grafana/plugins/prometheus/) | [Grafana Docs](https://docs.grafana.org/datasources/prometheus/) * Work with the open-source service monitoring system and time series database. * Prometheus AlertManager - [GitHub](https://github.com/camptocamp/grafana-prometheus-alertmanager-datasource) * Allows you to use the AlertManager API of Prometheus to create dashboards in Grafana. * SimpleJson - [Grafana](https://grafana.com/grafana/plugins/grafana-simple-json-datasource/) | [GitHub](https://github.com/grafana/simple-json-datasource) * Stackdriver / Google Cloud Monitoring * Data source for Google’s monitoring service (formerly named, and listed as, Stackdriver). * Tempo * High volume, minimal dependency trace storage. OSS tracing solution from Grafana Labs. * TestData DB * Generates test data in different forms. * Zipkin * Data source for the distributed tracing system. ## Other Plugins * Grafana Image Renderer (Renderer) - [Grafana](https://grafana.com/grafana/plugins/grafana-image-renderer/) | [GitHub](https://github.com/grafana/grafana-image-renderer) * Handles rendering panels and dashboards to PNGs using a headless browser (Chromium). * Traces (Application) - [Grafana](https://grafana.com/grafana/plugins/grafana-enterprise-traces-app/) * Grafana Enterprise Traces (GET) is a commercial offering based on Tempo, and allows you to deploy a highly-scalable, simple, and reliable traces cluster in your own data center. * worldPing - [GitHub](https://github.com/raintank/worldping-app) * Continually tests, stores and alerts on the global performance and availability of your Internet applications so you can pinpoint issues. * Zabbix (Application) - [Grafana](https://grafana.com/grafana/plugins/alexanderzobnin-zabbix-app/) | [GitHub](https://github.com/alexanderzobnin/grafana-zabbix) * Visualizes your Zabbix metrics. --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/service-boundaries/ --- # Service Boundaries - Grafana - [Limits and Quotas - Grafana](https://community.exoscale.com/product/dbaas/service-specific/grafana/service-boundaries/limits-and-quotas/index.md) - Managed Grafana Limitations and Quotas - [SLA - Grafana](https://community.exoscale.com/product/dbaas/service-specific/grafana/service-boundaries/sla/index.md) - Managed Grafana Service Level Agreement - [Pricing ↗︎](https://www.exoscale.com/pricing/#managed-grafana) --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/service-boundaries/limits-and-quotas/ --- # Limits and Quotas - Grafana ## Limits Grafana OSS : is the only feature set offered; enterprise features (e.g. fine-grained RBAC, reporting) are not included. Custom Plugins : must be requested via support for security vetting before installation. Single-Region Only : is the provided service scope; cross-zone replication is not supported (use forks for disaster-recovery copies). API Keys : and user management are available, but organisation & team features are limited to one default organisation. Service Plans Restrictions : Access to certain plans (e.g., Business, Premium) requires activation by the support team. Requests can be made during service creation. ## Quotas | Usage | Quota | | -------------------------------------------------------- | ------------------------ | | DBaaS services overall | 10 | ## Availability Managed Grafana is available in all zones. --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/service-boundaries/sla/ --- # SLA - Grafana Refere to the overall [DBaaS SLA](https://community.exoscale.com/product/dbaas/service-boundaries/sla/index.md). --- url: https://community.exoscale.com/product/dbaas/service-specific/grafana/reference/ --- # Reference - Grafana - [API DBaaS](https://community.exoscale.com/reference/api/dbaas/dbaas-grafana/index.md) - All operations on DBaaS. (external) - [CLI DBaaS](https://community.exoscale.com/reference/cli/exo/dbaas/index.md) - All commands on DBaaS. (external)